AdsGram

中文

English
Русский
Español
Português
Türkçe
العربية
فارسی
Français
Українська
Bahasa Indonesia
हिंदी

中文

English
Русский
Español
Português
Türkçe
العربية
فارسی
Français
Українська
Bahasa Indonesia
हिंदी

主题

合作方集成 ​

AdsGram 支持与主流归因和追踪平台集成。这些平台可以让您追踪用户在与 AdsGram 广告互动后产生的点击、安装和行为，并将转化数据回传给 AdsGram，从而帮助您按转化成本（tCPA）优化广告活动。

目前支持以下集成：

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

Adjust 集成步骤 ​

1. 选择网络 ​

在 Campaign Lab 部分进入 Partners（合作伙伴）

  • 点击 New Partner。
  • 搜索 AdsGram 并选择。
  • 点击 Next。

2. 选择应用 ​

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

3. 设置数据共享选项 ​

在此部分配置与 AdsGram 的数据共享参数，选择需要传送给 AdsGram 分析的事件和应用参数。
详细说明可见 Adjust 文档。

4. 获取追踪链接 ​

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

5. 转化数据传输 ​

默认情况下，用户活动数据会从 Adjust 传输到 AdsGram，并自动归入相应的目标：

  • 会话（Sessions）— 归入 Goal 1
  • 安装（Installs）— 归入 Goal 2

重要信息

要启动 tCPA 广告活动，所选目标至少需要获得 10 次转化。例如，如果广告活动针对 Goal 2 启动，则 Goal 2 至少需要获得 10 次转化。

AppMetrica 集成步骤 ​

创建 Tracker： ​

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

详细说明可见AppMetrica 文档 。

安装数据传输： ​

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

Keitaro ​

1. 在 Keitaro 中创建 Tracker（追踪器） ​

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

2. 在 Keitaro 中配置 Postback ​

  1. 在已创建的 Tracker 设置中，进入 Postback 或 API Integration（API 集成）部分。

  2. 在 Postback URL 字段中，填写 AdsGram 的接口地址：

    https://api.adsgram.ai/confirm_conversion?

  3. 添加必需的 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}).
  2. 在 AdsGram 后台创建广告活动时，将该链接粘贴到 Click URL 字段中。
  3. 在链接中添加所需的 AdsGram 宏参数：
    https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&publisher={publisher_id}&banner={banner_id}&record={record_data}
  4. 请务必确保最终链接中包含 {record_data} 宏。

4. 在 Keitaro 中设置 Goals（目标） ​

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

Kochava ​

1. 在 Kochava 中创建 Tracker ​

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

2. 设置合作方（Partner）集成 ​

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

3. 配置集成参数 ​

  1. 在 Integration Settings（集成设置）中，选择追踪类型（Click-Through、View-Through 或 Hybrid）。
  2. 启用 Server-to-Server Postbacks（服务器对服务器回传）。
  3. 在 Postback URL 中填写 AdsGram 接口：
    https://api.adsgram.ai/confirm_conversion
  4. 在 Postback Parameters 中添加以下参数：
    • 必填参数：{record_data}（由 Kochava 自动插入）
    • 新增参数：token，值为 YOUR_UNIQUE_TOKEN（从你的 AdsGram 个人资料中获取）
  5. 配置数据映射宏：
    • {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}).
  2. 在 AdsGram 后台创建广告活动时，将该链接粘贴到 Click URL 字段中。
  3. 在链接中添加 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}
  4. 请确保最终 URL 中包含 {record_data} 宏。

5. 在 Kochava 中配置事件（Events） ​

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

6. 测试集成 ​

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

AppsFlyer ​

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

集成配置完成后，AdsGram 将接收到：

  • 应用安装（Installs）— 自动归入 Goal 1
  • 其他所有 In-App Events — 自动归入 Goal 2

无需在 AdsGram 中进行额外配置或事件与目标的映射。例如，如果 AppsFlyer 发送了 registration、purchase、deposit 等事件，它们都会自动计入 Goal 2。

重要信息

tCPA 广告活动只能针对 Goal 1 启动，也就是说只能针对应用安装进行优化。归入 Goal 2 的 In-App Events 不能用作 tCPA 广告活动的优化目标。

1. 通过「集成合作伙伴」接入 AdsGram ​

AdsGram 是 AppsFlyer 的集成合作伙伴。接入步骤如下：

  • 在 AppsFlyer 中进入 协作 → 合作伙伴市场
  • 搜索 AdsGram（营销名称）或 adsgram1e_int（技术名称），并选择该合作伙伴

2. 配置安装回传 ​

打开 集成 标签页：

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

重要信息

如果您想启动针对安装优化的广告活动，请确保安装数据已发送至 AdsGram 并显示在 Goal 1 下。针对安装优化的 tCPA 广告活动只能针对 Goal 1 启动。

3. 配置应用内事件回传 ​

在 应用内事件回传 部分为 In-App Events（购买、注册等）配置回传：

  • 添加所需事件，例如：
    • purchase - 购买
    • af_complete_registration - 注册
  • 在 For users from 字段中选择 仅该合作伙伴
  • AdsGram 只会接收事件本身，不包含其参数或收入数据。因此在 Including 中可以选择 No values & no revenue

推荐启用：

  • 允许配置集成（应用内事件回传除外）
  • 允许配置应用内事件回传

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

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

4. 配置追踪链接 ​

打开 追踪链接 标签页：

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

5. 配置权限 ​

打开 权限 标签页，启用所需权限：

  • 访问应用仪表盘
  • 聚合转化数据
  • 事件
  • Protect360

👉 点击 保存集成

6. 在 AdsGram 中配置广告活动 ​

在 AdsGram 中创建广告活动时：

  • 在 链接 字段中插入 Click link，系统会自动生成 AppsFlyer 追踪链接并添加所需的宏
  • 如果 AppsFlyer 追踪链接中尚未包含您的 package/bundle 名称，请在其中指定（例如 id12345678 或 com.app.name）
  • 在出现的 链接 字段中，填写商品在 Google Play / App Store / RuStore 上的直达链接

7. 注意事项 ​

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