Customers using Adjust can have data sent to FreeWheel DSP for two use cases: conversion attribution and user segmentation. See below for details about setting these features up with FreeWheel DSP.

Conversion Attribution

Conversion Attribution for Media Companies

If you are a media company working with an advertiser that uses Adjust:

The Adjust click URL generally looks like:

https://app.adjust.com/<tracker_token>

?campaign=CampaignName&adgroup=AdGroupName&creative=CreativeName&idfa_upper_sha1={{IOS_ID_SHA1}}&gps_adid_upper_sha1={{ANDROID_ID_SHA1}}&install_callback=<EscapedPostbackURLforInstall>&event_callback_<EventToken1>=<EscapedPostbackURLforInAppEvent1>&event_callback_<EventToken2>=<EscapedPostbackURLforInAppEvent2>

• tracker_token is the special token of the specific network and is obtained from Adjust
• campaign is an optional parameter.  Normally, a static value is passed, but the Beeswax macro {{CAMPAIGN_ID_ALT}} can be used if the Alternative ID field is complete with the desired campaign name in the Edit Campaign screen.
• adgroup is an optional parameter.  It is normally a static value determined by the client.
• creative is an optional parameter.  Normally, a static value is passed, but the Beeswax macro {{CREATIVE_ID_ALT}} can be used if the Alternative ID field is complete with the desired campaign name in the Edit Campaign screen.
• install_callback is required.  It is the escaped version of the standard Beeswax postback. It will look something like:

https%3A%2F%2Fcnv.event.prod.bidr.io%2Flog%2Fpbk%3Ftag_id%3D1%26buzz_key%3Dyourbuzzkey%26auction_id%3D{{AUCTION_ID}}

• It is important that the brackets around AUCTION_ID remain unescaped.
• tag_id is the corresponding event ID in the platform you have set up for installs.
• To track additional events, use this format:

...&event_callback_EventToken1=<EscapedPostbackURLforInAppEvent1>&event_callback_EventToken2=<EscapedPostbackURLforInAppEvent2>&...

• There is no limit on how many event callbacks can be added, however it is possible to reach a URL character limit.
• The postback URL will look like the above except the tag_id should be replaced with the corresponding event (e.g. in-app purchase, new session, etc.)
• EventToken1 and EventToken2 are unique tokens of custom events that clients implement in the Adjust SDK. It is not related to tracker_token.
• Connect multiple postback calls per install or event by using a + symbol between escaped callback URLs.  Note that the + should not be escaped.

It is important to include device ID macros for the most accurate conversion tracking. Be sure to include parameters: &idfa_upper_sha1={{IOS_ID_SHA1}}&gps_adid_upper_sha1={{ANDROID_ID_SHA1}}

Conversion Attribution for Advertisers

For advertisers who have contracts using Adjust:

The Adjust click URL generally looks like:

https://app.adjust.com/<tracker_token>

?ref_id={{AUCTION_ID}} &campaign=CampaignName&adgroup=AdGroupName&creative=CreativeName& idfa_upper_sha1={{IOS_ID_SHA1}}&gps_adid_upper_sha1={{ANDROID_ID_SHA1}}

• tracker_token is the special token of the specific network and is obtained from Adjust.
• ref_id is the placeholder to tell adjust to pass the auction ID through to FreeWheel.
• Campaign is an optional parameter. Normally, a static value is passed, but the macro {{CAMPAIGN_ID_ALT}} can be used if the Alternative ID field is complete with the desired campaign name in the Edit Campaign screen.
• Adgroup is an optional parameter. It is normally a static value determined by the client.
• Creative is an optional parameter. Normally, a static value is passed, but the macro {{CREATIVE_ID_ALT}} can be used if the Alternative ID field is complete with the desired campaign name in the Edit Campaign screen.

It is important to include device ID macros for the most accurate conversion tracking. Be sure to include parameters: &idfa_upper_sha1={{IOS_ID_SHA1}}&gps_adid_upper_sha1={{ANDROID_ID_SHA1}}

In Adjust, set FreeWheel event pixels up as "real-time callbacks". These are implemented on the Adjust backend, therefore removing the need to insert encoded postbacks in click URLs and allowing for tracking of multiple events.

To set this up:

• Create the events in the platform to track
• Go to the app they want to create callbacks for in Adjust
• For each corresponding event in the UI (see below) add the appropriate event callback URL in this format:
  • For non-revenue based events: equal,{network_name},beeswax,https://cnv.event.prod.bidr.io/log/pbk?tag_id=YOUR_EVENT_ID&buzz_key=YOUR_BUZZKEY&auction_id={dcp_ref_id}
  • For revenue tracking events, please use the VALUE parameter: equal,{network_name},beeswax,https://cnv.event.prod.bidr.io/log/pbk?tag_id=YOUR_EVENT_ID&buzz_key=YOUR_BUZZKEY&auction_id={dcp_ref_id}&value={revenue_usd}
  • Be sure to replace YOUR_BUZZKEY with the buzzkey and YOUR_EVENT_ID with the ID of the event
• Contact your FreeWheel representative to run an E2E test to validate this is tracking and firing correctly

Audience Syncing

Customers of FreeWheel and Adjust can sync users for targeting purposes. There are two ways to sync users from Adjust.

Using the Adjust Audience Builder

FreeWheel can automatically pick up audiences from the Adjust Audience Builder and load them into the platform. 

To enable FreeWheel to ingest data from Audience Builder, please reach out to your Account Representative to help configure this.

Using the Adjust Module

The Adjust module can push data into the platform. This sends server side sync calls per event.

To enable this, please reach out to your FreeWheel representative who will need to enable alternative segment ID for Segment postbacks for your account.

The steps you will need to perform once this has been enabled are:

• In the platform, set up one segment per event type (for example, install, session, or purchase) and app combination
  • Ensure the Days (or ttl_days in the API) is set to 90 days to ensure maximum retention time for these users
  • Set the Alternative ID of the segment to be "appbundle-eventtype" where the app bundle is the one that is being advertised
    • For example, "com.beeswax.mygame-install"
  • A list of the event types are in the activity kind list here: https://partners.adjust.com/placeholders/
  • For custom events, the event linking will be the "eventtype"
• Set the module to "on" in Adjust and enter the buzzkey and the corresponding account ID (this is "2" by default) in the Adjust UI