广告功能

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

概览

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

实现

建议您通过 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 的默认名称为 _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(分析)中“管理”下的设置启用广告功能,有时您可能需要以编程方式停用该功能。

要停用所有广告功能,包括再营销和广告报告功能,请将 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 都可以停用这些功能的信标。