Deferred deep link tracking

The Hive SDK passes the deep link event to attribution when the app is launched via a deep link.

The current deferred deep link tracking feature is only supported by Airbridge attribution.

Tracking deferred deep link with Airbridge¶

This explains how to set up deferred deep links and create tracking links in Android and iOS environments.

Setting up Android deferred deep link¶

1. Register the necessary information for the deep link in [Tracking Links] > [Deep Links] on the Airbridge dashboard. For instructions on how to register, please refer to Setting Up Airbridge Deep Links.

2. When setting up Airbridge tracking deep links, the Android URI scheme should be set to match the Android package name. Add the Intent Filter for deep link handling in AndroidManifest.xml as shown below. In the code, YOUR_APP_NAME refers to the Airbridge app name. The app name can be found in Airbridge dashboard settings > Airbridge app settings > App name.

   <activity ...>
           ...
           <intent-filter android:autoVerify="true">
                   <action android:name="android.intent.action.VIEW" />
   
                   <category android:name="android.intent.category.DEFAULT" />
                   <category android:name="android.intent.category.BROWSABLE" />
   
                   <data android:scheme="http" android:host="YOUR_APP_NAME.abr.ge" />
                   <data android:scheme="https" android:host="YOUR_APP_NAME.abr.ge" />
           </intent-filter>
           <intent-filter android:autoVerify="true">
                   <action android:name="android.intent.action.VIEW" />
   
                   <category android:name="android.intent.category.DEFAULT" />
                   <category android:name="android.intent.category.BROWSABLE" />
   
                   <data android:scheme="http" android:host="YOUR_APP_NAME.airbridge.io" />
                   <data android:scheme="https" android:host="YOUR_APP_NAME.airbridge.io" />
           </intent-filter>
           ...
   </activity>
   

iOS deferred deep link setup¶

1. Register the information needed for the deep link in [Tracking Links]>[Deep Link] on the Airbridge dashboard. For instructions on how to register, please refer to Setting Up Airbridge Deep Links.

2. When setting up Airbridge tracking deep links, the iOS URI scheme should be set to be the same as the iOS Bundle ID. The iOS app ID follows the format 'App ID Prefix + . + Bundle ID'. For example, if the App ID Prefix is prefix and the Bundle ID is example, then the iOS app ID will be prefix.example.

3. In the Xcode project > Signing & Capabilities > Associated Domains, add applinks:YOUR_APP_NAME.airbridge.io and applinks:YOUR_APP_NAME.abr.ge. YOUR_APP_NAME is the name of the Airbridge app.
   You can check the app name in Airbridge Dashboard > Settings > Airbridge App Settings > App Name.

Tracking link creation¶

1. To track deferred deep links, you need to set the deep link URL according to the Scheme URL notation used by Hive.
   • If you set {host} to Hive in the URL, refer to the Hive SDK's operations based on {host} in the User Engagement > Common Fields section.
   • If you set {host} to game in the URL, the necessary information for the game is passed through EngagementListener in the form of EngagementEventType.EVENT and JSONObject. For callback declaration and registration methods, refer to the User Engagement Global Callback Declaration and Registration section.
2. After creating the tracking link, refer to Testing Airbridge Deep Links for how to test deferred deep links.