Troubleshooting Tracking Integration Issues
This article is written keeping AppsFlyer in mind however most of the points discussed here should be similarly applicable to other tracking methods as well.
Overview:
App must be live on app/play store with latest SDK:
Make sure to test the tracking SDK integration:
Make sure to activate CPIDroid as partner & default postbacks:
Make sure Advanced Privacy is disabled:
Make sure to enable install/event postbacks:
Make sure the event name is configured precisely:
Check & make sure the tracking link is correct:
Make sure tracking link is redirecting to app/play store:
Check & make sure at least these parameters are there:
Trigger conversion from SDK correctly & immediately:
Check if you are getting organic/non-organic installs:
Check if your pricing plan is active:
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.
Important: Do not run campaign until your latest app is live in the Play Store or App Store.
Please note that testing the integration is highly recommended, 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, install your app then check if conversion was captured in your AppsFlyer dashboard.
Guide for Appsflyer: https://help.smartxaas.marketing/en/article/getting-started-with-appsflyer-tracking-sdk-gjsk6t/?bust=1732970335216
Mark sure to activate us (CPI Droid) as a partner or enable postbacks for us (CPI Droid) as per the instructions given below article:
Guide for Appsflyer: https://help.smartxaas.marketing/en/article/getting-started-with-appsflyer-tracking-sdk-gjsk6t/?bust=173297033521
Please keep Advanced Privacy disabled ( IMPORTANT)
Guide for Appsflyer: https://help.smartxaas.marketing/en/article/getting-started-with-appsflyer-tracking-sdk-gjsk6t/?bust=1732970335216
It's a very common mistake, advertisers forget to enable Install postbacks (for CPI campaign) and event postbacks (for CPA campaign)
Guide for Appsflyer: https://help.smartxaas.marketing/en/article/getting-started-with-appsflyer-tracking-sdk-gjsk6t/?bust=1732970335216
It's a very common mistake, advertisers either don't configure event name or leave it to default.
We strongly recommend ensuring & check that the event name you provided while creating CPA campaign, exactly the same event name that 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.
Always Pull Tracking link from your AppsFlyer Dashboard only and it should look like this;
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}
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://www.affpaying.com/affops to check redirections.
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)
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.
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.
You may have to activate/upgrade your plan on appsflyer for mobile attribution.
Overview:
App must be live on app/play store with latest SDK:
Make sure to test the tracking SDK integration:
Make sure to activate CPIDroid as partner & default postbacks:
Make sure Advanced Privacy is disabled:
Make sure to enable install/event postbacks:
Make sure the event name is configured precisely:
Check & make sure the tracking link is correct:
Make sure tracking link is redirecting to app/play store:
Check & make sure at least these parameters are there:
Trigger conversion from SDK correctly & immediately:
Check if you are getting organic/non-organic installs:
Check if your pricing plan is active:
1. App must be live on app/play store with latest SDK:
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.
Important: Do not run campaign until your latest app is live in the Play Store or App Store.
2. Make sure to test the tracking SDK integration:
Please note that testing the integration is highly recommended, 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, install your app then check if conversion was captured in your AppsFlyer dashboard.
Guide for Appsflyer: https://help.smartxaas.marketing/en/article/getting-started-with-appsflyer-tracking-sdk-gjsk6t/?bust=1732970335216
3. Make sure to activate CPIDroid as partner & default postbacks:
Mark sure to activate us (CPI Droid) as a partner or enable postbacks for us (CPI Droid) as per the instructions given below article:
Guide for Appsflyer: https://help.smartxaas.marketing/en/article/getting-started-with-appsflyer-tracking-sdk-gjsk6t/?bust=173297033521
4. Make sure Advanced Privacy is disabled:
Please keep Advanced Privacy disabled ( IMPORTANT)
Guide for Appsflyer: https://help.smartxaas.marketing/en/article/getting-started-with-appsflyer-tracking-sdk-gjsk6t/?bust=1732970335216
5. Make sure to enable install/event postbacks:
It's a very common mistake, advertisers forget to enable Install postbacks (for CPI campaign) and event postbacks (for CPA campaign)
Guide for Appsflyer: https://help.smartxaas.marketing/en/article/getting-started-with-appsflyer-tracking-sdk-gjsk6t/?bust=1732970335216
6. Make sure the event name is configured precisely:
It's a very common mistake, advertisers either don't configure event name or leave it to default.
We strongly recommend ensuring & check that the event name you provided while creating CPA campaign, exactly the same event name that 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.
7. Check & make sure the tracking link is correct:
Always Pull Tracking link from your AppsFlyer Dashboard only and it should look like this;
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}
8. Make sure tracking link is redirecting to app/play store:
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://www.affpaying.com/affops to check redirections.
9. Check & make sure at least these parameters are there:
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)
10. Trigger conversion from SDK correctly & immediately:
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.
11. Check if you are getting organic/non-organic installs:
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.
12. Check if your pricing plan is active:
You may have to activate/upgrade your plan on appsflyer for mobile attribution.
Updated on: 30/11/2024
Thank you!