Adjust

For information from Adjust, please see here.

Features and Limitations

• Integration can be done by using the module, where postbacks are set globally or via dynamic setup by appending the Awin postback within a callback parameter in the Adjust click tracker

• Dynamic setup is not suitable for In-App purchase event as order reference can’t be passed through the Awin postback

• Commission Group can be populated with a breakdown i.e. commissionGroup1:amount1|commissionGroup2:amount2|commissionGroup3:amount3. For more information about using multiple commission groups, please also see our Commission Groups article.

Integrating Awin Tracking

Integrating Adjust

Step One: Before you can begin configuration of Adjust and the necessary postbacks, you’ll first need to ensure that the Adjust SDK is implemented in your app and to integrate Partner Parameters – orderId and cg (sale amount is passed through by default). The orderId parameter is to be populated with the order reference.

ADJEvent *event = [ADJEvent eventWithEventToken:@"abc123"];
[event addPartnerParameter:@"orderId" value:@"ord23888882"];
[Adjust trackEvent:event];

In case order reference and commission group are already configured with different parameter names to orderId and cg in Partner Parameters then Parameter Mapping should be used to pass these value as order reference and commission group to Awin.

Step Two: Ensure to enable and configure the Awin module.

Step Three: Awin technical contact to create Install commission group in the Awin platform and provide it to you, the Advertiser. Enter Install commission group in Awin module in INSTALL CID field.

Step Four: Create revenue event in the Adjust Dashboard.

Step Five: In the Awin module enable In-App Revenue and Parameter Forwarding to pass sale amount, order reference and commission group through the Awin postback

Step Six: Additionally use event linking to link the revenue event to Awin and link any other in-app event need transmitting to Awin

Step Seven: Create a tracking link for Revenue Events.

https://app.adjust.com/pdkq4x8_q9och1w?campaign=Affiliates&adgroup=!!!dateDAY!!!&creative=!!!affid!!!&awin_click_id=!!!awc!!!&awin_program_code=1001&deep_link=example-app-uk%3A%2F%2Fhome&redirect=!!!redirectURL!!!

Required parameters to be added to the Adjust tracking link:

Deeplinking

AWIN supports a URI scheme but doesn’t support the handling of iOS Universal links and Android app link methods of deep linking. This is due to the link wrapping. It applies to any link used within AWIN. To deep link with Adjust tracking link via AWIN, you will need to setup the Adjust tracking link URL with a URI scheme. Preferably, your app developer should configure the SDK to support HTTP URL as a deep link value.

If the URI scheme is filled in the deep_link parameter, the user will consistently be directed to the static page within the app. However, in cases where the app isn't installed, Safari will display an invalid address error. This method does not support dynamic deep linking. Alternatively, if the app developer implements handling for HTTP URLs by converting them into URI schemes that the app can understand (e.g., making them app-readable product destinations), users will be directed to the relevant product page within the app. Notably, this approach avoids displaying an invalid address error in Safari when the app is not installed.

Attribution

Adjust attributes based on the first click of the last partner.

Set Attribution metrics

• Re-attribution window should match the Awin cookie length

• Inactivity period should be set to 0

• In order to receive first click of the day from the last publisher, the Advertiser should populate Adjust campaign structure parameters with the following Awin placeholders !!!id!!! and !!!dateDAY!!!

Postbacks

Install postback

https://www.awin1.com/sread.php?tt=ss&tv=2&type=ai&merchant={{awin_program_code}}&amount=1&ref={adid}&parts={installCID}:1&testmode=0&cks={{awin_click_id}}&p1={adid}&p2={os_name}&p30=adjust

In-app purchase postback

https://www.awin1.com/sread.php?tt=ss&tv=2&type=ap&merchant={{awin_program_code}}&amount={{revenue_float}}&ref={{orderId}}&parts={{cg}}&testmode=0&cks={{awin_click_id}}&cr={currency}&vc={vc}&p1={adid}&p2={os_name}&p30=adjust

Testing your App Tracking

Once you’ve completed the installation of your app tracking, please get in touch with your assigned Awin technical point of contact for more information on how to test your tracking.

For a more general overview of the testing process, please review our Testing your Integration article.