Troubleshooting: Whitelisted IP Address Not Recognized for Conversions
Table of Contents
Introduction
This troubleshooting guide by TUNE addresses why your whitelisted IP address might not be recognized for conversions within the partner marketing platform. Understanding and resolving this issue ensures accurate conversion tracking and measurement for your marketing partnerships.
Issue Description
⚠️ The Problem
If your whitelisted IP address is not being recognized for conversions, it could interfere with accurate tracking and attribution in your affiliate or partner marketing campaigns.
Impact: This can lead to:
- Missing conversion data in reports
- Inaccurate partner performance metrics
- Revenue tracking discrepancies
- Payment calculation errors
Signs & Symptoms
🔍 How to Identify This Issue
You may be experiencing IP whitelist recognition issues if you observe any of the following:
- Missing conversions: Conversions from the whitelisted IP are missing or blocked in reports
- Rejected conversions: Rejected conversions appear despite whitelist settings being configured
- Data discrepancies: Delays or discrepancies between expected and actual conversion data
- Inconsistent tracking: Some conversions from the IP are tracked while others are not
Basic Troubleshooting Steps
Before proceeding to advanced troubleshooting, verify these fundamental requirements:
✓ Basic Verification Checklist
- Confirm the IP address was correctly added to the whitelist prior to conversion events
- Check whether sufficient time has elapsed for whitelist changes to propagate across TUNE servers (typically 5-10 minutes)
- Verify the email address used for the whitelist request is linked to an active employee account within your TUNE platform
-
Ensure the IP address format is correct (e.g.,
192.168.1.1for IPv4 or proper CIDR notation) - Confirm you're testing from the exact IP address that was whitelisted
How to Verify Your IP Whitelist Configuration:
- Log in to your TUNE platform as an administrator
- Navigate to Company → Customize Application → Settings
- Locate the IP whitelist settings
- Verify your IP address appears in the list and is formatted correctly
- Check the timestamp of when the IP was added to ensure it was before the conversion events
Advanced Troubleshooting Steps
If basic troubleshooting steps don't resolve the issue, follow these advanced procedures:
1 Run a New Conversion Test
Perform a fresh conversion test from the whitelisted IP address to verify if the issue persists.
Testing Procedure:
- Ensure you're connected from the whitelisted IP address
- Clear your browser cache and cookies
- Navigate to your offer's tracking link
- Complete a test conversion
- Wait 2-3 minutes for the conversion to process
- Check the Conversion Report to see if the conversion was accepted or rejected
2 Manually Approve Rejected Conversions
If conversions are still being rejected despite the whitelist, you can manually approve them while investigating the root cause.
Manual Approval Process:
- In your TUNE dashboard, navigate to Reports → Conversion Report
- Set the filter to show Rejected conversions
- Filter by the IP address in question to locate rejected conversions
- Select the conversions you want to approve
- Click the Approve button
- Confirm the approval action
3 Verify Employee Account Association
Ensure the email address used to request the IP whitelist is associated with an active employee account.
Verification Steps:
- Navigate to Company → Manage Employees
- Search for the email address used for the whitelist request
- Verify the account exists and has Active status
- Check that the account has appropriate permissions
- If the account is inactive or missing, resubmit the whitelist request with an active administrator email
4 Check for IP Address Changes
Verify that your actual IP address hasn't changed from the whitelisted address.
How to Check Your Current IP:
-
Visit a site like
whatismyipaddress.comfrom the location where conversions are being sent - Compare the displayed IP address with your whitelisted IP in TUNE
- If they don't match, request to whitelist the current IP address
- Consider whether your ISP uses dynamic IP addresses that may change periodically
Contact Support
📧 Need Additional Help?
If the issue continues after performing these troubleshooting steps, please contact the TUNE support team for further assistance.
Information to Include When Contacting Support:
- IP Address: The specific IP address that should be whitelisted
- Conversion IDs: Specific conversion IDs that were rejected (if available)
- Timestamps: When the conversions occurred and when the IP was whitelisted
- Email Address: The email address used to request the IP whitelist
- Troubleshooting Steps Taken: What steps you've already completed from this guide
- Screenshots: Any relevant screenshots showing the issue (rejected conversions, whitelist settings, etc.)
Additional Resources
📚 Related Documentation
For more information on conversions and reporting within TUNE, explore these resources:
- Reporting Overview - Comprehensive guide to TUNE's reporting features
- Conversion Tracking Best Practices - Tips for accurate conversion tracking
- Understanding IP Whitelisting - Detailed explanation of how IP whitelisting works
- Security Settings in TUNE - Overview of security features and configurations
Conclusion
Ensuring your whitelisted IP addresses are recognized correctly is vital for accurate partner marketing performance measurement. Following this guide should help resolve common issues related to IP whitelisting in TUNE's platform.
✓ Key Takeaways
- Verify IP addresses are correctly formatted and added to the whitelist before conversion events
- Allow 5-10 minutes for whitelist changes to propagate across TUNE servers
- Ensure the email address used for whitelist requests is linked to an active employee account
- Run fresh conversion tests after making whitelist changes
- Contact support with detailed information if issues persist
We value your success and encourage you to reach out if you need further support. Our team is here to help ensure your TUNE platform operates smoothly and accurately tracks all your marketing performance data.