(应用程序接口转换)应用程序接口元转换

文档
只有使用Singular的网页、电脑和控制台 游戏归因功能的Singular客户才能获得网页电脑和控制台事件的转换回传功能。

Singular与Meta转换应用程序接口(Meta Conversions API)的整合允许广告商将Singular归因的Meta点击转换发送至Meta。Singular网页、PC和游戏机测量均支持这种整合。关于Singular与Meta的移动测量整合,请参阅我们帮助中心的相关文章

如何配置 Meta 转换 API 集成

  1. 确保您有一个与Singular集成的网页电脑或控制台应用程序
  2. 转到 Singular > 归因 > 合作伙伴配置
  3. 点击 "添加合作伙伴",输入并选择 "Meta Conversions API
  4. 在对话框中,选择要配置的应用程序和应用程序站点(平台)。请注意,此集成仅支持网页、PC 和控制台应用程序
  5. Meta Event Manager面板粘贴应用程序的"访问令牌"和"数据集 ID"。


  6. 可选择配置要发送到 Meta 的其他事件,并将其映射到 "Meta 事件名称"。


  7. 单击 "保存 "完成。

常见问题

在哪里可以找到 Meta 数据集 ID?
  1. 导航至Meta 事件管理器
  2. "数据源"下,选择网络/PC/控制台数据源

    如果这是新数据源,请通过"连接数据源"创建新数据源,并按照 Meta 的逐步指南创建"网络"数据源。点击此处阅读有关Meta 数据源的更多信息。
  3. "设置"下,复制您的"数据集 ID"
在哪里可以找到访问令牌?
  1. 导航至Meta 事件管理器
  2. "数据源"下,选择网络/PC/控制台数据源。


    如果这是新数据源,请通过"连接数据源"创建新数据源,并按照 Meta 的逐步指南创建"网络"数据源。点击此处阅读有关Meta 数据源的更多信息。
  3. "设置"下拉至"转换 API",在"设置直接集成"下生成并复制访问令牌。

Singular通过API发送哪些数据?
参数 详细信息
event_name
  • 标准事件或自定义事件名称。该字段会自动映射到 Singular 事件名称。此值用于协助 META 重复数据删除事件。event_id 参数也用于重复数据删除。
fbc
  • Facebook 点击 ID
  • 自动传递
hashed email
  • 可选
  • 散列电子邮件可作为奇异工具事件属性 "ehash "传递
  • 哈希电子邮件值必须经过规范化和 SHA 256 哈希处理
hashed phone number
  • 可选
  • 散列电话号码可作为奇异工具事件属性 "phash "传递
  • 哈希电话号码必须经过E164标准化和 SHA 256 哈希处理
hashed first name
  • 可选
  • 散列姓名可作为奇异事件属性 "fnamehash "传递
  • 建议使用罗马字母 a-z 字符。只使用小写字母,不使用标点符号。如果使用特殊字符,文本必须以 UTF-8 格式编码。
  • 哈希后的姓名必须是 SHA 256 哈希值
hashed last name
  • 可选
  • 散列姓氏可作为奇异事件属性 "fnamehash "传递。
  • 建议使用罗马字母 a-z 字符。只使用小写字母,不使用标点符号。如果使用特殊字符,文本必须以 UTF-8 格式编码。
  • 哈希姓氏必须是 SHA 256 哈希值
IP address
  • 客户端 IP 地址
user agent
  • (仅限网络)事件对应浏览器的用户代理
事件重复数据删除(可选)
event_id
  • 重复数据删除所需的参数
  • 使用属性名称"eventId"将事件参数中的事件 ID 值传递给 Singular。

元要求:

  • 必须在转换 API 和浏览器像素事件中添加event_id参数。
  • event_id参数是一个标识符,可唯一区分类似事件。了解有关event_id参数的更多信息。
Meta Conversions API 有哪些限制?
  • Meta 建议使用 Meta 转换 API 来增强现有的 Meta 像素实施。
  • 对于移动整合,Meta 和 Singular 建议通过Singular与 Meta的专用移动归因整合来传递移动转换数据。如果您对通过 Meta Conversions API 传递移动转换数据感兴趣,请联系您的 Singular 客户成功经理。