Android iOS Unity JS API Media API 常见问题

腾讯优量汇数据上报集成版 Android SDK 接入文档

概述

集成版SDK同时提供优量汇广告变现能力、用户转化归因和用户行为数据上报能力。本文档旨在帮助应用开发者在程序中快速植入腾讯优量汇开发者平台提供的广告,并对后项的变现与增长数据进行分析。作为应用开发者,您只需要进行简单配置,就可以在您的应用中显示定制的广告,并进行相应的数据上报和分析。
关于 SDK 的具体使用方法,请仔细阅读下面的文档。

前期内测阶段,开发者需申请白名单,才可使用数据上报集成版SDK。白名单申请请联系您的运营经理。

接入指引

开发环境

确保您的开发及部署环境符合以下标准:

注册开户

开发者需在腾讯优量汇开发者平台上进行注册,在平台审核通过后,开发者就成为了腾讯优量汇的正式会员。

前置条件

接入集成版SDK时,需拔除已接入的转化SDK,否则会报错。

用户转化归因数据接入指引

转化归因功能指的是将广告产生的后续效果(例如:购买,下载,安装等)匹配到具体广告上的过程。是广告主查看报表、投放oCPA广告、优化广告效果所依赖的重要功能。

提醒

转化SDK上报的商品APPID和变现上报的APPID不相同,请保证ID上报正确性。
为了保障投放效果,游戏行业客户请务必上报下列行为:
转化行为 行为类型(action_type) 说明
激活 传入SDK时使用START_APP,SDK会自动识别是启动还是激活 30天内第一次打开APP
购买(付费) PURCHASE 用户完成内购付费时上报,需要上报金额
应用启动 START_APP 用户启动APP


广告主开发者需要在APP启动时上报APP启动行为,SDK会自主判断这次行为是激活行为、次留行为还是启动行为。

使用示例

1.首先需要初始化转化归因 SDK,推荐在Application中运行

@Override
public void onCreate() {
    GDTAction.init(this, "数据源 ID", "密钥 secretKey");
}

2.调用接口,进行事件上报。

public void test() {
    // 上报启动
    GDTAction.logAction(ActionType.START_APP);
    // 上报购买(付费)
    ActionUtils.onPurchase("商品类型如装备、皮肤", "商品名称", "商品标识符", 1, false, "虚拟货币类型", "真实货币类型", true);
}

用户行为数据接入指引

标准化事件

用户行为事件指用户在应用内产生的行为,针对行为事件上报,通过SDK需要上报3个字段:事件标识、字段标识、字段值。

描述 类型 是否必填 限制 样例
事件名称 事件名称 string 用户在开发者平台新建事件时必填;SDK无需上报 30个字符串以内 事件名A
事件标识 用来标识需要上报的事件,SDK上报时以该标识为准 string 必填 仅支持数字/字母/下划线 your_event_id
字段名称 用于事件上报的附属字段 string 用户在开发者平台新建事件时必填;SDK无需上报 100个字符串以内 事件附属字段名称A
字段标识 用于事件上报的附属字段标识,可通过代码识别对应数据 string 选填 仅支持数字/字母/下划线;每个事件最多可建10个字段标识 max_lev
字段值 用户自定义上报 string 选填 如果字段标识和字段值非空,需要可以序列化成jsonString,且总长度不能超过10KB 100

优量汇提供标准化行为事件供开发者选择上报。标准化事件的事件名称/事件标识和字段名称/字段标识都是固定的,不可修改,开发者参考标准化事件列表上报即可,字段值可自定义上报;

自定义事件

开发者可在腾讯优量汇开发者平台自定义事件:数据中心--事件数据--行为事件管理。开发者自定义事件后,可按自定义事件上报数据,并在事件分析报表查看。

点击新建事件,可自定义事件。

主要API

public class GDTDetectEvent {
    /**
     * 事件类构造方法,传入一个事件名,唯一标识该事件,该标识不能为 null 或者空字符串
     * {@link GDTDetectEventName} 类中预定义了一些事件名,带有前缀"gt_"的事件为预定义事件,用户自定义事件时不可占用
     */
    public GDTDetectEvent(String eventCode);

    /**
     * 向事件中添加参数
     * 注意事项:
     * 1. 这些参数最后会转换为 json 字符串,json 字符串总长度不能超过 10K。
     * 2. 如果 value 是自定义类型,请务必重写 {@link Object#toString()} 方法,否则会是”类名+哈希值“。
     */ 
    public void put(String key, Object value);
}

public class GDTDataDetector {
    /**
     * 上报事件
     */
    public void report(GDTDetectEvent event);
}

使用示例

1.首先需要初始化 SDK 注册流量侧的 AppId 信息,推荐在Application中运行

@Override
public void onCreate() {
    GDTAdSdk.init(this, appId);
}

2.调用DataDetector接口,进行事件上报。

public void test() {
    // 定义事件
    GDTDetectEvent event = new GDTDetectEvent(eventName);
    // 事件中添加参数
    event.put("key", "value");
    // 上报
    GDTDataDetector.getInstance().report(event);
}

事件分析报表

开发者上报了标准化事件或自定义事件数据后,即可在腾讯优量汇开发者平台查看相应的事件数据统计。数据中心--事件数据--事件分析报表

事件分析报表

Copyright © 1998 - 2020 Tencent Inc. All Rights Reserved.
腾讯公司 版权所有 | 加入优量汇