ASA渠道使用指南

一、集成SDK

注意：此文档是针对使用了渠道统计功能中的 ASA渠道报表统计功能而提供的补充性文档
SDK版本要求：SDK>=2.5.4，CocoaPods上对应版本：>=2.5.4.1，工具Xcode>=12.3

1.首次集成SDK的，先按照iOS集成指南或者后台【应用集成】->【iOS集成】文档集成完毕，使用ASA渠道时，初始化代码要做调整，参考以下文档

2.代码集成
1).引入头文件

Object-C

Swift

#import <AdServices/AAAttribution.h>

import AdServices

2).调用初始化，传入相关参数
注意：如果之前集成了openinstall SDK的用户，需要将之前的初始化方法替换掉，否则会导致统计失败

Object-C

Swift

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{

    [self opInit];
/*//同时使用了广告平台渠道统计和ASA渠道统计的代码示例
    if (@available(iOS 14, *)) {
        //权限申请
        [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
            [self opInit];
        }];
    }else{
        [self opInit];
    }
*/
}
- (void)opInit{
    //ASA广告归因
    NSMutableDictionary *config = [[NSMutableDictionary alloc]init];
    if (@available(iOS 14.3, *)) {
        NSError *error;
        NSString *token = [AAAttribution attributionTokenWithError:&error];
        [config setValue:token forKey:OP_ASA_Token];
    }
    /*//第三方广告平台统计代码
    NSString *idfaStr = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
    [config setValue:idfaStr forKey:OP_Idfa_Id];
    */
    [OpenInstallSDK initWithDelegate:self adsAttribution:config];
}

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    opInit();
/*//同时使用了广告平台渠道统计和ASA渠道统计的代码示例
    if #available(iOS 14.0, *) {
        //权限申请
        ATTrackingManager.requestTrackingAuthorization { (status) in
            opInit();
        }
    }else{
        opInit();
    }
*/
     func opInit(){
         //ASA广告归因
         var OpConfig:[String:Any] = [String:Any]();
         if #available(iOS 14.3, *) {
             do {
                 let token = try AAAttribution.attributionToken();
                 OpConfig.updateValue(token, forKey: OP_ASA_Token);
             } catch {}
         }
         /*//第三方广告平台统计代码
         let idfaStr = ASIdentifierManager.shared().advertisingIdentifier.uuidString
         OpConfig.updateValue(token, forKey: OP_Idfa_Id);
         */
         OpenInstallSDK.defaultManager()?.reportAdsAttribution(OpConfig);
     }
    //其它代码...
    return true
}