语法比较

本文档展示了针对各种常见跟踪自定义的跟踪代码演示。 如果您的 Google Analytics（分析）跟踪代码段包含 urchin.js 标记或传统的 ga.js 语法，请按照本指南将您的跟踪功能迁移到改进后的异步代码段。

迁移到异步跟踪

最佳做法是，首先复制现有的跟踪代码自定义设置并将其保存到文本文件（而不是文字处理器文档）。借助备份副本，您可以确保已迁移网站的所有自定义项。

将网页转换为使用异步代码段：

  1. 移除现有的跟踪代码段以及所有自定义设置。

    为了减少错误，我们建议您从将跟踪代码段注入到网页的包含文件或机制中移除现有的跟踪代码段。您可以将现有的跟踪代码段粘贴到文本文件中，以跟踪您使用的任何自定义方法。

  2. 将异步代码段插入您网页的“<head>”部分的底部，且位于您的网页或模板可能使用的所有其他脚本之后。

    使用异步代码段的主要优点之一是，您可以将异步代码段放置在 HTML 文档的顶部。这样可增大系统在用户离开网页之前发送跟踪信标的可能性。 我们已确定，在大多数网页上，异步代码段的最佳位置是在 <head> 部分的底部，紧挨着结束 </head> 标记之前。

  3. 使用您的网络媒体资源 ID 修改 _setAccount 方法。

    有关网络媒体资源 ID 的详情，请参阅帐号和数据视图（配置文件）文档中的“网络媒体资源”部分。

  4. 使用异步代码段的语法重新添加自定义内容。 使用本指南其余部分中介绍的自定义设置。 有关异步跟踪代码的详情，请参阅异步跟踪使用指南。

注意：为确保异步代码段相对于其他脚本的操作最精简，我们建议您通过以下任一方式在网站上放置其他脚本：

  • 在 HTML 的 <head> 部分中的跟踪代码段之前
  • 在跟踪代码段与所有网页内容之后（例如，在 HTML 正文的底部）

如果不行，您仍可以将异步代码段放在网页底部。您也可以拆分代码段，以保留异步跟踪的一些优势。

基本网页跟踪

若要熟悉异步语法，基本网页跟踪是再好不过的方式。这些示例使用正确的帐号设置跟踪对象，并调用网页跟踪方法。

异步代码段（推荐）

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);

返回页首

浏览器设置检测

这些示例说明了禁用 Flash 检测、关闭浏览器的名称/版本检测等浏览器设置自定义。

异步代码段（推荐）

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setClientInfo', false]);
_gaq.push(['_setAllowHash', false]);
_gaq.push(['_setDetectFlash', false]);
_gaq.push(['_setDetectTitle', false]);
_gaq.push(['_trackPageview']);

返回页首

广告系列投放期

默认情况下，Google Ads 广告系列的投放期设置为 6 个月。您可以使用 _setCampaignCookieTimeout() 方法调整广告系列的持续时间。

异步代码段（推荐）

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampaignCookieTimeout', 31536000000]);
_gaq.push(['_trackPageview']);

返回页首

广告系列字段 - 自定义

如果您已将 Google Ads 账号与 Google Analytics（分析）账号相关联，Google Analytics（分析）会自动收集您的 Google Ads 数据。要跟踪其他广告来源或电子邮件广告系列或类似来源的关键字链接，您可以使用以下方法创建自定义广告系列字段。有关详情，请参阅流量来源指南中的“广告系列跟踪”。

异步代码段（推荐）

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampNameKey', 'ga_campaign']);    // name
_gaq.push(['_setCampMediumKey', 'ga_medium']);    // medium
_gaq.push(['_setCampSourceKey', 'ga_source']);    // source
_gaq.push(['_setCampTermKey', 'ga_term']);        // term/keyword
_gaq.push(['_setCampContentKey', 'ga_content']);  // content
_gaq.push(['_setCampNOKey', 'ga_nooverride']);    // don't override
_gaq.push(['_trackPageview']);

返回页首

广告系列跟踪 — 已停用

Google Analytics（分析）会自动启用广告系列跟踪，但您可以使用 _setCampaignTrack() 方法将其停用。

异步代码段（推荐）

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampaignTrack', false]);    // Turn off campaign tracking
_gaq.push(['_trackPageview']);

返回页首

跨域链接

如需跟踪跨网域的流量，您可以使用 _setAllowLinker() 函数跟踪两个网域之间的用户点击。如需详细了解如何设置跨网域跟踪，请参阅跨网域跟踪。

异步代码段（推荐）

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

返回页首

跨网域表单数据

在为两个网域都启用了跨网域跟踪的情况下，您可以使用 _linkByPost() 方法将用户数据从一个网域传递到另一个网域。如需详细了解如何设置跨网域跟踪，请参阅跨网域跟踪。

异步代码段（推荐）

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<form name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

返回页首

电子商务跟踪

电子商务跟踪涉及在跟踪设置中调用三个关键方法。有关详情，请参阅电子商务跟踪。

异步代码段（推荐）

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
_gaq.push(['_addTrans',
  '1234',           // order ID - required
  'Mountain View',  // affiliation or store name
  '11.99',          // total - required
  '1.29',           // tax
  '5',              // shipping
  'San Jose',       // city
  'California',     // state or province
  'USA'             // country
]);
_gaq.push(['_addItem',
  '1234',           // order ID - required
  'DD44',           // SKU/code
  'T-Shirt',        // product name
  'Green Medium',   // category or variation
  '11.99',          // unit price - required
  '1'               // quantity - required
]);
_gaq.push(['_trackTrans']);

返回页首

事件跟踪

要使用事件跟踪，您需要在网页的适当位置（例如在 onclick 处理程序中）进行事件调用。有关事件跟踪的更多信息，请参阅事件跟踪指南。注意：事件跟踪不适用于 urchin.js 跟踪代码。

异步代码段（推荐）

本部分说明了使用异步语法设置跟踪的两种方法。对于事件跟踪，onclick 处理程序使用完全相同的语法。

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
...
<a onclick="_gaq.push(['_trackEvent', 'category', 'action', 'opt_label', opt_value]);">click me</a>

返回页首

会话超时

默认情况下，如果某用户在您网站上处于非活动状态的时间超过 30 分钟，那么用户会话将超时。以下示例展示了如何使用 _setSessionCookieTimeout() 方法对其进行修改。

异步代码段（推荐）

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setSessionCookieTimeout', 3600000]);
_gaq.push(['_trackPageview']);

返回页首

来源 — 搜索引擎、关键字、引荐来源网址

默认情况下，Google Analytics（分析）会在报告中将一系列网站标识为搜索引擎引荐。您可以使用这些方法更改搜索引擎列表。如需了解详情，请参阅流量来源指南中的“搜索引擎”。您还可以将 Google Analytics（分析）配置为忽略来自特定网域的引荐，或将特定关键字搜索视为直接流量。

异步代码段（推荐）

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_addIgnoredOrganic', 'ignore']);
_gaq.push(['_addIgnoredRef', 'urchin.com']);
_gaq.push(['_addOrganic', 'new_search_engine', 'q']);
_gaq.push(['_trackPageview']);

返回页首

限制为跟踪子目录

使用 _setCookiePath() 方法将某个子目录设置为所有跟踪的默认路径。这样做是为了将所有跟踪限制在网站的子目录中。

异步代码段（推荐）

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCookiePath', '/path/of/cookie/']);
_gaq.push(['_trackPageview']);

返回页首

使用本地服务器

如果您同时使用独立的 UDP 软件和 Google Analytics（分析）来跟踪网站，请使用这些方法。有关详情，请参阅跟踪 API 参考中的 UDP 服务器部分。

异步代码段

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setLocalRemoteServerMode']);
_gaq.push(['_trackPageview']);

返回页首

虚拟网页浏览

使用 _trackPageview() 方法以及您虚构的网址，跟踪没有到达您网站上的实际网页的用户的点击。一般来说，我们建议您使用事件跟踪来跟踪下载、出站链接、PDF 或类似类型的用户互动。这是因为虚拟网页浏览会计入网页浏览总量。

异步代码段

_gaq.push(['_trackPageview', '/downloads/pdfs/corporateBrief.pdf']);

返回页首