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

設定

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

allow_google_signals

如要停用以第三方廣告 ID 為依據的廣告功能，請將 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

匿名識別瀏覽器執行個體。根據預設，這個值會儲存在第一方 Analytics Cookie 中，並設有兩年的到期日。

欄位名稱	類型	預設值
`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_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 分隔。舉例來說，如果是 800 x 600 像素的螢幕，這個值會是 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`		property name=24 property value=36

範例

全域設定

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

為單一串流設定

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