Skip to main content

Troubleshooting Clicks and Conversions

Steps to verify clicks and conversions are being tracked, and a checklist of common issues when they're not.

We highly recommend testing everything from the point of view of your affiliate before you fully launch your affiliate program. The first thing to test is a click to make sure that Trackdesk's tracking script was installed on your website correctly.

💡 Tip: Ask the AI assistant "Why didn't this click convert?" or "Are my tracking and postbacks healthy?" and it checks the clicks, conversions and postback log for you.


​

How to test if clicks are set up properly

Make sure that the click script presented to you in the guides is correctly added to all landing pages of your website.

Next, navigate to the Offer list and click the Get link button to get the tracking link for a test affiliate.

Select an affiliate for which you would like to do the test and a landing page you would like to test.

Then, copy the URL that was shown to you.

Open the URL and then check the click report to see if a new click was added.

​

Troubleshooting clicks not appearing

If a click didn't show up, there are multiple situations that might be the cause.

Click script not present

One cause might be that the click script was added in an incorrect place. Check if the click script is present on the page. Also check that it is in the <head>, as high as possible. A script in the footer or low on the page may not run before the visitor leaves, so no click is recorded.

Click script not correctly added

Another cause might be that the click script was added in the correct place, but it was not copied in its entirety correctly (for example, part of it was not added).

Click was already created moments ago

If you tested a click moments before (within the range of one hour), then a new click won't be created as you will receive "the same click".

If you want to make another test of a new click immediately instead of waiting, you can visit the tracking link via a different browser or from a different IP address.


​

How to test if conversions are set up properly

Make sure the conversion script from the guides is added to the thank-you page, or any other page that is supposed to generate conversions.

Upon completing the flow in the section above for clicks, navigate to the page mentioned in the previous step.

If the conversion script is correctly present and all information is added correctly, a record will be added to the conversion report.

​

Troubleshooting conversions not appearing

If conversions didn't show up, there are multiple situations that might be the cause.

Using redirect instead of direct linking, or vice versa

Make sure that you are using the correct method to send traffic to the landing page.

Direct linking is used with tracking scripts to track the user.

Redirect tracking is used when the advertiser handles tracking itself, usually sending conversions via postback.

Incorrect affiliate link

It is important to check if the correct link is being used. You may be using a tracking link whose link ID points to a disabled landing page.

Inactive offer

It is also possible that you are using an affiliate link for an inactive offer, and in that case, the affiliate link will not work.

If you create clicks through the API (POST /api/node/clicks/v1), a click for an inactive offer is rejected with HTTP 400 and the error code CLICK_ERROR_CODE_OFFER_NOT_ACTIVE.

Conversion script not present

One cause might be that the conversion script was added in an incorrect place. Check if the conversion script is present on the page. Also check that it is on the thank-you page, right before the closing </body> tag, and runs only after a successful conversion.

Conversion script not correctly added

Another cause might be that the conversion script was added in the correct place, but it was not copied in its entirety correctly (for example, part of it was not added).

Check the conversion error log

If the conversion script is correctly added to the page, then most of the errors that can happen will be present in the conversion error log.

  • Source disabled error means that the affiliate you selected has disabled traffic status.

  • Conversion limit reached means that this offer has limited conversions.

  • Missing conversion amount means the conversion script is missing the amount parameter. Conversion types set to percentage need to have an amount from which the commission is calculated.

  • Conversion already exists relates to the External ID parameter on conversions. Only one conversion per Conversion Type can have the same External ID (for Network accounts, per Conversion Type and Revenue Origin). A duplicate request does not create a second conversion.

  • Conversion type not found means the conversionType value in the code is wrong. In this case, you are trying to send the conversion type Lead (value lead) in the body of the request, but the offer the click is from does not have conversion type Lead but Sale.

  • Currency not supported means the conversion's currency isn't enabled in your tenant settings. Check your supported currencies and either update them to include the currency being sent, or make sure your integration is sending one of the currencies you've already enabled.

  • Offer not active refers to your offer being paused or inactive; if you give out an affiliate link or a coupon which leads to an inactive offer, tracking will not work.

  • No valid coupon code means you are not using a valid coupon code. Make sure that you create a coupon on both sides: on your website so users can redeem it and it gives them a discount, and also in Trackdesk so that you are able to know which offer and affiliate the coupon is being redeemed for.

  • Revenue and payouts for conversion type not configured means the conversion type exists in the system, but is not set up on this offer's payouts.

Did this answer your question?