ASA渠道使用指南

一、集成SDK

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

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
}

3).获取ASA渠道编号
同H5获取方式一样,通过方法getInstallParmsCompleted获取channelCode对应的值即可

二、获取ASA广告系列ID

登录ASA官方后台苹果ASA官方后台创建广告系列并获取ID

三、创建openinstall开发者平台ASA渠道

1.注册并登录openinstall开发者平台创建

2.填入获取到的ASA广告系列ID

此处可创建一个编号为1234567890的ASA渠道,用于上架前的测试,看文档后面第六点

四、App Store输入关键字搜索广告并下载安装激活应用

五、查看openinstall开发者平台ASA渠道数据统计

openinstall开发者平台渠道报表中对应的ASA渠道安装数据成功统计即为归因成功,将继续追踪统计用户后续事件行为

六、上架前验证集成情况

1.按照集成文档完成集成操作。

2.在openinstall控制台的【渠道管理】-【ASA渠道】中创建一个广告系列ID为1234567890的ASA渠道。

3.在【iOS集成】中,点击右上角的“在线测试”按钮,扫描测试二维码,下载安装应用并打开。

4.在【渠道报表】-【ASA渠道】中观察渠道编号为1234567890的ASA渠道,若统计到安装量表示ASA集成正确。