将您的分析工具与 AMP 集成

重要提示：此文档不适用于您当前选择的格式 电子邮件！

概述

如果您运营软件即服务工具，帮助发布商更好地了解其流量和访问者，您可能需要将您的服务集成到 amp-analytics 中。这将使您的客户能够查看其 AMP HTML 页面的流量模式。

开始之前

在将您的分析服务添加到 AMP HTML 运行时之前，您可能需要

确定您的分析服务在 AMP HTML 文档中所需的变量和请求的类型。
确定导致从页面发送分析请求的触发器，这些触发器将与您的服务相关。
考虑您是否以及如何跨第一方和第三方 AMP 上下文跟踪用户。
确定您的分析仪表板如何处理 AMP 流量。
确定 amp-analytics 中是否有任何缺失的功能，并为所需功能提交功能请求。
AMP Analytics 将其变量发送到预配置的端点。如果您还没有现有的端点，请查看此示例，了解如何构建端点的概述。
- 对于除 iframe 之外的所有传输类型，变量都作为 HTTPS 请求中的查询字符串参数发送。
- 对于 iframe 传输类型，会创建一个 iframe，并通过 window.postMessage 将变量发送到该 iframe。在这种情况下，消息不必是 URL。此选项仅适用于经 MRC 认证的供应商。
考虑与 amp-analytics 的集成可能会如何影响您可能拥有的任何政策（尤其是您的隐私政策）或协议。

将您的配置添加到 AMP HTML 运行时

创建一个打算实施的问题，声明您将把您的分析服务的配置添加到 AMP HTML 的运行时中。请务必在描述中包含 cc @ampproject/wg-components。
开发一个实现以下内容的补丁
1. 在 vendors 文件夹中，创建一个新的配置 json 文件 ${vendorName}.json，其中包含超出默认值的任何选项，例如
  1. "vars": {} 用于其他默认变量。
  2. "requests": {} 用于您的服务将使用的请求。
  3. "optout": 如果需要。我们目前没有很好的退出系统，所以请联系我们，帮助我们设计一个适合您的系统。
  4. "warningMessage": 如果需要。在控制台中显示来自供应商的警告信息（例如弃用或迁移）。
2. 如果您正在使用 iframe 传输，还需要在 iframe-transport-vendors.js 中的 ANALYTICS_IFRAME_TRANSPORT_CONFIG 中添加一行，其中包含 "*vendor-name*": "*url*"
3. 在 examples/analytics-vendors.amp.html 中的示例。参考。
4. 在 extensions/amp-analytics/0.1/test/vendor-requests.json 文件中的测试。
5. 将您的分析服务添加到 extensions/amp-analytics/0.1/analytics-vendors-list.md 文件中的受支持供应商列表中。包括类型、描述和指向您的使用文档的链接。
测试您放在 examples/analytics-vendors.amp.html 中的新示例，以确保该示例的点击按预期工作。例如，正在收集所需的数据并显示在您的分析仪表板中。
提交包含此补丁的拉取请求，并引用“打算实施”问题。
更新您服务的使用文档并通知您的客户。
强烈建议维护AMP 仓库之外的集成测试。

代码管理器

代码管理服务有两种与 AMP Analytics 集成的方法

端点方法：充当 amp-analytics 的附加端点，并在后端进行营销管理。
配置方法：通过动态生成的 JSON 配置文件（每个发布商独有）进行代码管理。

端点方法与上一节中详述的标准方法相同。配置方法包括为每个发布商创建特定的 amp-analytics 唯一配置，并包含其所有兼容的分析包。发布商将使用类似于此的语法包含配置

<amp-analytics
  config="https://my-awesome-tag-manager.example.com/user-id.json"
></amp-analytics>

要采用此方法，请查看发布商与 AMP Analytics 集成的文档。

将您的分析工具与 AMP 集成

概述

开始之前

将您的配置添加到 AMP HTML 运行时

代码管理器

更多资源