已支援 · 可以使用
TikTok Events APIMeetROAS
將 MeetROAS 投放網址放進 TikTok Events API，再把平台產生的轉換設定貼回 MeetROAS。沒有 MeetROAS tile 時請選擇 Custom／Other tracker。
能不能用
官方契約驗證已通過；儲存有效的資料來源 ID 與 Access Token 後即可啟用正式回傳。
複製什麼，貼到哪裡
| 複製 | 貼到 |
|---|---|
| MeetROAS 產生、含 ttclid 的完整投放網址 | Website URL |
| 輸入 Pixel Code 與 Access Token | MeetROAS Campaign → 轉換整合 |
局部介面操作圖
Events Manager → Web Events → Settings → Events API
貼上 MeetROAS 產生的完整投放網址網址必須保留ttclid
Campaign → 轉換整合
輸入 Pixel Code 與 Access Token✓ 最後到 TikTok Events API 後台確認轉換成功
需要準備的資料
| 平台入口 | Events Manager → Web Events → Settings → Events API |
|---|---|
| 點擊 macro | ttclid |
| 回傳方式 | Server Event API |
MeetROAS 使用 Events API 2.0；Access Token 只加密儲存，不是 Postback URL。
設定步驟
- 在 MeetROAS 建立或開啟流量來源為 TikTok Events API 的 Campaign，並複製系統產生的投放網址。
- 建立或選擇 Web 資料來源並產生 Access Token。
- 把 MeetROAS Website URL 設為投放網址，保留 ttclid。
- 輸入 Pixel Code 與 Access Token，一鍵建立官方事件預設；Token 不會回顯。
- 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) |
| pwa_first_entry | — |
| account_registration | CompleteRegistration (standard) |
| first_deposit | FirstDeposit (custom) |
| first_day_deposit | FirstDayDeposit (custom) |
| deposit | Purchase (standard) |
| login | Login (custom) |
怎樣確認成功
MeetROAS 已依公開官方契約檢查請求格式、事件映射、回應判定與去重；沒有真實帳號，因此未宣稱全鏈路實證。Events Manager diagnostics 仍可作為自願核對。
- 測試點擊由平台產生，並在 MeetROAS 歸因到正確來源。
- MeetROAS 顯示事件已接收，且重試不會建立重複事件。
- 最後請到 TikTok Events API 後台確認轉換已成功收到；以該平台後台顯示為準。
注意事項
- 若同時使用瀏覽器 Pixel 與伺服器事件，event name 與 event_id 必須相同才能去重。同一交易只選擇 Deposit 或 First Deposit 其中一種語意回報。