---
title: "第三方追踪平台集成"
description: "将 AdsGram 与 AppsFlyer、Adjust、AppMetrica、Kochava 或 Keitaro 集成，追踪安装与转化以优化 tCPA。"
outline: [2,4]
---
# 合作方集成
AdsGram 支持与主流归因和追踪平台集成。这些平台可以让您追踪用户在与 AdsGram 广告互动后产生的点击、安装和行为，并将转化数据回传给 AdsGram，从而帮助您按转化成本（tCPA）优化广告活动。

目前支持以下集成：
- [AppsFlyer](#appsflyer)
- [Adjust](#adjust-集成步骤)
- [AppMetrica](#appmetrica-集成步骤)
- [Kochava](#kochava)
- [Keitaro](#keitaro)

您也可以使用其他追踪平台的链接，但在这种情况下，AdsGram 无法向追踪平台传递全部所需的详细数据。

## AdsGram 可识别的宏类型：
为了实现详细追踪，请使用宏。AdsGram 会在您的追踪链接中自动替换为真实数据。
- `{campaign_id}`
- `{banner_id}`
- `{publisher_id}`
- `{useragent}`
- `{device_model}`
- `{click_id}`
- `{ip}`
- `{campaign}` — 广告活动名称
- `{os_version}`
- `{lang}`
- `{gaid}`
- `{idfa}`
- `{record_data}`

::: warning  注意
要使 [Keitaro](#keitaro) 和 [Kochava](#kochava) 集成正常工作，广告活动链接中必须包含必需的 `{record_data}` 宏。如果缺少该必需宏，将无法进行转化追踪。
:::

> [!IMPORTANT] 重要信息
> 宏 `{publisher_id}` 仅作为唯一的流量主标识符展示 —— 不会包含其名称或其他身份信息。

后台会高亮显示已添加到链接的宏 <img src="../../images/icons/added_macros.png" alt="Added macros" width="18" style="display: inline" />，以及缺失的宏 <img src="../../images/icons/missed_macros.png" alt="Missed macros" width="18" style="display: inline" />。

![Selected macroses](./images/selected_macroses.webp =500x)

## Adjust 集成步骤
### 1. 选择网络
在 **Campaign Lab** 部分进入 **Partners**（合作伙伴）
- 点击 **New Partner**。
- 搜索 **AdsGram** 并选择。
- 点击 **Next**。

### 2. 选择应用
在下一页选择需要创建链接的应用。可以搜索或在列表中找到。一次只能为一个应用设置链接。\
选择应用后，点击 **Next**。

### 3. 设置数据共享选项
在此部分配置与 AdsGram 的数据共享参数，选择需要传送给 AdsGram 分析的事件和应用参数。\
详细说明可见 [Adjust 文档](https://help.adjust.com/zh/article/data-sharing-ad-network)。

### 4. 获取追踪链接
配置完成后，您将获得一个唯一的追踪链接，用于在 AdsGram 中创建广告活动。\
您也可以添加额外参数（如 UTM 标签）以更精确追踪流量来源。

### 5. 转化数据传输
默认情况下，用户活动数据会从 Adjust 传输到 AdsGram，并自动归入相应的目标：
- 会话（Sessions）— 归入 Goal 1
- 安装（Installs）— 归入 Goal 2

> [!IMPORTANT] 重要信息
> 要启动 tCPA 广告活动，所选目标至少需要获得 **10 次转化**。例如，如果广告活动针对 **Goal 2** 启动，则 **Goal 2** 至少需要获得 10 次转化。

## AppMetrica 集成步骤
### 创建 Tracker：
1. 在 AppMetrica 控制台注册账号、集成 SDK 并设置目标行为追踪后，即可创建 tracker
1. 指定 tracker 名称
1. 添加应用

详细说明可见[AppMetrica 文档 ](https://appmetrica.yandex.ru/docs/en/mobile-tracking/add-tracker)。

### 安装数据传输：
4. 选择回传接收方（AdsGram）
4. 指定需要发送给 AdsGram 的事件类型
4. 获取 **Postback URL** —— 用于将事件和安装数据传送到 AdsGram 服务器
4. 创建 postback 后，您将获得追踪链接。该链接需用于 AdsGram 广告活动。您也可以添加 UTM 等额外参数。

## Keitaro
### 1. 在 Keitaro 中创建 Tracker（追踪器）
  1. 登录 Keitaro 后台后，进入 **Trackers**（追踪器）页面。
  1. 点击 **Create tracker** 或 **New tracker**。
  1. 填写 Tracker 名称，并将流量来源类型选择为 **AdsGram**。
  1. 点击 **Save** 保存并创建 Tracker。

### 2. 在 Keitaro 中配置 Postback
  1. 在已创建的 Tracker 设置中，进入 Postback 或 API Integration（API 集成）部分。
  1. 在 Postback URL 字段中，填写 AdsGram 的接口地址：
     ```
     https://api.adsgram.ai/confirm_conversion?
     ```
  1. 添加必需的 `token` 参数和 `record` 参数。参数名称必须与 Tracking Link 中指定的 **record** 参数一致。

     例如，如果您在 Tracking Link 中按以下方式传递 AdsGram 宏：
     ```
     https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&record={record_data}
     ```

     那么需要在 Keitaro 的 postback 中指定：
     ```
     https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&record={_record}
     ```

     其中：
     - `YOUR_UNIQUE_TOKEN` — 你在 AdsGram 个人资料中获取的 Token
     - `record` — 你在 Tracking Link 中传递的参数
     - `{_record}` — 将 **record 参数的原始值** 传递给 postback 的宏

### 3. 在 AdsGram 中创建广告活动
  1. 从 Keitaro Tracker 设置中复制 Click URL（例如：https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}).
  1. 在 AdsGram 后台创建广告活动时，将该链接粘贴到 Click URL 字段中。
  1. 在链接中添加所需的 AdsGram 宏参数：
     ```
     https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&publisher={publisher_id}&banner={banner_id}&record={record_data}
     ```
  1. 请务必确保最终链接中包含 {record_data} 宏。

### 4. 在 Keitaro 中设置 Goals（目标）
  1. 在 Keitaro Tracker 设置中，进入 Goals 或 Conversions（转化）部分。
  1. 创建一个新的目标，或选择已有目标。
  1. 为该目标启用向前面设置的 URL 发送 Postback。
  1. 定义触发条件（例如：转化确认时，或特定状态下触发）。

## Kochava
### 1. 在 Kochava 中创建 Tracker
  1. 登录 Kochava 后台后，进入 Apps & Assets 页面。
  1. 点击 Add New，选择 App 来创建新的应用追踪器。
  1. 填写以下必填信息：
     - Platform（平台）：选择应用平台（iOS、Android、Web）
     - App Name（应用名称）：填写你的应用名称
     - Store ID（商店 ID）：填写应用的商店标识（App Store ID、包名等）
  1. 点击 Save 保存并创建应用。

### 2. 设置合作方（Partner）集成
  1. 在已创建的应用页面中，进入 Partner Management（合作方管理）部分。
  1. 点击 Add Partner。
  1. 在合作方列表中找到并选择 AdsGram。
  1. 点击 Next 进入配置页面。

### 3. 配置集成参数
  1. 在 Integration Settings（集成设置）中，选择追踪类型（Click-Through、View-Through 或 Hybrid）。
  1. 启用 Server-to-Server Postbacks（服务器对服务器回传）。
  1. 在 Postback URL 中填写 AdsGram 接口：
     ```
     https://api.adsgram.ai/confirm_conversion
     ```
  1. 在 Postback Parameters 中添加以下参数：
     - 必填参数：`{record_data}`（由 Kochava 自动插入）
     - 新增参数：token，值为 `YOUR_UNIQUE_TOKEN`（从你的 AdsGram 个人资料中获取）
  1. 配置数据映射宏：
     - `{campaign_id}` → campaign_id
     - `{click_id}` → click_id
     - `{publisher_id}` → publisher_id

### 4. 在 AdsGram 中创建广告活动
  1. 返回 Kochava 的 Tracking Links 页面并创建一个追踪链接（例如：https://your-app.kochava.com/install?data={encrypted_data}).
  1. 在 AdsGram 后台创建广告活动时，将该链接粘贴到 Click URL 字段中。
  1. 在链接中添加 AdsGram 必需的宏参数：
     ```
     https://your-app.kochava.com/install?data={encrypted_data}&campaign_id={campaign_id}&click_id={click_id}&publisher_id={publisher_id}&record={record_data}
     ```
  1. 请确保最终 URL 中包含 `{record_data}` 宏。

### 5. 在 Kochava 中配置事件（Events）
  1. 在 Kochava 后台进入 Events 页面。
  1. 创建一个新事件，或选择一个标准事件（如 install、purchase）。
  1. 为该事件配置 Postback：
     - 启用 Send Postback
     - 选择之前创建的 AdsGram 集成
     - 定义过滤条件和触发条件
  1. 保存事件配置。

### 6. 测试集成
  1. 使用 Kochava 的 Test Mode 测试安装追踪是否正常。
  1. 检查 Kochava 和 AdsGram 日志中的请求记录。
  1. 确认 record_data 参数是否被正确传递。

## AppsFlyer
AdsGram 与 AppsFlyer 的集成可以将应用安装和用户在应用内的行为数据发送给 AdsGram。

集成配置完成后，AdsGram 将接收到：
- **应用安装（Installs）**— 自动归入 **Goal 1**
- **In-App Events** — 可根据所配置的事件映射归入 **Goal 2** 或 **Goal 3**

您可以自行选择将特定事件（例如 registration、purchase、deposit 等）归入 AdsGram 的哪个目标。

### 1. 通过「集成合作伙伴」接入 AdsGram
AdsGram 是 AppsFlyer 的集成合作伙伴。接入步骤如下：
- 在 AppsFlyer 中进入 **协作** → **合作伙伴市场**
- 搜索 **AdsGram**（营销名称）或 **adsgram1e_int**（技术名称），并选择该合作伙伴

### 2. 配置安装回传
打开 **集成** 标签页：
- 启用 **激活合作伙伴**
- 关闭 **AAP**（须在应用设置和本标签页中同时关闭）
- 在 **安装回传** 中选择 **仅该合作伙伴**。这意味着 AdsGram 将接收归因于 AdsGram 的安装，这些安装将在 AdsGram 中计入 **Goal 1**

> [!IMPORTANT] 重要信息
> 如果您想启动针对安装优化的广告活动，请确保安装数据已发送至 AdsGram 并显示在 **Goal 1** 下。针对安装优化的 tCPA 广告活动只能针对 **Goal 1** 启动。

### 3. 配置应用内事件回传
在 **应用内事件回传** 部分为 In-App Events（购买、注册等）配置回传：
- 添加所需事件，例如：
  - purchase - 购买
  - af_complete_registration - 注册
- 在 **For users from** 字段中选择 **仅该合作伙伴**
- AdsGram 只会接收事件本身，不包含其参数或收入数据。因此在 **Including** 中可以选择 **No values & no revenue**
- 如需将事件发送到 AdsGram 的特定目标，请使用 **Mapped to parameter event** 字段：
  - 填写 `goal2`，将对应事件归入 **Goal 2**。
  - 填写 `goal3`，将对应事件归入 **Goal 3**。

推荐启用：
- 允许配置集成（应用内事件回传除外）
- 允许配置应用内事件回传

其他权限（留存报告、收入等）为可选项。

配置完成后，点击 **保存集成**。

### 4. 配置追踪链接
打开 **追踪链接** 标签页：
- AppsFlyer 会自动为 AdsGram 生成追踪链接，并添加所需的合作伙伴标识符：pid=adsgram1e_int
- AdsGram 的 4 个宏会自动填充（af_storeid、c 等）
- 如有需要，可将静态参数作为附加参数添加
- 在 **点击归因** 中选择归因窗口，默认值为 7 天，可按需修改

### 5. 配置权限
打开 **权限** 标签页，启用所需权限：
- 访问应用仪表盘
- 聚合转化数据
- 事件
- Protect360

👉 点击 **保存集成**

### 6. 在 AdsGram 中配置广告活动
在 AdsGram 中创建广告活动时：
- 将您的 AppsFlyer 链接粘贴到 **链接** 字段中。支持 AF Link 和 OneLink 两种链接。
- 系统会自动生成 AppsFlyer 追踪链接并添加所需的宏。
- 如果 AppsFlyer 追踪链接中尚未包含您的 **package/bundle** 名称，请在其中指定（例如 id12345678 或 com.app.name）
- 在出现的 **链接** 字段中，填写商品在 Google Play / App Store / RuStore 上的直达链接

#### 使用 InCost API
如果您想使用 InCost API，请在链接中添加 `af_app_id` 参数，并将其值设置为您的应用 ID。

示例： `af_app_id=YOUR_APP_ID`.

### 7. 注意事项
- 该配置对广告活动内的所有横幅广告生效
- 广告主需自行确保链接参数与归因设置正确
- 使用自定义链接时，还必须在 **链接** 字段中填写商品/应用的直达链接
