Adjust provides special integrations for a handful of select partners. In these cases, Adjust clients benefit from what we call modules. These modules offer extended integration.
Most of your network and traffic partners use our standard integration, which leverages our open callback API. This standard setup allows them to receive callbacks only for their attributed installs, sessions, events and so on. Special partners receive extended data or data that can not be accessed through our standard integration.
Special partner modules are activated on a per-app basis directly through your Adjust dashboard. You can access these modules by clicking on your App Settings, where you will find the Partner Setup tab. To begin transmitting data to the respective partner, simply enter the partner-specific information into the Adjust module. Once saved, Adjust will automatically start sending the necessary data to your partner. You can deactivate this integration at any time by removing the app key or keys from your module.
In addition, you may need to create a tracker for the partner if you are planning to run traffic. You may also need to add parameters listed in the next section of this document, Adding parameters to your URLs. Please also refer to our guide to Tracker Generation.
The sections below list the specially integrated partners, what data they have access to, and how you can set up a tracker for these partners.
- 1 Activating special partners
- 2 List of Special Partners
- 3 SDK-to-SDK integrations
- 4 Further integrations
1Activating special partners
Special partners have server-to-server modules, which you can find in the App Settings panel of your dashboard.
All modules are activated and deactivated on demand in your dashboard. To activate a module, you can either toggle a switch to “on” (in the case of most analytics partners), or enter a specific API key or App ID from your partner’s systems. To deactivate, just remove the keys or flip the switch.
A module will activate a certain set of server-to-server callbacks, which the modules below specify for each partner:
- click callbacks informing partners about clicks you are receiving
- install callbacks informing the partners of new users that install your app
- session callbacks informing the partners of users returning to your app
- reattribution callbacks informing partners of successfully re-engaged users
- various event callbacks informing partners of in-app events
Install, session, and reattribution callbacks are often key to the partner’s functionality, and are thus activated when you activate the module. Event callbacks can usually be configured one-by-one to give you complete control of what events are visible to your partner.
You can configure exactly which events are sent, and how. Usually most partners allow you to select a label or type in a label that will be used when interacting with the partner’s APIs.
- In your Adjust dashboard, click on the settings of the app for which you wish to transmit events
- Click on the partner of interest
- Enter the event name as required by the partner in the field under the event name as named in your Adjust dashboard.
- Only mapped events will be sent to the partner. Any event where the field is left blank will not.
1.2Forwarding revenue data
You can also activate revenue forwarding. By default, Adjust does not transmit revenue data associated with events to partners. If you activate revenue forwarding, we will allow your partner’s callbacks to receive revenue as long as there is revenue associated with an event that you are sending and the partner has an API option for receiving revenue.
- In your Adjust dashboard, click on the settings of the app for which you wish to activate revenue forwarding
- Click on the partner of interest
- Activate the
1.3Running traffic with special partners
Once you have activated a special partner module for a network, you usually need to provide the network with a tracker. In most cases, you can create this tracker yourself in any structure you require.
Please note that many network partners require additional parameters to be added onto the click URL. In this case, these parameters are listed in the section below. It is possible your traffic will be incorrectly tracked if you do not add these parameters.
Facebook Marketing Partners, Twitter Marketing Partners and other similar analytics partners, do not use tracker URLs per se, and you won’t need to set any up. In this case, you just need to activate any modules that may apply.
1.4Adding parameters to your click URLs
Adjust is network agnostic, and as such our goal is to provide a flexible and dynamic tool.
In some cases, you may need to add a parameter or two onto the tracker before setting it up with your traffic provider. You can easily modify these in a text editor or directly in the text field in the partners’ websites. Once you understand the basic rules, URL parameters are simple and easy to add.
The first parameter on a URL is delineated with a question mark (
?) after the domain, and any subsequent parameters are delineated with an ampersand (
&). Parameters have a name, or a label, that immediately follows the delineator, and all parameters also have a value.
Each network will have different URL parameters. We have listed these in the “Tracker URL” section of the tables below.
1.5Sending additional in-app data with partner parameters
The Adjust SDK can transmit additional data to your partners via partner parameters on sessions, installs, reattributions and events. This is useful when your partner accepts custom data that you are passing through Adjust, for example:
- custom shopping cart objects for CPA networks
- internal customer IDs for retargeting purposes
- gaming level indications and other funnel characteristics
To implement these partner parameters you will need to check the code relevant to the platform of your app. SDK README’s for all platforms can be found here
1.6Mapping Partner Parameters
It may be the case that a single partner parameter is to be sent to different partner-networks in a different format or with a different name. With Adjust you can specify individually the name for which each partner will receive each partner parameter:
- In your Adjust dashboard, click on the settings of the app for which you wish to map the partner parameters
- Click on the partner of interest
Partner Parameter Mapping
- Enter the partner parameter names as sent to Adjust by the sdk in the left
FROM APPcolumn. (This should be the same for every partner)
- Enter the partner parameter names as desired by this partner in the right
TO PARTNERcolumn. (This is partner specific!!)
- If a partner parameter name is defined in the
FROM APPcolumn but the corresponding field in the
TO PARTNERcolumn is left empty, then this paramater will not be sent to this partner.
- Any partner parameter that is not mentioned in the mapping will be sent with the name it already has.
- Speak to your Adjust account manager before you add more partner parameters in the sdk, as this partner parameter mapping feature may be able to be used to avoid these unnecessary additions.
In the sections below, you can see if your partners accept partner parameters, and if so what those partner parameters are.
1.7Forwarding traffic from self-attributing networks
You can forward traffic from some self-attributing networks, including Facebook, Apple Search, Snapchat, and Google AdWords, to select official campaign management partners. A keyword in a tracker’s campaign name will allow Adjust to know when to forward self-attributing network traffic to a campaign management partner.
If a campaign management partner can receive data from self-attributing networks, the relevant keyword will appear on the partner’s dedicated Adjust module page.
The campaign management partner you are running with can include their keyword in the tracker campaign name through the self-attributing network’s UI.
2List of Special Partners
The below is a list of special partners.
- Braze (formerly Appboy)
- Appreciate DSP
- Addict Mobile
- Light Reaction
- Amazon Mobile Ad Network
- Datalift Retargeting
- Conversant Universal Template
- DAU-UP ClicksMob Network
- Dynalyst for Games
- Facebook PMDs
- FreakOut for DynamicAds
- Google Adwords
- Grow Mobile
- Ingenious Technologies
- Kenshoo network
- LINE Ads Platform
- Media Detect
- Millennial Media
- Nanigans Full Traffic
- RTB House
- Taptica Network
- Tencent GDT (腾讯广点通)
- The Trade Desk
- SVG Mobile
- Unity Ads
- Wider Planet
- Yahoo Japan Search
- Yahoo Gemini
- ART DMP
- Conversion Logic
- Eulerian DCP
- Google Analytics
- Impact Radius
- Leads Monitor
- Nanigans Twitter Partner
- Oracle Bluekai
- TSW (The Specialist Works)
- RadiumOne Mobile Analytics
- Sensors Data (神策数据)
- Sprinklr Audience
- Tapjoy Analytics
- The ASO Project
- Treasure Data
- Visual IQ
- Winclap Marketing SaaS
- Yahoo DMP
- Zen Marketing
All above partners are integrated with a server-to-server API. Adjust additionally has a few partners where we have set up SDK-to-SDK integrations, where data from the Adjust systems are received by the app, and transmitted to the other partner via their own SDKs.
In this case, you will have both the Adjust SDK and the partner SDK integrated into your app. In your app, you will be using the Adjust delegate callbacks to receive the attribution data from Adjust, and then in that method, call the partner SDK to forward the attribution data.
Please check out the SDK documentation for instructions on implementing the methods to access attribution data from Adjust inside the app:
Similar functionality is available in all Adjust SDKs, and instructions can be found in each README.
When you have implemented the attribution callbacks, you need to add the partner methods. These vary from partner to partner, and we have documented this below.
3.1Attribution data considerations
Please note that the delegate callbacks are primarily designed for your internal use, and is effectively used when adding context to your app’s behavior depending on Adjust data. As such, we are not able to control the data as effectively as when we are building server-to-server modules.
Take care to note the attribution data policies documented here.
Adobe Analytics is a comprehensive online marketing and web analytics suite. The SDK-to-SDK integration between Adjust and Adobe enables you to push install, reattribution, session and event data into your Adobe setup. Adjust sends this data to the Adobe SDK by utilizing delegate callbacks with attached attribution data. For more information on the Adobe Analytics setup, you can check out our write up.
AT Internet is an analytics platform. When you have implemented the attribution callback, please follow AT Internet’s instructions to complete the integration and share attribution data.
Batch is a Mobile CRM platform. When you have implemented the attribution callback, you can use Batch segmentation to send push notifications to your users based on install attribution data.
Please check out our SDK README on the topic here.
In deltaDNA, you can set up a special in-app event called
adjustAttribution. When you receive the Adjust delegate callbacks with attribution data, you need to track that event with the deltaDNA SDK, and add the
acquisitionChannel parameter with the attribution data.
deltaDNA has a great write-up on the topic.
Mixpanel can be integrated as a server-to-server integration, as well as SDK-to-SDK. The server-to-server integration works best if you have not used Mixpanel before. If you already have Mixpanel integrated into your app, it is best to modify your app with the Mixpanel SDK-to-SDK integration.
When you have implemented the attribution callback, you can use Mixpanel super properties to attach the attribution data to the user. This is related to when you identify the user with Mixpanel.
Please check out our SDK README on the topic here.
While Bing Ads doesn’t support receiving non-attributed callbacks, they are still an integrated partner of Adjust and operate on a basis of dynamic integrations. In line with this, you can easily setup your Bing Ads campaigns using the following tracker URL structure template:
Feel free to navigate through Bing Ads’ guide to modify your campaign structure parameters in which ever way you wish.