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

設定

本文件列出了 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_name
廣告活動條件
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 設為頂層網域 + 1 個子網域 (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

指定用來儲存 Analytics (分析) Cookie 的子路徑。

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

範例

全域設定

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

為單一直播影片設定

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

cookie_prefix

指定前置字串，前面會加上 Analytics (分析) 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
});

忽略參照網址

設為 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。且不得為個人識別資訊 (個人識別資訊)。這個值不應儲存在 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 屬性值

範例

全域設定

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

為單一直播影片設定

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