# AdsGram × MeetROAS

状态：已支持，可以使用。

## 能不能用

可以使用。储存自己的 AdsGram token 并建立固定事件预设；下一次 Web Landing Campaign 投放后可在 Statistics 核对转换。

- 平台入口: Campaign → Web Landing Link；账号 token 位于 AdsGram advertiser account
- 点击 macro: `{record_data}`
- 官方文件: https://docs.adsgram.ai/advertiser/tracking

## 复制什么，贴到哪里

- 复制 MeetROAS 产生的完整投放网址，贴到: Web Landing Link
- 复制平台账号设定，贴到: MeetROAS Campaign → Conversion integrations

## 需要准备的资料

使用 https://api.adsgram.ai/confirm_conversion，并填写自己账号的 token；MeetROAS 固定保留 record={record_data}，token 加密保存且不会回显。

## 设定步骤

1. 在 MeetROAS 建立或打开流量来源为 AdsGram 的 Campaign，并复制系统产生的投放网址。
2. 建立 Web Landing Campaign，并将 MeetROAS 投放网址放入 Web Landing Link；网址已包含 {record_data}。
3. 从 AdsGram advertiser account 取得 token；MeetROAS 会从一个 URL 产生 goaltype 1、2、3。
4. 在 MeetROAS 贴上含自己 token 的完整 Conversion Confirmation URL，再一键建立注册、首充／首购、重复充值／购买预设。
5. 请求格式、事件映射、HTTP 200 成功判定与重试去重已依 AdsGram 官方文件验证；这不是付费流量的全链路实证。投放后可在 AdsGram Statistics 核对实际转换。

> 如果没有 MeetROAS tile，请使用 Custom、Other tracker 或通用 Postback。

## 事件与金额

一键预设固定为注册 → goaltype=1、首充／首购 → goaltype=2、重复充值／购买 → goaltype=3。官方 API 没有 value、price 或 currency 栏位，MeetROAS 不会猜测或传送金额。

## 下游金额 → 上游参数对照

方向：下游 → MeetROAS Partner Event API → 归因来源。value 是收益，price 是获客成本，currency 是下游声明的币别。— 表示当前 MeetROAS connector 不投影该字段，不代表上游没有该功能。URL 金额栏列出可选模板 placeholder：模板有该参数且下游有该金额才替换，缺少金额就移除；不会自动加参数、互相代填或换汇。注册与登录不能携带金额。

| 上游 | value → | price → | currency / 缺值规则 |
| --- | --- | --- | --- |
| AdsGram | — | — | 不投影 currency；不换汇 |

## 点击、Goal 与槽位预设

点击 macro 由上游展开为真实 click ID，再由 MeetROAS 回传；不是下游的 mrc_。下表是目前新增预设的行为，既有手动绑定不会被自动覆盖。帐号识别与 URL 必须从各上游取得，不从槽号或 token 推测事件。

| 上游 | 投放网址 macro / 参数 | 回传 click 字段 | 事件 / Goal 对应 |
| --- | --- | --- | --- |
| AdsGram | {record_data} | record={record_data} | account_registration → goaltype=1；first_deposit → goaltype=2；deposit → goaltype=3。token 来自 AdsGram 帐号；每槽一个绑定 |

## 怎样确认成功

请求格式、事件映射、HTTP 200 成功判定与重试去重已依 AdsGram 官方文件验证；这不是付费流量的全链路实证。投放后可在 AdsGram Statistics 核对实际转换。

最后请到 AdsGram 后台确认转换已成功收到；以该平台后台显示为准。

## 注意事项

- Telegram Ads Campaign 不传 AdsGram macro，不能使用这个 Conversion Confirmation API；必须使用 Web Landing Link。
- 只有 HTTP 200 代表 AdsGram 已接受转换；其他 2xx 不视为成功。