加入分析会话

在 Playground 中打开

简介

Linker 是一项 amp-analytics 功能，用于将用户会话从 AMP 缓存域加入到发布商原始域。有关完整文档，请参阅组件的参考。

如果您想了解更多关于 AMP 中的客户端 ID 的信息，您可以在此处找到简短的摘要，以及 Google Analytics 特定信息此处。

要查看此整个过程的实际操作，请点击此链接。

设置

在页眉中导入 amp-analytics 组件。

<script async custom-element="amp-analytics" src="https://cdn.ampproject.org/v0/amp-analytics-0.1.js"></script>

将 AMP Linker 与现有的分析提供商配合使用

如果您的分析提供商已经支持 Linker 功能，则启用它只需更改简单的配置。将以下内容添加到您现有的 amp-analytics 配置中。

<amp-analytics type="googleanalytics">
  <script type="application/json">
    {
      "linkers": {
        "enabled": true
      }
    }
  </script>
</amp-analytics>

将 AMP Linker 与自定义分析配合使用

如果您希望设置自己的配置，AMP linker 也支持。在以下示例中，名称为 linker1 的 linker 参数将附加到传出链接。此参数的值将包括 ids 配置对象中的任何键值对。具体在此示例中，将传递两个条目。一个键值对，键为 _a，值为 CLIENT_ID 宏返回的值，另一个键为 v，值为 123。您可以在 ids 对象中包含任意多个条目。

<amp-analytics>
    <script type="application/json">
      {
        ... // existing amp-analytics configuration
        "linkers" : {
          "linker1": {
            "ids": {
              "_a": "CLIENT_ID(_a)",
              "v": 123
            },
            "enabled": true
          }
        }
      }
    </script>
</amp-analytics>

将 AMP Linker 与多个链接器配合使用

您可能还想在一个页面上配置多个链接器。为此，您需要为每个链接器向 linkers 对象添加一个条目。您还可以通过将 enabled: true 条目移动到 linkers 对象下一级来一次启用所有链接器。

<amp-analytics>
    <script type="application/json">
      {
        "linkers" : {
          "enabled": true,
          "linker1": {
            "ids": {
              "_a": "CLIENT_ID(_a)",
            }
          },
          "linker2": {
            "ids": {
              "b": "CLIENT_ID(b)",
            }
          }
        }
      }
    </script>
</amp-analytics>

目标域名

每个链接器还将接受一个可选的 destinationDomains 条目。您可以使用它来仅将链接器参数添加到特定的目标。如果省略此条目，它将默认为源域以及规范域。在下面的示例中，只会修饰指向 example.com 和 ampproject.org 域的链接。这些必须作为域名数组包含在内。

<amp-analytics>
    <script type="application/json">
      {
        "linkers" : {
          "enabled": true,
          "destinationDomains": ['example.com'],
          "linker1": {
            "ids": {
              "_foo": "CLIENT_ID(_foo)"
            }
          }
      }
    </script>
</amp-analytics>

需要进一步解释？

如果本页的解释没有涵盖您的所有问题，请随时联系其他 AMP 用户，讨论您的确切用例。

转到 Stack Overflow

未解释的功能？

AMP 项目强烈鼓励您的参与和贡献！我们希望您能成为我们开源社区的持续参与者，我们也欢迎您对您特别感兴趣的问题做出一次性贡献。

在 GitHub 上编辑示例

由 @lannka 撰写