標準通用 Analytics (分析) 資源自 2023 年 7 月 1 日起已停止處理資料。通用 Analytics (分析) 360 資源將自 2024 年 7 月 1 日起停止處理資料，部分通用 Analytics (分析) 360 功能也會在那之前淘汰，因為我們會遷移至 Google Analytics (分析) 4。在現有導入方式中加入 Google Analytics (分析) 4。

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

Analytics.js 欄位參考資料

本文件列出所有 analytics.js 可設定的欄位名稱。

僅建立欄位
一般
User
工作階段
流量來源
系統資訊
命中
內容資訊
應用程式
事件
加強型電子商務
社交互動
時間
例外狀況
自訂維度 / 指標

僅建立欄位

下列欄位只能在 create 方法中設定。詳情請參閱《進階設定指南》中的「建立追蹤器物件」一節。

追蹤 ID/ 網站資源 ID

所有命中類型都必須提供此欄位。

追蹤 ID / 網站資源 ID。格式為 UA-XXXX-Y。所有收集的資料都會與這組 ID 建立關聯。

欄位名稱	值類型	預設值
`trackingId`	text	None：無

範例值：UA-XXXX-Y
使用範例：

ga('create', 'UA-XXXX-Y');

// Alerts the tracking ID for the default tracker.
ga(function(tracker) {
  alert(tracker.get('trackingId'));
});

追蹤程式名稱

選用。這只能在 create 方法中設定。

追蹤器物件的名稱。

欄位名稱	值類型	預設值
`name`	text	`t0`

範例值：myTracker
使用範例：

ga('create', 'UA-XXXX-Y', {'name': 'myTracker'});

用戶端 ID

選用。這只能在 create 方法中設定。

匿名識別瀏覽器執行個體。根據預設，這個值會儲存在第一方 Analytics (分析) Cookie 中，有效期限為兩年。

欄位名稱	值類型	預設值
`clientId`	text	`Randomly Generated`

範例值：35009a79-1a05-49d7-b876-2b884d0f825b
使用範例：

ga('create', 'UA-XXXX-Y', {
  'clientId': '35009a79-1a05-49d7-b876-2b884d0f825b'
});

取樣率

選用。這只能在 create 方法中設定。

指定要追蹤的使用者百分比。預設值為 100 (未取樣任何使用者)，但大型網站可能需要使用較低的取樣率，才能維持在 Google Analytics (分析) 處理限制範圍內。

欄位名稱	值類型	預設值
`sampleRate`	號碼	`100`

範例值：5
使用範例：

ga('create', 'UA-XXXX-Y', {'sampleRate': 5});

網站速度取樣率

選用。這只能在 create 方法中設定。

這項設定決定網站速度信標傳送的頻率。根據預設，系統會自動評估 1% 的使用者。

欄位名稱	值類型	預設值
`siteSpeedSampleRate`	號碼	`1`

範例值：10
使用範例：

ga('create', 'UA-XXXX-Y', {'siteSpeedSampleRate': 10});

一律傳送參照網址

選用。這只能在 create 方法中設定。

根據預設，用來歸因流量來源的 HTTP 參照網址，只會在參照網站的主機名稱與目前網頁的主機名稱不同時傳送。除非您想將目前主機的其他網頁視為參照連結網址，否則請勿啟用這項設定。

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

範例值：true
使用範例：

ga('create', 'UA-XXXX-Y', {'alwaysSendReferrer': true});

允許錨定參數

選用。這只能在 create 方法中設定。

根據預設，analytics.js 會在查詢字串和目前網頁網址的錨點中搜尋自訂廣告活動參數，例如 utm_source、utm_medium 等。如果將這個欄位設為 False，就會忽略錨定標記中顯示的所有自訂廣告活動參數。

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

範例值：false
使用範例：

ga('create', 'UA-XXXX-Y', {'allowAnchor': false});

Cookie 名稱

選用。這只能在 create 方法中設定。

用來儲存數據分析資料的 Cookie 名稱

欄位名稱	值類型	預設值
`cookieName`	text	`_ga`

範例值：gaCookie
使用範例：

ga('create', 'UA-XXXX-Y', {'cookieName': 'gaCookie'});

Cookie 網域

選用。這只能在 create 方法中設定。

指定用來儲存數據分析 Cookie 的網域。如果您將這個選項設為「無」，系統就會設定 Cookie，且不指定網域。

欄位名稱	值類型	預設值
`cookieDomain`	text	`document.location.hostname (normalized)`

範例值：example.com
使用範例：

ga('create', 'UA-XXXX-Y', {'cookieDomain': 'example.com'});

Cookie 旗標

選用。這只能在 create 方法中設定。

指定要附加至 Cookie 的其他標記。標記必須以半形分號分隔。

欄位名稱	值類型	預設值
`cookieFlags`	text	None：無

範例值：SameSite=None; Secure
使用範例：

ga('create', 'UA-XXXX-Y', {'cookieFlags': 'SameSite=None; Secure'});

Cookie 到期時間

選用。這只能在 create 方法中設定。

指定 Cookie 到期時間 (以秒為單位)。

欄位名稱	值類型	預設值
`cookieExpires`	整數	`63072000 (two years)`

範例值：86400
使用範例：

ga('create', 'UA-XXXX-Y', {'cookieExpires': 86400});

Cookie 更新

選用。這只能在 create 方法中設定。

如果 CookieUpdate 設為 true (預設值)，analytics.js 會在每次載入網頁時更新 Cookie。而 Cookie 到期時間也會隨之更新，根據最近一次造訪網站的時間進行設定。舉例來說，如果將 Cookie 到期時間設為一週，而使用者每五天就使用同一個瀏覽器造訪網站，則 Cookie 到期時間會在每次造訪時更新，因此永遠不會過期。

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

範例值：true
使用範例：

ga('create', 'UA-XXXX-Y', {'cookieUpdate': 'false'});

Google 商店 GAC

選用。這只能在 create 方法中設定。

根據預設，analytics.js 會寫入 Cookie 以儲存廣告活動資訊。這個欄位可用於停止寫入該 Cookie。

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

範例值：false
使用範例：

ga('create', 'UA-XXXX-Y', {'storeGac': false});

舊版 Cookie 網域

選用。這只能在 create 方法中設定。

這個欄位是用來設定 analytics.js 如何搜尋舊版 Google Analytics (分析) 指令碼 (例如 ga.js 和 urchin.js) 產生的 Cookie。

欄位名稱	值類型	預設值
`legacyCookieDomain`	text	None：無

範例值：store.example.com
使用範例：

ga('create', 'UA-XXXX-Y', {'legacyCookieDomain': 'store.example.com'});

匯入舊版記錄

選用。這只能在 create 方法中設定。

指定 analytics.js 是否應嘗試從 ga.js Cookie 匯入歷來資料。

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

範例值：false
使用範例：

ga('create', 'UA-XXXX-Y', 'auto', {'legacyHistoryImport': false});

允許連結器參數

選用。這只能在 create 方法中設定。

如果將這個欄位設為 True，系統會啟用跨網域轉移狀態的跨網域連接器計量器。

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

範例值：true
使用範例：

ga('create', 'UA-XXXX-Y', {allowLinker: true});

一般

允許廣告功能

選用。

當您透過 displayfeatures 外掛程式或 Google Analytics (分析) (「資源設定」>「資料收集」) 啟用 Google Analytics (分析) 廣告功能的信標時，將這個欄位設為 false 即可停用 Google Analytics (分析) 廣告功能的信標。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`allowAdFeatures`	None：無	boolean	`true`	不適用	全部

範例值：false
使用範例：

ga('set', 'allowAdFeatures', false)

遮蓋 IP

選用。

如果有這項設定，系統會遮蓋寄件者的 IP 位址。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`anonymizeIp`	`aip`	boolean	None：無	不適用	全部

範例值：true
使用範例：

ga('set', 'anonymizeIp', true);

資料來源

選用。

表示命中的資料來源。從 analytics.js 傳送的命中會將資料來源設為「web」；從其中一個行動 SDK 傳送的命中會將資料來源設為「app」。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`dataSource`	`ds`	text	None：無	None	全部

範例值：crm
使用範例：

ga('set', 'dataSource', 'crm');

佇列時間

選用。

用於收集離線 / 潛在命中。這個值代表命中記錄到命中傳送之間經過的時間差異 (以毫秒為單位)。這個值必須大於或等於 0。如果值超過 4 小時，則可能無法處理命中資料。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`queueTime`	`qt`	整數	None：無	None	全部

範例值：560
使用範例：

ga('set', 'queueTime', 560);

強制使用安全資料傳輸層 (SSL)

選用。

根據預設，從 HTTPS 網頁傳送的信標使用 https 傳送，從 HTTP 網頁傳送的信標則使用 http 傳送。將 forceSSL 設為 True 會強制 HTTP 網頁也使用 https 傳送所有信標。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`forceSSL`	None：無	boolean	`false`	不適用	全部

範例值：true
使用範例：

ga('set', 'forceSSL', true);

交通運輸

選用。

指定要用來傳送命中的傳輸機制。可用的選項為「信標」、「xhr」或「image」。根據預設，analytics.js 會依據命中大小和瀏覽器功能，嘗試找出最合適的方法。如果您指定「信標」，而使用者的瀏覽器不支援「navigator.sendBeacon」方法，系統會視命中大小改回使用「image」或「xhr」。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`transport`	None：無	text	`none (automatically determined)`	None	全部

範例值：beacon
使用範例：

ga('send', 'event', 'click', 'download-me', {transport: 'beacon'});

使用信標

選用。

這個選項現已淘汰。請改用「傳輸」。設為 true 會指示用戶端使用 navgator.sendBeacon 傳送命中。如果您想在使用者離開網站前追蹤事件，卻又不想延遲瀏覽，就可以使用這個方法。如果瀏覽器不支援 navigator.sendBeacon，命中會正常傳送。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`useBeacon`	None：無	boolean	`false`	不適用	全部

範例值：true
使用範例：

ga('send', 'event', 'click', 'download-me', {useBeacon: true});

連結器參數

選用。

跨網域評估的連接器參數。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`linkerParam`	None：無	text	None：無	None	全部

範例值：_ga=1.231587807.1974034684.1435105198
使用範例：

// Alerts the linker parameter for the default tracker.
ga(function(tracker) {
  alert(tracker.get('linkerParam'));
});

Hit 回呼

選用。

處理命中後會呼叫的函式。此回呼功能的設計一律為在成功傳送命中後直接呼叫，或經判定無法傳送命中資料或傳送失敗時。呼叫時，系統不會將任何引數傳遞至函式。建議您不要使用 clickcallBack 執行對應用程式至關重要的程式碼，因為在極少數的情況下，系統可能無法呼叫某些程式碼 (例如伺服器沒有回應，或是 analytics.js 無法載入)。在這種情況下，您可以設定逾時，確保執行作業。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`hitCallback`	None：無	功能	None：無	None	全部

使用範例：

// Alerts the user when a hit is sent.
ga('send', 'pageview', {
  'hitCallback': function() {
    alert('hit sent');
  }
});

// Use a timeout to ensure the execution of critical application code.
ga('send', 'pageview', {'hitCallback': criticalCode});
setTimeout(criticalCode, 2000);

// Only run the critical code once.
var alreadyCalled = false;
function criticalCode() {
  if (alreadyCalled) return;
  alreadyCalled = true;

  // Run critical code here...
}

使用者

User-ID

選用。

如未在要求中指定用戶端 ID (cid)，則此為必填欄位。這是網站擁有者/資料庫使用者提供的已知 ID。ID 不得為 PII (個人識別資訊)。這個值不得保留在 Google Analytics (分析) Cookie 或其他 Analytics (分析) 提供的儲存空間中。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`userId`	`uid`	text	None：無	None	全部

範例值：as8eknlll
使用範例：

// Set the user ID when creating the tracker.
ga('create', 'UA-XXXX-Y', {'userId': 'as8eknlll'});

// Alternatively, you may set the user ID via the `set` method.
ga('set', 'userId', 'as8eknlll');

議程

工作階段控制

選用。

用於控制工作階段持續時間。如果設為「開始」，這會強制新的工作階段以這次命中為開頭，「結束」則會強制目前的工作階段以這次命中結尾。系統會忽略所有其他值。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`sessionControl`	`sc`	text	None：無	None	全部

範例值：start
使用範例：

// Starts a new session.
ga('send', 'pageview', {'sessionControl': 'start'});

流量來源

文件參照網址

選用。

指定為網站帶來流量的推薦連結來源。這個值也會用於計算流量來源。這個值的格式是網址。這個欄位是由 create 指令所初始化，只有在目前的主機名稱與參照網址主機名稱不同時才會設定，除非「alwaysSendReferrer」欄位設為 true。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`referrer`	`dr`	text	`document.referrer`	2048 位元組	全部

範例值：http://example.com
使用範例：

ga('set', 'referrer', 'http://example.com');

廣告活動名稱

選用。

指定廣告活動名稱。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`campaignName`	`cn`	text	None：無	100 位元組	全部

範例值：(direct)
使用範例：

ga('set', 'campaignName', '(direct)');

廣告活動來源

選用。

指定廣告活動來源。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`campaignSource`	`cs`	text	None：無	100 位元組	全部

範例值：(direct)
使用範例：

ga('set', 'campaignSource', '(direct)');

廣告活動媒介

選用。

指定廣告活動媒介。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`campaignMedium`	`cm`	text	None：無	50 位元組	全部

範例值：organic
使用範例：

ga('set', 'campaignMedium', 'organic');

廣告活動關鍵字

選用。

指定廣告活動關鍵字。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`campaignKeyword`	`ck`	text	None：無	500 位元組	全部

範例值：Blue Shoes
使用範例：

ga('set', 'campaignKeyword', 'Blue Shoes');

廣告活動內容

選用。

指定廣告活動內容。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`campaignContent`	`cc`	text	None：無	500 位元組	全部

範例值：content
使用範例：

ga('set', 'campaignContent', 'content');

廣告活動 ID

選用。

指定廣告活動 ID。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`campaignId`	`ci`	text	None：無	100 位元組	全部

範例值：ID
使用範例：

ga('set', 'campaignId', 'ID');

系統資訊

螢幕解析度

選用。

指定螢幕解析度。這個欄位是由 create 指令初始化。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`screenResolution`	`sr`	text	None：無	20 位元組	全部

範例值：800x600
使用範例：

ga('set', 'screenResolution', '800x600');

可視區域大小

選用。

指定瀏覽器 / 裝置的可視區域。這個欄位是由 create 指令初始化。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`viewportSize`	`vp`	text	None：無	20 位元組	全部

範例值：123x456
使用範例：

ga('set', 'viewportSize', '123x456');

文件編碼

選用。

指定用於為頁面 / 文件編碼的字元集。這個欄位是由 create 指令初始化。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`encoding`	`de`	text	`UTF-8`	20 位元組	全部

範例值：UTF-8
使用範例：

ga('set', 'encoding', 'UTF-16');

螢幕色彩

選用。

指定螢幕色彩深度。這個欄位是由 create 指令初始化。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`screenColors`	`sd`	text	None：無	20 位元組	全部

範例值：24-bits
使用範例：

ga('set', 'screenColors', '8-bit');

使用者語言

選用。

指定語言。這個欄位是由 create 指令初始化。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`language`	`ul`	text	None：無	20 位元組	全部

範例值：en-us
使用範例：

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

已啟用 Java

選用。

指定是否已啟用 Java。這個欄位是由 create 指令初始化。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`javaEnabled`	`je`	boolean	None：無	不適用	全部

範例值：true
使用範例：

ga('set', 'javaEnabled', true);

Flash 版本

選用。

指定 Flash 版本。這個欄位是由 create 指令初始化。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`flashVersion`	`fl`	text	None：無	20 位元組	全部

範例值：10 1 r103
使用範例：

ga('set', 'flashVersion', '10 1 r103');

衝撞

命中類型

所有命中類型都必須提供此欄位。

匹配類型，必須為「pageview」、「screenview」、「event」、「transaction」、「item」、「social」、「exception」和「time」。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`hitType`	`t`	text	None：無	None	全部

範例值：pageview
使用範例：

ga('send', {
  'hitType': 'pageview',
  'page': '/home'
});

非互動命中

選用。

指定將命中視為非互動式。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`nonInteraction`	`ni`	boolean	None：無	不適用	全部

範例值：true
使用範例：

ga('set', 'nonInteraction', true);

內容資訊

文件位置網址

選用。

指定網頁的完整網址 (不含錨定標記)。這個欄位是由 create 指令初始化。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`location`	`dl`	text	None：無	2048 位元組	全部

範例值：http://foo.com/home?a=b
使用範例：

ga('set', 'location', 'http://foo.com/home?a=b');

文件主機名稱

選用。

指定代管內容的主機名稱。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`hostname`	`dh`	text	None：無	100 位元組	全部

範例值：foo.com
使用範例：

ga('set', 'hostname', 'foo.com');

文件路徑

選用。

網頁網址的路徑部分，開頭應為「/」。如果是「網頁瀏覽」命中，請務必指定 &dl 或 &dh 和 &dp。用於指定虛擬網頁路徑。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`page`	`dp`	text	None：無	2048 位元組	全部

範例值：/foo
使用範例：

ga('set', 'page', '/foo');

文件標題

選用。

網頁 / 文件的標題。預設為 document.title。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`title`	`dt`	text	None：無	1500 位元組	全部

範例值：Settings
使用範例：

ga('set', 'title', 'Settings');

畫面名稱

這是畫面瀏覽命中類型的必要項目。

此參數在網站資源上是選用項目，在行動裝置資源中則是必要參數，用來觸發畫面瀏覽命中的「畫面名稱」。在網站資源中，這會預設為網頁的專屬網址，方法為使用 &dl 參數 (即原樣) 或從 &dh 和 &dp 組合而成。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`screenName`	`cd`	text	None：無	2048 位元組	畫面瀏覽計算

範例值：High Scores
使用範例：

ga('set', 'screenName', 'High Scores');

內容群組

選用。

您最多可以建立 5 個內容分類，每個群組都擁有 1 到 5 (含) 之間的索引。每個內容分類最多可包含 100 個內容群組。內容群組的值是階層文字，以「/」分隔。系統會移除開頭和結尾的所有斜線，並將所有重複的斜線縮減為單一斜線。舉例來說，「/a//b/」會轉換為「a/b」。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`contentGroup`	`cg<groupIndex>`	text	None：無	100 位元組	全部

範例值：news/sports
使用範例：

ga('set', 'contentGroup5', '/news/sports');

連結 ID

選用。

針對資源啟用加強型連結歸因時，在「網頁活動分析」報表中啟用的 DOM 元素 ID，用來區分同一個網址的多個連結。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`linkid`	`linkid`	text	None：無	None	全部

範例值：nav_bar
使用範例：

ga('set', '&linkid', 'html-element-id');

應用程式

應用程式名稱

選用。

指定應用程式名稱。任何包含應用程式相關資料 (即應用程式版本、應用程式 ID 或應用程式安裝工具 ID) 的命中，都必須提供此欄位。針對傳送至網站資源的命中，此欄位為選用欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`appName`	`an`	text	None：無	100 位元組	全部

範例值：My App
使用範例：

ga('set', 'appName', 'My App');

應用程式 ID

選用。

應用程式 ID。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`appId`	`aid`	text	None：無	150 位元組	全部

範例值：com.company.app
使用範例：

ga('set', 'appId', 'com.company.app');

應用程式版本

選用。

指定應用程式版本。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`appVersion`	`av`	text	None：無	100 位元組	全部

範例值：1.2
使用範例：

ga('set', 'appVersion', '1.2');

應用程式安裝程式 ID

選用。

應用程式安裝工具 ID。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`appInstallerId`	`aiid`	text	None：無	150 位元組	全部

範例值：com.platform.vending
使用範例：

ga('set', 'appInstallerId', 'com.platform.vending');

活動

事件類別

對於事件命中類型，此為必填屬性。

指定事件類別。欄位不得留空。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`eventCategory`	`ec`	text	None：無	150 位元組	event

範例值：Category
使用範例：

ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action'
});

事件動作

對於事件命中類型，此為必填屬性。

指定事件動作。欄位不得留空。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`eventAction`	`ea`	text	None：無	500 位元組	event

範例值：Action
使用範例：

ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action'
});

事件標籤

選用。

指定事件標籤。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`eventLabel`	`el`	text	None：無	500 位元組	event

範例值：Label
使用範例：

ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action',
  'eventLabel': 'Label'
});

事件值

選用。

指定事件值。值不得為負數。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`eventValue`	`ev`	整數	None：無	None	event

範例值：55
使用範例：

ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action',
  'eventValue': 55
});

加強型電子商務

產品 SKU

選用。

產品的 SKU。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product) id`	`pr<productIndex>id`	text	None：無	500 位元組	全部

範例值：P12345
使用範例：

ga('ec:addProduct', {'id': 'P12345'});

產品名稱

選用。

產品名稱產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product) name`	`pr<productIndex>nm`	text	None：無	500 位元組	全部

範例值：Android T-Shirt
使用範例：

ga('ec:addProduct', {'name': 'Android T-Shirt'});

產品品牌

選用。

與產品相關的品牌。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product) brand`	`pr<productIndex>br`	text	None：無	500 位元組	全部

範例值：Google
使用範例：

ga('ec:addProduct', {'brand': 'Google'});

產品類別

選用。

產品所屬的類別。產品索引必須是 1 到 200 (含首尾) 之間的正整數。產品類別參數可以是階層式。使用 / 做為分隔符號，最多可以指定 5 層階層。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product) category`	`pr<productIndex>ca`	text	None：無	500 位元組	全部

範例值：Apparel
使用範例：

ga('ec:addProduct', {'category': 'Apparel'});

產品子類

選用。

產品的子類。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product) variant`	`pr<productIndex>va`	text	None：無	500 位元組	全部

範例值：Black
使用範例：

ga('ec:addProduct', {'variant': 'Black'});

產品價格

選用。

產品的單價。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product) price`	`pr<productIndex>pr`	currency	None：無	None	全部

範例值：29.20
使用範例：

ga('ec:addProduct', {'price': '29.20'});

產品數量

選用。

產品數量。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product) quantity`	`pr<productIndex>qt`	整數	None：無	None	全部

範例值：2
使用範例：

ga('ec:addProduct', {'quantity': 2});

產品優待券代碼

選用。

與產品相關聯的優待券代碼。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product) coupon`	`pr<productIndex>cc`	text	None：無	500 位元組	全部

範例值：SUMMER_SALE13
使用範例：

ga('ec:addProduct', {'coupon': 'SUMMER_SALE13'});

產品位置

選用。

產品在清單或集合中的位置。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product) position`	`pr<productIndex>ps`	整數	None：無	None	全部

範例值：2
使用範例：

ga('ec:addProduct', {'position': 2});

產品自訂維度

選用。

產品層級的自訂維度，其中維度索引為 1 到 200 (含) 之間的正整數。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product) dimension`	`pr<productIndex>cd<dimensionIndex>`	text	None：無	150 位元組	全部

範例值：Member
使用範例：

ga('ec:addProduct', {'dimension1': 'Member'});

產品自訂指標

選用。

產品層級的自訂指標，其中指標索引是介於 1 到 200 (含) 之間的正整數。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product) metric`	`pr<productIndex>cm<metricIndex>`	整數	None：無	None	全部

範例值：28
使用範例：

ga('ec:addProduct', {'metric1': 28});

產品動作

選用。

命中中產品的角色。如未指定產品動作，則系統會忽略該次命中中的所有產品定義。必須為下列任一值：details、click、add、remove、checkout、checkout_option、purchase、refund。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product action)`	`pa`	text	None：無	None	全部

範例值：detail
使用範例：

ga('ec:setAction', 'detail');

交易 ID

選用。

交易 ID。這是產品動作設為「purchase」或「refund」時可傳送的額外參數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product action) id`	`ti`	text	None：無	None	全部

範例值：T1234
使用範例：

ga('ec:setAction', 'purchase', {'id': 'T1234'});

聯盟

選用。

發生這筆交易的商店或聯盟。這是產品動作設為「purchase」或「refund」時可傳送的額外參數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product action) affiliation`	`ta`	text	None：無	None	全部

範例值：Google Store
使用範例：

ga('ec:setAction', 'purchase', {'affiliation': 'Google Store'});

收益

選用。

交易總金額，包括稅金和運費。如未傳送，系統會使用同筆命中中所有產品的產品數量和價格欄位，自動計算這個值。這是產品動作設為「purchase」或「refund」時可傳送的額外參數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product action) revenue`	`tr`	currency	None：無	None	全部

範例值：123.21
使用範例：

ga('ec:setAction', 'purchase', {'revenue': '123.21'});

稅金

選用。

與交易相關的稅金總額。這是產品動作設為「purchase」或「refund」時可傳送的額外參數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product action) tax`	`tt`	currency	None：無	None	全部

範例值：10.78
使用範例：

ga('ec:setAction', 'purchase', {'tax': '10.78'});

運送

選用。

與交易相關聯的運費。這是產品動作設為「purchase」或「refund」時可傳送的額外參數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product action) shipping`	`ts`	currency	None：無	None	全部

範例值：3.55
使用範例：

ga('ec:setAction', 'purchase', {'shipping': '3.55'});

優待券代碼

選用。

交易兌換優待券。這是產品動作設為「purchase」或「refund」時可傳送的額外參數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product action) coupon`	`tcc`	text	None：無	None	全部

範例值：SUMMER08
使用範例：

ga('ec:setAction', 'purchase', {'coupon': 'SUMMER08'});

產品動作清單

選用。

發生產品動作的來源清單或集合。產品動作設為「detail」或「click」時，可能會傳送這個額外的參數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product action) list`	`pal`	text	None：無	None	全部

範例值：Search Results
使用範例：

ga('ec:setAction', 'click', {'list': 'Search Results'});

結帳步驟

選用。

結帳漏斗中的步驟編號。這是產品動作設為「checkout」時，系統可能會傳送這個額外參數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product action) step`	`cos`	整數	None：無	None	全部

範例值：2
使用範例：

ga('ec:setAction', 'checkout', {'step': 2});

結帳步驟選項

選用。

結帳步驟的其他資訊。這是產品動作設為「checkout」時，系統可能會傳送這個額外參數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(product action) option`	`col`	text	None：無	None	全部

範例值：Visa
使用範例：

ga('ec:setAction', 'checkout', {'option': 'Visa'});

產品曝光清單名稱

選用。

產品所屬的清單或集合。曝光清單索引必須是介於 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(impression) list`	`il<listIndex>nm`	text	None：無	None	全部

範例值：Search Results
使用範例：

ga('ec:addImpression', {'list': 'Search Results'});

產品曝光 SKU

選用。

產品 ID 或 SKU。曝光清單索引必須是介於 1 到 200 (含首尾) 之間的正整數。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(impression) id`	`il<listIndex>pi<productIndex>id`	text	None：無	None	全部

範例值：P67890
使用範例：

ga('ec:addImpression', {'id': 'P67890'});

產品曝光名稱

選用。

產品名稱曝光清單索引必須是介於 1 到 200 (含首尾) 之間的正整數。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(impression) name`	`il<listIndex>pi<productIndex>nm`	text	None：無	None	全部

範例值：Android T-Shirt
使用範例：

ga('ec:addImpression', {'name': 'Android T-Shirt'});

產品曝光品牌

選用。

與產品相關的品牌。曝光清單索引必須是介於 1 到 200 (含首尾) 之間的正整數。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(impression) brand`	`il<listIndex>pi<productIndex>br`	text	None：無	None	全部

範例值：Google
使用範例：

ga('ec:addImpression', {'brand': 'Google'});

產品類別

選用。

產品所屬的類別。曝光清單索引必須是介於 1 到 200 (含首尾) 之間的正整數。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(impression) category`	`il<listIndex>pi<productIndex>ca`	text	None：無	None	全部

範例值：Apparel
使用範例：

ga('ec:addImpression', {'category': 'Apparel'});

產品曝光變化版本

選用。

產品的子類。曝光清單索引必須是介於 1 到 200 (含首尾) 之間的正整數。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(impression) variant`	`il<listIndex>pi<productIndex>va`	text	None：無	None	全部

範例值：Black
使用範例：

ga('ec:addImpression', {'variant': 'Black'});

產品曝光位置

選用。

產品在清單或集合中的位置。曝光清單索引必須是介於 1 到 200 (含首尾) 之間的正整數。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(impression) position`	`il<listIndex>pi<productIndex>ps`	整數	None：無	None	全部

範例值：2
使用範例：

ga('ec:addImpression', {'position': 2});

產品曝光價格

選用。

產品的價格。曝光清單索引必須是介於 1 到 200 (含首尾) 之間的正整數。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(impression) price`	`il<listIndex>pi<productIndex>pr`	currency	None：無	None	全部

範例值：29.20
使用範例：

ga('ec:addImpression', {'price': '29.20'});

產品曝光自訂維度

選用。

產品層級的自訂維度，其中維度索引為 1 到 200 (含) 之間的正整數。曝光清單索引必須是介於 1 到 200 (含首尾) 之間的正整數。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(impression) dimension`	`il<listIndex>pi<productIndex>cd<dimensionIndex>`	text	None：無	None	全部

範例值：Member
使用範例：

ga('ec:addImpression', {'dimension1': 'Member'});

產品曝光自訂指標

選用。

產品層級的自訂指標，其中指標索引是介於 1 到 200 (含) 之間的正整數。曝光清單索引必須是介於 1 到 200 (含首尾) 之間的正整數。產品索引必須是 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(impression) metric`	`il<listIndex>pi<productIndex>cm<metricIndex>`	整數	None：無	None	全部

範例值：28
使用範例：

ga('ec:addImpression', {'metric1': '28'});

選用。

促銷 ID。促銷價格索引必須為 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(promo) id`	`promo<promoIndex>id`	text	None：無	None	全部

範例值：SHIP
使用範例：

ga('ec:addPromo', {'id': 'SHIP'});

選用。

促銷活動名稱。促銷價格索引必須為 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(promo) name`	`promo<promoIndex>nm`	text	None：無	None	全部

範例值：Free Shipping
使用範例：

ga('ec:addPromo', {'name': 'Free Shipping'});

選用。

與宣傳活動相關聯的廣告素材。促銷價格索引必須為 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(promo) creative`	`promo<promoIndex>cr`	text	None：無	None	全部

範例值：Shipping Banner
使用範例：

ga('ec:addPromo', {'creative': 'Shipping Banner'});

選用。

廣告素材的位置。促銷價格索引必須為 1 到 200 (含首尾) 之間的正整數。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(promo) position`	`promo<promoIndex>ps`	text	None：無	None	全部

範例值：banner_slot_1
使用範例：

ga('ec:addPromo', {'position': 'banner_slot_1'});

選用。

指定命中中包含的宣傳活動角色。如未指定宣傳動作，系統會採用預設的宣傳動作「檢視」。如要評估使用者點擊促銷活動的次數，請將這個值設為「promo_click」。如果是 analytics.js，您必須先安裝「加強型電子商務」外掛程式，才能使用這個欄位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`(promo) action`	`promoa`	text	None：無	None	全部

範例值：click
使用範例：

ga('ec:setAction', 'promo_click'});

貨幣代碼

選用。

如果顯示的話，表示所有交易貨幣金額皆以當地幣別表示。值必須是有效的 ISO 4217 貨幣代碼。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`currencyCode`	`cu`	text	None：無	10 位元組	全部

範例值：EUR
使用範例：

ga('set', 'currencyCode', 'EUR');

社群網路

對社交命中類型而言，這是必填屬性。

指定社群網路，例如 Facebook 或 Google+。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`socialNetwork`	`sn`	text	None：無	50 位元組	社交

範例值：facebook
使用範例：

ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

社交動作

對社交命中類型而言，這是必填屬性。

指定社交互動動作。舉例來說，當使用者按下 +1 按鈕時，在 Google+ 上的社交活動就是「加號」。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`socialAction`	`sa`	text	None：無	50 位元組	社交

範例值：like
使用範例：

ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

社交動作目標

對社交命中類型而言，這是必填屬性。

指定社交互動的目標。這個值通常是網址，但可以是任何文字。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`socialTarget`	`st`	text	None：無	2048 位元組	社交

範例值：http://foo.com
使用範例：

ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

時間

使用者載入時間類別

時間命中類型必填。

指定使用者載入時間類別。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`timingCategory`	`utc`	text	None：無	150 位元組	時間碼

範例值：category
使用範例：

ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123
});

使用者計時變數名稱

時間命中類型必填。

指定使用者載入時間變數。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`timingVar`	`utv`	text	None：無	500 位元組	時間碼

範例值：lookup
使用範例：

ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123
});

使用者載入時間

時間命中類型必填。

指定使用者載入時間值。此值以毫秒為單位。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`timingValue`	`utt`	整數	None：無	None	時間碼

範例值：123
使用範例：

ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123
});

使用者載入時間標籤

選用。

指定使用者載入時間標籤。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`timingLabel`	`utl`	text	None：無	500 位元組	時間碼

範例值：label
使用範例：

ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123,
  'timingLabel': 'label'
});

例外狀況

例外狀況說明

選用。

指定例外狀況的說明。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`exDescription`	`exd`	text	None：無	150 位元組	例外狀況

範例值：DatabaseError
使用範例：

ga('send', 'exception', {
  'exDescription': 'DatabaseError'
});

例外狀況是否嚴重？

選用。

指定例外狀況是否為嚴重例外狀況。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`exFatal`	`exf`	boolean	`1`	不適用	例外狀況

範例值：true
使用範例：

ga('send', 'exception', {
  'exFatal': true
});

自訂維度 / 指標

自訂維度

選用。

每個自訂維度都有相關聯的索引。自訂維度上限為 20 個 (Analytics (分析) 360 帳戶則為 200 個)。尺寸索引必須是介於 1 到 200 (含首尾) 之間的正整數。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`dimension`	`cd<dimensionIndex>`	text	None：無	150 位元組	全部

範例值：Sports
使用範例：

ga('set', 'dimension14', 'Sports');

自訂指標

選用。

每個自訂指標都有相關聯的索引。自訂指標最多只能有 20 個 (Analytics (分析) 360 帳戶則為 200 個)。指標索引必須是介於 1 到 200 (含首尾) 之間的正整數。

欄位名稱	通訊協定參數	值類型	預設值	長度最大值	支援的命中類型
`metric`	`cm<metricIndex>`	號碼	None：無	None	全部

範例值：47
使用範例：

ga('set', 'metric7', 47);