AI-ready documentation
媒体渠道接入指南
说明媒体渠道接入引力平台的技术要求，包括监测链接必须支持的宏参数、监测链接示例、Callback 接口返回格式与对接自检清单。
一、接入前必读
- 本接入过程无需在引力平台注册账户，仅需技术侧确认接口满足以下要求后，将公司名称提供给引力运营/商务。
- 监测链接与回调接口均需严格按文档要求实现，否则将影响归因与回调功能。
二、监测链接宏参数规范
在监测链接中，以下宏参数必须支持替换（格式为 {宏参数名}）：
| 参数名 | 宏参数 | 适用平台 | 说明 |
|---|---|---|---|
| IDFA | {idfa} | iOS | IDFA 原值（未哈希） |
| OAID | {oaid} | Android | OAID 原值（未哈希） |
| Android ID | {android_id} | Android | Android ID 原值（未哈希） |
| IMEI | {imei} | Android | IMEI 原值（未哈希） |
| IP | {ip} | 全平台 | IPv4 地址，格式为 A.B.C.D |
| UA | {ua} | 全平台 | 需进行 URL Encode 编码 |
| Callback | {callback} | 全平台 | 用户激活归因后的回调地址 |
三、监测链接示例
引力会提供类似如下格式的监测链接供广告投放使用，请调用方确保宏参数务必正确替换。
iOS 监测链接示例（仅示例，不要直接用）：
https://backend.gravity-engine.com/event_center/api/v1/event/click/?idfa={idfa}&ip={ip}&ua={ua}&callback={callback}Android 监测链接示例（仅示例，不要直接用）：
https://backend.gravity-engine.com/event_center/api/v1/event/click/?oaid={oaid}&android_id={android_id}&imei={imei}&ip={ip}&ua={ua}&callback={callback}四、Callback 接口返回格式
当用户归因成功后，引力会调用您提供的 Callback 地址，必须按以下 JSON 格式返回响应：
成功响应（HTTP 200）：
{
"code": 200,
"result": "success"
}失败响应（HTTP 400）：
{
"code": 400,
"result": "failed"
}- 请确保接口响应
Content-Type为application/json。 - 仅当返回
code: 200时，引力视为回调成功；否则会进行重试（具体重试策略以引力侧为准）。
五、技术对接自检清单
请确认满足以下两点后，将公司名称提供给引力运营/商务：
- 监测链接支持替换所有指定的宏参数，格式为
{参数名}。 - Callback 接口返回格式严格符合上述 JSON 结构，且支持成功与失败两种情况。
六、接入信息确认清单
接入前，请先确认以下信息：
| 确认项 | 需要明确的内容 |
|---|---|
| 技术对接群 | 是否有媒体技术对接群，便于技术层面沟通监测链接、Callback 联调与异常排查 |
| 投放产品类型 | 本次投放的产品类型，例如安卓、iOS、微信小游戏 |
| 媒体官方简称 | 媒体官方对外的中文简称、英文简称或缩写，用于后台媒体列表与报表标识 |
| 媒体官方 logo | 媒体官方高清 logo，优先 SVG，也可提供 PNG |
| 公司官网 | 媒体是否有官方网站，如有请提供地址 |
| 消耗数据接口 | 是否支持账户消耗数据的 API 拉取 |
七、接入咨询
如需接入引力平台，可以扫描下方二维码联系我们：
文档维护：Gravity Engine
文档修改日期：