If your clicks, conversions, or customers aren't tracking correctly in Tapfiliate, don't worry - this often turns out to be a small issue with the integration setup, or a program setting behaving exactly as configured. Work through the sections below in order.
First: Is It Missing, or Just Not Approved Yet?
These are two different problems and they look the same from the outside, so it is worth ruling one out before you touch your integration.
Open the Conversions page and look for the order. If it is there, the sale was tracked.
If your program does not approve commissions automatically, every new commission arrives as Pending and adds nothing to the affiliate's balance until you approve it under Commissions. Nothing is broken - the sale is waiting for you.
đĄ Check your filters before concluding anything is missing. The Conversions page has its own date range and a status selector above the table (All, Approved, Pending, Disapproved). A report and the Conversions page showing different numbers is nearly always a difference in filters, not in data.
Program Settings That Stop a Sale Being Recorded
A cap on conversions per customer
If your program has a recurring frequency cap, it limits how many conversions can be attributed to an affiliate for one customer. Once a customer is capped, later purchases from that same customer are not captured at all - the first order tracks, the second one does not, and nothing in the dashboard explains why.
A cap of 1 means only the first purchase per customer ever counts. If you want repeat purchases to earn a commission, raise the cap: set it to 2 and two sales per customer are tracked.
This is worth checking first whenever tracking works on one test order and not on the next. See Capping the number of lifetime/recurring commissions for where the cap is set and how it behaves.
The customer record has been cancelled
If the customer linked to that email has been cancelled in your account, no commission is recorded for their later purchases.
How the Sale Is Attributed
Sometimes the sale was tracked, but credited to a different affiliate than you expected.
Lifetime commissions. If lifetime commissions are switched on and the buyer's email is sent as the customer ID, every later purchase from that email goes to the affiliate who first referred them, whichever link was clicked this time.
Last click wins. Otherwise the sale goes to the affiliate whose link was clicked most recently, within your account's cookie window.
Same browser, same device, same domain. The purchase has to happen where the click happened. Use a fresh private window for each test, otherwise an earlier test click is still the most recent one.
Coupon codes take precedence. If the order carries a coupon code assigned to an affiliate, that affiliate gets the sale even when a different link was clicked. See How to Use and Track Coupon Codes.
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.
Check for a second checkout route: Many sites have more than one path to a purchase - a direct product link and a category or cart path, for example - and only one of them may carry the tracking code.
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:
Here's an article that explains how to find your Account ID.
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.
Coupon-code URLs are a common example: they often apply the code and then redirect, and if that redirect drops the query string the ?ref= never reaches our script.
Conversions Sent Through the API
If your conversions are sent server to server and your integration is getting an authentication error back, those conversions were never stored on our side.
â ď¸ Fixing the key does not bring them back. Once requests are being accepted again, resend the conversions for the whole period the integration was failing, or the gap in your reporting stays there.
See How to Integrate with Tapfiliate via the REST API. A common cause is a team member being disabled: their API key is then refused, which is covered in How to Invite and Manage Team Members.
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. Sending these four things with your first message saves a round of questions:
Which integration method you use (a platform plugin, the JavaScript snippets, Google Tag Manager or the API).
When you first noticed the drop.
Any recent changes to your website, checkout, order confirmation page, theme, consent banner or tracking scripts.
A link to a test product, or a 100% discount coupon, so we can place a free test order and inspect the code on your confirmation page.
FAQ
âOne test order tracked and the next one didn't. Why?
Three common reasons, in this order: the two tests used the same customer email and your program has a cap on conversions per customer; lifetime commissions sent the second one to the affiliate who first referred that customer; or the second test ran in the same browser, where an earlier click was still the most recent one.
âMy affiliate says their link doesn't work.
Open their link yourself in a private window and check the address bar on the landing page. If ?ref= is still there, the link is fine, and the question becomes what happened between the click and the order.
â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.
âHow can I test if my integration is working correctly?
Testing your integration is a crucial step to ensure that clicks and conversions are being tracked accurately. The best way to do this is by performing a test conversion using an affiliate link in an incognito/private browser window.
â
For a detailed, step-by-step walkthrough on how to perform this test and what to look for in your dashboard, please refer to our dedicated guide:đ How to Validate Your Tracking