跟踪代码问题排查

如果您要排查 Google Analytics（分析）跟踪的问题，请先确保您的基本设置正确无误，符合“帮助中心”中的验证您的设置部分的要求。

Google Analytics（分析）跟踪问题排查将围绕两个关键问题进行：

  1. 跟踪代码语法中存在错误/拼写错误（例如，空格、拼写错误的自定义内容、错误的参数名称）
  2. 检查报告中是否缺少数据

本文档的其余部分介绍了如何使用问题排查工具来找出并纠正这两类基本问题。

常见跟踪代码错误

无论您是使用异步语法还是使用传统语法，为保证您在自定义或调整跟踪代码时不会出现最常见的错误，请牢记以下几点：要了解如何轻松地检查这些错误，请参阅使用 ga_debug.js 进行调试。

  • 方法名称使用的大小写错误。
    请注意，方法名称区分大小写。如果方法名称使用的大小写错误，方法调用将失败。例如：
    _gaq.push(['_trackpageview']);   // wrong
_gaq.push(['_trackPageView']);   // wrong
_gaq.push(['_trackPageview']);   // correct
  • 方法名称不正确。
    如果跟踪没有正确运行，请进行检查并确保使用的方法名称正确。例如： 
    _gaq.push(['_setDomain', 'example.com']);       // wrong
_gaq.push(['_setDomainName', 'example.com']);   // correct
  • 使用引号传递非字符串值。
    只有字符串应在传递时加引号。所有其他类型都不应加引号。
    任何非字符串值，例如布尔值、对象字面量、函数或数组，在传递时不应加引号。只有在传递要解释为字符串的内容时，才应使用引号。如果您正在从传统语法迁移到异步语法，那么在传统语法中不加引号传递的任何函数参数在异步语法中仍然不加引号。示例：
    _gaq.push(['_setAllowLinker', 'false']);    // wrong
_gaq.push(['_setAllowLinker', false]);      // correct
  • 字符串在开头或结尾处加有空格。
    示例：
    _gaq.push(['_setAccount', ' UA-65432-1']);    // wrong
_gaq.push(['_setAccount', 'UA-65432-1']);     // correct

返回页首

常见报告数据问题

如果您的报告中缺少数据，请阅读本部分以找出最常见的错误，并了解建议采取的操作。

未检测到跟踪代码更改或设置

首次在网页上安装跟踪代码或添加其他跟踪代码功能（如，用于电子商务）时，您可以通过检查以下元素轻松地验证网页请求的设置是否正确：

  • 网页请求 ga.js JavaScript
  • 网页请求 __utm.gif
  • utmac 和 utmcc 变量在 __utm.gif 请求中发送
  • 所有相关跟踪参数都适用于您希望发送的其他数据（请参阅下面的 GIF 请求参数列表）。

如果所有这些元素都正确发送，则数据最迟会在 24 小时内显示在报告中。不过，您还可以将报告中的日期范围更改为“今天”，查看数据是否会立即显示。

返回页首

网页或事件未显示在报告中

如果包含跟踪代码的网页未显示在“内容”报告中，请检查以下各项：

  • 您查找的网页是否正确？
    • Google Analytics（分析）使用 utmp 参数的值作为请求的网页，因此如果您的网页网址为 /test/myPage.html，请确保您在“内容”报告中查找的是 myPage.html。检查 utmp 参数的值以查看正在发送的网页请求。
  • 您查找的事件是否正确？
    • Google Analytics（分析）使用 utme 参数的值以 5(object*action*label)(value) 格式跟踪事件：
    • 5 为常数
    • 对象和操作为必填项
    • 标记和值为选填项
    有关详情，请参阅跟踪事件文档。
  • 您每天跟踪的唯一网址或虚拟网页是否超过 50000 个？
    • Google Analytics（分析）会收集网站发送的所有信息，且每天报告其中前 50000 个网页（按浏览量排序）的信息。其余的所有网页均被汇总到内容报告中标记为“(other)”的单独部分中。要查看浏览量较低的网页的详细报告信息，您可以使用过滤器设置一个新数据视图（配置文件），然后移除浏览量较高的所有网页，这会有效地允许剩余网页包含在前 50000 个网址中。
  • 确保您在报告界面中访问正确的帐户和数据视图（配置文件）。
    • Google Analytics（分析）根据网域 ID（采用 UA-123456-1 形式）来区分不同帐户。此网域 ID 将插入到跟踪代码中，系统正是通过这种方式将来自网页的数据与给定帐户相关联。确保您正查看的帐户和数据视图（配置文件）中的网域 ID（“Google Analytics（分析）设置” -> “修改” -> “检查状态”）与 GIF 请求的 utmac 参数中发送的网域 ID 相同。

返回页首

广告系列跟踪问题

为了在 Google Analytics（分析）中跟踪某个广告系列，链接到您网站的广告必须附加有跟踪参数。Google Analytics（分析）跟踪代码 (GATC) 会使用网页网址和引荐参数的组合来识别发送的广告系列。然后，此信息将储存在您的网站的 Cookie 中，并在 GIF 请求的 utmcc 参数中发送。在许多情况下，网站网址重定向将从这些链接中去除跟踪参数或引荐数据，而这会导致广告系列报告中出现错误。

要测试重定向是否会引起广告系列跟踪问题，请点击指向您网站的引荐或标记链接，并在 utmcc 参数中查找相应的广告系列数据。要详细了解如何查找和阅读 utmcc 参数，请参阅 GIF 请求参数和使用 ga_debug.js 进行调试。

目标（转化）归因不正确

转化是指与特定广告系列有关的目标。要确保您已将某个目标与给定广告系列或引荐正确关联，请执行以下操作：

  1. 点击指向您网站的引荐，这会设置广告系列 Cookie。
  2. 点击您的网站访问转化或目标网页。
  3. 检查 utmcc 参数中发送的数据，以确保该广告系列 Cookie 仍然有效。

跟踪代码收集到所有广告系列信息后会将其储存在 Cookie 中，该 Cookie 在用户进行多次会话时持续存在。 对于执行跟踪功能的每个网页，广告系列信息会在 GIF 请求中发送。因此，每次网页浏览都具有与其相关联的广告系列/引荐数据。如果将某个网页浏览配置为目标，则与这一网页浏览相关的广告系列随后将与该目标相关联。要详细了解如何查找和阅读 utmcc 参数，请参阅 GIF 请求参数和使用 ga_debug.js 进行调试。

返回页首

基本调试步骤

每当 Google Analytics（分析）跟踪代码执行时，都会向 Google Analytics（分析）收集服务器请求一个名为“__utm.gif”的单像素 GIF 图片。Google 收集到的有关某个特定网页请求的所有参数都将附加到该图片的请求字符串中，包括：

  • 网址浏览量信息
  • 广告系列信息
  • 电子商务数据
  • 浏览器属性
  • 客户端 ID

GIF 请求中包含的数据就是发送到 Google Analytics（分析）服务器的对应数据，这些数据随后会得到处理并出现在您的报告中。因此，通过查看 __utm.gif 请求中发送的数据，您可以确定跟踪代码是否工作，更重要的是，确定它是否正向您的报告发送错误的数据。

要调试您的跟踪代码，请按以下基本步骤操作：

  1. 通过点击您网站上的相关链接，使用第三方调试工具检查针对 Google Analytics（分析）的 GIF 请求。
  2. 验证跟踪代码不包含任何常见跟踪代码错误。
  3. 确保 utmp 参数存在。
  4. 确保 utmcc 参数存在且非空。
    如果 utmcc 参数为空，则不发送任何 Cookie 数据并忽略请求。
  5. 重复测试几次以确保每次都发送 GIF 请求。

返回页首

调试工具

GIF 请求的网址附加有许多名称/值参数。您可以使用免费工具以更加易于阅读的形式显示 GIF 请求，而不是尝试完整地查看此字符串。下表列出了许多可与最常见的浏览器结合使用的工具。

为方便起见，我们开发了 Google Analytics（分析）跟踪代码调试程序，该工具可帮助您排查跟踪代码问题，而无需您亲自更改代码。只需启用此扩展程序，您就可以检查自己的实际网页上是否存在错误。详细了解 ga_debug.js。

浏览器 工具
所有 Firebug Lite
Chrome Google Analytics（分析）跟踪代码调试程序 新功能！
Chrome 内置的开发人员工具（比如 Resources）
Firefox Live HTTP Headers
Firefox Firebug
Firefox Charles
Internet Explorer Fiddler
Internet Explorer Charles
Safari 内置“活动”窗口
Safari Charles

在您安装并设置了工具后，您可以打开要排查的网页并在工具中查看 GIF 分析。首先，您要确保有关网页确实正在发送 __utm.gif 请求。只要看到该请求，您就可以确定 Google Analytics（分析）服务器正在从该网页收集数据。本部分的其余部分提供了使用 Live HTTP Header 和 Firebug 的基本说明，以便您了解在网络浏览器中使用内置工具或插件是多么容易的事情。

使用 Live HTTP Headers

  1. 下载并安装适用于 Firefox 的 LiveHTTPHeaders；重新启动浏览器。
  2. 打开 Live HTTP Headers（“工具” > “LiveHTTPHeaders”）。
  3. 点击“生成器”标签。
  4. 访问您的网站（或任何已安装 Google Analytics（分析）跟踪代码的网页）。
  5. 验证是否对 urchin.js 或 ga.js 发出了请求。
  6. 检查是否对 __utm.gif 发出了请求。

使用 Firebug

Firebug 扩展程序提供了跟踪代码请求（urchin.js 或 ga.js）和 GIF 请求 (__utm.gif) 的结构更为明确的视图。以下为使用 Firebug 详细查看 GIF 请求的步骤。

  1. 下载并安装适用于 Firefox 的 Firebug；重新启动浏览器。
  2. 访问您的网站。
  3. 在 Firefox 中，依次选择“工具” > “Firebug” > “打开 Firebug” > “为此网站启用 Firebug”。
  4. 点击“网络”，然后点击“图片”。
  5. 重新载入网页，并检查列表中是否显示对 __utm.gif 的新请求。
  6. 在“参数”标签中验证请求的组成部分。

返回页首

使用 ga_debug.js 进行调试

除标准 ga.js 外，Google Analytics（分析）小组部署了名为“ga_debug.js”的 Google Analytics（分析）JavaScript 替代版本。该脚本的目的是帮助 Google Analytics（分析）用户排查安装问题。 如果您对 Google Analytics（分析）不太熟悉，或者您正将网站迁移到新的异步语法，此脚本会对您大有帮助。

该脚本会提供关于每个 GIF 请求的详情，并将记录在跟踪代码中检测到的警告和错误消息。这一目标是通过将消息输出到 window.console 对象来实现的。然后，您可以使用以下工具之一查看这些错误：

  • Firebug（用于 Firefox）
  • 用于 Chrome 和/或 Safari 的内置工具
  • Firebug Lite（用于其他浏览器）

要使用 ga_debug.js 脚本，您可以修改您具有访问权限并且可以编辑的网页的跟踪代码引用。为此，在该网页的跟踪代码中，将对 /ga.js 的所有引用替换为 /u/ga_debug.js。我们建议，如果您针对某个大型网站使用调试脚本，那么您最好仅在测试环境中使用此脚本。或者，如果您要调试一个小型网站，那么建议您仅以此方式测试所选网页，而不是整个网站。

重要注意事项：您不应修改自己的实际网站以适应此版本的 JavaScript。ga_debug.js 脚本比 ga.js 跟踪代码大，通常不会被缓存。因此，在您的实际网站中使用该脚本将减慢所有用户访问您网站的速度。再次提醒您，这仅适用于您自己的测试目的。

如果您使用 Universal Analytics (analytics.js) 跟踪自己的网站，则可以启用 analytics_debug.js（analytics.js 的调试版本）来排查跟踪代码的问题。有关 analytics_debug.js 的详细信息，请参阅调试。

使用 Google Analytics（分析）跟踪代码调试程序

Google Analytics（分析）跟踪代码调试程序是一款 Chrome 浏览器扩展程序，可以为您启用 ga_debug.js ，而无需您亲自更改代码。使用 ga_debug.js 可能是对您网站的跟踪行为进行问题排查和分析的最简单的方式。只需启用此扩展程序，您就可以检查实际网页上是否存在错误，而无需修改代码本身中的跟踪引用。

要使用此扩展程序，请点击地址栏右侧的相应图标进行启用。然后，打开 Chrome JavaScript 控制台即可看到控制台中的消息。

  • 在 Windows 和 Linux 操作系统中，依次点击 [Page Icon] -> 开发人员 -> Javascript 控制台，或同时按 Ctrl-Shift-J。
  • 在 Mac 操作系统中，依次点击查看 -> 开发人员 -> Javascript 控制台，或同时按 Command-Option-J。

返回页首

GIF 请求参数

GIF 请求很长。以下示例仅为 GIF 请求的一部分：

http://www.google-analytics.com/__utm.gif?utmwv=4&utmn=769876874&utmhn=example.com&utmcs=ISO-8859-1&utmsr=1280x1024&utmsc=32-bit&utmul=en-us&utmje=1&utmfl=9.0%20%20r115&utmcn=1&utmdt=GATC012%20setting%20variables&utmhid=2059107202&utmr=0&utmp=/auto/GATC012.html?utm_source=www.gatc012.org&utm_campaign=campaign+gatc012&utm_term=keywords+gatc012&utm_content=content+gatc012&utm_medium=medium+gatc012&utmac=UA-30138-1&utmcc=__utma%3D97315849.1774621898.1207701397.1207701397.1207701397.1%3B...

该表包含了通过 GIF 请求传递的许多参数的列表。每次执行跟踪代码时并非都会传递所有参数，因为某些参数仅适用于特定情况，如广告系列引荐或购物车。当使用此引用时，请记住您将查找应用于您正在调查的网页/请求的最常用变量。

变量 说明 示例值
utmac 帐户字符串。在所有请求中显示。 utmac=UA-2202604-2
utmcc
 Cookie 值。此请求参数将发送从网页中请求的所有 Cookie。
 utmcc=__utma%3D117243.1695285.22%3B%2B __utmz%3D117945243.1202416366.21.10. utmcsr%3Db%7C utmccn%3D(referral)%7C utmcmd%3Dreferral%7C utmcct%3D%252Fissue%3B%2B
utmcn 开始一个新的广告系列会话。utmcn 或 utmcr 存在于任何给定请求中。更改广告系列跟踪数据；但不启动新会话。
 utmcn=1
utmcr
 指示重复的广告系列访问。当对相同链接进行后续点击时，系统就会设置该变量。utmcn 或 utmcr 存在于任何给定请求中。
 utmcr=1
utmcs
 浏览器的语言编码。有些浏览器不设置此变量，在这种情况下该变量将设置为“-”。
 utmcs=ISO-8859-1
utmdt
 网页标题，是一个网址编码字符串。 utmdt=analytics%20page%20test
utme 可扩展参数 值已编码，用于事件和自定义变量。
utmfl
Flash 版本 utmfl=9.0%20r48&
utmhn

 主机名，是一个网址编码字符串。 utmhn=x343.gmodules.com
utmhid

 用于关联 Google Analytics（分析）GIF 请求和 AdSense 的随机数字。 utmhid=2059107202
utmipc
 产品代码。这是给定产品的 SKU 代码。

 utmipc=989898ajssi
utmipn
 产品名，是一个网址编码字符串。 utmipn=tee%20shirt
utmipr
 单价。在物品级别设置。值为数字且仅使用美国货币格式。
 utmipr=17100.32
utmiqt
 数量。 utmiqt=4
utmiva
 某个物品的不同版本。例如：大、中、小、粉红色、白色、黑色、绿色。字符串为网址编码。
 utmiva=red;
utmje
 指示浏览器是否启用了 Java 支持。1 表示启用。 utmje=1
utmn
 为每个 GIF 请求生成的唯一 ID，用于防止 GIF 图片缓存。 utmn=1142651215
utmp
 当前网页的网页请求。 utmp=/testDirectory/myPage.html
utmr
 引荐，完整的网址。 utmr=http://www.example.com/aboutUs/index.php?var=selected
utmsc
 屏幕颜色深度 utmsc=24-bit
utmsr
 屏幕分辨率 utmsr=2400x1920
utmt
 指示请求的类型，包括：事件、交易、物品或自定义变量。如果 GIF 请求中不存在此值，则请求的类型为网页。 utmt=event
utmtci
 帐单邮寄地址所在城市 utmtci=San%20Diego
utmtco
 帐单邮寄地址所在国家/地区 utmtco=United%20Kingdom
utmtid
 订单 ID，为网址编码字符串。 utmtid=a2343898
utmtrg
 帐单邮寄地址所在区域，为网址编码字符串。 utmtrg=New%20Brunswick
utmtsp
 运费，单位和价格的值。 utmtsp=23.95
utmtst
 关联公司，通常用于电子商务中的实体商户。 utmtst=google%20mtv%20store
utmtto
 总数。单位和价格的值。 utmtto=334.56
utmttx
 税款。单位和价格的值。 utmttx=29.16
utmul
 浏览器语言。 utmul=pt-br
utmwv
 跟踪代码版本 utmwv=1

 

返回页首