转化 API

转化 API 网关 - 对错误和警告进行故障排除

如果您发现服务器事件缺失，或服务器事件数量低于浏览器事件，请使用本文档来排查问题。如需了解故障排除工具，请参阅转化 API 网关 - 故障排除工具。

使用以下故障排除步骤来帮助发现问题：

  1. 导航至“事件管理工具”
  2. 在浏览器中打开网站
  3. 转化 API 网关管理员用户界面

未将网域配置为发送事件

转化 API 网关将接收您在集成设置期间配置的已关联网域所发出的事件。如果服务器事件的数量看似低于浏览器事件，可能是因为 Pixel 像素代码发送事件时所在的网域尚未与 Meta 关联。

诊断

  • 登录事件管理工具
  • 选择相应事件
  • 点击查看详情，然后选择事件概览
  • 从左侧的下拉列表中选择网域，找到浏览器事件发出时所在的网域
  • 如果这些网域缺失或不同于配置的网域，则预计不会成功收到浏览器事件

解决方案

  • 遵循本指南，在您的转化 API 网关关联界面添加所要求的网域。

DNS 未配置或 DNS 映射错误

转化 API 网关托管在创建时为其分配 IP 地址的 AWS 上。您必须将网域的子域映射到此 IP 地址，以便可以通过第一方请求调用从浏览器访问转化 API 网关端点。

诊断

  • 使用 https://dnschecker.org/ 等在线 DNS 检查工具，验证转化 API 网关网域是否已解析到正确的 IP 地址并已完全传播。如果网域未解析到任何 IP 地址，请参阅解决方案部分，以便执行后续步骤。
  • 从您的 AWS EC2 面板获取转化 API 网关服务器的 IP 地址，或向您的云基础架构联系人询问此信息。
  • 如果两个 IP 地址不同，请参阅解决方案部分，以便执行后续步骤。

解决方案

  • 与网域注册服务机构的管理员合作。
  • 使用您转化 API 网关服务器的 IP 地址（显示在 AWS EC2 面板上）更新网域注册服务机构中的 DNS 记录。
    • 创建一条 DNS A 记录，将您的转化 API 网关子域映射到设置期间生成的服务器 IP 地址。

证书从未颁发

如果转化 API 网关从未从 Let’s Encrypt 获得颁发的证书（即使 DNS 正确配置了很长一段时间），这意味着您的网域太过普通，以致 Let’s Encrypt 拒绝颁发证书。

解决方案

  • 考虑在转化 API 网关实例之前放置 AWS 负载均衡器 (ALB)，并使用 ALB 托管您拥有的证书。

证书已颁发，但过期了

如果您在成功安装转化 API 网关后关闭了端口 80，或者您正在运行旧版本，就会出现此问题。

解决方案

  • 打开端口 80，并将转化 API 网关升级至最新版本。

无法访问网关用户界面

如果您在成功安装转化 API 网关后关闭了端口 80，或者您正在运行旧版本，就会出现此问题。

解决方案

  • 确认转化 API 网关实例的 IP 地址与 DNS 配置一致。如果不一致，请参阅 DNS 未配置或 DNS 映射错误。
  • 如果服务器没有响应，这可能是因为网络临时出错，可以通过重新启动实例解决问题。转化 API 网关可能需要几分钟才能启动，因此请等待 10 分钟左右再重新登录。

网关需要升级版本

v1.0.8 之前版本的转化 API 网关似乎已停止向 Meta 发送事件。建议您将网关至少升级至 v1.0.8，以充分发挥设置的优势。此操作会恢复事件流程，确保将来会自动更新。

诊断

  • 如要查看转化 API 网关的最新版本：
    • 打开转化 API 网关的管理员用户界面：
https://<Conversions API Gateway Endpoint>/hub
  • 查看转化 API 网关服务器的最新版本：
    • 左侧菜单 > 设置 > 更新

解决方案

如要升级转化 API 网关，请执行以下操作：

利用 EKS 日志排除故障

如果您在安装单账户 EKS 版或多账户版的转化 API 网关时遇到任何问题，请参考相应日志来排查问题。

在组名“ConversionsAPIGateway/cloud-init-output.log”下的“AWS Cloudwatch”中，可获取 EKS 安装日志。您可以检查是否有任何错误消息。常见错误包括超出 AWS 资源上限和缺少 AWS 权限。



CAA 类 DNS 记录中没有 amazonaws.com

如果转化 API 网关要求创建的 DNS 记录中有一个正确的 TLS 证书或没有 CAA 记录，可忽略此节内容。

如果您有此网域的 CAA 记录，并且您安装了 AWS EKS 版本的单账户专用转化 API 网关或 1.10.* 或更高版本的多账户专用转化 API 网关（使用 AWS Certificate Manager 来创建网域），请务必提供 amazonaws.com 作为该 CAA 记录的值。CAA 记录示例如下：

0 issue "amazonaws.com"

如果您安装了 1.9.* 或更早版本的多账户专用转化 API 网关，请务必提供 letsencrypt.org 作为 CAA 记录的值。示例如下：

0 issue "letsencrypt.org"

另请参阅