Integrated partners FAQ

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?

Find the required update here and follow the instructions provided.

If your update is not listed, contact integrations@appsflyer.com, include your integration PID, and describe your request.

How do I change the login email of the account?

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?

Reason Solution
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?

Reason Solution
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:

  • Ad network permissions (the main toggle)
  • Configure integration
  • Configuring in-app event postbacks

 

Why does the advertiser fail to grant permissions to ad network team members?

Reason Solution

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?

Reason Solution
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

  1. Check your spam folder.
  2. Clear the browser cache or open AppsFlyer in a different browser.
  3. Try to reset your password again (wait at least 20 minutes after the previous request).
  4. If you still don't receive the password recovery email, contact Support (support@appsflyer.com) 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?

  1. Get approval from the advertiser to implement the Audience integration.
  2. Email advertiser's CSM (ask the advertiser for the correct email) and Partner Solutions (partnersolutions@appsflyer.com).
  3. Once the request is approved, we will proceed with the integration.

How to enable Advanced Privacy

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?

Reason Solution

Revenue macro is not included in the postback configuration.

Send an email to integrations@appsflyer.com 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.

  • If you have access to the application setup,
    1. In the AppsFlyer Dashboard, go to Integrated partners, and click on your logo.
    2. Under Integration tab > In-app event postbacks, find the relevant event in the list of the mapped events.
    3. Check Send revenue column and see if Values & revenue option is selected.
  • If you do not have to the application setup, ask the Advertiser to enable Ad Network Permissions 

Advertiser chose not to share the revenue value with the ad network.

More information about sending event data and possible scenarios.

Why don't I receive in-app event postbacks?

Reason Solution

In-app event postback is not configured on the integration level

Send an email to integrations@appsflyer.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?

Reason Solution
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?

Reason Solution
The advertiser didn't define any value for the dashboard parameters.
  • If you have access to the application setup,
    1. In the AppsFlyer Dashboard, go to Integrated partners, and click on your logo.
    2. Under the Integration tab, find the relevant parameter and check its value.
    3. If it's not defined, contact the Advertiser and ask to fill in the value.
  • If you do not have to the application setup, ask the Advertiser to enable Ad Network Permissions 

Why is the S2S event data from the advertiser is missing or incorrect?

Reason Solution
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?

Reason Solution
Re-engagement postback is disabled in AppsFlyer backend Send an email to integrations@appsflyer.com 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 integrations@appsflyer.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 is_retargeting=true is added into the click attribution URL.

Why don't I receive re-attribution postbacks?

Reason Solution
Your postback template does not have re-attribution identifier flag. Send an email to integrations@appsflyer.com 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 is_retargeting=true is added into the click attribution URL.

Why don't I receive correct event identifiers on event postbacks?

Reason Solution
Macro (mapped-iae) is not integrated in the in-app event postback.

Send an email to integrations@appsflyer.com with your

  • pid or ad network email
  • receiving parameter of partner event identifier,

and request to integrate the macro.

More on postback macros.

Advertiser or agency didn't configure the partner event identifier correctly or at all.

If the click attribution URL contains af_prt

ask the agency to check if the partner event identifier is correctly configured on their dashboard.

If not,

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?

Even if the Advertiser allows sending you postbacks for traffic attributed to all sources, AppsFlyer does not share with the partners the campaign-level data attributed to other partners.

Why can't I export reports?

Reason Solution

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:

  1. Make sure the advertiser allowlisted the devices you are using for testing.
  2. 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:

  • Ask the advertiser to enable in-app event postbacks.
  • If the advertiser grants you permissions for in-app events configuration, make sure to enable In-app event postbacks in the Integration tab.
  • The names of SDK Events must be mapped to the names of events as configured in your own system.

    allow-to-configure-in-app-events-postbacks.png

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.

 Example

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:

Problem Solution
The partner platform is not recording the clicks correctly. Investigate the implementation on your side and make the necessary fixes.
Click capping

Check the P360 dashboard (your client should give you access first):

  • You can see the blocked clicks in the main Fraud Breakdown table, under Blocked and Capped clicks.
  • Check Partner account admin email for notifications about click capping.
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.

More information on SKAN campaigns.

Protect360

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.

  1. 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.
  2. 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.

Was this article helpful?