# HilltopAds × MeetROAS

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

## 能不能用

可以使用。先完成一次 Postback test；HilltopAds Results 显示 closed 后，MeetROAS 才会启用正式回传。

- 平台入口: Trackers／Manage Campaigns → Postback test
- 点击 macro: `{{ctoken}}`
- 官方文件: https://hilltopads.com/advertisers-help/en/articles/14483450-how-to-track-multiple-events-using-goals-in-hilltopads

## 复制什么，贴到哪里

- 复制 MeetROAS 产生的完整投放网址，贴到: HilltopAds Final Destination URL
- 复制平台账号设定，贴到: MeetROAS Campaign → Conversion integrations

## 需要准备的资料

复制 trackhta.com/close/ 的账号 URL，保留 token={{ctoken}} 与 advertiserId。Main 不带 goal；Micro 由 MeetROAS 正规化为 goal=<event_key>。

## 设定步骤

1. 在 MeetROAS 建立或打开流量来源为 HilltopAds 的 Campaign，并复制系统产生的投放网址。
2. 把 MeetROAS 投放网址设为 Final Destination URL；{{ctoken}} 已包含在网址中。
3. 从 Trackers 复制账号 URL；Main 不带 goal，Micro 由 MeetROAS 自动加入事件 goal。
4. 在 MeetROAS 只贴一次 Trackers URL，再一键建立 PWA 安装 Main 与其他事件 Micro；若主要目标不同，只撤销有歧义的对应后重设。所有 URL 会完整显示，可随时编辑。
5. 从 Manage Campaigns 的 Final Destination URL 旁执行 Postback test，打开测试链接并触发事件；MeetROAS 显示送出后，到 Trackers → Test Conversion 刷新，只有 Results 显示 closed 才完成。

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

## 事件与金额

每个 Campaign 最多一个启用中的 Main；其他事件使用 Micro。price 是转化成本，只接收 Partner Event price；currency 只能与 price 一起使用。

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

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

| 上游 | value → | price → | currency / 缺值规则 |
| --- | --- | --- | --- |
| HilltopAds | — | price={{price}} | currency={{currency}} 原样替换；模板必须同时带 price。缺 price 时两者都移除，缺 currency 时只移除 currency；不换汇 |

## 点击、Goal 与槽位预设

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

| 上游 | 投放网址 macro / 参数 | 回传 click 字段 | 事件 / Goal 对应 |
| --- | --- | --- | --- |
| HilltopAds | {{ctoken}} | token={{ctoken}} | 无既有 Main 时 pwa_install → Main（无 goal），其余公开事件 → Micro（goal=&lt;event_key&gt;）；已有 Main 时新预设全为 Micro |

## 怎样确认成功

从 Manage Campaigns 的 Final Destination URL 旁执行 Postback test，打开测试链接并触发事件；MeetROAS 显示送出后，到 Trackers → Test Conversion 刷新，只有 Results 显示 closed 才完成。

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

## 注意事项

- Main 不得带 goal；Micro 的 goal 由 MeetROAS 事件 key 决定，不使用旧 URL 中的任意标签。