#广告事件上报

目前系统支持 Facebook、TikTok、Kwai、MgskyAds 等多个广告平台的事件回传。 调用本 API 的调用方无需区分链接来自哪方广告平台，ROIBest 系统会自动区分并将事件回传至对应的来源。

::: tip 区分渠道 如果需要区分哪些渠道可以通过调用查询广告参数接口查询链接的参数，通过channel_id区分

• "4" = Facebook
• "5" = Tiktok
• "9" = Kwai
• "10" = Google
• "20" = 小步网络
• "21" = OKSPIN
• "22" = SNAPTUBE
• "23" = BIGO
• "24" = APPLUCK
• "34" = Trafficstars
• "56" = MG SKY
• "58" = Macan Native
• "60" = Propellerads
• "61" = MiniTrax :::

推广链接不可跨渠道投放，即在 MIS 中获取的 tiktok 渠道推广链接不可放在 Kwai 平台上，这会导致识别的来源出错，从而导致事件回传失败。

在调用本 API 之前，需要完成广告配置。并且调用 API 所传递的 link_id 必须是从广告平台进入生成的 ID。

#请求参数

请使用 JSON 格式在 Request Body 中传递；event_name 请根据各个广告平台的事件名进行传递，extra里的数据请根据各个平台的对应事件的相关额外字段进行传递，我们会对应发送给各个平台。即event_name事件名和extra里的字段按各个平台不同的情况来写。

关于是否需要传递额外参数请查询各广告平台的事件定义。以下是 Facebook 平台部分需要提供的额外字段的事件：

#响应参数

服务器固定以 JSON 方式返回响应。

#示例

#请求示例

{
   "link_id": "4740128923061846",
  "event_name": "Purchase",
  "extra": {
      "currency": "USD",
      "value": 19.99,
      "is_upgrade_version": 1
   }
}

#返回示例

{
   "code": 0,
   "msg": "success",
   "data": {}
}

#MgskyAds 渠道说明

#标准事件枚举

MgskyAds 仅识别以下 3 个标准事件，event_name 请从下表中选择：

#API 上报事件映射

如果您在 API 调用中使用的 event_name 与上方标准枚举不一致（例如填写了 purchase、pay、register 等自定义名称），可以在 ROIBest MIS → 像素配置 → MgskyAds → 编辑弹窗中配置 API 上报事件映射规则。

配置映射后，ROIBest 会在转发前将自定义 event_name 自动替换为对应的 MgskyAds 标准事件：

• 匹配规则：大小写不敏感，自动忽略前后空格（Purchase、purchase、PURCHASE 视为同一项）
• 未命中映射：event_name 原名透传至 MgskyAds，不丢弃、不报错
• 未配置任何映射：所有上报均以原 event_name 透传

示例：

映射配置（在 MIS 中设置）：

API 上报：

{
  "link_id": "4740128923061846",
  "event_name": "Purchase",
  "extra": { "currency": "USD", "value": 19.99 }
}

实际转发给 MgskyAds：

{
  "link_id": "4740128923061846",
  "event_name": "EVENT_PURCHASE",
  "extra": { "currency": "USD", "value": 19.99 }
}