流量來源整合
將目標事件回傳到廣告平台
以下平台都已支援，可以使用。平台沒有 MeetROAS tile 時，請選擇 Custom／Other tracker；每篇指南會直接告訴你要複製什麼、貼到哪裡。
已支援、可以使用的平台
設定完成後請傳送一次測試轉換，最後以流量商後台顯示成功為準。
Meta (Facebook CAPI)可以使用 · 官方契約已驗證 · fbclidTikTok Events API可以使用 · 官方契約已驗證 · ttclidTrafficStars可以使用 · 設定後測試 · {click_id}PropellerAds可以使用 · 設定後測試 · ${SUBID}RichAds可以使用 · 設定後測試 · [CLICK_ID]ExoClick可以使用 · 設定後測試 · {conversions_tracking}Adsterra可以使用 · 設定後測試 · ##SUB_ID_SHORT(action)##BidVertiser可以使用 · 設定後測試 · {BV_CLICKID}HilltopAds可以使用 · 設定後測試 · {{ctoken}}EvaDav可以使用 · 設定後測試 · {CLICKID}AdMaven可以使用 · 設定後測試 · {:click_id}AdsGram可以使用 · 官方契約已驗證 · {record_data}Kadam可以使用 · 全鏈路已實證 · {click_id}GeeMee可以使用 · 白名單後測試 · {pixel_click_id}MGSkyAds可以使用 · 固定 IP 後測試 · {pixel_click_id}
共同流程
- 在 MeetROAS Campaign 選擇正確的流量來源。
- 複製 MeetROAS 產生、已帶平台 click macro 的投放網址。
- 在廣告平台取得帳號專屬 Postback，或為 Event API 儲存帳號設定。
- 依頁面指示一鍵建立預設，或只在平台要求時逐事件建立對應。
- 回到流量商後台確認轉換成功；以流量商後台顯示為準。
下游金額 → 上游參數對照
方向：下游 → MeetROAS Partner Event API → 歸因來源。value 是收益，price 是獲客成本，currency 是下游宣告的幣別。— 表示目前 MeetROAS connector 不投影該欄位，不代表上游沒有該功能。URL 金額欄列出可選範本 placeholder：範本有該參數且下游有該金額才替換，缺少金額就移除；不會自動加參數、互相代填或換匯。註冊與登入不能攜帶金額。
| 上游 | value → | price → | currency / 缺值規則 |
|---|---|---|---|
| Meta (Facebook CAPI) | data[].custom_data.value | — | data[].custom_data.currency；value 與 currency 齊全才傳送金額物件；不換匯 |
| TikTok Events API | data[].properties.value | — | data[].properties.currency；value 與 currency 齊全才傳送金額物件；不換匯 |
| TrafficStars | value={value} | price={price} | 不投影 currency；不換匯 |
| PropellerAds | payout=${PAYOUT} | — | 不投影 currency；不換匯 |
| RichAds | — | — | 不投影 currency；不換匯 |
| ExoClick | value={value} | — | 不投影 currency；不換匯 |
| Adsterra | — | atpay={payout} | /name/.../at 為 USD；/code/CCC/.../at 為 CCC；currency 不另傳，若明示且與 URL 不同則拒絕，不換匯 |
| BidVertiser | revenue={REVENUE} | — | 不投影 currency；不換匯 |
| HilltopAds | — | price={{price}} | currency={{currency}} 原樣替換；範本必須同時帶 price。缺 price 時兩者都移除，缺 currency 時只移除 currency；不換匯 |
| EvaDav | payout={PAYOUT} | — | 不投影 currency；不換匯 |
| AdMaven | value={payout} | — | 不投影 currency；不換匯 |
| AdsGram | — | — | 不投影 currency；不換匯 |
| Kadam | — | — | 不投影 currency；不換匯 |
| GeeMee | data.value | — | data.currency；value 與 currency 齊全才傳送，否則 data={}；不換匯 |
| MGSkyAds | data.value | — | data.currency；first_deposit / deposit 必須同時有 value 與 currency，否則拒絕；first_day_deposit 可傳兩者或 data={}；其他事件僅接受 data={}；不換匯 |
點擊、Goal 與槽位預設
點擊 macro 由上游展開為真實 click ID，再由 MeetROAS 回傳；不是下游的 mrc_。下表是目前新增預設的行為，既有手動綁定不會被自動覆蓋。帳號識別與 URL 必須從各上游取得，不從槽號或 token 推測事件。
| 上游 | 投放網址 macro / 參數 | 回傳 click 欄位 | 事件 / Goal 對應 |
|---|---|---|---|
| Meta (Facebook CAPI) | fbclid | data[].user_data.fbc ← fb.1.<clickObservedAtMs>.<fbclid> | data[].event_name 使用下表預設 |
| TikTok Events API | ttclid | data[].user.ttclid | data[].event 使用下表預設；custom 事件不用於 Campaign optimization |
| TrafficStars | {click_id} | clickid={click_id} | goalid：帳號的 Goal ID，逐事件手動綁定；無一鍵預設。lead_code={lead_code} 由穩定的不透明 MeetROAS 事件識別替換 |
| PropellerAds | ${SUBID} | visitor_id=${SUBID} | pwa_install → Main（不帶 goal）；account_registration → goal=2；first_deposit → goal=3。每槽一個綁定，只有 Main 用於 CPA 優化 |
| RichAds | [CLICK_ID] | key=[CLICK_ID] | pwa_install → action=conversion；first_deposit → action=conversion1（Approved）。每槽一個綁定 |
| ExoClick | {conversions_tracking} | tag={conversions_tracking} | goal：帳號產生的 32 位 token；不從 token 推測業務名稱；無一鍵預設 |
| Adsterra | ##SUB_ID_SHORT(action)## | subid_short={clickid} | 主轉換不帶 event；其他槽為 event=event1 / event2 / event3。槽號沒有業務語意；無一鍵預設 |
| BidVertiser | {BV_CLICKID} | CLICKID={BV_CLICKID} | pwa_install → Global（不帶 Goal）；每 Campaign 一個綁定，同一 click 的重複轉換會被上游忽略 |
| HilltopAds | {{ctoken}} | token={{ctoken}} | 無既有 Main 時 pwa_install → Main（無 goal），其餘公開事件 → Micro（goal=<event_key>）；已有 Main 時新預設全為 Micro |
| EvaDav | {CLICKID} | click_id={CLICKID} | 無一鍵預設；逐事件綁定帳號產生的 URL |
| AdMaven | {:click_id} | unique_req={externalid} | 主轉換不帶 dimension；第二轉換使用 dimension=adp，不可用於第一轉換。info 來自帳號 URL；無一鍵預設 |
| AdsGram | {record_data} | record={record_data} | account_registration → goaltype=1；first_deposit → goaltype=2；deposit → goaltype=3。token 來自 AdsGram 帳號；每槽一個綁定 |
| Kadam | {click_id} | data={click_id} | 每筆事件可設定 literal status，預設使用事件 key；Kadam 端需設定相同接收字串。舊 data-only 綁定需先改為明確 status 或撤銷，才可加入其他對應。分類與計數由 Kadam 決定，不傳金額；{cpc} 僅記錄點擊成本 |
| GeeMee | {pixel_click_id} | pixel_click_id | eid 使用下表預設；pixel_id 來自帳號。替代事件須手動選擇 |
| MGSkyAds | {pixel_click_id} | pixel_click_id | eid 使用下表預設；pixel_id 來自帳號。沒有映射的事件不建立綁定 |
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 | Meta (Facebook CAPI) | TikTok Events API | GeeMee | MGSkyAds |
|---|---|---|---|---|
| landing_view | ViewContent (standard) | ViewContent (standard) | EVENT_CONTENT_VIEW | — |
| install_click | InstallClick (custom) | InstallClick (custom) | — | EVENT_PWA_INSTALL |
| install_prompt_accepted | InstallPromptAccepted (custom) | InstallPromptAccepted (custom) | EVENT_PWA_INSTALL | — |
| pwa_install | PWAInstall (custom) | Download (standard) | — | — |
| pwa_open_attempt | — | — | EVENT_PWA_OPEN | — |
| pwa_first_open | PWAFirstOpen (custom) | PWAFirstOpen (custom) | EVENT_PWA_ACTIVATE | — |
| pwa_first_entry | — | — | — | EVENT_PWA_OPEN |
| account_registration | CompleteRegistration (standard) | CompleteRegistration (standard) | EVENT_COMPLETE_REGISTRATION | EVENT_COMPLETE_REGISTRATION |
| first_deposit | FirstDeposit (custom) | FirstDeposit (custom) | EVENT_FIRST_DEPOSIT (alternative: EVENT_FTD) | EVENT_FIRST_DEPOSIT |
| first_day_deposit | FirstDayDeposit (custom) | FirstDayDeposit (custom) | EVENT_FIRST_DAY_PURCHASE | — |
| deposit | Purchase (standard) | Purchase (standard) | EVENT_PURCHASE (alternative: EVENT_REPEAT_PURCHASE) | EVENT_PURCHASE |
| login | Login (custom) | Login (custom) | EVENT_LOGIN | — |