集成版 SDK 转化归因数据接入使用说明文档

导入SDK

使用 SDK 前请联系运营人员获取：行为数据源ID（UserActionSetID）和 AppSecretKey。

在具体代码引入的地方将对应接口import进来。目前SDK最低支持系统版本号为iOS 9.0

#import 'GDTAction.h'
#import 'GDTAction_convenience.h'

SDK初始化

找到您的App的入口（AppDelegate.m）并导入头文件，并在didFinishLaunchingWithOptions方法中调用[GDTAction init] 方法，这样就完成了初始化SDK的工作。SDK初始化完成之后，可以在在applicationDidBecomeActive方法中调用logAction:StartApp上报应用启动行为。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    /*
     * 在接入优量汇行为数据SDK时，请在App启动的时候调用初始化方法
     * 初始化方法调用时请传入数据源UserActionSetId和在后台看到的secretKey密钥串
     */
    [GDTAction init:@"yourActionSetId" secretKey:@"yourSecretKey"];

    return YES;
}

- (void)applicationDidBecomeActive:(UIApplication *)application {

    /*
     * 在应用启动的时候请上报GDTSDKActionNameStartApp行为
     * SDK内部会判断此次启动行为是否为激活行为并上报，开发者无需另外作判断逻辑
     */
    [GDTAction logAction:GDTSDKActionNameStartApp actionParam:@{@"value":@(123)}];
}

-(BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
    /*
     * 在应用被呼起的时候请上报GDTSDKActionNameStartApp行为，并带上呼起的openURL链接
     * 
     */
    [GDTAction logAction:GDTSDKActionNameStartApp actionParam:@{GDTSDKActionParamKeyOpenUrl:url.absoluteString}];
    return true;    
}

上报转化行为数据

在App内发生转化行为时，可以调用通用上报接口或专用上报接口上报行为数据。

// 用户发生购物行为时，可以用[GDTAction logAction]上报用户的这次行为，并将价格（整型值，单位分）等行为参数一起带上
[GDTAction logAction:GDTSDKActionNameCompleteOrder actionParam:@{@"product_id":@(12345),@"value":@(12800)}];

关于行为类型名字（actionName）和行为参数（actionParam）的类型，在通用上报API这一章节有详细说明。

在1.1.0版本中，增加了一系列专用上报接口，每个接口预定义了若干个行为参数，这些接口中的行为类型与上面的行为名有些是共用的，建议优先考虑使用专用接口，若专用接口无法满足上报需求，则考虑使用通用接口上报。

通用上报API

• GDTAction

• ActionName

当前版本我们支持如下的标准行为类型，除了这些行为以外，如果您需要上报自定义行为，可以给logAction:(NSString *)actionName方法的actionName参数传入自定义的字符串。

• ActionParam

  1. 广告主在调用上报StartApp行为时，SDK会自主判断此次行为是否为激活行为。若广告主需要自主控制上报激活启动行为时，可以在ActionParam中设置GDTSDKActionParamKeyAudienceType的Key，Value为GDTActionParamAudienceType_UsedAudience。当带有该标示的启动行为上报时我们会默认此次行为为老客户的应用启动行为。
  2. 广告主在上报时需要做自定义去重时可以在ActionParam中设置GDTSDKActionParamKeyOuterActionId的Key，value为任意自定义如订单号的字符串作为自定义去重id，系统会根据该id进行去重。
  3. 当用户需要指定上报用户次日留存指标时，可以在上报StartApp时，加上length_of_stay的参数，值为1，系统会指定该次上报为留存数据。

专用上报API

• GDTAction+convenience.h