Note about iOS 14: no updates are required for offers tracked with Adjust. TUNE’s postback tracking does not rely on IDFA for attribution.
This article is intended for customers interested in driving mobile app conversions and having the Adjust SDK installed in their app. Adjust is a mobile attribution and marketing analytics platform, and is a TUNE integrated partner. With the TUNE and Adjust integration, you can accurately measure mobile app conversions coming through your partner marketing campaigns and ensure the related mobile app data is passed back to TUNE.
Configure App Install Tracking
To use the integration, you do not need to enable anything on either platform. The integration is automatically ready to use, just simply follow these steps:
- Go to the Adjust dashboard for your mobile app and select TUNE from the Network list in the Manage Network Trackers tab.
- Give this tracker a name and click Create.
- You now have a tracking link ready to use.
- Customize your Adjust tracking link by inserting your TUNE tracking domain into the Adjust tracking link where it says NETWORKID.go2cloud.org and enter the type of payout (CPI, CPC, or CPM) where it says ENTER_COST_TYPE. Below is an example of an Adjust tracking link with the necessary inputs highlighted.
https://app.adjust.com/wh4t7z?campaign={offer_name}&adgroup={affiliate_name}&creative={file_name}&idfa={ios_ifa}&gps_adid={google_aid}&android_id={google_aid}&campaign_id={offer_id}&creative_id={file_id}&affiliate_id={aff_id}&impression_id={transaction_id}&subpublisher_id={aff_sub}
&install_callback=http%3A%2F%2FNETWORKID.go2cloud.org%2Faff_lsr%3Ftransaction_id%3D{transaction_id}
&cost_type=ENTER_COST_TYPE&cost_amount={payout}&cost_currency={currency} - Copy the completed Adjust tracking link and paste it into TUNE as the Default Offer URL for your offer.
- Whitelist Adjust Ip Addresses: We recommend all Adjust clients receiving data through callbacks to allowlist the Adjust server IP addresses and reject all other requests.
- You are all done! Share this offer with your partners, and traffic will be directed to the Adjust link to measure installs for your mobile app.
Configure In-App Event Tracking (Optional)
For proper measurement of in-app events, you need to ensure your Adjust tracking link contains your postback URL directly in the tracking link itself. To configure the integration for in-app events, follow these steps:
- Go to your Adjust dashboard and create a tracking link as described above in steps 1 – 3 and copy it.
- Go to https://partners.adjust.com/. You can use this link creator to easily create your In-App Event Tracking link.
- Paste the Adjust tracking link into the first section titled Enter Your Links.
- Scroll down to the end of section 2 titled “Your Callbacks” to the area for inputting an Event Callback. In the Token field, insert the event token from your Adjust dashboard that corresponds with the applicable event. In the Callback field, insert the applicable TUNE Event Postback URL. Repeat this for each event you will like to track.
This article assumes you understand how to view and customize an Event Postback in TUNE. Please refer to this article for more information.
- Retrieve your customized Adjust tracking link in section 4 titled “Generated URLs”.
Here is an example of the Adjust tracking link configured for In-App Events:
https://app.adjust.com/8m12m77?campaign={offer_name}&adgroup={affiliate_name}&creative={file_name}&idfa={ios_ifa}&gps_adid={google_aid}&android_id={google_aid}&campaign_id={offer_id}&creative_id={file_id}&affiliate_id={aff_id}&impression_id={transaction_id}&subpublisher_id={aff_sub}&install_callback=http%3A%2F%2FNETWORKID.go2cloud.org%2Faff_lsr%3Ftransaction_id%3D{transaction_id}
&cost_type=ENTER_COST_TYPE&cost_amount={payout}&cost_currency={currency}&event_callback_d4peit={YOUR_ENCODED_CALLBACK_URL}&event_callback_2z1xyw={YOUR_ENCODED_CALLBACK_URL} - Copy the completed Adjust tracking link and paste it into TUNE as the Default Offer URL for your offer.
- You’re all done! Share this Offer with your partners, and traffic will be directed to the Adjust link to measure re-engagement for your mobile app.
Implement Universal Links (Optional)
Universal links can work seamlessly across mobile apps and the web, on all operating systems and devices, and they can send users to specific pages in your app or website for an optimal mobile experience.
Here are the steps to properly form your universal link using Adjust and TUNE:
- Generate your Adjust universal link. For help with that, please refer to Adjust’s help article.
Example (basic):https://z9pm.adj.st/?adjust_t=klm012
Example (with paths and other parameters):
https://z9pm.adj.st/my/path?adjust_t=klm012&adjust_campaign=Getaway_Vacation_Campaign_2-0&adjust_adgroup=35-42&adjust_creative=island_sunset
-
URL encode your TUNE postback URL (
https://NETWORKID.go2cloud.org/aff_lsr?transaction_ID=TRANSACTION_ID
) and set it as theadjust_install_callback
parameter on the universal link from step 1. Be sure to replaceNETWORKID
with your TUNE account’s network ID.
Example:
https://z9pm.adj.st/?adjust_t=klm012&adjust_install_callback=https%3A%2F%2FNETWORKID.go2cloud.org%2Faff_lsr%3Ftransaction_id%3DTRANSACTION_ID
Note: we will use the placeholderTRANSACTION_ID
for the value of transaction_id until the last step. This is to ensure that it doesn’t get URL encoded by accident.
-
URL encode the link from step 2 and place it as the
url
parameter on an Adjust JavaScript Redirect link (https://app.adjust.com/jsr?url=
).
Example:
https://app.adjust.com/jsr?url=https%3A%2F%2Fz9pm.adj.st%2F%3Fadjust_t%3Dklm012%26adjust_install_callback%3Dhttp%253A%252F%252FNETWORKID.go2cloud.org%252Faff_lsr%253Ftransaction_id%253DTRANSACTION_ID
- Replace
TRANSACTION_ID
with{transaction_id}
.
Example:
https://app.adjust.com/jsr?url=https%3A%2F%2Fz9pm.adj.st%2F%3Fadjust_t%3Dklm012%26adjust_install_callback%3Dhttp%253A%252F%252FNETWORKID.go2cloud.org%252Faff_lsr%253Ftransaction_id%253D{transaction_id}
- Set the link from step 4 as the Default Offer URL in your offer in TUNE.
Congrats! Your offer is now ready for traffic with universal link support.