設定

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

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

匿名識別瀏覽器執行個體。根據預設，這個值會儲存在第一方 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，並在目前的瀏覽器工作階段結束時過期。

欄位名稱	類型	預設值
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		屬性名稱=24 屬性值=36

範例

全域設定

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

為單一串流設定

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