文档已更新。
中文(简体) 译文尚未完成。
英语更新时间:4月25日

转化 API 网关:设置指南

使用以下步骤设置转化 API 网关。

阅读本设置指南之前,请确保您已查看并完全满足转化 API 网关的前提条件

第 1 步:开始设置并着手部署

要开始设置流程,请前往 Meta 事件管理工具中的“设置”选项卡。在“设置转化 API 网关”下点击开始



  • 查看转化 API 网关的前提条件,然后选择下一步

选择偏好设置

  • 选择要启用的设置,然后点击继续

    • 增强事件可帮助完善转化归因分析,最大限度地优化您目前与 Meta 分享的事件的表现。
    • 监控转化 API 网关状况,Meta 可更有效地排查潜在问题。


  • 接着,在选择您的托管区域下选择所需的区域。您只能在一个区域中设置转化 API 网关。
  • 点击下一步以打开 Amazon Web Services (AWS);或点击复制网址以将网址发送给您组织的 AWS 账户管理员。

第 2 步:配置 AWS 和安装

如果您尚未登录 AWS,请先登录。

  • 系统会开启转化 API 网关堆栈的快速创建流程。

  • 系统会预先填入全部字段。请勿更改 ProvisioningData 字段。
  • 点击 Create stack(创建堆栈),开始安装。
  • 创建过程耗时约 30 至 40 分钟,此后系统会将 3 项输出信息写入新 AWS 实例的“Outputs”(输出)选项卡。当“Stack info”(堆栈信息)选项卡中的状态显示 CREATE_COMPLETE 时,即表示已创建完毕。
  • 创建完毕后,前往 Outputs(输出)选项卡。
  • (推荐)创建自定义网域帮助数据路由,请参阅下文第 4 步
  • 记下 CapigSetupURL,您需要将其用于预配转化 API 网关用户界面。

第 3 步:验证数据收集

如要进入转化 API 网关管理员用户界面,请使用“Outputs”(输出)选项卡中的 CapigSetupURL(参考第 2 步)。在 Meta 事件管理工具中也能找到 CapigSetupURL。

  • 首次登录管理员用户界面时,系统会提示您创建一个管理员账户。
  • 创建管理员账户后,选择 Log in(登录)
  • 您将看到转化 API 网关管理员用户界面站点。
  • 您第一次查看该站点时,服务器和浏览器数据可能为 0。填充此信息可能需要 5 分钟到 2 小时。
  • 如要核实系统是否正在收集数据,您可以转到您的网站并刷新页面。
  • 如果 2 小时后仍未填充事件,请联系 Meta。
  • 现在您会在 Pixel 像素代码设置下看到转化 API 网关。

(推荐)第 4 步:添加自定义网域

在转化 API 网关管理员用户界面中设置自定义网域。建议添加自定义网域,此网域可帮助优化数据路由,并可降低成本。

注意:您需要访问 DNS 提供方才能添加自定义网域

  • 登录转化 API 网关的管理员用户界面。
  • 前往左侧边栏中设置下的网域管理
  • 选择 DNS 提供方的 AWS Certificate Manager (ACM) 或 Cloudflare。

1. AWS Certificate Manager

请遵循 ACM 设置说明完成设置。

2. Cloudflare

请遵循 Cloudflare 设置说明完成设置。

排查设置问题

设置转化 API 网关时,使用以下步骤排查问题。对于一般故障排除,请参阅转化 API 网关 — 对错误和警告进行故障排除

浏览器自动填充干扰设置

如果由于预配数据过期而无法安装转化 API 网关,即使您是在事件管理工具中启动的安装,浏览器的自动填充功能也可能会自动填充之前用过的信息。

诊断

  1. 在事件管理工具中启动安装,并保存预配数据以供日后检查。
  2. 点击复制网址,并将复制的网址保存到任何文本编辑器中,如 Notepad。
  3. 点击开始部署,启动 AWS 创建页面。
  4. 在 AWS 创建页面,找到 ProvisioningData,并验证该条目是否与您之前复制的网址一致。如果不一致,说明自动填充功能已打开,您必须将其关闭。

解决方案

对于 FireFox 浏览器,请使用以下步骤:

  1. 点击 FireFox 浏览器的菜单图标(屏幕右上方的三条横线)。
  2. 点击“设置”。
  3. 选择隐私与安全设置。
  4. 滚动至历史记录。对于 FireFox 浏览器,需要为历史记录选择使用自定义设置
  5. 取消选择记住搜索和表单历史
  6. 系统会自动保存您的更改。

对于 Chrome 浏览器,请使用以下步骤:

  1. 点击 Chrome 浏览器的菜单图标(屏幕右上方的三个点)。
  2. 点击“设置”。
  3. 选择自动填写设置。
  4. 展开相应区域。
  5. 关闭自动填写设置。
  6. 系统会自动保存您的更改。

其他配置

通过 Meta 事件管理工具,您可以添加新连接,配置更多网域,以及对现有的转化 API 网关连接添加新的 Pixel 像素代码。如要指定相关选项,请按以下步骤操作:

点击显示在页面左侧的合作伙伴集成



选择转化 API 网关以将其打开。



在此界面中,您可以查看:

  • 网站事件
    1. 事件是在您的转化 API 网关站点中设置的网站操作,并且会通过 Meta Pixel 像素代码向 Meta 另行发送。
  • 网站网域
    1. 将转化 API 网关配置为通过 Pixel 像素代码与之相连的网站。


点击设置并选择您要执行的操作。

再添加一个转化 API 网关连接

通过此设置,您可使用另一个 Meta Pixel 像素代码设置新的转化 API 网关实例。下方显示的是对话框中的第一步,这与 Meta Pixel 像素代码设置页面中的步骤相似。接下来需要选择 Meta Pixel 像素代码以安装新的转化 API 网关连接。

在现有转化 API 网关连接中再添加一个 Meta Pixel 像素代码

通过此选项,您可以为已安装好的转化 API 网关再添加一个 Meta Pixel 像素代码。

要开始设置流程,请前往 Meta 事件管理工具中的设置选项卡。在“现有转化 API 网关”部分,点击连接按钮: