AdsGram

中文

English
Русский

中文

English
Русский

主题

转化追踪 ​

为了更详细地追踪广告活动的效果并正确归因目标行为的来源，建议使用分析系统。

AdsGram 可识别的宏类型： ​

为了实现详细追踪，请使用宏。AdsGram 会在您的追踪链接中自动替换为真实数据。

  • {campaign_id}
  • {banner_id}
  • {publisher_id}
  • {click_id}
  • {record_data}

注意

宏 {record_data} 是 API 正常运行所必需的。如果没有它，转化追踪将失败。

重要信息

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

广告活动链接示例：

https://your-tracker.com/?campaign={campaign_id}&banner={banner_id}&pub={publisher_id}&clickid={click_id}&record={record_data}

重要提示：

如果你的落地链接是通过 start 参数打开 Telegram Mini App（TMA），请使用如下格式的链接，例如：

https://t.me/[机器人名称]?start=[唯一推荐链接]_{campaign_id}_{banner_id}_{publisher_id}_{click_id}_{record_data}

后台会高亮显示已添加到链接的宏 Added macros，以及缺失的宏 Missed macros。

Selected macroses

转化确认 API ​

对于自定义分析系统或直接的服务器集成，可以使用 API。

API 接口：这是一个专门的 URL，当用户产生转化事件时，您的服务器会立即发起请求，从而使 AdsGram 能够实时接收活动结果数据。

Endpoint:

https://api.adsgram.ai/confirm_conversion

参数说明: ​

  • token — 与您的账户绑定的唯一令牌，可在 AdsGram 控制台获取（可重新生成）。

    获取token方式：进入右上角个人资料，点击按钮 Copy。 Copy macros

  • record — 每次点击或展示的唯一值，对应 AdsGram 自动插入追踪 URL 的 {record_data} 参数。

  • goaltype —— 一个新增参数，用于指定转化类型（即漏斗阶段），帮助区分不同的用户行为。该参数接受 1 到 3 的整数值。

    goaltype 的使用方式：

    1. 在你的产品或服务中定义转化漏斗的各个阶段。
    2. 将漏斗阶段映射到对应的 goaltype 值：
        1. 注册
        1. 首次充值 / 首次购买
        1. 二次（或多次）充值 / 复购
    3. 为用户路径中相关的阶段配置转化追踪。
    4. 在发送转化数据时，在 API 请求中加入 goaltype 参数。
    5. 在数据分析中使用该参数，按不同转化类型进行更精细的效果分析。

使用方法： ​

  1. 选择一个已激活的广告活动，或新建一个广告活动。
  2. 确保目标链接中包含{record_data}参数。
  3. 在 AdsGram 控制台获取您的 token。
  4. 在服务端设置逻辑，在用户完成目标行为时向 API 发送请求。
  5. 确认请求已成功处理，并在分析系统中查看数据。

用户完成转化后的服务器请求： ​

https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&record=7f3a1b6c5d2e4f8a

期望响应：200 OK —— 成功注册转化。

合作方集成 ​

AdsGram 已与 Adjust 和 AppMetrica 集成。也可以使用其他追踪平台的链接，但在这种情况下，AdsGram 无法向追踪平台传递更详细的数据。

重要信息

使用 Adjust 和 AppMetrica 的广告主现在可以获取用户在点击 AdsGram 广告横幅后产生的转化数据。

Adjust 集成步骤 ​

1. 选择网络 ​

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

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

2. 选择应用 ​

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

3. 设置数据共享选项 ​

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

4. 获取追踪链接 ​

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

重要信息

设置追踪链接后，用户点击 AdsGram 广告后的应用安装和应用内事件数据 仅在 Adjust 界面中展示。

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=YOUR_UNIQUE_TOKEN&record={record_data}
  4. 其中 YOUR_UNIQUE_TOKEN 为你在 AdsGram 个人资料中获取的 Token。

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 参数是否被正确传递。