ASA渠道联调

本文档面向的客户为：在 Xinstall 管理后台建立 [ ASA 渠道 ] 并需要进行统计的客户，是在原有的 iOS 集成基础上进行的额外集成工作。

若您不使用 [ ASA 渠道 ] 功能，则无需进行该文档中的额外集成工作，也能正常使用 Xinstall 提供的其他功能。

注意：在 iOS 端使用 [ ASA 渠道 ] 功能时，请确保 iOS SDK 版本号 >= 1.5.4，否则将无法支持该功能。（使用第三方 SDK 集成时，同样需要 SDK 版本号 >= 1.5.4）

一、完成基础 iOS 集成

根据《iOS集成》文档完成基础 iOS 集成工作。

二、初始化

由于 ASA 功能最低支持 iOS 版本为 14.3，使用 AdServices 框架进行获取关键的 ASA Token ，而该框架只在 Xcode 13.0 及以上版本内提供，故强烈建议使用 Xcode 13.0 以上的版本进行开发！

否则开发的 App 将无法在 iOS 14.3 及以上版本正常获取 ASA Token ，进而影响 [ ASA 渠道 ] 的统计效果。

在 Xinstall SDK 进行初始化的文件中，按照如下代码引入 AdServices 框架：

Objective-C

Swift

#if __has_include(<AdServices/AAAttribution.h>)
    #import <AdServices/AAAttribution.h>
#endif

#if canImport(AdServices)
    import AdServices
#endif

使用新的初始化方法进行 SDK 的初始化：

基础集成工作中的 [XinstallSDK initWithDelegate:self] 不需要再调用了，[XinstallSDK initWithDelegate:self idfa:idfa] 也不需要再调用了，请使用以下最新的方法进行初始化

Objective-C

Swift

#if __has_include(<AdServices/AAAttribution.h>)
    if (@available(iOS 14.3, *)) {
        NSError *error;
        NSString *asaToken = [AAAttribution attributionTokenWithError:&error];
        [XinstallSDK initWithDelegate:self idfa:nil asaToken:asaToken];
    } else {
        [XinstallSDK initWithDelegate:self];
    }
#else
    [XinstallSDK initWithDelegate:self];
#endif

#if canImport(AdServices)
    if #available(iOS 14.3, *) {
        do {
            let asaToken = try AAAttribution.attributionToken();
            XinstallSDK.initWith(self, idfa: nil, asaToken: asaToken)
        } catch {}
    } else {
        XinstallSDK.initWith(self)
    }
#else
    XinstallSDK.initWith(self)
#endif