At a glance: FAQs and integration troubleshooting for integrated partners.
Account and dashboard
I want to become an integrated partner
An advertiser should invite you to be onboarded with us.
Share this invitation procedure with the advertiser. After the advertiser invites you, you will receive an email with a form to fill out.
Once the form is filled out, we will contact you with the next steps.
Important: Use an email that has never been used to create an account in AppsFlyer before. Make sure the advertiser uses the same email in the invitation.
How can I update my integration?
How do I change the login email of the account?
Follow these instructions.
I cannot add an app to the dashboard
If you cannot add an app to the App search screen, make sure that:
- The advertiser has added the app to their dashboard
- The advertiser has activated the app integration with your network
Why don't I see the app on my dashboard?
|The Advertiser did not grant relevant permission to your Ad Network.||Contact the Advertiser, and ask them to enable Ad Network Permissions using these instructions.|
Why can't I configure the integration with the advertiser?
|The advertiser did not grant you permission to configure the integration.||
Request from the advertiser to make sure that the following permissions are granted to you:
Why does the advertiser fail to grant permissions to ad network team members?
If the Advertiser receives an error message Unable to add team members, please enter valid emails of the ad network team members, it means that the specified email address is not added as a Team Member under your Partner Account.
Check if the contact email is listed as a team member in your account.
Note: only account admin and team members with relevant admin capabilities can add new team members.
Why is the integration with the app not active in the dashboard while it definitely should be active?
|The integration was activated by an agency and not by the advertiser. Ad network setup is visible to ad networks themselves only when the advertiser (app owner) configures it.||
No further action required. Once the agency activates the integration, attribution and postbacks work normally.
I don't receive password recovery emails
- Check your spam folder.
- Clear the browser cache or open AppsFlyer in a different browser.
- Try to reset your password again (wait at least 20 minutes after the previous request).
- If you still don't receive the password recovery email, contact Support (firstname.lastname@example.org) to check the status of your email.
What are the partner permissions?
An advertiser can grant permission to a partner to configure the integration with that partner.
It's easier for you as a partner to test campaign configuration if you have permission to edit and change the integration of the advertiser setup with your ad network.
The permissions are (depending on the advertiser account):
- Integration parameter configurations
- In-app event configuration
- Retention reports
- Protect360 dashboard
For more information, visit our guide on Providing permissions to ad networks.
How to enable the AppsFlyer Audience integration?
- Get approval from the advertiser to implement the Audience integration.
- Email advertiser's CSM (ask the advertiser for the correct email) and Partner Solutions (email@example.com).
- Once the request is approved, we will proceed with the integration.
How to enable Advanced Privacy
Follow these instructions.
Data - postbacks and reports
How long does it take for results to appear in the dashboard?
Installs appear in the dashboard within two minutes from the moment of an install.
Install and in-app data appears in reports within 15 minutes.
Why don't I see the event value or revenue in the event postback or on the dashboard?
Revenue macro is not included in the postback configuration.
Send an email to firstname.lastname@example.org and request to add the relevant macro and your receiving parameter in case they are not included in the postback.
Revenue data is not included in the event message shared with AppsFlyer.
Advertiser chose not to share the revenue value with the ad network.
Why don't I receive in-app event postbacks?
In-app event postback is not configured on the integration level
|Send an email to email@example.com and request to configure in-app event postback (provide the desired in-app event postback template).|
|Mapped in-app event is not triggered or not reported to AppsFlyer||Contact the Advertiser and ask them to verify that the event is triggered and the in-app event mapping is configured correctly.|
|Advertiser didn't select the in-app events for which postbacks are sent under In-app event settings|
|The in-app event happened outside of the in-app event postback window|
Why is the click data missing in the postback?
|Click value is missing from the attribution link.||Verify that click parameter and value are included in the click attribution URL.|
|There is no correlation between the parameter defined in attribution link VS in the postback.||Verify that the click parameters are correctly defined in the click attribution URL and in the postback.|
|The install/in-app event is not attributed, and therefore there is no campaign-level or click data.|
Why are there missing dashboard parameters in the postback?
|The advertiser didn't define any value for the dashboard parameters.||
Why is the S2S event data from the advertiser is missing or incorrect?
|The Advertiser didn't correctly configure sending S2S data to AppsFlyer.||Contact the advertiser and ask to verify the configuration.|
Why don't I receive re-engagement postbacks?
|Re-engagement postback is disabled in AppsFlyer backend||Send an email to firstname.lastname@example.org to verify that re-engagement postback is enabled in AppsFlyer backend.|
|Your postback template does not have re-engagement identifier flag.||Send an email to email@example.com and ask to add the identifier if it's missing.|
|Retargeting parameter is not included in a click attribution URL, and therefore re-attribution cannot get recorded in AppsFlyer.||Make sure the parameter
Why don't I receive re-attribution postbacks?
|Your postback template does not have re-attribution identifier flag.||Send an email to firstname.lastname@example.org and ask to add the identifier if it's missing.|
Retargeting parameter is not included in a click attribution URL, and therefore reattibution cannot get recorded in AppsFlyer.
|Make sure the parameter
Why don't I receive correct event identifiers on event postbacks?
Send an email to email@example.com with your
and request to integrate the macro.
|Advertiser or agency didn't configure the partner event identifier correctly or at all.||
If the click attribution URL contains
ask the agency to check if the partner event identifier is correctly configured on their dashboard.
ask the advertiser to check if the partner event identifier is correctly configured on their dashboard.
Why can't I see the campaign-level data for non-attributed traffic on postbacks?
Why can't I export reports?
The larger the specified date range, the larger the generated file. Large files may require more time to download.
|Specify a shorter time range for the report.|
|Too much browser cache can prevent the request from sending out.||Clear browser cache and try again, or export the report from a different browser.|
I can't download a report and get a message that the report quota has been exceeded
The number of reports that can be generated per day via Pull API and the data export pages is limited. Ad networks' limitation for both Pull API and the export page is:
- 12 calls for in-app reports
- 24 calls for non-in app reports
Ad networks' quota is counted separately from advertiser/agency quotas and doesn't decrease them. For more information, check Rate limitations guide.
Test installs don't appear in the dashboard
If you run test installs with a client but don't see any installs on your Appsflyer dashboard:
- Make sure the advertiser allowlisted the devices you are using for testing.
- If you run campaigns using S2S probabilistic modeling, ensure that your integration is validated by AppsFlyer. Contact your PDM.
Install postbacks are not sent to my servers
If you believe that postbacks are not sent to your servers:
- Make sure that the postback endpoint is active
- Make sure that the postback endpoint is the correct one - contact your PDM if it is not the correct endpoint
In-app event postbacks are not sent to my servers
In-app event postbacks must be enabled in your configuration with the advertiser:
Can't see in-app events postbacks setup of agencies
Ad networks get visibility to their setup done by advertisers, but not when it's done by agencies. Therefore, when an agency, but not the advertiser, maps in-app events for postbacks to a network, the ad network sees this section as inactive, although it is actually active for the agency.
Yuval is the marketer of the com.fused app, which is a client app of the Sonnet ad network. Yuval maps the af_purchase event to be sent as postback to Sonnet, when an attributed user to Sonnet performs a purchase.
Sava, an agency permitted to work with com.fused, also configures Sonnet to work with, and maps the af_completeregistration event to be sent as postback.
When Sonnet logs into the dashboard of com.fused, they see only the af_purchase event mapped with them, but not the af_completeregistration event. However, when users attributed to Sava perform registrations, the af_completeregistration event is sent to Sonnet.
Click data is missing
If click data is missing from postbacks, make sure that the AppsFlyer link has all the data you want to return to you in the postbacks. See our attribution link guide for more information.
If the advertiser configured the ad network to receive all postbacks, postbacks for events not attributed to the ad network don't contain click data.
Revenue data is missing
If revenue data is missing or appears as N/A in the advertiser postbacks, there could be two possible reasons:
- The advertiser has decided not to share revenue data.
- The advertiser has defined the in-app event incorrectly.
I see installs in AppsFlyer, but not on my internal servers
You need to place the AppsFlyer attribution link as the redirect URL on your servers. Then you need to use your server's own attribution link to run a full test.
Make sure to map the parameters of your network's attribution link to AppsFlyer's attribution link.
Dashboard data is missing
If you see data in the dashboard but that data is missing in your servers, verify that advertiser provides the necessary credentials or keys when configuring the integration with your ad network.
The advertiser should add any credentials, key, or tokens in the General Settings section of the Integration tab.
If your network requires credentials or keys for integration and the advertiser doesn't provide them, postbacks from AppsFlyer are rejected by your servers. Data cannot be posted to your server and is therefore missing.
Data from the advertiser is missing or incorrect
If you test integration with an advertiser and no data (installs, in-app events) is available, follow the suggestions below:
- If the issue happens with any advertiser, contact your PDM
- If the issue happens with only one advertiser or a few advertisers:
- verify with the advertiser that they implemented the AppsFlyer SDK in their app
- verify with the advertiser that the SDK implementation is correct
There is click data discrepancy between AppsFlyer and our platform
If the clicks are shown in the AppsFlyer dashboard, they are definitely recorded by AppsFlyer. The discrepancy in the numbers between AppsFlyer's and partner's data can happen for several reasons:
|The partner platform is not recording the clicks correctly.||Investigate the implementation on your side and make the necessary fixes.|
Check the P360 dashboard (your client should give you access first):
|A single IP can be sending multiple clicks from your servers||Check your implementation for this issue and make necessary fixes.|
|A malicious entity is sending clicks on your behalf with your PID in the attribution URL.||
Implement click signing.
|Click deduplication. If a user clicks on an ad multiple times, in AppsFlyer it is recorded as one click.||N/A|
Why doesn't my agency account show SKAN data?
Confirm that your campaign name is correct. To view your campaigns in the Agency AppsFlyer SKAdNetwork dashboard, the names of campaigns that you configure with the SKAdNetwork, should include your agency identifier and be structured as follows:
your af_prt + underscore (_) + your actual campaign name that follows your agency’s naming convention.
For example, if your af_prt is greatagency, your campaign name may look like this: greatagency_StreamKarxxxxxx.
How can I investigate fraud from AppsFlyer dashboard?
You can check blocked data only if the advertiser gives you access to Protect360 and Raw Data reports.
- Once the advertiser gives you the P360 access, you can download the blocked install/in-app events reports from the Export Data page of the dashboard. More about report types.
- In Raw Data reports you can:
- check the blocking reasons/sub-reasons
- filter down by Site to see which SiteIDs deliver high numbers of fraud results
Then you can investigate this further with the publishers that deliver fraudulent traffic and make educated decisions about working with these publishers.
Learn more about fraud.
Why do clicks and impressions get capped?
Sometimes the engagements are blocked under click/impressions capping if they exceed our defined thresholds. Read more about capping.
You can check capped data in Protect360 dashboard in the main Fraud Breakdown table (you need the advertiser to give you the access).
Under Clicks and Impressions in the table you can see the following data:
- Total: the total amount of clicks or impressions respectively (both fraud and legitimate)
- Blocked: the number of blocked clicks/impressions — including capped
- Capped: the number of blocked clicks/impressions — due to capping
The notification of the click capping is also sent to the admin email address of the account.
Why did a test install go to fraud?
If the majority of the installs coming from your network are marked as fraud, then any new test install can get marked as such.
For correct testing, follow the process as described here.
You should also consider stopping engaging with the publishers that drive the majority of fraud.
Can the wrong implementation of the SiteID parameter lead to Click Flooding?
Various criteria are evaluated to decide whether certain traffic should be blocked as click flooding.
Although this is not the only reason for click flooding, sometimes incorrect implementation of SiteID parameter can lead to blocking as click flooding. Read more about SiteID and make sure that it's correctly implemented.