Analytics.js 欄位參照

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

  1. 只建立欄位
  2. 一般
  3. 使用者
  4. 工作階段
  5. 流量來源
  6. 系統資訊
  7. 命中
  8. 內容資訊
  9. 應用程式
  10. 事件
  11. 加強型電子商務
  12. 社交互動
  13. 時間
  14. 例外狀況
  15. 自訂維度/指標

僅建立欄位

下列欄位只能在 create 方法中設定。如需詳細資訊,請參閱《進階設定指南》中的「建立追蹤程式物件」一節。

追蹤 ID/網站資源 ID

對於所有命中類型而言,此為必填屬性。

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

欄位名稱 值類型 預設值
trackingId 傳簡訊給
範例值: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 傳簡訊給 t0
範例值:myTracker
使用範例:
ga('create', 'UA-XXXX-Y', {'name': 'myTracker'});

Client-ID

(選填) 這個屬性只能在 create 方法中設定。

匿名識別瀏覽器執行個體。根據預設,這個值會成為第一方 Analytics (分析) Cookie 的一部分,效期為兩年。

欄位名稱 值類型 預設值
clientId 傳簡訊給 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 布林值 false
範例值:true
使用範例:
ga('create', 'UA-XXXX-Y', {'alwaysSendReferrer': true});

允許錨定參數

(選填) 這個屬性只能在 create 方法中設定。

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

欄位名稱 值類型 預設值
allowAnchor 布林值 true
範例值:false
使用範例:
ga('create', 'UA-XXXX-Y', {'allowAnchor': false});

Cookie 名稱

(選填) 這個屬性只能在 create 方法中設定。

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

欄位名稱 值類型 預設值
cookieName 傳簡訊給 _ga
範例值:gaCookie
使用範例:
ga('create', 'UA-XXXX-Y', {'cookieName': 'gaCookie'});

Cookie 網域

(選填) 這個屬性只能在 create 方法中設定。

指定用來儲存 Analytics (分析) Cookie 的網域。如果設為「無」,則會在不指定網域的情況下設定 Cookie。

欄位名稱 值類型 預設值
cookieDomain 傳簡訊給 document.location.hostname (normalized)
範例值:example.com
使用範例:
ga('create', 'UA-XXXX-Y', {'cookieDomain': 'example.com'});

Cookie 標記

(選填) 這個屬性只能在 create 方法中設定。

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

欄位名稱 值類型 預設值
cookieFlags 傳簡訊給
範例值: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 布林值 true
範例值:true
使用範例:
ga('create', 'UA-XXXX-Y', {'cookieUpdate': 'false'});

儲存 GAC

(選填) 這個屬性只能在 create 方法中設定。

根據預設,analytics.js 會寫入 Cookie 來儲存廣告活動資訊。這個欄位可用來停用寫入該 Cookie 的功能。

欄位名稱 值類型 預設值
storeGac 布林值 true
範例值:false
使用範例:
ga('create', 'UA-XXXX-Y', {'storeGac': false});

舊版 Cookie 網域

(選填) 這個屬性只能在 create 方法中設定。

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

欄位名稱 值類型 預設值
legacyCookieDomain 傳簡訊給
範例值:store.example.com
使用範例:
ga('create', 'UA-XXXX-Y', {'legacyCookieDomain': 'store.example.com'});

舊版記錄匯入

(選填) 這個屬性只能在 create 方法中設定。

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

欄位名稱 值類型 預設值
legacyHistoryImport 布林值 true
範例值:false
使用範例:
ga('create', 'UA-XXXX-Y', 'auto', {'legacyHistoryImport': false});

允許連結器參數

(選填) 這個屬性只能在 create 方法中設定。

如果將這個欄位設為 True,使用者就能剖析跨網域連接器連結計量器,用來跨網域轉移狀態。

欄位名稱 值類型 預設值
allowLinker 布林值 false
範例值:true
使用範例:
ga('create', 'UA-XXXX-Y', {allowLinker: true});

一般

允許廣告功能

(選用)

若透過多媒體廣告功能外掛程式或 Google Analytics (分析) ([資源設定] > [資料收集]) 啟用這些功能,請將這個欄位設為 false,以停用 Google Analytics (分析) 廣告功能的信標。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
allowAdFeatures 布林值 true 不適用 全部
範例值:false
使用範例:
ga('set', 'allowAdFeatures', false)

遮罩 IP

(選用)

如果同時,系統將遮蓋寄件者的 IP 位址。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
anonymizeIp aip 布林值 不適用 全部
範例值:true
使用範例:
ga('set', 'anonymizeIp', true);

資料來源

(選用)

表示匹配的資料來源。從 analytics.js 傳送的命中會將資料來源設為「網站」,從其中一個行動 SDK 傳送的命中會將資料來源設為「應用程式」。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
dataSource ds 傳簡訊給 全部
範例值:crm
使用範例:
ga('set', 'dataSource', 'crm');

佇列時間

(選用)

用於收集離線 / 潛在命中。這個值代表系統從回報到命中和傳送匹配之間經過的時間差異 (以毫秒為單位)。這個值必須大於或等於 0。如果值超過四小時,可能會導致系統無法處理匹配資料。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
queueTime qt 整數 全部
範例值:560
使用範例:
ga('set', 'queueTime', 560);

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

(選用)

根據預設,從 https 網頁傳送的信標將使用 https 傳送,而從 http 網頁傳送的信標將使用 http 傳送。如果將 forceSSL 設為 True,就會強制 http 網頁也會使用 https 傳送所有信標。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
forceSSL 布林值 false 不適用 全部
範例值:true
使用範例:
ga('set', 'forceSSL', true);

交通

(選用)

這會指定傳送匹配的傳輸機制。選項有「信標」、「xhr」或「圖片」。 根據預設,analytics.js 會根據命中大小及瀏覽器功能試著找出最佳方法。如果您指定「信標」,且使用者的瀏覽器不支援「navgator.sendBeacon」,這個方法就會因為命中大小而恢復為「image」或「xhr」。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
transport 傳簡訊給 none (automatically determined) 全部
範例值:beacon
使用範例:
ga('send', 'event', 'click', 'download-me', {transport: 'beacon'});

使用信標

(選用)

這個選項現已淘汰。請改用「傳輸」。如果設為 True,系統會指示用戶端使用 Navgator.sendBeacon 傳送命中。如果想要在使用者離開網站前追蹤活動,就應該避免發生瀏覽延遲。如果瀏覽器不支援 navigationgator.sendBeacon,系統會照常傳送命中。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
useBeacon 布林值 false 不適用 全部
範例值:true
使用範例:
ga('send', 'event', 'click', 'download-me', {useBeacon: true});

Linker 參數

(選用)

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
linkerParam 傳簡訊給 全部
範例值:_ga=1.231587807.1974034684.1435105198
使用範例:
// Alerts the linker parameter for the default tracker.
ga(function(tracker) {
  alert(tracker.get('linkerParam'));
});

命中回呼

(選用)

處理匹配後將會呼叫的函式。這個回呼一律會在成功傳送命中後,或是判定無法傳送命中或無法傳送命中時一律呼叫。呼叫時不會傳遞任何引數給函式。建議您避免使用 HitcallBack 執行對應用程式而言重要的程式碼,因為在極少數情況下,系統可能會呼叫呼叫 (例如伺服器沒有回應或 analytics.js 無法載入)。在此情況下,您可以設定逾時來確保執行。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
hitCallback 函式 全部
使用範例:
// 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...
}

使用者

使用者 ID

(選用)

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
userId uid 傳簡訊給 全部
範例值: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');

Session

工作階段控制

(選用)

用於控制工作階段持續時間。如果設為「start」,系統會強制新工作階段開始為這個命中,而「end」則會強制以目前命中結束目前的工作階段。所有其他值都會遭到忽略。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
sessionControl sc 傳簡訊給 全部
範例值:start
使用範例:
// Starts a new session.
ga('send', 'pageview', {'sessionControl': 'start'});

流量來源

文件參照網址

(選用)

指定哪些參照連結網址來源帶來了網站。這個值也會用來計算流量來源。這個值的格式必須是網址。這個欄位是由 create 指令初始化,且只有在目前的主機名稱與參照網址主機名稱不同時,才需要設定這個欄位 (除非「alwaysSendReferrer」欄位設為 true)。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
referrer dr 傳簡訊給 document.referrer 2048 位元組 全部
範例值:http://example.com
使用範例:
ga('set', 'referrer', 'http://example.com');

廣告活動名稱

(選用)

指定廣告活動名稱。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
campaignName cn 傳簡訊給 100 位元組 全部
範例值:(direct)
使用範例:
ga('set', 'campaignName', '(direct)');

廣告活動來源

(選用)

指定廣告活動來源。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
campaignSource cs 傳簡訊給 100 位元組 全部
範例值:(direct)
使用範例:
ga('set', 'campaignSource', '(direct)');

廣告活動媒介

(選用)

指定廣告活動媒介。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
campaignMedium cm 傳簡訊給 50 位元組 全部
範例值:organic
使用範例:
ga('set', 'campaignMedium', 'organic');

廣告活動關鍵字

(選用)

指定廣告活動關鍵字。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
campaignKeyword ck 傳簡訊給 500 位元組 全部
範例值:Blue Shoes
使用範例:
ga('set', 'campaignKeyword', 'Blue Shoes');

廣告活動內容

(選用)

指定廣告活動內容。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
campaignContent cc 傳簡訊給 500 位元組 全部
範例值:content
使用範例:
ga('set', 'campaignContent', 'content');

廣告活動 ID

(選用)

指定廣告活動編號。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
campaignId ci 傳簡訊給 100 位元組 全部
範例值:ID
使用範例:
ga('set', 'campaignId', 'ID');

系統資訊

螢幕解析度

(選用)

指定螢幕解析度。這個欄位會透過 create 指令初始化。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
screenResolution sr 傳簡訊給 20 位元組 全部
範例值:800x600
使用範例:
ga('set', 'screenResolution', '800x600');

可視區域大小

(選用)

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
viewportSize vp 傳簡訊給 20 位元組 全部
範例值:123x456
使用範例:
ga('set', 'viewportSize', '123x456');

文件編碼

(選用)

指定用來對網頁 / 文件編碼的字元集。這個欄位會透過 create 指令初始化。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
encoding de 傳簡訊給 UTF-8 20 位元組 全部
範例值:UTF-8
使用範例:
ga('set', 'encoding', 'UTF-16');

螢幕色彩

(選用)

指定螢幕色彩深度。這個欄位會透過 create 指令初始化。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
screenColors sd 傳簡訊給 20 位元組 全部
範例值:24-bits
使用範例:
ga('set', 'screenColors', '8-bit');

User Language

(選用)

指定語言。這個欄位會透過 create 指令初始化。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
language ul 傳簡訊給 20 位元組 全部
範例值:en-us
使用範例:
ga('set', 'language', 'en-us');

已啟用 Java

(選用)

指定是否要啟用 Java。這個欄位會透過 create 指令初始化。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
javaEnabled je 布林值 不適用 全部
範例值:true
使用範例:
ga('set', 'javaEnabled', true);

Flash 版本

(選用)

指定 Flash 版本。這個欄位會透過 create 指令初始化。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
flashVersion fl 傳簡訊給 20 位元組 全部
範例值:10 1 r103
使用範例:
ga('set', 'flashVersion', '10 1 r103');

Hit

命中類型

對於所有命中類型而言,此為必填屬性。

匹配類型,必須是「pageview」、「screenview」、「event」、「transaction」、「item」、「social」、「exception」、「timing」之一。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
hitType t 傳簡訊給 全部
範例值:pageview
使用範例:
ga('send', {
  'hitType': 'pageview',
  'page': '/home'
});

非互動命中

(選用)

指定匹配將視為非互動。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
nonInteraction ni 布林值 不適用 全部
範例值:true
使用範例:
ga('set', 'nonInteraction', true);

內容資訊

文件位置網址

(選用)

指定網頁的完整網址 (不含錨點)。這個欄位會透過 create 指令初始化。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
location dl 傳簡訊給 2048 位元組 全部
範例值:http://foo.com/home?a=b
使用範例:
ga('set', 'location', 'http://foo.com/home?a=b');

文件主機名稱

(選用)

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
hostname dh 傳簡訊給 100 位元組 全部
範例值:foo.com
使用範例:
ga('set', 'hostname', 'foo.com');

文件路徑

(選用)

網頁網址的路徑部分。應以「/」開頭。如果是「pageview」命中,你必須指定 &dl,或是同時指定 &dh 和 &dp,該命中有效。用來指定虛擬網頁路徑。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
page dp 傳簡訊給 2048 位元組 全部
範例值:/foo
使用範例:
ga('set', 'page', '/foo');

文件標題

(選用)

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
title dt 傳簡訊給 1,500 位元組 全部
範例值:Settings
使用範例:
ga('set', 'title', 'Settings');

畫面名稱

對於畫面瀏覽命中類型,此為必要屬性。

這個參數在網站資源上為選用參數,在行動裝置瀏覽畫面的行動版資源中則為必要參數,在畫面瀏覽命中用於「畫面名稱」中。在網站資源中,系統會使用現狀的 &dl 參數,或預設為從 &dh 和 &dp 組合網址,然後預設為網頁的不重複網址。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
screenName cd 傳簡訊給 2048 位元組 畫面瀏覽計算
範例值:High Scores
使用範例:
ga('set', 'screenName', 'High Scores');

內容群組

(選用)

您最多可以設定 5 個內容分類,每個群組都有 1 到 5 (含) 之間的關聯索引。每個內容分類最多可包含 100 個內容群組。內容群組的值是階層式文字,以「/」分隔。所有開頭和結尾的斜線都會移除,而任何重複的斜線則都會減少為單個斜線。例如,「/a//b/」會轉換成「a/b」。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
contentGroup cg<groupIndex> 傳簡訊給 100 位元組 全部
範例值:news/sports
使用範例:
ga('set', 'contentGroup5', '/news/sports');

連結 ID

(選用)

點擊中的 DOM 元素編號。在資源「加強型連結歸因」功能中使用時,此屬性可用於區分多個指向相同網址的連結。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
linkid linkid 傳簡訊給 全部
範例值:nav_bar
使用範例:
ga('set', '&linkid', 'html-element-id');

應用程式

應用程式名稱

(選用)

指定應用程式名稱。凡是含有應用程式相關資料的命中 (例如應用程式版本、應用程式編號或應用程式安裝工具編號),都必須提供這個欄位。如果是傳送至網站資源的命中,這個欄位是選填欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
appName an 傳簡訊給 100 位元組 全部
範例值:My App
使用範例:
ga('set', 'appName', 'My App');

應用程式 ID

(選用)

應用程式 ID。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
appId aid 傳簡訊給 150 位元組 全部
範例值:com.company.app
使用範例:
ga('set', 'appId', 'com.company.app');

應用程式版本

(選用)

指定應用程式版本。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
appVersion av 傳簡訊給 100 位元組 全部
範例值:1.2
使用範例:
ga('set', 'appVersion', '1.2');

應用程式安裝工具 ID

(選用)

應用程式安裝工具 ID。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
appInstallerId aiid 傳簡訊給 150 位元組 全部
範例值:com.platform.vending
使用範例:
ga('set', 'appInstallerId', 'com.platform.vending');

活動

事件類別

對於事件命中類型,此為必要屬性。

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
eventCategory ec 傳簡訊給 150 位元組 event
範例值:Category
使用範例:
ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action'
});

事件動作

對於事件命中類型,此為必要屬性。

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
eventAction ea 傳簡訊給 500 位元組 event
範例值:Action
使用範例:
ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action'
});

事件標籤

(選用)

指定事件標籤。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
eventLabel el 傳簡訊給 500 位元組 event
範例值:Label
使用範例:
ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action',
  'eventLabel': 'Label'
});

事件值

(選用)

指定事件值。值必須為非負數。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
eventValue ev 整數 event
範例值:55
使用範例:
ga('send', 'event', {
  'eventCategory': 'Category',
  'eventAction': 'Action',
  'eventValue': 55
});

加強型電子商務

產品 SKU

(選用)

產品的 SKU。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product) id pr<productIndex>id 傳簡訊給 500 位元組 全部
範例值:P12345
使用範例:
ga('ec:addProduct', {'id': 'P12345'});

產品名稱

(選用)

產品名稱。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product) name pr<productIndex>nm 傳簡訊給 500 位元組 全部
範例值:Android T-Shirt
使用範例:
ga('ec:addProduct', {'name': 'Android T-Shirt'});

產品品牌

(選用)

與產品相關聯的品牌。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product) brand pr<productIndex>br 傳簡訊給 500 位元組 全部
範例值:Google
使用範例:
ga('ec:addProduct', {'brand': 'Google'});

產品類別

(選用)

產品所屬的類別。產品索引必須是介於 1 至 200 (含) 之間的正整數。產品類別參數可以是階層式。使用「/」做為分隔符號,最多可以指定 5 個層級。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product) category pr<productIndex>ca 傳簡訊給 500 位元組 全部
範例值:Apparel
使用範例:
ga('ec:addProduct', {'category': 'Apparel'});

產品子類

(選用)

產品的子類。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product) variant pr<productIndex>va 傳簡訊給 500 位元組 全部
範例值:Black
使用範例:
ga('ec:addProduct', {'variant': 'Black'});

產品價格

(選用)

產品的單價。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product) price pr<productIndex>pr currency 全部
範例值:29.20
使用範例:
ga('ec:addProduct', {'price': '29.20'});

產品數量

(選用)

產品的數量。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product) quantity pr<productIndex>qt 整數 全部
範例值:2
使用範例:
ga('ec:addProduct', {'quantity': 2});

產品優待券代碼

(選用)

與產品相關聯的優待券代碼。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product) coupon pr<productIndex>cc 傳簡訊給 500 位元組 全部
範例值:SUMMER_SALE13
使用範例:
ga('ec:addProduct', {'coupon': 'SUMMER_SALE13'});

產品定位

(選用)

產品在清單或系列中的位置。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product) position pr<productIndex>ps 整數 全部
範例值:2
使用範例:
ga('ec:addProduct', {'position': 2});

產品自訂維度

(選用)

產品層級的自訂維度,維度索引為介於 1 至 200 (含) 之間的正整數。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product) dimension pr<productIndex>cd<dimensionIndex> 傳簡訊給 150 位元組 全部
範例值:Member
使用範例:
ga('ec:addProduct', {'dimension1': 'Member'});

產品自訂指標

(選用)

產品層級的自訂指標,指標指標為介於 1 至 200 (含) 之間的正整數。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product) metric pr<productIndex>cm<metricIndex> 整數 全部
範例值:28
使用範例:
ga('ec:addProduct', {'metric1': 28});

產品動作

(選用)

命中產品所扮演的角色。如未指定產品動作,系統將忽略該命中中的所有產品定義。必須是以下其中一種內容:詳細資料、點擊、新增、移除、結帳、結帳、購買、退款。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product action) pa 傳簡訊給 全部
範例值:detail
使用範例:
ga('ec:setAction', 'detail');

交易 ID

(選用)

交易 ID。「產品動作」設為「purchase」或「refund」時,可以傳送這個額外參數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product action) id ti 傳簡訊給 全部
範例值:T1234
使用範例:
ga('ec:setAction', 'purchase', {'id': 'T1234'});

聯盟

(選用)

進行交易的商店或聯盟。「產品動作」設為「purchase」或「refund」時,可以傳送這個額外參數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product action) affiliation ta 傳簡訊給 全部
範例值:Google Store
使用範例:
ga('ec:setAction', 'purchase', {'affiliation': 'Google Store'});

收益

(選用)

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product action) revenue tr currency 全部
範例值:123.21
使用範例:
ga('ec:setAction', 'purchase', {'revenue': '123.21'});

稅金

(選用)

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product action) tax tt currency 全部
範例值:10.78
使用範例:
ga('ec:setAction', 'purchase', {'tax': '10.78'});

運送

(選用)

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product action) shipping ts currency 全部
範例值:3.55
使用範例:
ga('ec:setAction', 'purchase', {'shipping': '3.55'});

優待券代碼

(選用)

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product action) coupon tcc 傳簡訊給 全部
範例值:SUMMER08
使用範例:
ga('ec:setAction', 'purchase', {'coupon': 'SUMMER08'});

產品動作清單

(選用)

發生產品動作的清單或產品素材資源集合。「產品動作」設為「detail」或「click」時傳送此額外參數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product action) list pal 傳簡訊給 全部
範例值:Search Results
使用範例:
ga('ec:setAction', 'click', {'list': 'Search Results'});

結帳步驟

(選用)

結帳程序中的步驟編號。「產品動作」設為「checkout」時傳送此額外參數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product action) step cos 整數 全部
範例值:2
使用範例:
ga('ec:setAction', 'checkout', {'step': 2});

結帳步驟選項

(選用)

有關結帳步驟的其他資訊。「產品動作」設為「checkout」時傳送此額外參數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(product action) option col 傳簡訊給 全部
範例值:Visa
使用範例:
ga('ec:setAction', 'checkout', {'option': 'Visa'});

產品曝光清單名稱

(選用)

產品所屬的清單或產品素材資源集合。曝光清單索引必須是介於 1 到 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(impression) list il<listIndex>nm 傳簡訊給 全部
範例值:Search Results
使用範例:
ga('ec:addImpression', {'list': 'Search Results'});

產品曝光 SKU

(選用)

產品 ID 或 SKU。曝光清單索引必須是介於 1 到 200 (含) 之間的正整數。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(impression) id il<listIndex>pi<productIndex>id 傳簡訊給 全部
範例值:P67890
使用範例:
ga('ec:addImpression', {'id': 'P67890'});

產品曝光名稱

(選用)

產品名稱。曝光清單索引必須是介於 1 到 200 (含) 之間的正整數。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(impression) name il<listIndex>pi<productIndex>nm 傳簡訊給 全部
範例值:Android T-Shirt
使用範例:
ga('ec:addImpression', {'name': 'Android T-Shirt'});

產品曝光品牌

(選用)

與產品相關聯的品牌。曝光清單索引必須是介於 1 到 200 (含) 之間的正整數。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(impression) brand il<listIndex>pi<productIndex>br 傳簡訊給 全部
範例值:Google
使用範例:
ga('ec:addImpression', {'brand': 'Google'});

產品曝光類別

(選用)

產品所屬的類別。曝光清單索引必須是介於 1 到 200 (含) 之間的正整數。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(impression) category il<listIndex>pi<productIndex>ca 傳簡訊給 全部
範例值:Apparel
使用範例:
ga('ec:addImpression', {'category': 'Apparel'});

產品曝光子類

(選用)

產品的子類。曝光清單索引必須是介於 1 到 200 (含) 之間的正整數。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(impression) variant il<listIndex>pi<productIndex>va 傳簡訊給 全部
範例值:Black
使用範例:
ga('ec:addImpression', {'variant': 'Black'});

產品曝光位置

(選用)

產品在清單或系列中的位置。曝光清單索引必須是介於 1 到 200 (含) 之間的正整數。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(impression) position il<listIndex>pi<productIndex>ps 整數 全部
範例值:2
使用範例:
ga('ec:addImpression', {'position': 2});

產品曝光價格

(選用)

產品的價格。曝光清單索引必須是介於 1 到 200 (含) 之間的正整數。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(impression) price il<listIndex>pi<productIndex>pr currency 全部
範例值:29.20
使用範例:
ga('ec:addImpression', {'price': '29.20'});

產品曝光自訂維度

(選用)

產品層級的自訂維度,維度索引為介於 1 至 200 (含) 之間的正整數。曝光清單索引必須是介於 1 到 200 (含) 之間的正整數。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(impression) dimension il<listIndex>pi<productIndex>cd<dimensionIndex> 傳簡訊給 全部
範例值:Member
使用範例:
ga('ec:addImpression', {'dimension1': 'Member'});

產品曝光自訂指標

(選用)

產品層級的自訂指標,指標指標為介於 1 至 200 (含) 之間的正整數。曝光清單索引必須是介於 1 到 200 (含) 之間的正整數。產品索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(impression) metric il<listIndex>pi<productIndex>cm<metricIndex> 整數 全部
範例值:28
使用範例:
ga('ec:addImpression', {'metric1': '28'});

促銷 ID

(選用)

促銷 ID。促銷活動索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(promo) id promo<promoIndex>id 傳簡訊給 全部
範例值:SHIP
使用範例:
ga('ec:addPromo', {'id': 'SHIP'});

促銷活動名稱

(選用)

促銷活動的名稱。促銷活動索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(promo) name promo<promoIndex>nm 傳簡訊給 全部
範例值:Free Shipping
使用範例:
ga('ec:addPromo', {'name': 'Free Shipping'});

促銷活動廣告素材

(選用)

與促銷活動相關的廣告素材。促銷活動索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(promo) creative promo<promoIndex>cr 傳簡訊給 全部
範例值:Shipping Banner
使用範例:
ga('ec:addPromo', {'creative': 'Shipping Banner'});

促銷活動排名

(選用)

廣告素材的位置。促銷活動索引必須是介於 1 至 200 (含) 之間的正整數。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(promo) position promo<promoIndex>ps 傳簡訊給 全部
範例值:banner_slot_1
使用範例:
ga('ec:addPromo', {'position': 'banner_slot_1'});

促銷活動動作

(選用)

指定命中所含促銷活動的角色。如未指定促銷活動動作,系統會採用預設的促銷動作「查看」。如要評估使用者點擊促銷活動,請將促銷活動設為「promo_click」。針對 analytics.js,您必須先安裝 Enhanced 電子商務外掛程式,才能使用這個欄位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
(promo) action promoa 傳簡訊給 全部
範例值:click
使用範例:
ga('ec:setAction', 'promo_click'});

貨幣代碼

(選用)

如果有,則代表所有交易貨幣金額的當地貨幣。值必須是有效的 ISO 4217 貨幣代碼。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
currencyCode cu 傳簡訊給 10 個位元組 全部
範例值:EUR
使用範例:
ga('set', 'currencyCode', 'EUR');

社交互動

社交網路

對於社交命中類型,此為必要屬性。

指定社交網路,例如 Facebook 或 Google+。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
socialNetwork sn 傳簡訊給 50 位元組 社交
範例值:facebook
使用範例:
ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

社交動作

對於社交命中類型,此為必要屬性。

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
socialAction sa 傳簡訊給 50 位元組 社交
範例值:like
使用範例:
ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

社交行動目標

對於社交命中類型,此為必要屬性。

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
socialTarget st 傳簡訊給 2048 位元組 社交
範例值:http://foo.com
使用範例:
ga('send', 'social', {
  'socialNetwork': 'facebook',
  'socialAction': 'like',
  'socialTarget': 'http://foo.com'
})

Timing

使用者載入時間類別

必須設定時間命中類型。

指定使用者的時間類別。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
timingCategory utc 傳簡訊給 150 位元組 時間碼
範例值:category
使用範例:
ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123
});

使用者時間變數名稱

必須設定時間命中類型。

指定使用者的時間變數。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
timingVar utv 傳簡訊給 500 位元組 時間碼
範例值:lookup
使用範例:
ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123
});

使用者載入時間

必須設定時間命中類型。

指定使用者時間值。這個值以毫秒為單位。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
timingValue utt 整數 時間碼
範例值:123
使用範例:
ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123
});

使用者時間標籤

(選用)

指定使用者的時間標籤。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
timingLabel utl 傳簡訊給 500 位元組 時間碼
範例值:label
使用範例:
ga('send', 'timing', {
  'timingCategory': 'category',
  'timingVar': 'lookup',
  'timingValue': 123,
  'timingLabel': 'label'
});

例外狀況

例外狀況說明

(選用)

指定例外狀況的說明。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
exDescription exd 傳簡訊給 150 位元組 例外狀況
範例值:DatabaseError
使用範例:
ga('send', 'exception', {
  'exDescription': 'DatabaseError'
});

例外狀況嚴重錯誤?

(選用)

指定例外狀況是否嚴重。

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
exFatal exf 布林值 1 不適用 例外狀況
範例值:true
使用範例:
ga('send', 'exception', {
  'exFatal': true
});

自訂維度 / 指標

自訂維度

(選用)

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
dimension cd<dimensionIndex> 傳簡訊給 150 位元組 全部
範例值:Sports
使用範例:
ga('set', 'dimension14', 'Sports');

自訂指標

(選用)

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

欄位名稱 通訊協定參數 值類型 預設值 長度上限 支援的命中類型
metric cm<metricIndex> 數字 全部
範例值:47
使用範例:
ga('set', 'metric7', 47);