加入分析会话

在 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 与多个 Linker 一起使用

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

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

目标域名

每个 Linker 还将接受一个可选的 destinationDomains 条目。你可以使用此项仅将 Linker 参数添加到特定目标。如果省略此条目，则它将默认为源域以及规范域。在下面的示例中，只会修饰到 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