For the complete documentation index, see llms.txt. This page is also available as Markdown.

Integrate with Adjust

impact.com can integrate with Adjust to receive attribution and in-app event data through automated callbacks.

How it works

  • In the Adjust platform, you’ll add the impact.com integration module to your app configuration, which enables the standard Install callback by default. Additional callbacks can be configured to suit your use case.

  • Once integrated, you'll generate an Adjust Tracker URL (or Measurement URL), append a necessary query string parameter, then set it as your mobile app(s)'s Download URL in the impact.com platform.

  • From there, you'll be able to test the integration with a test ad that will forward a user to your app's Adjust link. Events that you've configured in the integration and occur in your app will appear as Actions in the impact.com platform.

Enable the integration

impact.com is an integrated module partner within the Adjust platform. The instruction set below will enable the integration, which sends App Installs by default.

  1. In the Adjust dashboard, navigate to the panel on the left and select Campaign Lab → Partners, then select [Add] New Partner.

  1. Search for and select impact.

  2. On the App selection screen, select the app you want to configure, then select Next.

  1. On the Data sharing screen, select Edit to open the Enable data sharing modal, then enter the following:

Field
Value

App ID

The impact.com System App ID for your mobile app. In impact.com, go to [User profile] → Settings → Mobile Apps.

Account SID

Your impact.com API Account SID (case-sensitive). In impact.com, go to [User profile] → Settings → API.

Auth token

Your impact.com API Auth Token (case-sensitive). In impact.com, go to [User profile] → Settings → API.

  1. Select Enable, then select Next.

  2. In the Set your data sharing options section, you can choose from which source to pull data. Select [Radio button] Data from all attribution sources — this is the recommended setting.

    • If you want to limit callbacks to impact.com-attributed data, select [Radio button] Only data attributed to Impact.

  1. On the Link structure screen, enter a name for the link. Select Next.

  2. On the User destinations screen, configure the user flow for the link (for example, redirect and fallback destinations). Select Next.

  1. On the Attribution settings screen, navigate to the New user: attribution section → Clicks. Select [Toggle on] Enable probabilistic modeling and configure the Attribution window as needed. Select Next.

  1. Complete any remaining steps and select Quick create or Next to finish setup.

Additional forwarding options

Within the Adjust integration module, there are 3 toggles for additional callbacks that impact.com can receive:

  • Revenue Forwarding — forwards in-app revenue amounts and revenue event data to impact.com.

  • Parameter Forwarding — forwards Adjust partner parameters that collect custom data points to mapped impact.com parameters. See Parameter mapping below.

  • Session Forwarding — forwards in-app session information to impact.com; due to usually high volume of sessions recorded for an app, ensure this feature is disabled unless explicitly stated otherwise by an impact.com integration engineer.

Event Linking

If you want to send in-app events (e.g., Sale, Lead, etc.), configure these in the Event Linking section. Each event in Adjust must match a specific Event Code you’ve configured for your mobile app in impact.com.

For example, if you're tracking in-app sales, EVENT-REVENUE can be set to the case-sensitive value of the Event Code for an In-app Sale that you’ve configured for your mobile app(s) in impact.com (e.g., PURCHASE) To send in-app events (for example, Sale or Lead) to impact.com, configure them in the Map your events section within Adjust's Data sharing setup.

  1. In the Adjust dashboard, navigate to Campaign Lab → Partners, then select the Data sharing tab.

  2. Find your app from the list and select the pencil icon on the right of the row to edit.

  1. Navigate to the Map your events section.

  2. Add the events you want to track with impact.com and enter their corresponding Event Code value. This Event Code will be set up on the impact.com side.

    • The Event Code must match exactly as configured for your mobile app in impact.com.

    • Each mapped event will then appear as an Action in the impact.com platform once triggered in your app.

Parameter mapping

Refer to the linked resource below for the list of parameters that impact.com retrieves from Adjust in a callback. If you have custom values outside of this list you want to send to impact.com, these can be mapped here (e.g., SomeCustomString from your app could be mapped to Text1 on the impact.com side and could be configured as a condition for payouts and appear in your impact.com reports).

See the list of all parameters forwarded to impact.com in the Adjust Help Center.

Custom mapping of non-default parameters

If your app uses parameters that don't match the default mapping between impact.com and Adjust, you can configure custom mappings in the Map your parameters section of the Adjust Data sharing setup.

  1. In the Adjust dashboard, navigate to Campaign Lab → Partners, then select the Data sharing tab.

  2. Find your app from the list and select the pencil icon on the right of the row to edit.

  3. Navigate to the Map your parameters section.

  4. Map each custom Adjust parameter to its corresponding impact.com parameter.

Create Tracker URLs

If you have more than one app, repeat this process for both apps.

  1. In your Adjust dashboard, find your app’s tile and select Tracker URLs.

  2. In the modal, select New Tracker.

  3. For Tracker Name, input a sensible value like Impact.

  4. Select Quick Create.

  5. Once created, copy the Click URL.

  6. Append the following query string parameter to the link:

    • impactradius_click_id={clickid}

Configure mobile apps

This section assumes you’ve already set up an app. See Mobile App Tracking Explained in the impact.com Help Center for details on configuring a mobile app.

Update Download URL

If you have more than one app, repeat this process for both apps.

  1. In the impact.com platform, from the top navigation bar, select [User profile] → Settings.

  2. In the right column, navigate to the Tracking section and select Mobile Apps.

  3. In the list, find the mobile app that you want to modify and select [More] → View/Edit.

  4. Find the Download URL line item and paste in the Tracker/Measurement URL from Adjust, and make sure to append the following required query string parameter:

    • adgroup={sharedid}&campaign={irpid}&creative={iradid}&impactradius_click_id={clickid}

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, from the top navigation bar, select [User profile] → Settings.

  2. In the right column under the Tracking section, select Mobile Apps.

  3. In the list, find the mobile app that you want to modify and select [More] → Manage Event.

  4. In the top-right corner of the screen, select Add Event.

  5. Find the In-App Events line item and select Add Another Event.

  6. Enter the following information:

    • Event Display Name — This is simply a name for this event that will appear in the impact.com platform.

    • Event Code — Enter the Event Code for this event - it must be exactly as it appears on the Event Linking screen within the Impact Module.

    • Crediting Rule — Select Install if you are looking to add an INSTALL Event Code, or select Last Click if you are looking to track the source of the last referring click to your app.

  7. Select Add Another Event to add another, otherwise select Save.

Other Resources

See the Set up Impact article in the Adjust Help Center for additional documentation on this integration.

Last updated