At a glance: Enable cost for a specific app.
Overview
Get aggregate marketing cost data (including cost-related LTV performance metrics) using Cost API. The data is accurate, retroactively updated, and automated.
When you enable cost integration via API at the app level (meaning for a specific app), you need to separately integrate every ad network (partner) for every app.
Enabling Cost API
Note
If an advertiser uses an agency to run their campaigns, the agency, and not the advertiser, should integrate with the relevant partners. Otherwise, if both the advertiser and agency integrate with a partner using the same credentials for the same app, cost data is duplicated.
To enable Cost API:
- In AppsFlyer, from the side menu, select Collaborate > Active Integrations, and select the partner.
- Click Manage integration.
- Open the integrated partner Cost tab.
- Turn on the Get Cost Data toggle. The requirements to connect to the partner display.
- Configure and authenticate the integration to the partner. The integration method depends on the partner. Learn more
- If the partner’s cost configuration has Site ID mapping, select the desired site ID configuration from the dropdown. Learn more
- Click Save Cost.
- Click Test Connection.
- The API is active. AppsFlyer collects data from the partner 6 times a day, on average once every four hours.
- Cost data sync status and messages
Additional information
Integration methods
The integration method used to enable a cost integration depends on the partner integration mode with AppsFlyer. It can be one of the following:
- Login: Click Log in to <Network Name> to open the partner login window. Then follow the partner’s login prompts.
- Credentials: Enter partner-specific parameter values. For example: API Key.
- None: No connection configuration is required other than turning on the Get Cost Data toggle as instructed in step 2.
To learn what method is used by a particular partner refer to the Integration method column in the ad network cost integration table.
Site ID mapping
When reporting cost data, some partner integrations allow you to select how the site ID field populates. This means you can configure the site ID so that it matches the AppsFlyer site ID macros as they are in the attribution link.
- By default, site ID mapping is aligned with the AppsFlyer macros in the attribution link.
- If the attribution link you use has different macros than the site ID mapping options, site ID data will not populate correctly.
To select a site ID configuration method:
- In the integrated partner Cost tab, go to Site ID mapping, and select a configuration from the dropdown menu.
- Click Save Cost.
The change takes effect from the next day UTC. For example, if site ID mapping occurs on Monday, it will be reflected in data from Tuesday UTC.
Deleting integrated accounts
Connection to some integrated partners is achieved by logging into the partner from within AppsFlyer and connecting to the account. You can delete the integration as needed. Once deleted, AppsFlyer is no longer able to pull cost data from the account. Deleting an integration does not impact historical data.
To delete an integrated account:
- In AppsFlyer, from the side menu, go to Collaborate > Active integrations.
- Select the integrated partner, for example, Meta ads.
- Click Manage integration.
- Go to the Cost tab.
The list of connected accounts displays. - In the actions column, hover over an account.
The Delete connection option displays. - Click Delete connection.
A confirmation message displays. - Click Delete.
The account connection is deleted.
The collection of cost data for the previously connected account stops immediately. There is no impact to historical data.
Disabling Cost API
To disable Cost API:
- Go to Active integrations and select the partner.
- Go to the Cost tab.
- Disable Get Cost Data.
- Click Save Cost.
Note: If an advertiser stops working with an agency and disables the agency permissions at the app level, if the agency has cost configured for the app, cost data is still pulled. To stop this data from being pulled, the advertiser must ask the agency to disable their cost integration in AppsFlyer.
Cost API status
The operational status of cost integrations is available as follows:
- Cost (and ad revenue) integration status dashboard: Centralized list of partners for whom cost integration is enabled for one or more apps housed in your account.
- Integrated partners: Status available in the context of an individual app.
Integrated partner cost API status
The cost tab in the partner integration page is relevant for ad networks that support getting cost data via API, and displays:
- The status of your cost integration.
- Last time AppsFlyer successfully pulled matching cost data.
To view the individual partner cost integration status:
- In AppsFlyer, from the side menu, go to Collaborate > Active integrations.
- Select the partner.
- Go to the Cost tab.
The status and last sync time displays.
Status | Remarks/action required |
---|---|
Active | Integration is enabled and successfully connected to the ad network. |
Partner API is not returning matching cost data |
Connection is successful but the API has not returned any cost data matching AppsFlyer campaign attribution data. This happens because:
|
Partner API is not responding |
|
Invalid credentials |
|
Reach out to your ad network account manager to get access to their reporting API | Work with the partner account manager to enable the cost integration in the partner's system. |
Partner API is not returning data. Review integration. |
This happens because:
|
Your account is not enabled on the partner system to get cost |
Contact the partner. |