将您的分析工具与 AMP 集成

概述

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

开始之前

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

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

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

创建一个Intent-To-Implement 问题，说明您将把您的分析服务的配置添加到 AMP HTML 的运行时。请务必在您的描述中包含 cc @ampproject/wg-components。
开发一个实现以下内容的补丁
1. 供应商文件夹中的一个新的配置 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 中的新示例，以确保示例中的命中按预期工作。例如，所需的数据正在收集并显示在您的分析仪表板中。
提交包含此补丁的 Pull Request，并引用 Intent-To-Implement 问题。
更新您服务的使用文档并通知您的客户。
强烈建议维护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 运行时

标签管理器

更多资源