Integrate with AppsFlyer
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 suit your specific use case.
Note: This article covers the Integration with AppsFlyer for a Performance 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
Log in to your AppsFlyer account.
In the AppsFlyer dashboard, find the Configuration section and select Integrated Partners.
In the App Search, input
impact_radiusthen select Activate Partner.
Enable permissions
For efficient support and troubleshooting, make your AppsFlyer app visible to the impact.com team.
From the top navigation bar, select Permissions.
[Toggle on] Ad Network Permissions.
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.
password
Your impact.com API Auth Token. In the impact.com platform, navigate to your API Credentials to find your Auth Token.
ActionTrackerId
Your impact.com System App ID for your mobile app. In the impact.com platform, navigate to your Mobile Apps to find your System App ID.
user
Your impact.com API Account SID. In the impact.com platform, navigate to your API Credentials to find your Account SID.
Default Postbacks
The Default Postbacks section allows you to configure which events are sent to impact.com. For the Install event, you must set the for users from dropdown to All media sources, including organic to ensure impact.com receives data for all installs (paid, non-attributed, and organic).
Note: The option All media sources, including organic may not be immediately visible for the Install event. If it is not visible, please contact AppsFlyer Support and ask them to enable this setting for the impact.com partner integration.
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 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 Postback Window
Refer to In-app event postback window on AppsFlyer's Help Center for documentation on this feature.
Parameters
SDK event name
The SDK Name is the name of the parameter you’re using in the AppsFlyer SDK to track a data point.
Partner event identifier
This 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 option
Determine where this data point will be sent. Select All media sources, including organic for all configured In-App events to ensure impact.com receives all event data (paid, non-attributed, and organic).
Send Revenue
If 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).
Fixed structure parameter mapping
AppsFlyer sends conversion postbacks to impact.com with a fixed structure. While it’s not possible to update the fixed structure, it is possible to update the mapping for custom event data (event-values). Refer to custom parameters for more information.
Fixed structure parameters
APPSFLYER
IntegrationSource
(appsflyer-device-id)(idfa)(vendorId)(timestamp)
OrderId
(device-model)
DeviceModel
(ip)
IpAddress
(ip)
IpAddressCarrier
(appsflyer-device-id)
appsflyer_id
(os-version)
DeviceOs
(carrier)
DeviceCarrier
(ip)
IpAddressWifi
(event-value)
appsflyer-custom
(AppId)
ActionTrackerId
(mapped-iae) | INSTALL
EventCode
(app-version-name)
AppVer
NOW
EventDate
(custom-user-id)
CustomerId
(city)
CustomerCity
(country-code)
CustomerCountry
(app-id)
AppPackage
(idfa)
AppleIfa
(advertiserId)
GoogAId
(clickid)
ClickID
re-attribution | empty
Text1
(country-code) - Install only
Text2
re-engagement | empty
Text3
(af_siteid) - if impression attribution via appsflyer
MPID
Custom parameter mapping
Event-specific data (event-values) are sent by AppsFlyer as a JSON body and have the following default mapping if impact.com receives one of the AppsFlyer parameters for a conversion:
Custom event-value parameters
af_order_id
OrderId
String
af_content_id
ItemSku
String
af_content_type
ItemCategory
String
af_quantity
ItemQuantity
int
af_price
ItemPrice
decimal
af_revenue
Amount/Revenue
decimal
af_currency
Currency
String
af_date_a
Date1
String
af_date_b
Date2
String
af_city
CustomerCity
String
af_region
CustomerRegion
String
af_country
CustomerCountry
String
af_coupon_code
OrderPromoCode
String
af_param1
IR_OrderDiscount
decimal
af_param2
IR_ItemSubTotal
decimal
af_param3
IR_CustomerStatus
String
af_param4
CustomerEmail
String
af_param5
IR_CustomerId
String
Note: If you want to update the default mapping for event_values, contact support.
JSON example
The example below shows passing item-level data.
Warning: 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.
OneLink
On your AppsFlyer dashboard, in the left navigation menu, find the Collaborate section and select Active Integrations.
Select impact.com, then select the Attribution link tab.
Below the Choose your attribution link type section, select Use OneLink.
Below the Select OneLink template section, select the relevant template from the drop-down menu.
In the Click attribution link section, copy the OneLink so it can be configured as your app(s) Download URL in impact.com.
OneLink example
Attribution link
On your AppsFlyer dashboard, in the left navigation menu, find the Collaborate section and select Active Integrations.
Select impact.com, then select the Attribution link tab.
Below the Choose your attribution link type section, select Use single-platform link.
The Attribution 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 attribution link.
Attribution Link example
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
In the impact.com platform, from the top navigation bar, select
[User profile] → Settings.In the right column, select Mobile Apps.
In the list, find the mobile app that you want to modify and select
[More] → View/Edit.Find the Download URL line item and paste in the URL from AppsFlyer (either the attribution link or OneLink), and make sure to append the following required query string parameter:
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.
In the impact.com platform, from the top navigation bar, select
[User profile] → Settings.In the right column, select Mobile Apps.
In the list, find the mobile app that you want to modify and select
[More] → Manage Event.In the top-right corner of the screen, select Add Event.
Find the In-App Events line item and select Add Another Event.
Enter an Event Display Name — this is simply a name for this event that will appear in the impact.com platform.
Enter the Event Code for this event — it must be exactly as it appears under the Partner event identifier line in AppsFlyer.
Choose a Crediting Rule — in most cases, this will be Last Click.
Select Add Another Event to add another, otherwise select Save.
Last updated