将您的分析工具与 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. 在供应商文件夹中创建一个新的配置 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 运行时

标签管理器

更多资源