# TikTok Events API × MeetROAS

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

## 能不能用

官方契约验证已通过；储存有效的资料来源 ID 与 Access Token 后即可启用正式回传。

- 平台入口: Events Manager → Web Events → Settings → Events API
- 点击 macro: `ttclid`
- 官方文件: https://ads.tiktok.com/gateway/docs/index?doc_id=1771100984456193

## 复制什么，贴到哪里

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

## 需要准备的资料

MeetROAS 使用 Events API 2.0；Access Token 只加密保存，不是 Postback URL。

## 设定步骤

1. 在 MeetROAS 建立或打开流量来源为 TikTok Events API 的 Campaign，并复制系统产生的投放网址。
2. 建立或选择 Web 数据来源并产生 Access Token。
3. 把 MeetROAS Website URL 设为投放网址，保留 ttclid。
4. 输入 Pixel Code 与 Access Token，一键建立官方事件预设；Token 不会回显。
5. MeetROAS 已依公开官方契约检查请求格式、事件映射、回应判定与去重；没有真实帐号，因此未宣称全链路实证。Events Manager diagnostics 仍可作为自愿核对。

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

## 事件与金额

Deposit 与 First Deposit 都使用官方 Purchase；PWA 安装使用官方 Download；First-day Deposit 使用自订 FirstDayDeposit（只供报表与受众，不可作为 Campaign optimization event）。

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

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

| 上游 | value → | price → | currency / 缺值规则 |
| --- | --- | --- | --- |
| TikTok Events API | data[].properties.value | — | data[].properties.currency；value 与 currency 齐全才传送金额对象；不换汇 |

## 点击、Goal 与槽位预设

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

| 上游 | 投放网址 macro / 参数 | 回传 click 字段 | 事件 / Goal 对应 |
| --- | --- | --- | --- |
| TikTok Events API | ttclid | data[].user.ttclid | data[].event 使用下表预设；custom 事件不用于 Campaign optimization |

## Event API 一键预设对照

前六项是 MeetROAS 浏览器 / PWA 事件；下游 Partner Event API 只接收 account_registration、first_deposit、first_day_deposit、deposit、login。— 表示无映射，不会自动建立。预设仅供建议；手动设置可选平台事件目录及平台支持的自定义名称。括号中的 alternative 是示例，并非完整选项。standard / custom 表示上游事件类型。pwa_open 是隐藏运行时事件，不在一键预设或公开 Goal 选择中，不能与 pwa_first_open 混用。

| MeetROAS event_key | TikTok Events API |
| --- | --- |
| landing_view | ViewContent (standard) |
| install_click | InstallClick (custom) |
| install_prompt_accepted | InstallPromptAccepted (custom) |
| pwa_install | Download (standard) |
| pwa_open_attempt | — |
| pwa_first_open | PWAFirstOpen (custom) |
| account_registration | CompleteRegistration (standard) |
| first_deposit | FirstDeposit (custom) |
| first_day_deposit | FirstDayDeposit (custom) |
| deposit | Purchase (standard) |
| login | Login (custom) |

## 怎样确认成功

MeetROAS 已依公开官方契约检查请求格式、事件映射、回应判定与去重；没有真实帐号，因此未宣称全链路实证。Events Manager diagnostics 仍可作为自愿核对。

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

## 注意事项

- 若同时使用浏览器 Pixel 与服务器事件，event name 与 event_id 必须相同才能去重。同一交易只选择 Deposit 或 First Deposit 其中一种语意回报。