English (US) Español (Latinoamérica) 日本語 한국어 简体中文

Articles in this section

Adjust

iOS Tracking Link Generation

Remerge utilizes the Adjust iOS click tracking link to achieve the following goals:

  • Ensure the most optimal user experience.
  • Notify Adjust of a user click driven by a Remerge ad.

To support you with an especially user-friendly implementation, we have split this guide into two parts: the first is meant for your Developer, while the latter, is Marketer. In case of any questions, please reach out to your Remerge Account Manager. 

Developer Guide 

Prerequisites:

Integration of both the Custom Raw Scheme URL and Universal Links deep linking methods on your app allows you to accommodate ALL OS versions with the optimal deep linking protocol. Universal LInk implementation is mandatory in order to run an iOS campaign with Remerge. Therefore:

  • Implement the Universal Link on the Adjust dashboard and your app.
  • Implement the Custom Raw Scheme URL on your app.
  • Provide your marketing team with both the Universal Link and Custom Raw Scheme URL structures.

1. Retrieve iOS App Prefix & Bundle ID

  • Log in to your Apple Developer Portal, go to View Account > Account Summary and obtain your app's Team ID / App Prefix.
  • Your iOS app is assigned with a bundle ID (by either you or your developer) upon its creation. In order to retrieve the bundle ID, open iTunes Connect, and go to App Information > General Information.

2. Activate Universal Linking

  • Log in to your Adjust Account, go to Menu > Apps, located on the upper left-hand corner of the Adjust dashboard, and select your app.

    Screen_Shot_2019-05-13_at_10.57.07_AM.png

  • Click on the bottom drop-down arrow of your app, go to the SET UP YOUR APP column on the right, and click on All Settings.

    Screen_Shot_2019-05-13_at_12.20.31_PM.png
    Screen_Shot_2019-05-20_at_11.33.18_AM.png

  • Go to SETTINGS > Platforms, add your iOS bundle ID, and click on the SAVE button, located at the bottom of the module.

    Screen_Shot_2019-05-20_at_1.33.29_AM.png

    Screen_Shot_2019-05-20_at_11.56.36_AM.png
    Screen_Shot_2019-05-20_at_12.11.54_PM.png

  • Click on Universal Linking, add your APP PREFIX & APP SCHEME, and click on the SAVE button, located at the bottom of the page. Adjust automatically creates your short Universal Link token, upon the addition of the APP PREFIX & APP SCHEME. The short Universal Link token is a unique app-specific subdomain (in our example, the short Universal Link token is: u7f3.adj.st).

    Screen_Shot_2019-05-20_at_12.21.09_PM.png

    Screen_Shot_2019-05-20_at_12.57.28_PM.png

3. Link your App to Approved Domains

  • Go to your app and register your approved (associated) domains, by toggling the Enabled button, located next to Associated Domains, as displayed below: 

    Screenshot_2022-08-17_at_15.23.05.png

  • Whitelist the Adjust subdomain you have created in the previous step (in our example, u7f3.adj.st), by adding it alongside the applinks prefix to the list of your associated domains. In this scenario, an example of an approved domain would be applinks:u7f3.adj.st.
  • Adjust hosts the Apple-App-Site-Association (AASA) file for your subdomain on your behalf. For further information on preparing your app to handle Universal Links please visit Apple’s developer documentation.

4. Integrate Deep Linking Methods 

  • Implement the continueUserActivity method in your app. The continueUserActivity method is a simple technique for catching Universal Links. For further information on this method along with sample code, please visit Adjust's iOS SDK Readme Documentation.
  • Implement the *oldStyleDeeplink method in order to be able to handle users on older OS systems.

5. Test your Universal Links

  • Prior to utilizing Universal Links in campaigns, it is essential that you push the new build to the App Store.
  • Send yourself the created Universal Link (for example, via an email or slack). In order to confirm the accuracy of setup and implementation, click on the Universal Link from a mobile phone. You should be then automatically deep-linked into the exact conversion point within your app. If this is not the case and/or your app does not open, please verify the correct app integration by reviewing the above-mentioned steps. 
  • Provide your Remerge Account Manager with the final version of the created Universal Link.

Marketer Guide

Prerequisites:

  • Your developer has activated Universal Link support on your Adjust dashboard. 
  • Universal Link (mandatory)- The Adjust Universal Link can be created with/without parameters, as per the below example:
    Adjust Universal Link & Path Adjust Universal Link & Parameters Adjust Universal Link, Path & Parameters

    u7f3.adj.st/competition/10

    		 u7f3.adj.st?view=fixtures&seasonId=37326 u7f3.adj.st/competition/10?view=fixtures&seasonId=37326
  • Custom Raw Scheme URL (optional)- The Custom Raw Scheme URL guides the user to the exact in-app conversion point. The conversion point can be reached either by specifying the path and/or parameters, as per the below example:
    Custom Raw Scheme URL & Path Custom Raw Scheme URL & Parameters Custom Raw Scheme URL, Path & Parameters
    myapp://competition/10 myapp://?view=fixtures&seasonId=37326  myapp://competition/10?view=fixtures&seasonId=37326

1. Generate your Remerge Network Tracker

  • Log in to your Adjust Account, go to MENU > Apps, located on the upper left-hand corner of the Adjust dashboard, and select your app.

    Screen_Shot_2019-05-13_at_10.57.07_AM.png

  • Click on the bottom drop-down arrow, go to SET UP YOUR APP column on the right, and click on Tracker URLs.

    Screen_Shot_2019-05-13_at_12.20.31_PM.png
    Screen_Shot_2019-05-28_at_2.21.45_PM.png

  • Click on the NEW TRACKER button, located at the bottom of the module.

    Screen_Shot_2019-05-27_at_1.34.35_AM.png 

  • NAME your tracking link, select Remerge as your NETWORK, and click on the CUSTOMIZE button, located at the bottom of the page.

    Screen_Shot_2019-05-26_at_10.01.03_PM.png

  • Click on Additional Parameters.

    Screen_Shot_2019-05-27_at_11.43.49_AM.png

  • Leave the below fields empty and click on the APPLY button, located at the bottom of the page. That being said, you may take the following optional steps:

    • Add your DEEPLINK in its corresponding field.
    • Activate AD SPEND by toggling ON the Tracking Cost Data button.

      Screen_Shot_2019-05-27_at_12.04.46_PM.png

  • Click on the CREATE button, located at the bottom of the page.  

    Screen_Shot_2019-05-26_at_10.02.22_PM.png

  • Click on the DONE button, located at the bottom of the page.

    Screenshot_2020-05-26_at_15.40.35.png

2. Retrieve Reattribution & Inactivity Windows 

  • Your newly created tracking link (in our specific example, remerge_123) can be found under DATA MANAGEMENT > Trackers > Network-Level Trackers, as displayed below:

    Screenshot_2019-12-04_at_13.25.53.png

    Screenshot_2019-12-04_at_12.22.40.png

  • Click on the Wheel symbol, located to the right of the tracking link, and the EDIT button, located at the bottom of the page.

    Screen_Shot_2019-06-13_at_12.33.20_PM.png

    Screenshot_2020-01-24_at_12.12.04.png

  • Click on Attribution Settings, which should be set to DEFAULT. The DEFAULT setting should be visible on both the final version of your Remerge tracking link (please refer to Your tracker is ready screen), as well as throughout all of the Attribution Settings screens (located on the upper right-hand corner of the page, as displayed below).   

         Screen_Shot_2019-05-27_at_12.18.57_PM.png
 
         Screen_Shot_2019-05-27_at_12.19.07_PM.png

  • Ensure Device matching is enabled.
  • Click on Reattribution for Clicks.
  • Toggle ON Enable reattribution and click on the APPLY button, located at the bottom of the page. This ensures that the Inactivity period and Reattribution window time frames are inherited from the app level. 

    Screen_Shot_2019-06-10_at_4.35.21_PM.png

          Screen_Shot_2019-06-11_at_12.08.52_PM.png                  

  • Go back to the Attribution Settings screen and click on Reattribution for Impressions.
  • Toggle ON Enable reattribution and click on the APPLY button, located at the bottom of the page. This (as in the case of Reattribution for Clicks) ensures that the Inactivity period and Reattribution window time frames are inherited from the app level.

    Screen_Shot_2019-06-10_at_11.55.32_PM.png

    Screen_Shot_2019-06-11_at_5.37.27_PM.png

Please note:

  • The inactivity period for clicks and impressions should be identical. Ensure to register the same value for both, as:
    • Remerge needs to know which inactivity window of users can be targeted with your campaign.
    • Remerge cannot predict which impression will result in a click. 

  • Reattribution window for clicks and impressions can have different values. According to industry standards, the attribution window subsequent to an impression is shorter than the one subsequent to a click.

3. Generate your Adjust Universal Link via the Deeplink Generator

  • Go to MENU > Apps, located on the upper left-hand corner of the Adjust dashboard, and click on the Deeplink Generator.

    Screenshot_2020-05-26_at_16.00.10.png

  • Go to the PLATFORM field and select the iOS option from the drop-down menu.

    Screenshot_2020-05-27_at_12.29.32.png

  • Go to the AD ENVIRONMENT field and select the Deep linking with SFSafariViewController option from the drop-down menu.

    Screenshot_2020-05-27_at_16.07.58.png

  • Go to the FORMAT field and select the ulink option from the drop-down menu.

    Screenshot_2020-05-27_at_16.12.55.png

  • Go to the APP field and select the respective app (for which you would like to generate a deep link) from the drop-down menu.

    Screenshot_2020-05-27_at_16.32.52.png

  • Go to the TRACKER field and select your previously created tracking URL by selecting it from the drop-down menu.

    Screenshot_2020-05-27_at_18.49.02.png

  • You should now find the SHORT UNIVERSAL LINK automatically populated in its corresponding field, as per the below example (otherwise, please refer to the Developer section of this guide and ensure correct implementation).

    Screenshot_2020-05-28_at_12.37.44.png

  • Go to the IOS UNIVERSAL LINK PATH and enter the deep link path (previously obtained from your developer) and follow the below steps:

    • Enter the path WITHOUT the "/" sign, as it will be added automatically by Adjust.

      Screenshot_2020-05-28_at_12.42.03.png

    • In case your deep link path includes a variable (in our example, {product_id}), ensure to select the enforce option, located to the right of the path. Please note: Neglecting to select the enforce option will result in the deep link generator interpreting the path as INVALID. 

      Screenshot_2020-05-28_at_12.39.32.png

  • Scroll down to the DEVICE ID MACROS (IDFA) field to ensure the existence of the corresponding parameter, and click on the GENERATE DEEPLINK button, located below the field. 

    Screenshot_2020-05-28_at_12.35.04.png

  • Retrieve your newly created Adjust Universal Link. 

    Screenshot_2020-05-28_at_12.46.41.png

  • (You may also review 50 of your most recently generated links by clicking on the displayed below error).

    Screenshot_2020-05-28_at_12.54.36.png

4. Share your Tracking Link with Remerge

Upon completion of the above-mentioned steps and prior to going live, ensure to provide your Remerge Account Manager with the following:

  • Tracking URLs:

    • Adjust Universal Link (generated via the Deeplink Generator), containing the path to the conversion point (which you may obtain from your developer).
    • Standard Remerge Tracker Level Url for Click and Impression, containing the raw deep link custom path (optional). 
    • Ensure that both links have an IDENTICAL tracking ID.

  • A screenshot of your Inactivity period & Reattribution window, either both for Impression and/or Click.