广告功能

本指南将介绍如何使用 analytics.js 的广告功能插件。

概览

在 Google Analytics（分析）中，您可以前往媒体资源设置 > 数据收集启用 Google Analytics（分析）广告功能，包括搜索广告再营销名单。analytics.js 的广告功能插件可用于以编程方式启用广告功能，以及覆盖和停用 Google Analytics（分析）界面中创建的所有广告报告和再营销功能。

实现

如要启用广告功能插件，请添加一个 require 调用并指定 displayfeatures 插件。

ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'displayfeatures');
ga('send', 'pageview');

插件会向 stats.g.doubleclick.net 发送一个用于启用广告功能的请求。插件会创建一个有效时间为 1 分钟、名为 _gat 的新 Cookie。该 Cookie 不会存储任何用户信息，而只会用于限制必须发送到 doubleclick.net 的请求数量。

更改 Cookie 名称

Cookie 的默认名称为 _gat。您可以在对插件进行 require 操作时，通过设置 cookieName 选项来更改此名称。

ga('require', 'displayfeatures', {cookieName: 'display_features_cookie'});

请注意，第三个参数一般用于指定脚本的位置。 由于此插件包含在 analytics.js 中，因此只需传递 undefined 即可。

使用多个跟踪器

如要在有多个跟踪器的情况下使用广告功能插件，请在 require 调用的前面附加跟踪器名称：

// create a tracker named 'foo' for property UA-XXXXX-Y
ga('create', 'UA-XXXXX-Y', {name: 'foo'});
ga('foo.require', 'displayfeatures');
ga('foo.send', 'pageview');

// create a second tracker named 'bar' for a different property UA-XXXX-Z
ga('create', 'UA-XXXXX-Z', {name: 'bar'});
ga('bar.require', 'displayfeatures');
ga('bar.send', 'pageview');

加载指定跟踪器的广告功能插件后，跟踪器名称会附加到 Cookie 名称中。上面的示例会创建 _gat_foo 和 _gat_bar 这两个 Cookie。

停用广告功能

由于可通过 Google Analytics（分析）中“管理”下的设置启用广告功能，有时您可能需要以编程方式进行停用。

如要使用 analytics.js 停用所有广告功能，请在 create 命令之后、send 命令之前将 allowAdFeatures 设置为 false。

ga('create', 'UA-XXXXX-Y', 'auto');
ga('set', 'allowAdFeatures', false);
ga('send', 'pageview');

如果设置为 true（默认值），则 allowAdFeatures 可让 displayfeatures 插件和 Google Analytics（分析）中的广告功能设置正常发挥作用。此字段本身不会启用这些功能。

无论是通过 displayfeatures 插件还是从 Google Analytics（分析）中启用 Google Analytics（分析）广告功能，将 allowAdFeatures 设置为 false 都可以停用这些功能的信标。

如要仅停用广告个性化功能，请在 create 命令之后、send 命令之前将 allowAdPersonalizationSignals 设置为 false。

ga('create', 'UA-XXXXX-Y', 'auto');
ga('set', 'allowAdPersonalizationSignals', false);
ga('send', 'pageview');