Measurement Protocol 參數參考資料

本文件列出 Measurement Protocol 的所有參數。

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

一般

通訊協定版本

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

通訊協定版本。目前值為「1」。只有在變更不具回溯相容性時,這項變更才會變更。

參數 值類型 預設值 長度最大值 支援的命中類型
v text None:無 None:無 全部
範例值:1
使用範例:v=1

追蹤 ID/ 網站資源 ID

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

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

參數 值類型 預設值 長度最大值 支援的命中類型
tid text None:無 None:無 全部
範例值:UA-XXXX-Y
使用範例:tid=UA-XXXX-Y

遮蓋 IP

選用。

如果有這項設定,系統會遮蓋寄件者的 IP 位址。舉例來說,如果酬載中出現下列任一參數,系統就會遮蓋 IP:&aip=、&aip=0 或 &aip=1。

參數 值類型 預設值 長度最大值 支援的命中類型
aip boolean None:無 None:無 全部
範例值:1
使用範例:aip=1

停用廣告個人化設定

選用。

使用這個參數將事件標示為已停用廣告個人化功能,包括設為允許廣告個人化的資源中的事件。舉例來說,如果將交易標示為停用廣告個人化功能,系統在填入「過往購買者」的再行銷目標對象時,就不會使用該筆交易。

參數 值類型 預設值 長度最大值 支援的命中類型
npa boolean None:無 None:無 全部
範例值:1
使用範例:npa=1

資料來源

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
ds text None:無 None:無 全部
範例值:web
使用範例:ds=web

範例值:app
使用範例:ds=app

範例值:call center
使用範例:ds=call%20center

範例值:crm
使用範例:ds=crm

佇列時間

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
qt 整數 None:無 None:無 全部
範例值:560
使用範例:qt=560

快取破壞

選用。

用於在 GET 要求中傳送隨機號碼,確保瀏覽器和 Proxy 不會快取命中資料。我們發現某些第三方網際網路篩選軟體會在 HTTP 要求中加入錯誤的額外參數,因此應傳送這個參數,做為要求的最後參數。系統不會將這個值用於報表。

參數 值類型 預設值 長度最大值 支援的命中類型
z text None:無 None:無 全部
範例值:289372387623
使用範例:z=289372387623

使用者

用戶端 ID

選用。

如未在請求中指定使用者 ID (uid),則此為必填欄位。能以匿名方式識別特定使用者、裝置或瀏覽器執行個體。以網路來說,這類 Cookie 通常會儲存為第一方 Cookie,有效期限為兩年。如果是行動應用程式,每次安裝應用程式時,系統都會隨機產生一個參數。這個欄位的值應為一個隨機 UUID (第 4 版),如 http://www.ietf.org/rfc/rfc4122.txt 所述。

參數 值類型 預設值 長度最大值 支援的命中類型
cid text None:無 None:無 全部
範例值:35009a79-1a05-49d7-b876-2b884d0f825b
使用範例:cid=35009a79-1a05-49d7-b876-2b884d0f825b

使用者 ID

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
uid text None:無 None:無 全部
範例值:as8eknlll
使用範例:uid=as8eknlll

議程

工作階段控制

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
sc text None:無 None:無 全部
範例值:start
使用範例:sc=start

範例值:end
使用範例:sc=end

IP 覆寫

選用。

使用者的 IP 位址。這必須是 IPv4 或 IPv6 格式的有效 IP 位址。系統會一律以相同方式 (&aip (去識別化 IP)) 進行去識別化處理。

參數 值類型 預設值 長度最大值 支援的命中類型
uip text None:無 None:無 全部
範例值:1.2.3.4
使用範例:uip=1.2.3.4

使用者代理程式覆寫

選用。

瀏覽器的使用者代理程式。請注意,Google 擁有程式庫可識別真實的使用者代理程式。打造專屬虛擬服務專員時,你隨時可能遇到瓶頸。

參數 值類型 預設值 長度最大值 支援的命中類型
ua text None:無 None:無 全部
範例值:Opera/9.80 (Windows NT 6.0) Presto/2.12.388 Version/12.14
使用範例:ua=Opera%2F9.80%20%28Windows%20NT%206.0%29%20Presto%2F2.12.388%20Version%2F12.14

地理區域覆寫

選用。

使用者的地理位置。地理區域 ID 應為兩個字母的國家/地區代碼,或代表城市或區域的條件 ID (請參閱 http://developers.google.com/analytics/devguides/collection/protocol/v1/geoid)。這個參數會優先處理所有衍生自 IP 位址的位置,包括 IP 覆寫參數。如果代碼無效,地理區域維度會設為「(未設定)」。

參數 值類型 預設值 長度最大值 支援的命中類型
geoid text None:無 None:無 全部
範例值:US
使用範例:geoid=US

範例值:21137
使用範例:geoid=21137

流量來源

文件參照網址

選用。

指定為網站帶來流量的推薦連結來源。這個值也會用於計算流量來源。這個值的格式是網址。

參數 值類型 預設值 長度最大值 支援的命中類型
dr text None:無 2048 位元組 全部
範例值:http://example.com
使用範例:dr=http%3A%2F%2Fexample.com

廣告活動名稱

選用。

指定廣告活動名稱。

參數 值類型 預設值 長度最大值 支援的命中類型
cn text None:無 100 位元組 全部
範例值:(direct)
使用範例:cn=%28direct%29

廣告活動來源

選用。

指定廣告活動來源。

參數 值類型 預設值 長度最大值 支援的命中類型
cs text None:無 100 位元組 全部
範例值:(direct)
使用範例:cs=%28direct%29

廣告活動媒介

選用。

指定廣告活動媒介。

參數 值類型 預設值 長度最大值 支援的命中類型
cm text None:無 50 位元組 全部
範例值:organic
使用範例:cm=organic

廣告活動關鍵字

選用。

指定廣告活動關鍵字。

參數 值類型 預設值 長度最大值 支援的命中類型
ck text None:無 500 位元組 全部
範例值:Blue Shoes
使用範例:ck=Blue%20Shoes

廣告活動內容

選用。

指定廣告活動內容。

參數 值類型 預設值 長度最大值 支援的命中類型
cc text None:無 500 位元組 全部
範例值:content
使用範例:cc=content

廣告活動 ID

選用。

指定廣告活動 ID。

參數 值類型 預設值 長度最大值 支援的命中類型
ci text None:無 100 位元組 全部
範例值:ID
使用範例:ci=ID

Google Ads ID

選用。

指定 Google 廣告 ID。

參數 值類型 預設值 長度最大值 支援的命中類型
gclid text None:無 None:無 全部
範例值:CL6Q-OXyqKUCFcgK2goddQuoHg
使用範例:gclid=CL6Q-OXyqKUCFcgK2goddQuoHg

Google 多媒體廣告 ID

選用。

指定 Google 多媒體廣告 ID。

參數 值類型 預設值 長度最大值 支援的命中類型
dclid text None:無 None:無 全部
範例值:d_click_id
使用範例:dclid=d_click_id

系統資訊

螢幕解析度

選用。

指定螢幕解析度。

參數 值類型 預設值 長度最大值 支援的命中類型
sr text None:無 20 位元組 全部
範例值:800x600
使用範例:sr=800x600

可視區域大小

選用。

指定瀏覽器 / 裝置的可視區域。

參數 值類型 預設值 長度最大值 支援的命中類型
vp text None:無 20 位元組 全部
範例值:123x456
使用範例:vp=123x456

文件編碼

選用。

指定用於為頁面 / 文件編碼的字元集。

參數 值類型 預設值 長度最大值 支援的命中類型
de text UTF-8 20 位元組 全部
範例值:UTF-8
使用範例:de=UTF-8

螢幕色彩

選用。

指定螢幕色彩深度。

參數 值類型 預設值 長度最大值 支援的命中類型
sd text None:無 20 位元組 全部
範例值:24-bits
使用範例:sd=24-bits

使用者語言

選用。

指定語言。

參數 值類型 預設值 長度最大值 支援的命中類型
ul text None:無 20 位元組 全部
範例值:en-us
使用範例:ul=en-us

已啟用 Java

選用。

指定是否已啟用 Java。

參數 值類型 預設值 長度最大值 支援的命中類型
je boolean None:無 None:無 全部
範例值:1
使用範例:je=1

Flash 版本

選用。

指定 Flash 版本。

參數 值類型 預設值 長度最大值 支援的命中類型
fl text None:無 20 位元組 全部
範例值:10 1 r103
使用範例:fl=10%201%20r103

衝撞

命中類型

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

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

參數 值類型 預設值 長度最大值 支援的命中類型
t text None:無 None:無 全部
範例值:pageview
使用範例:t=pageview

非互動命中

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
ni boolean None:無 None:無 全部
範例值:1
使用範例:ni=1

內容資訊

文件位置網址

選用。

使用這個參數傳送內容所在網頁的完整網址 (文件位置)。在這種情況下,您可以使用 &dh 和 &dp 參數覆寫文件位置的主機名稱和路徑 + 查詢部分。JavaScript 用戶端會使用 document.location.origin + document.location.pathname + document.location.search 瀏覽器參數的串連即可決定這個參數。請務必移除網址中的所有使用者驗證或其他私人資訊。您必須指定 &dl 或 &dh 和 &dp 為「網頁瀏覽」命中,這項命中才有效。

參數 值類型 預設值 長度最大值 支援的命中類型
dl text None:無 2048 位元組 全部
範例值:http://foo.com/home?a=b
使用範例:dl=http%3A%2F%2Ffoo.com%2Fhome%3Fa%3Db

文件主機名稱

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
dh text None:無 100 位元組 全部
範例值:foo.com
使用範例:dh=foo.com

文件路徑

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
dp text None:無 2048 位元組 全部
範例值:/foo
使用範例:dp=%2Ffoo

文件標題

選用。

網頁 / 文件的標題。

參數 值類型 預設值 長度最大值 支援的命中類型
dt text None:無 1500 位元組 全部
範例值:Settings
使用範例:dt=Settings

畫面名稱

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

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

參數 值類型 預設值 長度最大值 支援的命中類型
cd text None:無 2048 位元組 畫面瀏覽計算
範例值:High Scores
使用範例:cd=High%20Scores

內容群組

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
cg<groupIndex> text None:無 100 位元組 全部
範例值:news/sports
使用範例:cg1=news%2Fsports

連結 ID

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
linkid text None:無 None:無 全部
範例值:nav_bar
使用範例:linkid=nav_bar

應用程式

應用程式名稱

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
an text None:無 100 位元組 全部
範例值:My App
使用範例:an=My%20App

應用程式 ID

選用。

應用程式 ID。

參數 值類型 預設值 長度最大值 支援的命中類型
aid text None:無 150 位元組 全部
範例值:com.company.app
使用範例:aid=com.company.app

應用程式版本

選用。

指定應用程式版本。

參數 值類型 預設值 長度最大值 支援的命中類型
av text None:無 100 位元組 全部
範例值:1.2
使用範例:av=1.2

應用程式安裝程式 ID

選用。

應用程式安裝工具 ID。

參數 值類型 預設值 長度最大值 支援的命中類型
aiid text None:無 150 位元組 全部
範例值:com.platform.vending
使用範例:aiid=com.platform.vending

活動

事件類別

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

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

參數 值類型 預設值 長度最大值 支援的命中類型
ec text None:無 150 位元組 event
範例值:Category
使用範例:ec=Category

事件動作

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

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

參數 值類型 預設值 長度最大值 支援的命中類型
ea text None:無 500 位元組 event
範例值:Action
使用範例:ea=Action

事件標籤

選用。

指定事件標籤。

參數 值類型 預設值 長度最大值 支援的命中類型
el text None:無 500 位元組 event
範例值:Label
使用範例:el=Label

事件值

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
ev 整數 None:無 None:無 event
範例值:55
使用範例:ev=55

電子商務

交易 ID

對於交易命中類型,此為必填屬性。
對於項目命中類型,此為必填屬性。

交易的專屬 ID。與特定交易相關的「交易命中」和「商品命中」這個值應一致。

參數 值類型 預設值 長度最大值 支援的命中類型
ti text None:無 500 位元組 交易,項目
範例值:OD564
使用範例:ti=OD564

交易聯盟

選用。

指定聯盟或商店名稱。

參數 值類型 預設值 長度最大值 支援的命中類型
ta text None:無 500 位元組 交易
範例值:Member
使用範例:ta=Member

交易收益

選用。

指定與交易相關的總收益。這個值應包含所有運費或稅金。

參數 值類型 預設值 長度最大值 支援的命中類型
tr currency 0 None:無 交易
範例值:15.47
使用範例:tr=15.47

交易運費

選用。

指定交易的總運費。

參數 值類型 預設值 長度最大值 支援的命中類型
ts currency 0 None:無 交易
範例值:3.50
使用範例:ts=3.50

交易稅金

選用。

指定交易的總稅金。

參數 值類型 預設值 長度最大值 支援的命中類型
tt currency 0 None:無 交易
範例值:11.20
使用範例:tt=11.20

項目名稱

對於項目命中類型,此為必填屬性。

指定項目名稱。

參數 值類型 預設值 長度最大值 支援的命中類型
in text None:無 500 位元組 項目
範例值:Shoe
使用範例:in=Shoe

商品價格

選用。

指定單一商品 / 單位的價格。

參數 值類型 預設值 長度最大值 支援的命中類型
ip currency 0 None:無 項目
範例值:3.50
使用範例:ip=3.50

商品數量

選用。

指定已購買的商品數量。

參數 值類型 預設值 長度最大值 支援的命中類型
iq 整數 0 None:無 項目
範例值:4
使用範例:iq=4

項目代碼

選用。

指定 SKU 或項目代碼。

參數 值類型 預設值 長度最大值 支援的命中類型
ic text None:無 500 位元組 項目
範例值:SKU47
使用範例:ic=SKU47

商品類別

選用。

指定項目所屬的類別。

參數 值類型 預設值 長度最大值 支援的命中類型
iv text None:無 500 位元組 項目
範例值:Blue
使用範例:iv=Blue

加強型電子商務

產品 SKU

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
pr<productIndex>id text None:無 500 位元組 全部
範例值:P12345
使用範例:pr1id=P12345

產品名稱

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
pr<productIndex>nm text None:無 500 位元組 全部
範例值:Android T-Shirt
使用範例:pr1nm=Android%20T-Shirt

產品品牌

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
pr<productIndex>br text None:無 500 位元組 全部
範例值:Google
使用範例:pr1br=Google

產品類別

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
pr<productIndex>ca text None:無 500 位元組 全部
範例值:Apparel
使用範例:pr1ca=Apparel

範例值:Apparel/Mens/T-Shirts
使用範例:pr1ca=Apparel%2FMens%2FT-Shirts

產品子類

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
pr<productIndex>va text None:無 500 位元組 全部
範例值:Black
使用範例:pr1va=Black

產品價格

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
pr<productIndex>pr currency None:無 None:無 全部
範例值:29.20
使用範例:pr1pr=29.20

產品數量

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
pr<productIndex>qt 整數 None:無 None:無 全部
範例值:2
使用範例:pr1qt=2

產品優待券代碼

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
pr<productIndex>cc text None:無 500 位元組 全部
範例值:SUMMER_SALE13
使用範例:pr1cc=SUMMER_SALE13

產品位置

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
pr<productIndex>ps 整數 None:無 None:無 全部
範例值:2
使用範例:pr1ps=2

產品自訂維度

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
pr<productIndex>cd<dimensionIndex> text None:無 150 位元組 全部
範例值:Member
使用範例:pr1cd2=Member

產品自訂指標

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
pr<productIndex>cm<metricIndex> 整數 None:無 None:無 全部
範例值:28
使用範例:pr1cm2=28

產品動作

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
pa text None:無 None:無 全部
範例值:detail
使用範例:pa=detail

交易 ID

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
ti text None:無 None:無 全部
範例值:T1234
使用範例:ti=T1234

聯盟

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
ta text None:無 None:無 全部
範例值:Google Store
使用範例:ta=Google%20Store

收益

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
tr currency None:無 None:無 全部
範例值:123.21
使用範例:tr=123.21

稅金

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
tt currency None:無 None:無 全部
範例值:10.78
使用範例:tt=10.78

運送

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
ts currency None:無 None:無 全部
範例值:3.55
使用範例:ts=3.55

優待券代碼

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
tcc text None:無 None:無 全部
範例值:SUMMER08
使用範例:tcc=SUMMER08

產品動作清單

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
pal text None:無 None:無 全部
範例值:Search Results
使用範例:pal=Search%20Results

結帳步驟

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
cos 整數 None:無 None:無 全部
範例值:2
使用範例:cos=2

結帳步驟選項

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
col text None:無 None:無 全部
範例值:Visa
使用範例:col=Visa

產品曝光清單名稱

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
il<listIndex>nm text None:無 None:無 全部
範例值:Search Results
使用範例:il1nm=Search%20Results

產品曝光 SKU

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
il<listIndex>pi<productIndex>id text None:無 None:無 全部
範例值:P67890
使用範例:il1pi2id=P67890

產品曝光名稱

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
il<listIndex>pi<productIndex>nm text None:無 None:無 全部
範例值:Android T-Shirt
使用範例:il1pi2nm=Android%20T-Shirt

產品曝光品牌

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
il<listIndex>pi<productIndex>br text None:無 None:無 全部
範例值:Google
使用範例:il1pi2br=Google

產品曝光類別

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
il<listIndex>pi<productIndex>ca text None:無 None:無 全部
範例值:Apparel
使用範例:il1pi2ca=Apparel

產品曝光變化版本

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
il<listIndex>pi<productIndex>va text None:無 None:無 全部
範例值:Black
使用範例:il1pi2va=Black

產品曝光位置

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
il<listIndex>pi<productIndex>ps 整數 None:無 None:無 全部
範例值:2
使用範例:il1pi2ps=2

產品曝光價格

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
il<listIndex>pi<productIndex>pr currency None:無 None:無 全部
範例值:29.20
使用範例:il1pi2pr=29.20

產品曝光自訂維度

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
il<listIndex>pi<productIndex>cd<dimensionIndex> text None:無 None:無 全部
範例值:Member
使用範例:il1pi2cd3=Member

產品曝光自訂指標

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
il<listIndex>pi<productIndex>cm<metricIndex> 整數 None:無 None:無 全部
範例值:28
使用範例:il1pi2cm3=28

促銷 ID

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
promo<promoIndex>id text None:無 None:無 全部
範例值:SHIP
使用範例:promo1id=SHIP

促銷活動名稱

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
promo<promoIndex>nm text None:無 None:無 全部
範例值:Free Shipping
使用範例:promo1nm=Free%20Shipping

促銷活動廣告素材

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
promo<promoIndex>cr text None:無 None:無 全部
範例值:Shipping Banner
使用範例:promo1cr=Shipping%20Banner

促銷活動位置

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
promo<promoIndex>ps text None:無 None:無 全部
範例值:banner_slot_1
使用範例:promo1ps=banner_slot_1

促銷活動動作

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
promoa text None:無 None:無 全部
範例值:click
使用範例:promoa=click

貨幣代碼

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
cu text None:無 10 位元組 全部
範例值:EUR
使用範例:cu=EUR

社交互動

社群網路

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

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

參數 值類型 預設值 長度最大值 支援的命中類型
sn text None:無 50 位元組 社交
範例值:facebook
使用範例:sn=facebook

社交動作

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

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

參數 值類型 預設值 長度最大值 支援的命中類型
sa text None:無 50 位元組 社交
範例值:like
使用範例:sa=like

社群媒體動作目標

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

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

參數 值類型 預設值 長度最大值 支援的命中類型
st text None:無 2048 位元組 社交
範例值:http://foo.com
使用範例:st=http%3A%2F%2Ffoo.com

時間

使用者載入時間類別

時間命中類型必填。

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

參數 值類型 預設值 長度最大值 支援的命中類型
utc text None:無 150 位元組 時間碼
範例值:category
使用範例:utc=category

使用者計時變數名稱

時間命中類型必填。

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

參數 值類型 預設值 長度最大值 支援的命中類型
utv text None:無 500 位元組 時間碼
範例值:lookup
使用範例:utv=lookup

使用者載入時間

時間命中類型必填。

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

參數 值類型 預設值 長度最大值 支援的命中類型
utt 整數 None:無 None:無 時間碼
範例值:123
使用範例:utt=123

使用者載入時間標籤

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
utl text None:無 500 位元組 時間碼
範例值:label
使用範例:utl=label

網頁載入時間

選用。

指定載入網頁所需的時間。此值以毫秒為單位。

參數 值類型 預設值 長度最大值 支援的命中類型
plt 整數 None:無 None:無 時間碼
範例值:3554
使用範例:plt=3554

DNS 時間

選用。

指定執行 DNS 查詢所需的時間 (以毫秒為單位)。

參數 值類型 預設值 長度最大值 支援的命中類型
dns 整數 None:無 None:無 時間碼
範例值:43
使用範例:dns=43

網頁下載時間

選用。

指定下載網頁所需的時間。此值以毫秒為單位。

參數 值類型 預設值 長度最大值 支援的命中類型
pdt 整數 None:無 None:無 時間碼
範例值:500
使用範例:pdt=500

重新導向回應時間

選用。

指定重新導向發生所需的時間。此值以毫秒為單位。

參數 值類型 預設值 長度最大值 支援的命中類型
rrt 整數 None:無 None:無 時間碼
範例值:500
使用範例:rrt=500

TCP 連線時間

選用。

指定建立 TCP 連線所需的時間。此值以毫秒為單位。

參數 值類型 預設值 長度最大值 支援的命中類型
tcp 整數 None:無 None:無 時間碼
範例值:500
使用範例:tcp=500

伺服器回應時間

選用。

指定伺服器在連線時間後回應所需的時間。此值以毫秒為單位。

參數 值類型 預設值 長度最大值 支援的命中類型
srt 整數 None:無 None:無 時間碼
範例值:500
使用範例:srt=500

DOM 互動時間

選用。

指定 Document.readyState 顯示為「互動式」所需的時間。此值以毫秒為單位。

參數 值類型 預設值 長度最大值 支援的命中類型
dit 整數 None:無 None:無 時間碼
範例值:500
使用範例:dit=500

內容載入時間

選用。

指定觸發 DOMContentLoaded 事件所需的時間。此值以毫秒為單位。

參數 值類型 預設值 長度最大值 支援的命中類型
clt 整數 None:無 None:無 時間碼
範例值:500
使用範例:clt=500

例外狀況

例外狀況說明

選用。

指定例外狀況的說明。

參數 值類型 預設值 長度最大值 支援的命中類型
exd text None:無 150 位元組 例外狀況
範例值:DatabaseError
使用範例:exd=DatabaseError

例外狀況是否嚴重?

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
exf boolean 1 None:無 例外狀況
範例值:0
使用範例:exf=0

自訂維度 / 指標

自訂維度

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
cd<dimensionIndex> text None:無 150 位元組 全部
範例值:Sports
使用範例:cd1=Sports

自訂指標

選用。

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

參數 值類型 預設值 長度最大值 支援的命中類型
cm<metricIndex> 號碼 None:無 None:無 全部
範例值:47
使用範例:cm1=47