Connecting cost integrations

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:

  1. In AppsFlyer, from the side menu, select Collaborate > Active Integrations, and select the partner.
  2. Click Manage integration.
  3. Open the integrated partner Cost tab.
  4. Turn on the Get Cost Data toggle. The requirements to connect to the partner display.
  5. Configure and authenticate the integration to the partner. The integration method depends on the partner. Learn more
  6. If the partner’s cost configuration has Site ID mapping, select the desired site ID configuration from the dropdown. Learn more
  7. Click Save Cost.
  8. Click Test Connection.

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:

  1. In the integrated partner Cost tab, go to Site ID mapping, and select a configuration from the dropdown menu.
  2. 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:

  1. In AppsFlyer, from the side menu, go to Collaborate > Active integrations.
  2. Select the integrated partner, for example, Meta ads.
  3. Click Manage integration.
  4. Go to the Cost tab.
    The list of connected accounts displays.
  5. In the actions column, hover over an account.
    The Delete connection option displays.
  6. Click Delete connection.
    A confirmation message displays.

    OauthDelete_en-us.png

  7. 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: 

  1. Go to Active integrations and select the partner.
  2. Go to the Cost tab.
  3. Disable Get Cost Data.
  4. 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:

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:

  1. In AppsFlyer, from the side menu, go to Collaborate > Active integrations.
  2. Select the partner. 
  3. 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:

  • The campaign ID has not been provided, so the cost can't be matched to campaigns.
  • You integrated a different partner ad account when logging into the partner via AppsFlyer (for example, a different Meta ads account). Check you connected the right partner ad account.
  • One of the credential fields in the partner cost integration is incorrect. For example, the bundle ID. Review and correct the integration credentials.
Partner API is not responding
  • The integrated partner's server is not responding to AppsFlyer.
  • Wait 6 hours. If the status message persists, contact AppsFlyer support.
Invalid credentials
  • AppsFlyer can't get data via the API because the credentials are not valid.
  • Reconnect using the correct 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 campaigns are paused and there is no data.
  • You integrated a different partner ad account when logging into the partner via AppsFlyer (for example, a different Meta ads account). Check you connected the right partner ad account.
  • One of the credential fields in the partner cost integration is incorrect. For example, the bundle ID. Review and correct the integration credentials.
Your account is not enabled on the partner system to get cost

Contact the partner.