菜单

引力：微小接入配置全流程指引

一、投前准备

因微小投腾讯媒体当前仅允许走SDK归因，所以客户端接入引力SDK的同时，也需要接入腾讯SDK，参考流程如下

（一）通用接入流程

1. 应用创建

操作路径：应用管理

1.1 必填字段说明
类目 说明 示例
产品类型 微信小游戏（仅游戏类）/微信小程序（非游戏类）严格区分，不可混用  

Appid&原始ID

通过小游戏资料页获取：

wx开头的AppID

gh_开头的原始ID
iaa类型标识

根据广告金政策准确勾选：

勾选（纯广告变现）

不勾选（内购或混合变现）

根据腾讯最新广告金政策，iaa类型的产品，其他买量渠道广告也会参与分成。

如果当前产品为iaa，请勾选上，否则引力计算的广告金可能会有较大偏差~

  

2. 微小SDK集成要求

适用范围：

非腾讯渠道投放需采用自归因API版本，按文档集成引力SDK即可

腾讯渠道且需要通过引力集成腾讯SDK，则参考文档完成改造：unitysdk接入，非unitysdk接入，DN-付费完整性不通过检查

需要使用到引力的归因&回传&分析的产品必须要接入引力的SDK，小游戏接入引力SDK发布前CHECKLIST

若仅需要使用批投功能的微信iaa产品，则可选择不接入。

另外：

归因依赖的部分关键参数均由引力sdk自动采集，所以建议主要走客户端上报，付费事件上报可以单独走服务端上报。
2.1 基础配置

域名白名单

添加https://backend.gravity-engine.com和https://api.gravity-engine.com至后台 request 合法请求域名列表中

否则产品下所有用户及后续行为均无法成功上报到引力

框架适配：

Unity项目需集成官方插件并配置全局宏参数

Cocos/原生项目通过标准SDK包集成

2.2 必要集成模块
产品类型 必选模块 可选模块
混合变现 初始化、启动、付费、广告 自定义事件
纯内购(IAP) 初始化、启动、付费 注册/创角等事件
纯广告(IAA) 初始化、启动、广告 深度行为事件
2.3 核心功能实现
2.3.1 配置并启动sdk

技术文档：

原生&cocos小游戏：原生及cocos等--sdk获取

unity小游戏：unity sdk获取（若为unity小游戏需要接入微信团队提供的插件，并添加全局参数）

unitySDK引入文档：unity添加全局宏参数

2.3.2 初始化

对应元事件{用户首次注册$UserFirstRegister}

初始化成功，用户成功上报到引力数据库，需要贵方自定义用户的clientID，需要是用户唯一ID，如openid或者贵方自定义的用户唯一ID。

引力将自动采集事件{用户首次注册}，即报表指标【新增用户数】

初始化成功的时间，即该用户注册时间。

技术文档：

原生及cocos等--初始化

unity初始化

重点：

在可以获取到用户唯一性信息时调用，推荐首次启动时调用，其他方法均需在本方法回调成功之后才可正常使用。

若openid由您方技术获取，则传给引力的openid必须为原值。

若您方没有获取openid的能力，则可以使用引力提供的，通过引力sdk快捷获取openid

Openid 是买量归因必须的参数，请注意一定传入！
2.3.3 启动事件

对应元事件{小程序启动$MPLaunch}，引力自动采集，对应报表指标【标准_激活数】

技术文档：

原生及cocos等--自动采集

unity--自动采集

2.3.4 付费事件上报

对应元事件{用户付费$PayEvent}，服务端上报优先，客户端丢单会导致数据不一致

技术文档：

原生及cocos等--付费事件上报

unity--付费事件上报

代码示例：

json/**
* 上报付费事件
* @param payAmount 付费金额 //必传，且单位为分
* @param payType 货币类型 按照国际标准组织ISO 4217中规范的3位字母，例如CNY人民币、USD美金等
* @param orderId 订单号 // // 必传，强制去重标识，且不要包含特殊字符
* @param payReason 付费原因 例如：购买钻石、办理月卡
* @param payMethod 付费方式 例如：支付宝、微信、银联
*/
ge.payEvent(300, "CNY", "your_order_id", "月卡", "支付宝");

2.3.5 广告事件上报

对应元事件{广告展示$AdShow}

技术文档：

原生及cocos等-广告事件上报

unity--广告事件上报

仅有广告变现收入的小游戏需要接入，引力的广告收入计算=广告观看次数*ecpm，其中

广告观看次数跟客户端上报相关，上报严格参考如下信息

ecpm是基于微信接口在T+1下发的行为口径的ecpm均值为主，当日ecpm一般为历史7天的ecpm预估，次日基于下发数据校准。

广告事件上报包含两个部分（重要）

上报建议：在微信接口返回onClose回调后上报，不判断is Ended（测试广告展示次数gap较小）

配置 access_token：微信小游戏需要参照文档：微信access token选择一种方案接入，应用管理token状态必须为有效才表示接入成功。

代码示例：

json
/**
* 上报广告展示事件 参数如下
* @param adType 广告类型 （枚举取值为：reward、banner、native、interstitial、video_feed、video_begin（预置属性和计算仅支持以上枚举，自定义取值不参与计算）分别对应激励视频广告、Banner广告、原生模板广告、插屏广告、视频广告、视频贴片广告）
* @param adUnitId 微信广告位ID（一般以adunit开头，注意不要填错，会导致ecpm拉取不到！）
* @param otherProperties 其他需要携带的自定义参数
*/
ge.adShowEvent("reward", "your_ad_unit_id", { custom_param: "" });

2.3.6 其他可选&自定义事件（需要先自定义创建事件之后再上报）

常用示例：

注册：可选上报，对应元事件{小程序用户注册$MPRegister}，对应报表{标准_注册数}

创角：可选自定义上报

完成新手引导：可选自定义上报

其他事件：比如触发具体埋点

创建事件及映射回传步骤：

在设置-元事件创建自定义事件，由技术上报后展示，参考文档：元数据管理

支持单独创建

文件创建

模版创建

在映射创建基于自定义事件，向媒体映射对应事件

（二）接入验证

1. 本地调试

在SDK中开启debug模式验证，技术文档：验证接入是否成功

若为服务端上报，则开启服务端debug验证

debug里会包含用户上报的事件明细，校验成功或者失败都会有提示

但是{用户首次注册$UserFirstRegister}不会出现在事件流，因为初始化成功的用户才能基于client ID继续上报其他用户行为事件。

2. 线上验证

找引力商务开启正式试用后，在用户细查，基于上报的client ID查询用户行为序列，是否有对应的元事件上报，以及每个事件上报的节点和属性是否正确。

路径：分析-用户细查-深度挖掘-用户行为序列

（三）上线发布

接入完引力SDK且发布后，您产品全媒体的数据回传都由引力负责，包含

腾讯SDK以外的全媒体回传，腾讯SDK仅能通过客户端上报数据，腾讯负责用户的归因和回传。

所以，如果您之前单独接了媒体的回传(SDK 或者 API)，则上线之前需要去掉，否则可能会导致重复上报数据！

1. 合规指南

技术文档：合规指南（原生&cocos&unity等小游戏通用）

请务必在隐私政策协议中告知用户使用引力引擎 SDK，包含以下内容：

SDK 名称：引力引擎 SDK

SDK提供方：深圳引力引擎科技有限公司

使用的功能：归因监测、ROI 核算、运营数据分析 等，请按实际使用的功能填写

收集的个人信息：OAID/IMEI/MAC/AndroidID/IDFV/IDFA 等。

以下截图所列举的信息都不涉及到采集

二、投放配置

1. 分媒体配置

1.1 巨量引擎--投前checklist

巨量投放操作步骤 填写及配置说明 引力路径截图 巨量相关截图
回传url&token配置

引力路径：应用管理-配置-巨量引擎

巨量URL

巨量token

在巨量引擎投放必填（API回传要求），否则买量账户后台将不会显示任何数据回传！
窗口期配置

引力路径：归因-窗口期配置

操作文档：窗口期配置

数据回传模型：漏斗模型

  

创建推广活动

（归因监测）

引力路径：归因-推广活动/映射管理

操作文档：推广活动、映射管理

方案一：支持一个推广活动下（对应一套点击监测和启动参数），可监测所有广告，但所有广告使用一种回传策略

方案二：一个账户对应一个推广活动，每个账户可以使用不同的回传策略

归因监测填写自检：

点击监测：填入媒体项目-有效触点（媒体截图-1）

启动参数：填入

工作台资产-小游戏路径（媒体截图-2）

橙子落地页-路径参数（媒体截图-3）

原生锚点-小游戏路径参数（媒体截图-4）

创建映射

（给媒体回传）

引力路径：归因-映射管理

操作文档：映射管理（包含常用示例指引）

常用优化目标枚举：

iap小游戏：激活、付费、次留（不分首次、每次付费）

iaa小游戏：基本不投放巨量。

关键事件参考引力：巨量关键事件回传

巨量联调

当前巨量媒体不支持微信小游戏联调

（若要投7R，需要单独创建7R落地页联调）

    
账户授权

指引文档：巨量账户授权指引

支持授权管家账户后，导入广告主账户

  
批量搭建

指引文档：巨量&微信小游戏 批量搭建指引

支持多账户按需求分配搭建

  

1.2 腾讯广告--自归因API&引力集成腾讯SDK投前checklist

腾讯SDK全切方案下，api无需回传，仅需要在SDK转化归因/监测链接组里添加引力的监测链接即可。

操作步骤如下

腾讯投放操作步骤 填写及配置说明 引力路径截图 腾讯相关截图
游戏特征

腾讯后台填写

https://ad.qq.com/atlas/51029100/assets/industry-game-features?type=MINI_GAME

 无需配置  
窗口期配置

引力路径：归因-窗口期配置

操作文档：窗口期配置

数据回传模型：事件模型（因为腾讯可无需回传激活）

再归因配置沉默窗口期，需要跟腾讯SDK代码里一致，代码测未填则腾讯默认30天

接入微小SDK的产品，为了通过DN的数据检测，需要回传全媒体全生命周期的用户行为给腾讯，参考腾讯SDK付费完整性解决方法

窗口期SDK全切建议是不限，跟腾讯SDK一致

创建推广活动

（归因监测）

引力路径：归因-推广活动/映射管理

操作文档：推广活动、映射管理

方案一：支持一个推广活动下（对应一套点击监测和启动参数），可监测所有广告，但所有广告使用一种回传策略

方案二：一个账户对应一个推广活动，每个账户可以使用不同的回传策略

引力默认使用点击监测+启动参数归因，无需额外填写

点击监测填入转化归因或者监测链接组均可，注意区分

转化归因建议使用SDK归因

智投媒体要求只能使用监测链接组

创建映射

（给媒体回传）

引力路径：归因-映射管理

操作文档：映射管理（包含常用示例指引）

SDK归因方案下，无需引力回传，若希望引力也回传一遍，则需要额外处理一下API鉴权

账户授权到引力并在DN后台开启鉴权即生效，账户掉授权或未启用会影响回传

用媒体后台的数据源ID，在应用管理配置

两种方案无区别，部分微信登录管家是无发获取API数据源则只能用方案一

腾讯联调

媒体联调路径：转化归因-转化联调

联调流程：

创建转化归因填入引力点击监测或者选择监测链接组

开始联调后填入联调的微信号及微信WX开头的ID，无需填写启动参数

即可用联调微信在朋友圈刷联调广告

 正常复制监测链接，无需额外配置
账户授权

指引文档：腾讯账户授权指引

新旧版工作台授权均支持，支持批量和单个导入

腾讯接口仅支持主管理员、管理员和业务单元管理员的角色授权，协作者暂时无法授权，请确认您的角色
批量搭建

指引文档：【腾讯新版】微信小游戏 批量搭建指引

支持九图、试玩、格子广告，智投等批量搭建

  

1.3 磁力/快手--投前checklist

快手操作步骤 填写及配置说明 引力路径截图 快手相关截图

新建小游戏资产

【快手后台】

路径：快手磁力追踪

其中，小游戏路径，参考复制推广活动启动参数

创建磁力建站落地页

【快手后台】

路径：磁力建站

选择小游戏组件并关联已审核通过的小游戏资产

 无需配置
窗口期配置

引力路径：归因-窗口期配置-回传配置

操作文档：窗口期配置

数据回传模型：漏斗模型

  

创建推广活动

（归因监测）

引力路径：归因-推广活动/映射管理

操作文档：推广活动、映射管理

方案一：支持一个推广活动（一套点击监测和启动参数），可监测所有广告，但所有广告使用一种回传策略

方案二：每个账户分别对应不同的推广活动（一套点击监测和启动参数），每个账户可以使用不同的回传策略

归因监测填写自检：

点击监测：填入快手广告创意-监测链接

启动参数：填入磁力追踪-营销组件-微信小游戏-小游戏路径

创建建站落地页并使用已通过审核的小游戏组件即可

创建映射

（给媒体回传）

引力路径：归因-映射管理

操作文档：映射管理（包含常用示例指引）

常用优化目标枚举：

iap小游戏：激活&付费必传，注册&次留选填

iaa小游戏：基本不投放巨量。

  
快手联调

媒体路径：资产-转化-转化追踪-追踪小程序-创建转化追踪

联调流程

新建微信小游戏相关转化追踪

转化事件：需确保联调事件在引力有对应映射

追踪方式：微信小程序回传

推广落地页：选择带有引力启动参数的小游戏资产对应的建站落地页

点击监测链接：填入引力点击监测链接

转化名称：任意命名

 保持以上配置OK，联调无需额外配置

账户授权

指引文档：磁力账户授权指引

仅支持广告主账户入口授权，其中罗盘及工作台均适用

基于广告账户授权，可选广告账户（单个账户授权需要授权成功后手动绑定产品）

基于用户授权，拉取快手ID下全部有权限的账户
批量搭建 指引文档：快手&微信小游戏、快手小游戏 批量搭建指引  

 

三、常问问题

1. SDK发布线上之后，没有用户上报到引力

检查合法域名是否配置完整

请务必将 https://backend.gravity-engine.com 及https://api.gravity-engine.com配置到后台 request 合法域名列表中。

否则产品下所有用户及后续行为均无法成功上报到引力

2. 客户端上报了广告展示事件，但是用户细查没有广告次数的统计

确认上报广告展示事件时填写的广告位类型和广告位ID是否正确

广告类型：需要在引力的枚举值内，不在枚举范围内的广告次数不会计算到预置属性。

3. 微小投巨量，引力后台归因成功但是后台没有数据

检查应用配置-巨量引擎，微小回传相关的URL和token是否未填写，参考本文投放配置1.1

最近修改: 2025-09-01Powered by