廣告功能

本指南說明如何使用 analytics.js 的廣告功能外掛程式。

總覽

您可以在 Google Analytics (分析) 中依序前往「資源設定」>「資料收集」來啟用 Google Analytics (分析) 廣告功能 (包括搜尋廣告再行銷名單)。analytics.js 的廣告功能外掛程式可讓您透過程式啟用廣告功能，並覆寫和停用在 Google Analytics (分析) 使用者介面中建立的所有廣告報表和再行銷功能。

導入作業

注意：如果透過 displayfeatures 外掛程式啟用廣告功能，系統不會啟用所有廣告功能 (例如搜尋廣告再行銷名單、跨裝置報表等)

建議採用的方法是在 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 (分析) UI 中建立的所有資源設定。

您可以在 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');