广告平台渠道 iOS 集成指南

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

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

注意：根据目前已有的各大主流广告平台的统计方式，目前 iOS 端需要用户授权获取 IDFA 后才能正常进行 [ 广告平台渠道 ] 的统计，对该行为敏感的 App 请慎重进行该文档中说明的集成工作。

一、完成基础 iOS 集成

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

二、配置获取 IDFA 的声明

请求 IDFA 的权限与「获取相册访问」「获取定位」等的权限类似，也需要在 Info.plist 文件中配置一个权限作用声明，否则将导致 App 启动后马上闪退。配置项如下：

<key>NSUserTrackingUsageDescription</key>
<string>这里是针对获取 IDFA 的作用描述，请根据实际情况填写</string>

三、初始化

由于 Apple 从 iOS 14.5 开始，强制要求使用 AppTrackingTransparency 框架获取用户对 IDFA 的授权许可，而该框架只在 Xcode 12.0 及以上版本内提供，故强烈建议使用 Xcode 12.0 以上的版本进行开发！

否则开发的 App 将无法在 iOS 14.5 及以上版本正常获取 IDFA ，进而影响 [ 广告平台渠道 ] 的统计效果。

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

Objective-C

Swift

#import <AdSupport/AdSupport.h>
#if __has_include(<AppTrackingTransparency/AppTrackingTransparency.h>)
#import <AppTrackingTransparency/AppTrackingTransparency.h>
#endif

import AdSupport
#if canImport(AppTrackingTransparency)
import AppTrackingTransparency
#endif

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

基础集成工作中的 [XinstallSDK initWithDelegate:self] 不需要再调用了

Objective-C

Swift

#if __has_include(<AppTrackingTransparency/AppTrackingTransparency.h>)
    if (@available(iOS 14, *)) {
        [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
            NSString *idfa = ASIdentifierManager.sharedManager.advertisingIdentifier.UUIDString;
            [XinstallSDK initWithDelegate:self idfa:idfa];
        }];
    } else {
        NSString *idfa = ASIdentifierManager.sharedManager.advertisingIdentifier.UUIDString;
        [XinstallSDK initWithDelegate:self idfa:idfa];
    }
#else
    NSString *idfa = ASIdentifierManager.sharedManager.advertisingIdentifier.UUIDString;
    [XinstallSDK initWithDelegate:self idfa:idfa];
#endif

#if canImport(AppTrackingTransparency)
    if #available(iOS 14.0, *) {
        ATTrackingManager.requestTrackingAuthorization { status in
            let idfa = ASIdentifierManager.shared().advertisingIdentifier.uuidString;
            XinstallSDK.initWith(self, idfa: idfa);
        }
    } else {
        let idfa = ASIdentifierManager.shared().advertisingIdentifier.uuidString;
        XinstallSDK.initWith(self, idfa: idfa);
    }
#else
    let idfa = ASIdentifierManager.shared().advertisingIdentifier.uuidString;
    XinstallSDK.initWith(self, idfa: idfa);
#endif