加入分析会话

在 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 的链接器参数将附加到传出链接。此参数的值将包括 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