# 媒体渠道接入指南

> 来源：https://help.gravity-engine.com/docs/attribution/media-channel-integration
> 说明媒体渠道接入引力平台的技术要求，包括监测链接必须支持的宏参数、监测链接示例、Callback 接口返回格式与对接自检清单。
> 文档修改日期：2026-10-30






## 一、接入前必读 [#一接入前必读]

* 本接入过程无需在引力平台注册账户，仅需技术侧确认接口满足以下要求后，将公司名称提供给引力运营/商务。
* 监测链接与回调接口均需严格按文档要求实现，否则将影响归因与回调功能。

## 二、监测链接宏参数规范 [#二监测链接宏参数规范]

在监测链接中，以下宏参数必须支持替换（格式为 `{宏参数名}`）：

| 参数名        | 宏参数            | 适用平台    | 说明                  |
| ---------- | -------------- | ------- | ------------------- |
| 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 监测链接示例（仅示例，不要直接用）：**

```text
https://backend.gravity-engine.com/event_center/api/v1/event/click/?idfa={idfa}&ip={ip}&ua={ua}&callback={callback}
```

**Android 监测链接示例（仅示例，不要直接用）：**

```text
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-接口返回格式]

当用户归因成功后，引力会调用您提供的 Callback 地址，**必须按以下 JSON 格式返回响应**：

**成功响应（HTTP 200）：**

```json
{
  "code": 200,
  "result": "success"
}
```

**失败响应（HTTP 400）：**

```json
{
  "code": 400,
  "result": "failed"
}
```

> **注意**
> * 请确保接口响应 `Content-Type` 为 `application/json`。
> * 仅当返回 `code: 200` 时，引力视为回调成功；否则会进行重试（具体重试策略以引力侧为准）。

## 五、技术对接自检清单 [#五技术对接自检清单]

请确认满足以下两点后，将**公司名称**提供给引力运营/商务：

* **监测链接**支持替换所有指定的宏参数，格式为 `{参数名}`。
* **Callback 接口**返回格式严格符合上述 JSON 结构，且支持成功与失败两种情况。

## 六、接入信息确认清单 [#六接入信息确认清单]

接入前，请先确认以下信息：

| 确认项       | 需要明确的内容                                  |
| --------- | ---------------------------------------- |
| 技术对接群     | 是否有媒体技术对接群，便于技术层面沟通监测链接、Callback 联调与异常排查 |
| 投放产品类型    | 本次投放的产品类型，例如安卓、iOS、微信小游戏                 |
| 媒体官方简称    | 媒体官方对外的中文简称、英文简称或缩写，用于后台媒体列表与报表标识        |
| 媒体官方 logo | 媒体官方高清 logo，优先 SVG，也可提供 PNG              |
| 公司官网      | 媒体是否有官方网站，如有请提供地址                        |
| 消耗数据接口    | 是否支持账户消耗数据的 API 拉取                       |

## 七、接入咨询 [#七接入咨询]

如需接入引力平台，可以扫描下方二维码联系我们：

<img alt="扫描二维码联系引力接入对接人" src="__img0" />