AMP

Analytics: the basics

Important: this documentation is not applicable to your currently selected format ads!

从这里开始了解 AMP 分析的相关基础知识。

使用 amp-pixel 还是 amp-analytics?

AMP 提供了以下两个组件,可满足您的分析和衡量需求:amp-pixelamp-analytics。两个组件都会将分析数据发送到定义的端点。

如果您只是跟踪诸如简单的跟踪像素之类的行为,则可以使用 amp-pixel 组件,它提供了基本的网页浏览跟踪功能;网页浏览数据将发送到定义的网址。某些与供应商的集成功能可能需要使用此组件,在这种情况下,这些集成功能将指定确切的网址端点。

对于大多数分析解决方案,请使用 amp-analyticsamp-analytics 也提供了网页浏览跟踪功能。此外,您还可以跟踪用户与任何类型的网页内容的互动情况,包括链接点击和按钮点击。

在与 AMP 平台集成的过程中,各个提供商均提供了预定义的 amp-analytics 配置,以便能够轻松地捕获数据并推送到其跟踪工具。您可以通过分析供应商列表访问各个供应商文档。

您可以在网页中同时使用 amp-pixelamp-analyticsamp-pixel 用于简单的网页浏览跟踪,amp-analytics 则用于所有其他跟踪。此外,您还可以多次添加各个标记。如果您与多家分析提供商合作,则需要为每个解决方案都添加一个标记。请注意,AMP 网页越简单,越可以为用户带来出色的体验。因此,如果您不需要额外标记,就不要使用。

创建简单的分析配置

了解如何创建简单的 amp-pixelamp-analytics 配置。

简单的 amp-pixel 配置

要创建简单的 amp-pixel 配置,请在 AMP 网页的正文中插入如下所示的类似内容:

<amp-pixel src="https://foo.com/pixel?RANDOM"></amp-pixel>

在此示例中,网页浏览数据将与一个随机数一起发送到定义的网址。RANDOM 变量是 AMP 平台中诸多替换变量中的一个。点击此处详细了解变量替换

amp-pixel 组件是内置组件,因此您无需像处理 AMP 扩展组件(包括 amp-analytics)一样为其添加包含声明。但您应将 amp-pixel 标记放在尽可能靠近 <body> 开头的位置。只有当标记本身进入视线范围内时,跟踪像素才会触发。如果将 amp-pixel 放在靠近网页底部的位置,则可能不会触发跟踪像素。

简单的 amp-analytics 配置

要创建简单的 amp-analytics 配置,您必须首先将以下 custom-element 声明包含在 AMP 文档的 <head> 中(另请参阅组件包含声明):

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

以下示例与 amp-pixel 示例类似。每当用户浏览网页时,系统均会触发触发器事件,并将网页浏览数据与一个随机 ID 一起发送到定义的网址:

<amp-analytics>
  <script type="application/json">

      {"requests":
        {"pageview": "https://foo.com/pixel?RANDOM
      ", },"triggers":
        {"trackPageview":
          {"on": "visible",
          "request": "pageview"

    } } }
  </script>
</amp-analytics>

在上面的示例中,我们将一个名为 pageview 的请求定义为 https://foo.com/pixel?RANDOM。如前所述,RANDOM 将被替换为一个随机数,因此实际上,最终显示的请求将如下所示:https://foo.com/pixel?0.23479283687235653498734

当网页变得可见(使用触发器关键字 visible 指定)时,事件将触发,并发送 pageview 请求。触发器属性决定了 pageview 请求何时触发。详细了解请求和触发器

变量替换

amp-pixelamp-analytics 组件均允许所有标准网址变量替换(请参阅 AMP HTML 变量替换)。在以下示例中,网页浏览请求将随当前 AMP 文档的规范网址、其标题以及客户端 ID 一起发送到相应网址:

<amp-pixel
  src="https://example.com/analytics?url=${canonicalUrl}&title=${title}&clientId=${clientId(site-user-id)}"
></amp-pixel>

由于 amp-pixel 标记的简单性,它只可包括平台定义的变量或 AMP 运行时可从 AMP 网页中解析的变量。在上面的示例中,平台会填充 canonicalURLclientId(site-user-id) 的值。 amp-analytics 标记可包括与 amp-pixel 相同的变量,以及标记配置内唯一定义的变量。

在请求字符串中,请为网页或平台定义的变量使用 ${varName} 格式。在构建分析请求时,amp-analytics 标记会将模板替换为其实际值(另请参阅 amp-analytics 中支持的变量。)

在以下 amp-analytics 示例中,网页浏览请求将发送到相应网址,其中还包含从变量替换中提取的其他数据(某些由平台提供,某些在 amp-analytics 配置中直接定义):

<amp-analytics>
  <script type="application/json">
    {
      "requests": {
        "pageview": "https://example.com/analytics?url=${canonicalUrl}&title=${title}&acct=${account}&clientId=${clientId(site-user-id)}"
      },
      "vars": {
        "account": "ABC123"
      },
      "triggers": {
        "someEvent": {
          "on": "visible",
          "request": "pageview",
          "vars": {
            "title": "My homepage"
          }
        }
      }
    }
  </script>
</amp-analytics>

在上面的示例中,变量 accounttitle 是在 amp-analytics 配置中定义的。变量 canonicalUrlclientId 不是在配置中定义的,因此它们的值将被平台替换。

重要提示:变量替换非常灵活;您可以在不同位置定义相同的变量,并且 AMP 运行时会按相应的优先顺序解析值(请参阅变量替换顺序)。

用户识别

网站使用 Cookie 在浏览器中存储与用户相关的信息。Cookie 可用于判断用户之前是否访问过某个网站。在 AMP 中,网页可通过发布商的网站提供,也可通过缓存(例如 Google AMP 缓存)提供。发布商的网站和缓存很可能具有不同的网域。为了安全起见,浏览器可能(并且通常)会限制访问其他网域的 Cookie(另请参阅跨来源跟踪用户)。

默认情况下,不管用户是从发布商的原始网站还是通过缓存访问网页,AMP 都将管理客户端 ID 的配置。AMP 生成的客户端 ID 的值为 "amp-" 后跟一个随机 base64 编码字符串,如果同一用户再次访问某网页,该用户的客户端 ID 将保持不变。

在任何情况下,AMP 都负责管理客户端 ID 的读取和写入。当某个网页通过缓存提供或以其他方式显示在发布商原始网站浏览环境之外时,尤其需要注意这一点。在这种情况下,系统将无法访问发布商网站的 Cookie。

如果从发布商的网站中提供 AMP 网页,则可以向 AMP 使用的客户端 ID 框架说明要查找和使用的后备 Cookie。在这种情况下,clientId 变量的 cid-scope-cookie-fallback-name 参数将被解读为 Cookie 名称。格式可能显示为 CLIENT_ID(cid-scope-cookie-fallback-name)${clientId(cid-scope-cookie-fallback-name)}

例如:

<amp-pixel
  src="https://foo.com/pixel?cid=CLIENT_ID(site-user-id-cookie-fallback-name)"
></amp-pixel>

如果 AMP 发现此 Cookie 已设置,则客户端 ID 替换将返回 Cookie 的值。如果 AMP 发现此 Cookie 未设置,则 AMP 将生成一个值,格式为 amp-,后跟一个随机 base64 编码字符串。

如需详细了解客户端 ID 替换(包括如何添加可选的用户通知 ID),请参阅 AMP 分析中支持的变量

了解详情:要想继续了解分析相关知识,请参阅深入了解 AMP 分析用例