Troubleshooting Tracking Integration Issues

Open in Zendesk |

This article is writtenkeeping AppsFlyer in mindhowever most of the points discussed here should be similarly applicable to other tracking methods as well.<span class="wysiwyg-underline">Overview:</span>1. App must be live on app/play store with latest SDK:

2. Make sure to test the tracking SDK integration:
3. Make sure to activate CPIDroid as partner & default postbacks:
4. Make sure Advanced Privacy is disabled:
5. Make sure to enable install/event postbacks:
6. Make sure the event name is configured precisely:
7. Check & make sure the tracking link is correct:
8. Make sure tracking link is redirecting to app/play store:
9. Check & make sure at least these parameters are there:
10. Trigger conversion from SDK correctly & immediately:
11. Check if you are getting organic/non-organic installs:
12. Check if your pricing plan is active:

<span class="wysiwyg-underline">1. App must be live on app/play store with latest SDK:</span>**<span class="wysiwyg-underline">

</span>**-----------------------------------------------------------------------------------------------------------------------------------------

• After integrating the Tracking SDK into your app, please don't forget to upload your latest apk or ipa file and take it live into the Play Store or App Store.

<span class="wysiwyg-color-red">Important:</span> Do NOT run campaign until your latest app is live in the Play Store or App Store.

<span class="wysiwyg-underline">2. Make sure to test the tracking SDK integration:</span>**<span class="wysiwyg-underline">

</span>**-------------------------------------------------------------------------------------------------------------------------------------

Please note that testing the integration is highly recommend, please find below some relevant official articles:-

• Simple Manual Testing : You can simply pull the tracking link from your dashboard and click it, then it should redirect to App/Play Store, then install your app then check if conversion was captured in your appsflyer dashboard.
• Guide for Appsflyer: https://thesmartware.zendesk.com/hc/en-us/articles/115002632051-Getting-Started-with-Appsflyer-Tracking-SDK#h_01EX23B9Q71SWQRY0798545AV2

<span class="wysiwyg-underline">3. Make sure to activate CPIDroid as partner & default postbacks:</span>

Mark sure to activate us (CPI Droid) as a partner or enable postbacks for us (CPI Droid) as per the instructions given in below article:

• Guide for Appsflyer: https://thesmartware.zendesk.com/hc/en-us/articles/115002632051-Getting-Started-with-Appsflyer-Tracking-SDK#h_01EQFG4PWR5EEA5KE6DBJPA777

<span class="wysiwyg-underline">4. Make sure Advanced Privacy is disabled:</span>

<span class="wysiwyg-color-red">Please keep Advanced Privacy disabled (IMPORTANT)</span>

• Guide for Appsflyer: <span class="wysiwyg-color-red">https://thesmartware.zendesk.com/hc/en-us/articles/115002632051-Getting-Started-with-Appsflyer-Tracking-SDK#h_01EQFG4PWR5EEA5KE6DBJPA777</span>

<span class="wysiwyg-underline">5. Make sure to enable install/event postbacks:

</span>

It's a very common mistake, advertiser forget to enable Install postbacks (for CPI campaign) and event postbacks (for CPA campaign)

• Guide for Appsflyer: https://thesmartware.zendesk.com/hc/en-us/articles/115002632051-Getting-Started-with-Appsflyer-Tracking-SDK#h_01EQFG4WH0D5DRF2TAKPRFCQTM

<span class="wysiwyg-underline">6. Make sure the event name is configured precisely:</span>

It's a very common mistake, advertiser either don't configure event name or leave it to default.

• We strongly recommend to ensure & check that the even name you provided while creating CPA campaign, exactly the same event name should be configured in your tracking system.
• Please make sure you send exactly the same event name (as provided while creating CPA campaign from your advertiser dashboard) to our event postback url.
• If event name we receive on our event postback url is not same as the event name configured in the CPA campaign then tracking will not work.

<span class="wysiwyg-underline">7. Check & make sure the tracking link is correct:</span>

Always Pull Tracking nlink from your Appsflyer Dashboard only and it should look like;

• Example for iOS: http://app.appsflyer.com/id1234567890?pid=cpidroid_int&clickid={click_id}&af_siteid={pub_id}
• Example for Android: http://app.appsflyer.com/com.package.name?pid=cpidroid_int&clickid={click_id}&af_siteid={pub_id}

<span class="wysiwyg-underline">8. Make sure tracking link is redirecting to app/play store:</span>

• Kindly very that if tracking link is actually taking users to the app/play store after clicking.
• You may use our in house Affiliate Link Tester at <https://affilitest.com/> to check redirections.

<span class="wysiwyg-underline">9. Check & make sure at least these parameters are there:</span>

• Make sure link contains correct app id,
• pid=cpidroid_int and
• clickid={click_id}
• af_siteid={pub_id}
• af_prt=agency_int (if you have appsflyer agency partner account)

<span class="wysiwyg-underline">10. Trigger conversion from SDK correctly & immediately:</span>

Make sure the Tracking SDK triggers installs and events from the app as per the conversion flow only.

• As for Installs, it should be triggered from SDK upon app download or open immediately.
• As for events, it should be triggered from SDK upon user completed the certain action as defined by that event.

<span class="wysiwyg-underline">11. Check if you are getting organic/non-organic installs:</span>

• Kindly make sure you are getting organic installs recorded into your appsflyer dashboard, otherwise it's an indication that your SDK is not working correctly.

<span class="wysiwyg-underline">12. Check if your pricing plan is active:</span>

• You may have to activate/upgrade your plan on appsflyer for mobile attribution.

Updated on: 03/02/2026