Integrate with AppsFlyer

Suggest Edits

impact.com can integrate with your existing AppsFlyer mobile app setup to enable tracking, reporting, and payouts for events in your mobile apps.

The integration supports a range of app events, including Installs, In-App Sales, Leads, App Opens, and Sign-ups, and can be customized to suite your specific use case.

⚠️

Note

This article covers the Integration with AppsFlyer for an Affiliate Program. Learn more about how to Integrate with AppsFlyer for your Advocate Program.

How it works

  • In your AppsFlyer account, you’ll enable the impact.com module, configure its settings, then get your app’s attribution link.
  • In your impact.com account, you'll add (or update) your mobile app(s)' Download URL with the attribution link created while integrating.
  • For each in-app event you want to send to impact.com, you'll add new events (and Event Codes) to your mobile app(s) in impact.com.

Enable the module

  1. Log in to your AppsFlyer account.
  2. In the AppsFlyer dashboard, find the Configuration section and select Integrated Partners.
  3. In the App Search, input impact_radius then select Activate Partner.

Configure the module

Each subsection below refers to the relevant setting section of the module. To configure the module in AppsFlyer, navigate to Configuration → Integrated Partners, find the impact.com module and select Edit.

General Settings

In the General Settings section, you’ll need to add your mobile app’s System App ID and your impact.com API credentials (Account SID & Auth Token).

📘

Note

The General Settings section configures the Install event — other events are configured in the In-App Events section.

FieldDescription
passwordYour impact.com API Auth Token. Navigate to
[Vertical Ellipsis] → Settings → API to find this value.
ActionTrackerIdYour impact.com System App ID for your mobile app. Navigate to
[Vertical Ellipsis] → Settings → Mobile Apps to find this value.
userYour impact.com API Account SID. Navigate to
[Vertical Ellipsis] → Settings → API to find this value.

Default Postbacks

The Default Postbacks section shows how impact.com will receive the standard install events from AppsFlyer via a postback. This section should be left as default — impact.com will receive events with an INSTALL event code, which will match the event code that your mobile app(s) in impact.com are expecting.

In-App Event Settings

If the In-App Events Postback option is enabled, make sure to fill out this section; otherwise, leave this blank.

Your credentials here are identical to the ones used in the General Settings section — simply duplicate the values used for user, password, and AppId (identical to ActionTrackerId).

In-App Events Postback

If you want to send in-app events to impact.com (e.g., Sale, Lead, etc.), enable the In-App Events Postback option.

In-App Postback Window

Refer to In-app event postback window on AppsFlyer's Help Center for documentation on this feature.

Parameters

ParameterDescription
SDK event nameThe SDK Name is the name of the parameter you’re using in the AppsFlyer SDK to track a data point.
Partner event identifierThis is the identifier that impact.com will look for — must be configured as an Event Code for your mobile app. For example, if you want to track an in-app order with an SDK event name of af_purchase, then af_purchase must be configured as an Event Code for your mobile app in impact.com.
Sending optionDetermine where this data point will be sent.
Send RevenueIf the SDK is set to send a specific parameter- toggle on Send Values and Revenue (if revenue is available) or Send Values and No Revenue (if no revenue is available).

AppsFlyer will take all the data that you’re sending and forward it to impact.com as an encoded JSON format. We will then look for the appropriate parameters as listed in the table below.

AppsFlyer Parameterimpact.com ParameterType
af_order_idOrderIdString
af_content_idItemSkuString
af_content_typeItemCategoryString
af_quantityItemQuantityint
af_priceItemPricedecimal
af_revenueAmountdecimal
af_currencyCurrencyCodeString
af_date_aDate1String
af_date_bDate2String
af_cityCustomerCityString
af_regionCustomerRegionString
af_countryCustomerCountryString
af_coupon_codeOrderPromoCodeString
af_param1IR_OrderDiscountdecimal
af_param2IR_ItemSubTotaldecimal
af_param3IR_CustomerStatusString
af_param4IR_CustomerIdString

JSON example

The example below shows passing item-level data.

event-value={
  "af_order_id":"AF_test6", 
  "af_currency":"USD", 
  "af_coupon_code":"SALE20", 
  "af_city":"Santa Barbara", 
  "af_region": "CA", 
  "af_country":"USA", 
  "af_param1":"10.55", 
  "af_param2:":"123.45", 
  "af_param3":"NEW", 
  "af_param4":"914FEC35CE8BFA1A067581032F26B053591EE38A",
  "af_content_type":["hat","glasses", "bracelet"], "af_content_id":["sku-000","sku010","sku011"],
  "af_quantity":[1,2,2],
  "af_price":[35.21,300.03,250]
}

⚠️

Order-Level vs. Item-Level reporting

If you're only reporting order-level data, pass the af_revenue parameter, which maps to the impact.com Amount parameter — item-level parameters (e.g., af_price) will be ignored.

If passing item-level data (af_content_type, af_quantity, af_price) for an event, send it in array format (e.g., af_quantity = [ItemQuantity1, ItemQuantity2]) — the order-level af_revenue will be ignored.

AppsFlyer attribution link

You’ll need to retrieve an AppsFlyer attribution link or generate an AppsFlyer OneLink (learn more about OneLink in the AppsFlyer Help Center).

Whichever link you retrieve needs to be set as the Download URL for your mobile app(s) within the impact.com platform.

⚠️

Note

Standard attribution links do not support deep linking — only OneLink does.

Attribution link

  1. In your AppsFlyer dashboard, find the Configuration section and select Integrated Partners.
  2. Find the impact.com module, then select Tracking Link.
  3. The “Tracking Link” parameters section will allow you to add custom parameters to the click tracking link at the bottom — required parameters for impact.com are already set. Once you have appended the required parameters, copy the “Click Tracking Link”.

Attribution Link example

app.appsflyer.com/id1486762009?af_siteid={irpid}&pid=impactradius_int&af_click_lookback=7d&clickid={clickid}&af_sub_siteid={irmpname}

OneLink

  1. In your AppsFlyer dashboard, find the Configuration section and select Configure OneLink.
  2. Generate the OneLink for your app — make sure to append clickid={clickid} as a query string parameter.
  3. Copy the OneLink so it can configured as your app(s) Download URL in impact.com.

OneLink example

acme.onelink.me/3218718612?af_c_id={ircid}&pid=impactradius_int&is_retargeting=true&af_click_lookback=7d&af_dp={gwlurl}&af_reengagement_window=30d&af_inactivity_window=0d&clickid={clickid}&af_siteid={irpid}&af_sub_siteid={irmpname}

Configure mobile app(s)

See Set up Mobile App Tracking in the impact.com Help Center for details on configuring a mobile app. This section assumes you’ve already set up an app — it focuses on two key parts related to integrating with AppsFlyer.

Update Download URL

  1. In the impact.com platform, navigate to
    [Vertical Ellipses] → Settings.
  2. In the right column, select Mobile Apps.
  3. In the list, find the mobile app that you want to modify and select
    [Ellipses] → View/Edit.
  4. Find the Download URL line item and paste in the URL from AppsFlyer (either the attribution link or OneLink), and make sure append the following two required query string parameters:

    af_siteid={irpid} af_sub_siteid={irmpname}

Manage Event Codes

For each additional in-app event you’re tracking, you’ll need to configure it as an Event Code for your mobile app. Once added, this will make the event payable to partners.

  1. In the impact.com platform, navigate to
    [Vertical Ellipses] → Settings.
  2. In the right column, select Mobile Apps.
  3. In the list, find the mobile app that you want to modify and select
    [Ellipses] → Manage Event.
  5. In the top corner of the screen, select Add Event.
  6. Find the In-App Events line item and select Add Another Event.
  7. Enter an Event Display Name — this is simply a name for this event that will appear in the impact.com platform.
  8. Enter the Event Code for this event — it must be exactly as it appears under the Partner event identifier line in AppsFlyer.
  9. Choose a Crediting Rule — in most cases, this will be Last Click.
  10. Select Add Another Event to add another, otherwise select Save.

Updated 6 months ago