本頁面由 Cloud Translation API 翻譯而成。

設定

本文件列出 Google Analytics 的所有設定欄位。

allow_google_signals

如要停用所有廣告功能，請將 allow_google_signals 設為 false。

欄位名稱	類型	預設值
`allow_google_signals`	`boolean`	true

範例

全域設定

gtag('set', 'allow_google_signals', true);

為單一串流設定

gtag('config', 'STREAM_ID', {
  'allow_google_signals': true
});

allow_ad_personalization_signals

如要停用廣告個人化功能，請設為 false。

欄位名稱	類型	預設值
`allow_ad_personalization_signals`	`boolean`	true

範例

全域設定

gtag('set', 'allow_ad_personalization_signals', true);

為單一串流設定

gtag('config', 'STREAM_ID', {
  'allow_ad_personalization_signals': true
});

campaign_content

用於 A/B 測試和指定內容廣告。使用 campaign_content 即可：不同的廣告或連結指向同一個網址。

欄位名稱	類型	預設值
`campaign_content`	`string`	`undefined`

範例

全域設定

gtag('set', 'campaign_content', 'logolink');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'campaign_content': 'logolink'
});

campaign_id

用於識別這個參照連結網址參照的廣告活動。使用「campaign_id」來辨識特定廣告活動

欄位名稱	類型	預設值
`campaign_id`	`string`	`undefined`

範例

全域設定

gtag('set', 'campaign_id', 'abc.123');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'campaign_id': 'abc.123'
});

campaign_medium

使用 campaign_medium 識別媒介，例如電子郵件或單次點擊出價。

欄位名稱	類型	預設值
`campaign_medium`	`string`	`undefined`

範例

全域設定

gtag('set', 'campaign_medium', 'cpc');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'campaign_medium': 'cpc'
});

campaign_name

用於關鍵字分析。使用 campaign_name 辨識特定產品宣傳或策略性廣告活動

欄位名稱	類型	預設值
`campaign_name`	`string`	`undefined`

範例

全域設定

gtag('set', 'campaign_name', 'spring_sale');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'campaign_name': 'spring_sale'
});

campaign_source

使用 campaign_source 識別搜尋引擎、電子報名稱或其他名稱來源。

欄位名稱	類型	預設值
`campaign_source`	`string`	`undefined`

範例

全域設定

gtag('set', 'campaign_source', 'google');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'campaign_source': 'google'
});

campaign_term

用於付費搜尋。使用 campaign_term 記下這則廣告的關鍵字。

欄位名稱	類型	預設值
`campaign_term`	`string`	`undefined`

範例

全域設定

gtag('set', 'campaign_term', 'running+shoes');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'campaign_term': 'running+shoes'
});

廣告活動

包含可設定的所有廣告活動值的物件。

提供 campaign 物件以支援舊版實作。大多數情況下不建議使用建議您改用每個欄位的 campaign 前置字串版本：

campaign_id
campaign_source
campaign_medium
campaign_name
campaign_term
campaign_content

，瞭解如何調查及移除這項存取權。

欄位名稱	類型	預設值
`campaign`	`object`	`undefined`

範例

全域設定

gtag('set', 'campaign', {
  'id': 'abc.123',
  'source': 'google',
  'medium': 'cpc',
  'name': 'spring_sale',
  'term': 'running+shoes',
  'content': 'logolink'
});

為單一串流設定

gtag('config', 'STREAM_ID', {
  'campaign': {
    'id': 'abc.123',
    'source': 'google',
    'medium': 'cpc',
    'name': 'spring_sale',
    'term': 'running+shoes',
    'content': 'logolink'
  }
});

client_id

匿名識別瀏覽器執行個體。根據預設，系統會儲存這個值效期為兩年

欄位名稱	類型	預設值
`client_id`	`string`	針對每位使用者隨機產生的值。

範例

全域設定

gtag('set', 'client_id', 'aaa.bbb');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'client_id': 'aaa.bbb'
});

content_group

欄位名稱	類型	預設值
`content_group`	`string`

範例

全域設定

gtag('set', 'content_group', '/news/sports');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'content_group': '/news/sports'
});

cookie_domain

指定用來儲存數據分析 Cookie 的網域。

設為 'none' 即可在不指定網域的情況下設定 Cookie。

設為 'auto' (預設值)，即可將 Cookie 設為頂層網域以及一個子網域 (eTLD +1)舉例來說，如果 cookie_domain 設為 'auto' https://example.com 表示網域使用 example.com。 https://subdomain.example.com 也會針對網域使用 example.com。

欄位名稱	類型	預設值
`cookie_domain`	`string`	`'auto'`

範例

全域設定

gtag('set', 'cookie_domain', 'example.com');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'cookie_domain': 'example.com'
});

cookie_expires

每次將命中資料傳送至 Google Analytics 時，Cookie 到期時間為更新為目前時間加上 cookie_expires 欄位的值。也就是說，如果使用兩年的預設值 (63072000)，使用者每月造訪您的網站，但他們的 Cookie 永遠不會過期。

如果將 cookie_expires 時間設為 0 (零) 秒，Cookie 就會轉換為以工作階段為基礎的 Cookie，並在目前的瀏覽器工作階段結束時到期。

欄位名稱	類型	預設值
`cookie_expires`	`number`	`63072000`

範例

全域設定

gtag('set', 'cookie_expires', 28 * 24 * 60 * 60 /* 28 days, in seconds */);

為單一串流設定

gtag('config', 'STREAM_ID', {
  'cookie_expires': 28 * 24 * 60 * 60 /* 28 days, in seconds */
});

cookie_flags

設定時可將其他標記附加到 Cookie。標記必須以分號。請參閱「寫入新的 Cookie」一節，查看幾個可設定的標記範例。

欄位名稱	類型	預設值
`cookie_flags`	`string`

範例

全域設定

gtag('set', 'cookie_flags', 'SameSite=None;Secure');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'cookie_flags': 'SameSite=None;Secure'
});

cookie_path

指定用來儲存數據分析 Cookie 的子路徑。

欄位名稱	類型	預設值
`cookie_path`	`string`	`'/'`

範例

全域設定

gtag('set', 'cookie_path', '/example_path');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'cookie_path': '/example_path'
});

cookie_prefix

指定要在數據分析 Cookie 名稱前面加上的前置字串。

欄位名稱	類型	預設值
`cookie_prefix`	`string`

範例

全域設定

gtag('set', 'cookie_prefix', 'prefix');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'cookie_prefix': 'prefix'
});

cookie_update

如果將 cookie_update 設為 true，gtag.js 就會更新每個網頁的 Cookie 載入。這會將 Cookie 到期時間更新為相對於最大值近期造訪該網站的情形。舉例來說，如果 Cookie 到期時間設為一週若使用者每五天使用同一個瀏覽器造訪一次，Cookie 過期就會失效且永遠不會過期。

如果設為 false，系統就不會在每次載入網頁時更新 Cookie，這個引數包含根據使用者首次造訪 Cookie 的時間網站。

欄位名稱	類型	預設值
`cookie_update`	`boolean`	`true`

範例

全域設定

gtag('set', 'cookie_update', true);

為單一串流設定

gtag('config', 'STREAM_ID', {
  'cookie_update': true
});

ignore_referrer

設為 true，指示 Analytics 不應顯示參照網址做為流量來源瞭解這個欄位的使用時機

欄位名稱	類型	預設值
`ignore_referrer`	`boolean`	false

範例

全域設定

gtag('set', 'ignore_referrer', true);

為單一串流設定

gtag('config', 'STREAM_ID', {
  'ignore_referrer': true
});

language

指定使用者的語言偏好設定。預設為使用者的 navigator.language 的值。

欄位名稱	類型	預設值
`language`	`string`	預設值為 `navigator.language`。

範例

全域設定

gtag('set', 'language', 'en-us');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'language': 'en-us'
});

page_location

指定網頁的完整網址。預設為使用者的 document.location 的值。

欄位名稱	類型	預設值	Character Limit
`page_location`	`string`	預設值為 `document.location`。	1000

範例

全域設定

gtag('set', 'page_location', 'https://example.com/page1');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'page_location': 'https://example.com/page1'
});

page_referrer

指定為網頁帶來流量的推薦連結來源。此外，這個值也用來計算流量來源這個值的格式是網址。預設為使用者的 document.referrer 值。

欄位名稱	類型	預設值	Character Limit
`page_referrer`	`string`	預設值為 `document.referrer`。	420

範例

全域設定

gtag('set', 'page_referrer', 'https://example.com');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'page_referrer': 'https://example.com'
});

page_title

網頁或文件的標題。預設為使用者的 document.title 值。

欄位名稱	類型	預設值	Character Limit
`page_title`	`string`	預設值為 `document.title`。	300

範例

全域設定

gtag('set', 'page_title', 'Settings');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'page_title': 'Settings'
});

send_page_view

如果設為 False，預設程式碼片段就不會傳送 page_view。

欄位名稱	類型	預設值
`send_page_view`	`boolean`	true

範例

全域設定

gtag('set', 'send_page_view', false);

為單一串流設定

gtag('config', 'STREAM_ID', {
  'send_page_view': false
});

screen_resolution

指定螢幕的解析度。應為兩個正整數中間以 x 分隔。例如，針對 800px x 600px 的螢幕，值為 800x600。根據使用者的 window.screen 值計算而得。

欄位名稱	類型	預設值
`screen_resolution`	`string`	預設值會以 `window.screen` 計算

範例

全域設定

gtag('set', 'screen_resolution', '800x600');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'screen_resolution': '800x600'
});

user_id

為網站擁有者/資料庫提供的使用者指定已知 ID 內容。ID 不得為 PII (個人識別資訊)。值一律不得保留在 Google Analytics Cookie 或其他 Analytics 中所提供的儲存空間

欄位名稱	類型	預設值	Character Limit
`user_id`	`string`		256

範例

全域設定

gtag('set', 'user_id', 'id');

為單一串流設定

gtag('config', 'STREAM_ID', {
  'user_id': 'id'
});

user_properties

使用者屬性可用來描述例如語言偏好設定或地理位置最多 25 個每項專案還可設定其他使用者屬性。

欄位名稱	類型	預設值	Character Limit
`user_properties`	`object`		屬性名稱=24 屬性值=36

範例

全域設定

gtag('set', 'user_properties', {
  'favorite_color': 'blue'
});

為單一串流設定

gtag('config', 'STREAM_ID', {
  'user_properties': {
    'favorite_color': 'blue'
  }
});