iOS Tracking Link Generation

Remerge utilizes the AppsFlyer click tracking link to achieve the following goals:

• Ensure the most optimal user experience by deep linking the user directly to the exact product page within the app.
• Notify AppsFlyer of a Remerge click. 

Universal Links 

In 2015, with the launch of iOS 9, Apple has introduced Universal Links to the market and changed the way deep links are handled in iOS. Universal Links have become a standard for iOS 10 and above. They are part of the deep linking ecosystem (and as such offer a deep linking functionality), yet unique to the iOS ecosystem.

Universal Links are proven to be especially beneficial when it comes to making the most of your marketing efforts. Therefore, we do kindly ask that you provide us with your Universal Links as soon as possible. The following example is taken from an active (anonymized) Remerge campaign. The evident impact on your user's experience is very much immediate, as we can attest to an instant increase in reengagement rate, (500%!), upon the implementation of Universal Links in a client's app:

Reengagement Rate:

The OneLink

AppsFlyer offers a unique tracking link, the OneLink™, which utilizes three primary features with a single click: device detection and redirection, deep linking, and deferred deep linking. You may turn the Onelink into an iOS universal link that works on all OS versions. For further information on AppsFlyer's OneLink and best practices, please visit the OneLink Overview Page. 

AppsFlyer employs Universal Links solely for the purpose of an app open. In other words, the user is not yet deep linked to the right page. In fact, AppsFlyer leverages the deep link scheme to guarantee a smooth Universal Link performance on all OS versions. This means that AppsFlyer nonetheless requires the raw deep link custom scheme (myapp://...) to redirect a user to the exact page within the app.

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, Marketer.  In case of any questions, please reach out to your Remerge Account Manager.

Developer Guide

Prerequisites: Deep links are imperative to ensure smooth functioning AppsFlyer Universal Links. Therefore, prior to initiating Universal Links implementation, ensure your app is enabled to work with deep links after which take the following steps:

1. Retrieve App's Team ID / App Prefix

• Log in to your Apple Developer Portal, go to View Account < Account Summary, and obtain your app's Team ID / App Prefix.

2. Configure OneLink Subdomain & Link to App

• Log in to your AppsFlyer Account, go to the navigation menu, scroll down to Configure OneLink < iOS and tick Enable iOS 9 Universal Links for deep linking.
• Populate the Team ID / App Prefix (which you have retrieved in step 1). For pending apps, ensure to also provide the iOS App Bundle ID. For further information please visit AppsFlyer's OneLink Deep Linking Guide.
• Create your subdomain (in case you have yet to create one).
• Enter your deep linking scheme in the Deep linking Custom URL Scheme (iOS8/Android 5 and below) box:

3. Link your App to Approved Domains

• Go to your app and register the approved (associated) domains, by toggling the Enabled button, located next to Associated Domains:
  
  
  
  
• Add your subdomain xxx.onelink.me to the list of associated domains. Your list of approved domains will be displayed as follows:

• AppsFlyer hosts the Apple-App-Site-Association (AASA) file for the onelink.me subdomain on your behalf.

4. Enable AppsFlyer's SDK for Attribution & Deep Linking

The onAppOpenAttribution Method

AppsFlyer's onAppOpenAttribution SDK function parses data and returns it via a hashed object. However, when users are deep linked directly using Universal / App Links, the onAppOpenAttribution function returns the full link unparsed since the app opens directly without passing through AppsFlyer first.

The onAppOpenAttribution SDK function facilitates AppsFlyer in accessing the full re-engagement data for all user types. In order to do achieve that, follow the below guidelines:

• Integrate the continuteUserActivity and openURL methods in your app. ContinuteUserActivity and openURL are two ways of informing AppsFlyer's SDK of an app open. However, each method is applicable to specific (below-listed) iOS versions. Therefore, ensure you are utilizing both methods, as this enables Remerge to support you via both the Universal Link and Raw Custom Scheme deep linking protocols. (Code example for each method can be found in the Performing Deep Linking section of AppsFlyer's SDK Integration for iOS):
  
  
  • iOS Version 9 and/or Above - The continuteUserActivity method informs AppsFlyer's SDK of an app open via a Universal Link. 
  • iOS Version 10 and/or Above - The openURL method informs AppsFlyer's SDK of an app open via a Raw Custom Scheme.
    
    
• Make sure the onAppOpenAttribution function extracts all of the data from the parameters, and particularly speaking, from af_dp, in order to deep link the user to the right location within the app.

Below flow chart and the accompanying clarifications illustrate the deep linking process for iOS:

5. Submit the Updated App to the Appstore 

• Once the above-mentioned steps are completed, submit the app update to the Appstore. Please note: Your Onelink will ONLY work for users with the updated app version.

 

Marketer Guide

This part of the guide takes you through the process of iOS tracking link generation with AppsFlyer.

Prerequisites: Ensure that the selected fallback option is the iOS Appstore.

1. Enable In-App Retargeting 

• Log in to your AppsFlyer Account and select your app.
• Toggle ON Enable retargeting attribution. 
• Go to Minimum time between re-engagement conversions and select the None option, located at the bottom of the page. 
  
  

2. Locate & Activate Remerge 

• Go to the navigation menu, located on the left-hand corner of the dashboard, scroll down to Configuration, and select Integrated Partners.
  
  
  
  
• Find Remerge by entering it in the search field and click on its logo to open our configuration window, located on the Integration tab, and toggle ON Activate partner. Please note: Each partner integration (advertisers & agencies) requires an initial manual activation. The Activate partner toggle MUST remain ON at ALL TIMES (for a step-by-step guide and further information on the Integration tab please visit our Event Forwarding with AppsFlyer Guide).
• To also employ the View-Through Attribution methodology, remain on the Integration tab, scroll down to Re-engagement attribution, and toggle ON Re-engagement view-through attribution:

   

  

3. Generate your Remerge Attribution & Impression Links

Click on the Attribution Link tab, in order to create attribution links to be employed in your campaign with Remerge. Please note: You are merely utilizing a wizard that is designed to help you with URL creation, windows, and other aspects of your campaign setup. This means that AppsFlyer DOES NOT automatically save your generated attribution links. The below screen will be displayed upon clicking on the Attribution Link tab.   

 

• Add Parameters - The click attribution link consists of parameters. Said parameters provide you with the insight you may later utilize for the purpose of campaign analysis and marketing strategy. Adding parameters can be done in one of the following methods: 

1. Utilize our template - You may leave the fields (placeholders) blank. In turn, we will dynamically populate the parameters on your behalf and replace them with their actual values. 

2. Enter the parameters - You may enter the parameters manually while adhering to the below guidelines (you may replace predefined parameters with new parameters and/or values).

• For optimal integration, DO NOT edit the following parameters:
  
  

  af_ad={ad_name}

  af_ad_id={ad}

  af_adset={{Ad.Label.Name.Encode}}

  af_adset_id={{Ad.Label.Id}}
  
  

• DO NOT utilize af_sub5, as Remerge utilizes said parameter for internal debugging purposes. 

The following is a standardized list of parameters and values implemented in AppsFlyer's User Interface: 

&clickid={clickid}
&advertising_id={device_id_raw}
&c={campaign_name_raw}
&af_c_id={campaign}
&af_ad={ad_name}
&af_ad_id={ad}, &af_siteid={partner}
&af_sub_siteid={publisher}

• Set up Retargeting - Enable retargeting by toggling ON Retargeting Settings, as displayed below. Once retargeting is enabled, AppsFlyer automatically adds the is_retargeting=true tracking parameter to the target URL. Your Remerge tracking link is now a retargeting attribution link URL.

       

• Configure the OneLink by selecting the Use OneLink option, and picking your Remerge campaign OneLink, as displayed below. The OneLink changes the click tracking link from being app-specific to an OneLink URL. 
  
  
  
  
• Add deep linking information. Ideally, ensure to enter the raw deep link path to the exact product page in your app. If this is not possible, make sure to provide us with a raw deep link that opens your app. Entering the deep link data in the Deep Link URL box populates the af_dp= parameter in the tracking link found at the bottom of the page. As previously mentioned, we do recommend providing us with a path to the exact landing page, as it promotes a superior user experience. 
  
  
  
  
• You may add an inactivity window. Follow the below instructions should you choose to do so:
  
  
  • Activate the Ignore active user for retargeting option by toggling it ON.
    
    
    
    
  • Go to the Inactivity window option and set the slider to your preferred time frame (1-30 day range). 
    
    

The inactivity period parameter (in our specific example, af_inactivity_window=7d) is now appended to your final Remerge attribution tracking link, located at the bottom of the page.
 

That being said, In favor of maximizing scale and performance, we strongly advise leaving the Ignore active user for retargeting toggle turned OFF.

• Select your Re-Engagement Window - Set the post-re-engagement time frame in which a user's in-app events should be attributed to Remerge (values can range between 1-90 days, up to 23 hours, or a lifetime), as shown in the screenshot below. AppsFlyer populates the &af_reengagement_window=x tracking link parameter with your value of choice. 
  
  
  
  
• Select your Click-Through Lookback Window - Set the maximum time passing from a click to re-engagement, as shown below. AppsFlyer populates the &af_click_lookback=x tracking link parameter with your value of choice. For further information on AppsFlyer's Lookback Windows please visit the Lookback Window Configuration Page.
  
  

The final version of your Remerge Click Attribution Link should resemble the following structure:

• Select your View-Through Lookback Window, as displayed below, and reenter your preferred time frame. 
  
  
  
  
• Ensure your newly generated Impression Attribution Link includes the below parameter:
  

  &af_viewthrough_lookback=1d 

The final version of your Remerge Impression Attribution Link should resemble the following structure:

The pid=remerge_int is a Remerge-specific identifier, which lets AppsFlyer know the click is coming from Remerge. Ensure that the pid=remerge_int parameter is included in the tracking link prior to submitting your final attribution link to Remerge.

4. Share your Remerge Attribution Links with Remerge 

Upon completion of the above steps, and before going live, copy your newly generated tracking links from the bottom section of the attribution link generator and forward said links to your Remerge Account Manager. Please adhere to the below guidelines for error prevention purposes:

• Create your Tracking Links as per the above instructions ONLY (Integrated Partners > Remerge > Attribution Link) and DO NOT employ the below configuration option:
  
  
  
  
• Utilize the Universal Link path parameter (af_dp= parameter) to enable an app-open ONLY. Therefore, DO NOT append any additional data after the app-open parameter of your Universal Link path (e.g., after https://{client}.onelink.me/5r3b). Failing to comply with this request will result in a disruption of the attribution and click-tracking process.
• ALWAYS provide Remerge with the Long Link in case you have utilized AppsFlyer's custom link creation tool. For further information on Long / Short Links, visit AppsFlyer's Creating Links page.