设置归因回传

针对 Adobe Experience SDK 的 Adjust iOS Extension 发送的安装数据为 Adjust 所接收后，设备就会被归因至安装来源。如果针对用户进行了再营销，或用户与其他推广活动进行了交互，那么该归因信息就可能会发生变化。

您可以配置回传函数来响应归因变更。Adjust 收到新的归因信息后，会异步将数据发送回设备。回传函数会以参数形式接收设备的归因数据。

请参阅 Adjust 的归因数据政策，进一步了解归因数据。

参考

要设置回传函数以监听归因变化，请使用以下参数调用 AdjustAdobeExtensionConfig 实例的 setAttributionChangedBlock 方法：

attributionChangedBlock: OnAttributionChangedListener: 该函数会返回 void，并以序列化归因对象的形式接收设备归因信息。

教程：创建归因回传

要配置归因回传，您需要创建一个函数，并将其指定给 AdjustAdobeExtensionConfig 实例。参阅本教程，您将以集成指南中的 App Delegate 为基础，创建一个补全函数，并通过该函数将用户的归因信息以字符串形式输出，记录在日志中。最终结果将如下：

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

您需要进行下列操作：

在 App Delegate 中找到您的 AdjustAdobeExtensionConfig 实例。在下一行中，以函数块为参数，调用 setAttributionChangedBlock 方法。该函数块会接收归因信息。

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];

在函数块中，将归因描述输出至 Xcode 记录器。

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];

完成了！用户归因信息发生变更时，回传函数会将更新后的归因信息写入系统日志。