# MeetROAS 流量来源整合

以下平台都已支持，可以使用。没有 MeetROAS tile 时请选择 Custom／Other tracker。设定后发送一次测试转换，最后以流量商后台显示成功为准。

- [Meta (Facebook CAPI)](https://developers.meetroas.com/sources/meta.md) — `fbclid`
- [TikTok Events API](https://developers.meetroas.com/sources/tiktok.md) — `ttclid`
- [TrafficStars](https://developers.meetroas.com/sources/trafficstars.md) — `{click_id}`
- [PropellerAds](https://developers.meetroas.com/sources/propellerads.md) — `${SUBID}`
- [RichAds](https://developers.meetroas.com/sources/richads.md) — `[CLICK_ID]`
- [ExoClick](https://developers.meetroas.com/sources/exoclick.md) — `{conversions_tracking}`
- [Adsterra](https://developers.meetroas.com/sources/adsterra.md) — `##SUB_ID_SHORT(action)##`
- [BidVertiser](https://developers.meetroas.com/sources/bidvertiser.md) — `{BV_CLICKID}`
- [HilltopAds](https://developers.meetroas.com/sources/hilltopads.md) — `{{ctoken}}`
- [EvaDav](https://developers.meetroas.com/sources/evadav.md) — `{CLICKID}`
- [AdMaven](https://developers.meetroas.com/sources/admaven.md) — `{:click_id}`
- [AdsGram](https://developers.meetroas.com/sources/adsgram.md) — `{record_data}`
- [Kadam](https://developers.meetroas.com/sources/kadam.md) — `{click_id}`
- [GeeMee](https://developers.meetroas.com/sources/geemee.md) — `{pixel_click_id}`
- [MGSkyAds](https://developers.meetroas.com/sources/mgsky.md) — `{pixel_click_id}`

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

方向：下游 → 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} | pwa_install → Global；每个 Campaign 一个绑定。回传不带 status、cost、payout 或 currency；投放网址可另用 {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 | EVENT_PWA_ACTIVATE |
| 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 | — |