本指南說明如何使用 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
,以便啟用廣告功能。外掛程式會建立名為 _gat
的新 Cookie,逾時時間為一分鐘。這個 Cookie 只是用來限制須向 doubleclick.net
發出的要求數量,不會儲存任何使用者資訊。
變更 Cookie 名稱
預設的 Cookie 名稱為 _gat
。您可以在需要外掛程式時設定 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 (分析) 中的廣告功能設定正常運作。這個欄位並不會開啟這些功能。
將 allowAdFeatures
設為 false
即可停用 Google Analytics (分析) 廣告功能的信標 (無論該信標已透過 displayfeatures
外掛程式或 Google Analytics (分析) 啟用)。
如果只停用廣告個人化功能,請在 create
指令「之後」及 send
指令之前,將 allowAdPersonalizationSignals
設為 false
。
ga('create', 'UA-XXXXX-Y', 'auto'); ga('set', 'allowAdPersonalizationSignals', false); ga('send', 'pageview');