Iterable integration with AppsFlyer

For Iterable to support iOS Universal Links, they need an AASA file. See the following instructions.

When you set up OneLink with Universal Links, you already have an AASA associated with the OneLink. To obtain the AASA:

1. Go to OneLink templates and find a OneLink that is configured with Universal Links.
2. Add /.well-known/apple-app-site-association to the end of the OneLink URL.
3. Paste the OneLink in the browser address bar and hit enter. For example: <OneLinkSubdomain>.onelink.me/.well-known/apple-app-site-association. When you do so, the AASA file is downloaded to your computer. You can open it using any simple text editor.
4. Define link re-write rules. For more information see here.
5. Send this AASA file to Iterable. For more information and to learn more about the contents of this file, see Iterable's guide.

When you set up OneLink with App Links, you already have an Asset Links file associated with the OneLink. To obtain the Asset Links file:

1. Go to OneLink templates and find a OneLink that is configured with App Links.
2. Add /.well-known/assetlinks.json to the end of the OneLink URL.
3. Paste the OneLink in browser address bar and hit enter. For example:<OneLinkSubdomain>.onelink.me/.well-known/assetlinks.json. When you do so, the Asset Links file is downloaded to your computer. You can open it using any simple text editor.
4. Send this Asset Links file to Iterable. For more information and to learn more about the contents of this file, see Iterable's guide.

Step 1: Adding the click domain to the activity in the Android manifest

In the Android manifest, add the click domain host and any prefix in the activity tag of the activity you want to deep link into.

<activity android:name=".DeepLinkActivity">
    <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="https"
               android:host="click.example.com"
               android:pathPrefix="/campaign" />
     </intent-filter>
</activity>

Step 2: Setting up the app to resolve click domains

The SDK needs to resolve the OneLink behind the click domain to get the campaign details. The details are returned in the onAppOpenAttribution method.

To resolve click domains:

1. Make sure that your SDK version is at least 4.9.0.
2. List the click domains in the SDK API setResolveDeepLinkURLs. This API needs to be called before SDK initialization. For more information, see the SDK documentation here.
    

   AppsFlyerLib.getInstance().setResolveDeepLinkURLs("click.example.com");

This section discusses how to set up your app to support Universal Links.

Step 1: Associating click domains in Xcode

1. In Xcode, click on your project.
2. Click on Capabilities.
3. Turn Associated Domains on.
4. Click the + sign and add your click domain. For example, applinks:click.example.com.

The SDK needs to resolve the OneLink behind the click domain to get the campaign details. The details are returned in the onAppOpenAttribution method.

To resolve click domains:

1. Make sure that your SDK version is at least 4.9.0.
2. List the click domains in the SDK property resolveDeepLinkURLs. This property needs to be set before SDK initialization. For more information, see the SDK documentation here.
    

   AppsFlyerLib.getInstance().setResolveDeepLinkURLs("clickdomain.com", "myclickdomain.com", "anotherclickdomain.com");
   

The SDK needs to resolve the OneLink behind the click domain to get the campaign details. The details are returned in the onAppOpenAttribution method.

To resolve click domains:

1. Make sure that your SDK version is at least 4.9.0.
2. List the click domains in the SDK property resolveDeepLinkURLs. This property needs to be set before SDK initialization. For more information, see the SDK documentation here.
    
   Objective-C Swift

   [AppsFlyerLib shared].resolveDeepLinkURLs = @[@"example.com",@"click.example.com"];

   AppsFlyerLib.shared().resolveDeepLinkURLs = ["example.com", "click.example.com"]
   

3. Add the following code so that the SDK can resolve the click recording domain:
    
   Objective-C Swift

   Add this code in AppDelgate.m

   - (NSDictionary *)allHTTPHeaderFieldsForResolveDeepLinkURL:(NSURL *)URL {
       if ([URL.host  isEqual: @"click.example.com"]) {
           return [NSDictionary dictionary];
       }
       else {
           return nil;
       }
   }

   Add this code in AppDelgate.swift

   func allHTTPHeaderFields(forResolveDeepLinkURL URL: URL!) -> [String : String]! {
       if (URL.host == "click.example.com") {
           /// Change User-Agent
           return [:]
       } else {
           return nil;
       }
   }