# MGSkyAds × MeetROAS

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

## 能不能用

可以使用。MeetROAS 会固定从 157.230.193.182 发送；请先将该 IP 提供给 MGSkyAds，储存自己的 Pixel ID 与事件设定后发一次测试，平台后台或 log 显示对应 eid 后即可开始投放。

- 平台入口: MGSkyAds Event API 与服务器 IP 设置
- 点击 macro: `{pixel_click_id}`
- 官方文件: https://interactive.craft.me/j95Jr30fQ8q6FZ

## 复制什么，贴到哪里

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

## 需要准备的资料

MGSkyAds 不是复制 URL Postback 的模式。MeetROAS 始终以固定出口 157.230.193.182 呼叫官方 Event API；Campaign 共享一个 Pixel ID，各事件选择固定 eid。

## 设定步骤

1. 在 MeetROAS 建立或打开流量来源为 MGSkyAds 的 Campaign，并复制系统产生的投放网址。
2. 把 MeetROAS 投放网址设为 MGSkyAds Campaign URL；网址含 pixel_click_id={pixel_click_id}。
3. 将 MeetROAS 固定出口 157.230.193.182 提供给 MGSkyAds，所有请求无论是否启用白名单都从该 IP 发送。
4. 在 MeetROAS 一键建立所有 MGSkyAds 固定 eid 预设；不必先保存 Pixel ID 才能建立对应。Pixel ID 会持续显示并可随时编辑。
5. 使用 MGSkyAds 的测试功能产生真实 pixel_click_id 并打开投放网址；到 MGSkyAds 后台或 log 确认收到对应 eid。

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

## 事件与金额

建议对应：点击安装入口 → EVENT_PWA_INSTALL；点击尝试打开 PWA → EVENT_PWA_OPEN；首次成功打开 → EVENT_PWA_ACTIVATE；注册、首充、充值分别对应 EVENT_COMPLETE_REGISTRATION、EVENT_FIRST_DEPOSIT、EVENT_PURCHASE。尝试打开来自 pwa_open_attempt，不能用安装完成或实际打开代替。首充与充值金额须由下游提供 value／currency。

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

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

| 上游 | value → | price → | currency / 缺值规则 |
| --- | --- | --- | --- |
| 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 对应 |
| --- | --- | --- | --- |
| 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 | MGSkyAds |
| --- | --- |
| landing_view | — |
| install_click | EVENT_PWA_INSTALL |
| install_prompt_accepted | — |
| pwa_install | — |
| pwa_open_attempt | EVENT_PWA_OPEN |
| pwa_first_open | EVENT_PWA_ACTIVATE |
| account_registration | EVENT_COMPLETE_REGISTRATION |
| first_deposit | EVENT_FIRST_DEPOSIT |
| first_day_deposit | — |
| deposit | EVENT_PURCHASE |
| login | — |

## 怎样确认成功

使用 MGSkyAds 的测试功能产生真实 pixel_click_id 并打开投放网址；到 MGSkyAds 后台或 log 确认收到对应 eid。

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

## 注意事项

- 不要把浏览器参数或自行发明的 eid 直接送往 MGSkyAds；事件由 MeetROAS 固定出口服务器传送，金额只来自目标平台签章事件。