本指南将介绍如何使用 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 名称
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');