跳到主要内容

简介

提示

该功能仅支持 Android 平台。

前言​

为方便游戏对不同渠道进行区分的需求，XDSDK 内部进行了可配置的渠道分包功能，并添加了对今日头条广告包 SDK（以下简称 TT SDK）、腾讯广点通 SDK（以下简称 GDT SDK） 埋点功能进行了封装。

SDK 内部埋点说明​

内部埋点​

在 SDK 的帐户登录流程中会自动上报以下事件（通过 TT SDK、GDT SDK 上报）：

  • 登录
  • 注册
  • 设置用户唯一标识
  • 支付（通过 TapDB 进行广告渠道回传）

预设埋点​

除上述内部埋点之外，SDK 还提供了预置埋点提供游戏上报行为埋点：

  • 完成教学任务/副本
  • 升级
  • 查看内容/商品详情
  • 添加到购物车
  • 提交购买/下单
  • 添加支付渠道
  • 应用启动
  • 页面浏览
  • 咨询
  • 搜索
  • 评分
  • 分享
  • 申请
  • 领取卡券
  • 导航
  • 商品推荐
  • 添加账号

另外还可添加自定义埋点，详情请参考开发指南预定义事件说明。

分包说明​

XDSDK 内部会根据 XDConfig.json 文件中配置的 tapsdk -> db_config -> channel 的值进行 TapDB 初始化的 channel 值进行初始化， 在使用分包功能之后会优先将子包中的渠道信息作为 TapDB 初始化时的 channel 配置，用来满足游戏对不同渠道进行投放时的渠道区分（可在 TapDB 数据后台进行查看）。

普通分包​

目前公司的包管理系统 NPKG 上已经支持上传母包进行分包打出子包的功能，该功能需要申请 NPKG 上的权限。

  1. 申请 NPKG 分包权限（详情请联系 @明瑞锐），并提供打包时的 keystore 文件、alias、password、包名 信息；
  2. 在上传的母包检查窗口中选中广告渠道包的 Tab 栏，以 json 文件上传所需要的渠道子包信息（窗口有模版），点击申请按钮；
  3. 待子包打包完毕之后可下载子包即可。

第三方平台渠道分包​

提示

由于第三方平台的相关规定，若游戏需要在第三方平台进行广告投放，则需要「强制接入」第三方平台的分包 SDK。具体需求请与广告组联系。

  1. 将游戏包上传至 NPKG 使用普通分包的功能打出今日头条的母包；
  2. 将第三方渠道母包上传至对应的第三方平台广告管理后台进行渠道子包的分包。

通过 XDADs.getChannelName(Context context) 方法可获取到第三方分包 SDK 对应的子包渠道名称。

当前所支持的第三方平台有：

第三方渠道渠道缩写渠道分包官方文档
今日头条TThttps://bytedance.feishu.cn/docs/doccnWHO1ZOWn3YrZVblvoEw4th
腾讯广点通GDThttps://docs.qq.com/doc/DQkNBeVR4UmFNd2pO
快手KShttps://docs.qingque.cn/d/home/eZQD2frJ_lFAEq1dxZ4zcxIlF?identityId=1weidtLQshH

广告包埋点 SDK 说明​

今日头条广告包​

TT SDK 初始化所需要的参数：

  • appID
  • appName
  • channel (该参数会以分包功能最终获取到的渠道名称(channelName)为参数值)

appID、appName 参数需要在头条后台获取，具体值可联系投放部门。

腾讯广点通广告包​

GDT SDK 初始化所要的参数：

  • userActionSetID
  • appSecretKey

这两个参数需要登录腾讯 DMP 系统（MP广告主登录MP 系统 - 「人群管理」- 「高级拓展」进入 DMP），在「数据接入」页面创建 App 用户行为数据源。 行为数据源选择 ANDROID，并填写想用的应用 ID，输入源名称创建一个数据源。创建好数据源之后，则会看到 DMP 系统为 App 数据源分配的两个 ID，一个则为行为数据源 ID（userActionSetID）,另一个是 appSecretKey。

如果没有指定数据源上报数据并查看并且没有渠道号的需求，则这两个参数可不进行配置。

SDK 集成​

分包/广告包功能 SDK 的集成请参考接入指南介绍进行集成。