Skip to main content

Troubleshooting Common Tracking Issues

Test and troubleshoot your integration and make sure traffic data reaches the Tapfiliate platform

Anton Zelenin avatar
Written by Anton Zelenin
Updated over a week ago

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:

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.

Did this answer your question?