Hubspot ESP integration with AppsFlyer

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

   

1. Installation: Add the AppsFlyerURLResolver to your project Podfile:  pod'AppsFlyerURLResolver'.
2. Variable definition: Copy the code snippet below to your Xcode project

   var window: UIWindow?
   class AppDelegate: UIResponder, UIApplicationDelegate {
             var window: UIWindow? 
             varJSDeeplinkURL? // <<-- here we keep the hubspot link as a variable

3. Resolve click domains: To get campaign details, the SDK needs to resolve the OneLink behind the click domain. The details are returned in the onAppOpenAttribution method. 
   
   • Define the click domains in the SDK property resolveDeepLinkURLs using the code below. Make sure to set this property before SDK initialization. 
     

     [[AppsFlyerTracker sharedTracker].resolveDeepLinkURLs = @[@"click.example.com",@"click.example.com"]];

   • Add the following code so that the SDK can resolve the click recording domain:
     

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

4. Add the following code and define the domain that needs to be resolved, as highlighted in the following example:
   

   func application(_ application: UIApplication, continue userActivity: NSUserActivity,
   restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
      // This statement must include only the URL which will be resolved to JS script which inludes AppsFlyer URL
      
               if (userActivity.webpageURL?.absoluteString.contains(“click.example.com”) == true) {
         // This line will trigger URLResolver
         JSDeeplink = userActivity.webpageURL
      } else {
        // This is regular ESP links without JS resolving
       AppsFlyerLib.shared().continue(userActivity, restorationHandler: nil)
     }
     return true
    }
   

5. To resolve the Hubspot URL, copy the code below:
   

   func applicationDidBecomeActive(_ application: UIApplication) {
      if let deeplink = JSDeeplink {
         JSDeeplink = nil
         URLResolver(isDebug: false).resolveJSRedirection(url: deeplink.absoluteString) { resolveURLStr in
      if let resolveURLStr = resolveURLStr,
     
               let resolveURL = URL(string: resolveURLStr) {
         AppsFlyerLib.shared().handleOpen(resolveURL, options: nil)
        }
        AppsFlyerLib.shared().start()
       }
      } else {
        AppsFlyerLib.shared().start()
       }
      }

For Hubspot to support iOS Universal Links, an AASA file is required. The AASA file is automatically created and associated with OneLink when setting up OneLink with Universal Links. To obtain the AASA file and upload it to Hubspot:

1. Under Experiences & Deep Linking in AppsFlyer, go to OneLink Management and find a OneLink link that's configured with Universal Links.
2. Add /.well-known/apple-app-site-association to the end of the OneLink URL.
3. Paste the OneLink link into your browser address bar and press Enter. For example, <OneLinkSubdomain>.onelink.me/.well-known/apple-app-site-association.
   The AASA file is downloaded to your computer and you can open it using any text editor.
4. Upload the AASA file to Hubspot according to these guidelines.
   After uploading the AASA file, it appears under Files and folders:  
   

   

Traffic from your domain that requires using an AASA file will be redirected to the Hubspot platform, where the file is located. The link address will include <yourdomain>/hubfs/….

To set up URL redirections, read here. 

• The following example shows the URL redirection setup:
  

  

• The following example shows a completed URL redirect:
  

  

For more information on setting up Hubspot, reach out to Hubspot support via the Hubsport platform.