If your clicks, conversions, or customers aren’t tracking correctly in Tapfiliate, don’t worry - this means there’s probably a small issue with the integration setup. Below are the most common causes and steps you can take to troubleshoot and get tracking back on track.
Check Your Integration Setup
The most common reason for missing tracking data is an incorrect or incomplete integration. Here’s how you can verify your integration:
Run the integration tester: Use Tapfiliate’s integration tester to ensure your codes are installed and working properly. If there are any problems, the tester will highlight them so you can fix them quickly. Here’s a guide that explains how to use the integration tester.
Simulating Test Conversions: Perform a test conversion (purchase, signup, etc.) after following a referral link. Here’s a guide that walks you through how to simulate test conversions.
Verify your Account ID:
Make sure the Account ID in your detect and conversion scripts matches the one in your Tapfiliate account. The Account ID is essential for tracking — it tells the code which account the clicks and conversions should be registered under.
If you copied the scripts directly from Settings → Supported Integrations, your Account ID is already included, so you can simply copy and paste them.
However, if you used an integration guide from the Help Center, the Account ID needs to be added manually. In that case, the code will look something like this:
Review Recent Website Changes
If you’ve recently updated your website - added a new theme, changed your checkout process, or edited site code - it’s possible that Tapfiliate scripts were removed or affected.
Make sure these changes don't interfere with referral parameters or page redirects.
Check for Redirect Issues
Tracking relies on referral parameters (the part of a URL that identifies the affiliate). If these are cut off during redirects, Tapfiliate won’t be able to detect clicks or store cookies in the visitor’s browser.
To test this click an affiliate link yourself.
Check if the referral parameter (?ref=...) remains in the URL when you land on the final page.
For example, your website is mywebsite.com and your referral link is mywebsite.com/?ref=yty1zmwId:
If the referral parameter (?ref=yty1zmwId) disappears immediately after opening the link, then there’s a redirect issue that needs to be fixed.
If the parameter is visible on the first page but disappears only after navigating through the site, that’s expected behavior.
When referral or tracking parameters get cut off in a redirect, the most common causes are:
Improper Redirect Configuration (on Advertiser’s server or CMS)
Your website may be using a redirect (301, 302, or JavaScript-based) that doesn’t preserve query strings.
Third-Party Link Shorteners or Intermediary Pages
Some link shorteners (like Bitly, or internal link wrappers) or campaign tracking tools may fail to forward query parameters properly.
Tracking/Consent Tools or Middleware (e.g., Cloudflare, GTM redirects, privacy layers)
Security/CDN setups can rewrite URLs or force HTTPS redirects without parameters. Some consent/redirect banners reload the page without the query string.
Incorrect UTM or Tracking Link Implementation
Tracking parameters might be appended incorrectly
Cross-domain Redirects
If the referral goes from one domain to another, CNAME, referrer, or cookie handling might break the chain.
Understand Tracking Delays
Clicks can take 5–10 minutes to appear in your Tapfiliate dashboard depending on the integrations.
Conversions should appear immediately once the integration is triggered successfully.
After testing your integration, allow a few minutes for data to appear in your dashboard.
When to Contact Support
If you’ve gone through all the steps above and are still not seeing tracking activity, our support team can help identify what’s going wrong.
FAQ
❓What kind of technical support can I get?
Our technical support team is here to help you succeed. We can:
Review your use case and provide recommendations on how to implement your flow effectively.
Point you to relevant code snippets and resources in our technical library.Outline the types of code your developers would need to create for your specific setup.
While we don’t create custom code for individual clients, we work closely with your team to guide, support, and empower them so that your implementation is smooth and successful.
