菜单

引力：安卓接入配置全流程指引

本文主要用户安卓类app使用引力的通用流程指引，包括

投前准备：

应用创建及事件埋点接入

SDK接入、验证及发布

基础配置

运营：应用分场景配置&归因回传配置

投放：分媒体投放配置

一、投前准备

（一）通用接入流程

1.流程总览

1.1 创建应用

1.1.1 必填字段说明

类目	是否必填	说明
产品类型	必填	原生应用--Android
应用名称	必填	您的游戏名称，示例：XX游戏-巨量、XX游戏-tap
包名	必填	您的游戏包名，格式com.xxxx.xxxx 相同产品类型下校验包名唯一性，比如安卓只允许一个com.123.123
子包名	选填	若您的产品有多个包名，希望不同包名下用户在同一个应用下
行业	投放oppo必填	仅影响oppo买量，不同行业回传字段不一致
产品图标	选填	手动上传最大支持1024*1024、1M以内的1:1的jpg/png格式文件。
备注	选填

1.1.2 重要参数复制

快速复制所有需要参数，确保技术接入传参正确，其中：

access token：每个引力应用的唯一app access token，请与其他access token区分

1.2 埋点方案梳理

针对安卓应用的埋点方案可基于不同游戏类型划分为不同的埋点方案，事件类型主要分为以下两种

事件类型	事件说明	事件特征	示例
预置事件&属性	用户常用基础事件&属性通常需要给媒体回传，且带有部分引力预置计算的事件及属性	无需额外创建即可上报带$符号的	事件名：用户付费($PayEvent）属性1：订单ID($order_id) 属性2：支付金额(分)($pay_amount) 属性3：支付项目($pay_reason) ……
自定义事件及属性	广告主希望自上报的事件&属性通常用于产品数据分析，或者给媒体的自定义回传	需要先创建后上报不带$符号	事件名：防御升级(TowerUpgrade) 属性1：防御类型(tower_type) 属性2：防御塔唯一ID(tower_id) 属性3：新等级(new_level) 属性4：消耗金币(cost_coins)

1.3 SDK集成

本文只提供AndroidSDK接入流程，API上报&其他接入&接口信息请查阅：引力引擎技术文档中心

⚠️引力引擎Android SDK并不集成任何媒体Android SDK，如需接入，请自行跟媒体对接SDK接入及联调。

Android app当前支持的开发框架如下：

接入步骤	包含内容	SDK下载地址	接入文档
快速集成	Android原生SDK	Android下载地址	*Android接入文档*
快速集成	unity SDK	unity 下载地址	unity接入文档

1.4 事件上报

接入注意事项参考如下

接入步骤	包含内容	常见接入问题
快速集成	获取引力应用access token 集成引力引擎SDK配置并启动用户初始化注册、付费、广告、提现等事件上报上报验证	通用错误码： 0：请求成功，是否入库还需要进一步通过debug验证或者线上入库的验证 2001：SDK配置报错，通常为应用token用错，或者状态异常错误码 2000：初始化或者事件上报时报错，通常为用户没有初始化或者传入clientid错误 1004：必填参数缺失，或者参数类型错误
行为事件上报	元事件&事件属性上报公共事件属性上报
用户属性上报	9种常用用户属性上报方法
进阶功能	oaid集成（MSA-SDK、直接传入）三方平台绑定（数数）时间校准（时间戳、NTP服务器）
自动采集	不可关闭（归因相关）：$AppInstall、$AppStart、$AppEnd 可手动关闭（减少套餐用量）：$AppCrash、$AppView、$AppClick
发版记录	/

（二）验证及发布

2 接入验证

2.1 本地debug验证

参考文档：接入验证

验证步骤：

开启debug模式：需要研发手动开启客户端debug or 服务端debug
关键事件验证：理论上所有上报的事件和属性都需要检查一下上报是否成功/是否入库/格式是否正确

2.2线上验证

验证步骤：

在分析-用户细查过滤测试用户的client_id，跳转到用户行为序列（图一）
检查测试用户触发的预置事件及属性&自定义事件及属性，是否有事件记录，且属性是否准确（图二）

3. 线上发布

3.1 合规指南

参考文档：合规指南

⚠️引力引擎SDK正式上线前检查：

确保上线前debug模式已关闭
除巨量&腾讯强制接入媒体SDK进行回传以外，确保其他在回传的SDK均已关闭，否则数据会重复上报

至此，确认包含引力引擎SDK的版本在线上已发布，至此，您就可以通知买量团队联调或者投放了。

二、运营配置（仅首次）

本环节包含了买量前应用和归因相关的统一配置项，可在投放前统一检查配置

1. 应用配置

本模块主要是应用层级的统一配置项，建议您在投放前统一检查配置

配置类型	配置项	详细信息	使用场景	是否必填
归因配置类	渠道归因	*归因优先级选择*	常规归因优先级选择，跟媒体SDK归因对数必选渠道包归因	必填
	融合归因	*引力&巨量融合归因配置*	巨量融合归因接口查询需要，减少与媒体归因gap	必填
	预约新游	预约归因优先级选择	预约场景使用	非必填
	回传演练模式	安卓回传演练模式配置	部分媒体自定义回传付费+关键行为可用涉及重点配置变参考下文运营配置 2	非必填
数据回调类	归因回调	*归因回调*	引力的用户归因结果回调到自建中台	非必填
	归因回调	*同步归因*	引力的用户归因结果回调给客户端	非必填
	数数回调	*数数回调-三方绑定事件*	引力的用户归因结果回调给客户数数后台	非必填
	回流配置		需要单独配置回流周期与再归因区分时可用	非必填
媒体回传配置	斗鱼	填入加密密钥	需要API回传给斗鱼时必填	回传必填
	华为商店	填入客户端ID、客户端密钥、APPID	需要API回传给华为商店时必填	回传必填
	美柚	填入加密密钥	需要API回传给美柚时必填	回传必填
	网易云音乐	填入麦穗后台的分配的source、secret、appKey	需要API回传给网易云音乐时必填	回传必填
	WiFi万能钥匙	填入client_id、secret_key	需要API回传给WiFi万能钥匙时必填	回传必填
	DataNexus	引力鉴权指引文档	需要API回传给腾讯时必填	回传必填
	小米	填入资产ID、密钥	需要API回传给小米时必填	回传必填

2. 归因配置

本模块主要是应用层级归因和回传的统一配置项，建议您在投放前统一检查和配置

2.1 归因配置&再归因配置

主要涉及到app归因窗口期和再归因配置

app归因窗口期，默认7天
再归因：默认关闭

目前app产品较少涉及到本模块变更，若有需求，请联系运营

2.2 回传配置

主要涉及到app对应分媒体回传配置注意事项

2.2.1 归因回传窗口期

该模块决定了产品维度给媒体回传的数据是全量回传还是自定义回传

规则如下：

不限，则默认所有用户归因后的全量数据，全生命周期回传。
选择其他天数，则用户注册后超过该天数则不回传
- 其中天数按小时颗粒度计算，1天=注册后24小时
- 如窗口期1天，则用户今日17点注册，截止明日17点前，所有后续行为均会回传，超过17点后的行为均不回传
每次调整保存后，一分钟后生效，无需研发发版。

2.2.2 数据回传模型

主要涉及到给媒体回传事件之间的规则

比如：

巨量要求先回传激活，付费回传才有效，否则接口显示回传成功，但账户后台不显示付费，导致数据差异
硬核可以直接回传付费，不校验是否回传激活

故引力提供了两个数据回传模型方便配置。

回传模型

释义

适用场景

事件模型

用户的各事件回传独立

某事件未回传不影响其他事件回传

演练模式（激活由媒体采集，无需引力回传）
腾讯投放小游戏（注册由媒体自采集，无需回传激活）

漏斗模型

用户触发的所有事件回传之前，都需要校验是否回传过激活

若未回传激活，则其他事件全部漏斗跳过不回传

巨量、磁力投放小游戏、app产品
腾讯投放app产品

三、买量配置

该模块主要介绍了完成以上配置后，投手买量时对应的获取监测、授权、批投等步骤

通用配置步骤	内容&参考链接	页面截图	注意事项	是否必填
1、获取监测链接	新建推广活动		所有产品均需要复制引力监测链接填入媒体后台建议分媒体分账户使用不同监测，方便后续报表的账户&推广活动数据拆分	必填
2、具体回传配置	快速生成默认映射手动生成映射		默认映射可选项只有激活、注册、付费、次留若需要回传如关键行为、表单提交等，需要手动生成映射后回传	除安卓付费游戏投巨量&腾讯可不填其余必填
3、账户授权	多媒体账户授权查看		账户必须要绑定产品，否则报表不计入消耗账户建议绑定人员，人员为空的账户默认所有人可见，避免数据泄漏	非必要
4、批量搭建	巨量创编指引腾讯创编指引磁力创编指引素材库		若账户无入口权限，找管理员配置页面权限	非必要
5、报表查看	多维报表数据查看素材报表		维度和指标、关键日期均支持权限配置有疑问参考权限配置或咨询引力运营	非必要
6、数据分析	分析合集		数据来源包含sdk自采集&贵方手动上报的埋点事件	非必要

四、其他场景解决方案（待补充）

主要介绍安卓产品不同场景的解决方案

细分解决方案	文档链接	适用场景	注意事项

最近修改: 2025-12-05Powered by