Set up an attribution callback

When Adjust receives install data from the Adjust iOS Extension for Adobe Experience SDK, the device is attributed to the source of the install. This attribution information can change if the user is retargeted or interacts with another campaign.

You can configure a callback function to respond to attribution changes. When Adjust receives new attribution information, it sends the data asynchronously back to the device. The callback function receives the device's attribution data as an argument.

Read Adjust's attribution data policies for more information about attribution data.

Reference

To set a callback function to listen for attribution changes, call the setAttributionChangedBlock method of your AdjustAdobeExtensionConfig instance with the following argument:

attributionChangedBlock: OnAttributionChangedListener: A function that returnsvoidand receives device attribution information as a serialized attribution object.

Tutorial: Create an attribution callback

To configure an attribution callback, you need to create a function and assign it to your AdjustAdobeExtensionConfig instance. In this tutorial, you'll build on the App Delegate from the integration guide and create a completion function that outputs the user's attribution information to logs as a string. The final result looks like this:

Swift
Objective-C

1
import UIKit
2
import AEPCore
3
import AEPServices
4
import AdjustAdobeExtension
5

6
@main
7
class AppDelegate: UIResponder, UIApplicationDelegate {
8

9
   func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
10
      MobileCore.setLogLevel(LogLevel.trace)
11
      let appState = application.applicationState
12

13
      if let config = AdjustAdobeExtensionConfig(environment: ADJEnvironmentSandbox) {
14
        config.setAttributionChangedBlock({ attribution in
15
            print("Adjust Attribution Callback received: [\(attribution.description)]")
16
        })
17
         AdjustAdobeExtension.setConfiguration(config)
18
      }
19

20
      MobileCore.registerExtensions([AdjustAdobeExtension.self]) {
21
         MobileCore.configureWith(appId: "{your_adobe_app_id}")
22
         if appState != .background {
23
               MobileCore.lifecycleStart(additionalContextData: nil)
24
         }
25
      }
26
      return true
27
   }
28

29
    func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
30
        if let deeplink = ADJDeeplink(deeplink: url) {
31
            Adjust.processDeeplink(deeplink)
32
        }
33
        return true
34
    }
35

36
    func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
37
        if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
38
            if let incomingUrl = userActivity.webpageUrl {
39
                if let deeplink = ADJDeeplink(deeplink: incomingUrl) {
40
                    Adjust.processDeeplink(deeplink)
41
                }
42
            }
43
        }
44
        return true
45
    }
46
}

1
#import "AppDelegate.h"
2
@import AEPCore;
3
@import AEPServices;
4
#import <AdjustAdobeExtension/AdjustAdobeExtension.h>
5

6
@implementation AppDelegate
7

8
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
9
    [AEPMobileCore setLogLevel: AEPLogLevelTrace];
10
    const UIApplicationState appState = application.applicationState;
11

12
    // Adjust Adobe Extension configuration
13
    AdjustAdobeExtensionConfig *config = [AdjustAdobeExtensionConfig configWithEnvironment:ADJEnvironmentSandbox];
14
    [config setAttributionChangedBlock:^(ADJAttribution * _Nullable attribution) {
15
        NSLog(@"Adjust Attribution Callback received:[%@]", attribution.description);
16
    }];
17
    [AdjustAdobeExtension setConfiguration:config];
18

19
    [AEPMobileCore registerExtensions:@[AdjustAdobeExtension.class]
20
                           completion:^{
21
        [AEPMobileCore configureWithAppId: @"{your_adobe_app_id}"];
22

23
        if (appState != UIApplicationStateBackground) {
24
            [AEPMobileCore lifecycleStart:nil];
25
        }
26
    }];
27

28
    return YES;
29
}
30

31
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
32
   [Adjust processDeeplink: [[ADJDeeplink alloc] initWithDeeplink:url]];
33
   return YES;
34
}
35

36
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
37
   if ([[userActivity activityType] isEqualToString:NSUserActivityTypeBrowsingWeb]) {
38
     [Adjust proceessDeeplink:[[ADJDeeplink alloc] initWithDeeplink:[userActivity webpageURL]]];
39
   }
40
   return YES;
41
}
42
@end

Here's what you need to do:

Inside your App Delegate, find your AdjustAdobeExtensionConfig instantiation. On the next line, call the setAttributionChangedBlock method with a function block as an argument. This function block receives the attribution information.

Swift
Objective-C

13
if let config = AdjustAdobeExtensionConfig(environment: ADJEnvironmentSandbox) {
14
    config.setAttributionChangedBlock({ attribution in })
15
    AdjustAdobeExtension.setConfiguration(config)
16
}

14
AdjustAdobeExtensionConfig *config = [AdjustAdobeExtensionConfig configWithEnvironment:ADJEnvironmentSandbox];
15
[config setAttributionChangedBlock:^(ADJAttribution * _Nullable attribution) {}];
16
[AdjustAdobeExtension setConfiguration:config];

Inside the function block, output the attribution description to the Xcode logger.

Swift
Objective-C

13
if let config = AdjustAdobeExtensionConfig(environment: ADJEnvironmentSandbox) {
14
    config.setAttributionChangedBlock({ attribution in
15
         print("Adjust Attribution Callback received: [\(attribution.description)]")
16
    })
17
    AdjustAdobeExtension.setConfiguration(config)
18
}

14
AdjustAdobeExtensionConfig *config = [AdjustAdobeExtensionConfig configWithEnvironment:ADJEnvironmentSandbox];
15
[config setAttributionChangedBlock:^(ADJAttribution * _Nullable attribution) {
16
     NSLog(@"Adjust Attribution Callback received:[%@]", attribution.description);
17
}];
18
[AdjustAdobeExtension setConfiguration:config];

That's it! When a user's attribution information changes, this callback function writes out the updated attribution information to the system log.