Measurement Protocol 參數參考資料

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

通訊協定版本。目前的值為「1」。這項變更只會在與回溯不相容的變更發生時變更。

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

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

(選填)

如果同時，系統將遮蓋寄件者的 IP 位址。舉例來說，如果酬載中含有下列任一參數，則系統會遮蓋 IP：&aip=、&aip=0 或 &aip=1

(選填)

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

(選填)

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

(選填)

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

(選填)

用來在 GET 要求中傳送隨機數字，確保瀏覽器和 Proxy 不會快取匹配資料。由於某些第三方網際網路篩選軟體在 HTTP 要求中加入了其他參數，因此應該做為要求的最終參數傳送。報表中不會使用這個值。

(選填)

如果要求中未指定使用者 ID (uid)，則此為必要欄位。藉由匿名方式識別特定使用者、裝置或瀏覽器執行個體。對網路而言，這類 Cookie 通常會儲存為第一方 Cookie，有效期限為兩年。如果是行動應用程式，系統則會針對每個應用程式安裝的例項分別隨機產生。這個欄位的值應為隨機 UUID (第 4 版)，如 http://www.ietf.org/rfc/rfc4122.txt 中所述。

(選填)

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

(選填)

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

(選填)

使用者的 IP 位址。這必須是 IPv4 或 IPv6 格式的有效 IP 位址。會一律以匿名方式處理，就跟使用 &aip (去識別化 IP) 一樣。

(選填)

瀏覽器的使用者代理程式。請注意，Google 提供程式庫讓您辨識實際使用者代理程式。手自製代理程式隨時有可能中斷。

(選填)

使用者的地理位置。地理區域編號應為兩個字母的國家/地區代碼，或代表城市或地區的標準編號 (請參閱 http://developers.google.com/analytics/devguides/collection/protocol/v1/geoid)。這個參數優先於衍生自 IP 位址的任何位置，包括 IP 覆寫參數。無效的代碼將會導致地理區域維度設為「(未設定)」。

(選填)

指定哪些參照連結網址來源帶來了網站。這個值也會用來計算流量來源。這個值的格式必須是網址。

(選填)

指定廣告活動名稱。

(選填)

指定廣告活動來源。

(選填)

指定廣告活動媒介。

(選填)

指定廣告活動關鍵字。

(選填)

指定廣告活動內容。

(選填)

指定廣告活動編號。

(選填)

指定 Google 廣告 ID。

(選填)

指定 Google 多媒體廣告 ID。

(選填)

指定螢幕解析度。

(選填)

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

(選填)

指定用來對網頁 / 文件編碼的字元集。

(選填)

指定螢幕色彩深度。

(選填)

指定語言。

(選填)

指定是否要啟用 Java。

(選填)

指定 Flash 版本。

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

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

(選填)

指定匹配將視為非互動。

(選填)

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

(選填)

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

(選填)

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

(選填)

網頁 / 文件的標題。

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

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

(選填)

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

(選填)

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

(選填)

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

(選填)

應用程式 ID。

(選填)

指定應用程式版本。

(選填)

應用程式安裝工具 ID。

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

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

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

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

(選填)

指定事件標籤。

(選填)

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

對於交易命中類型，此為必要屬性。
對於商品命中類型，此為必填屬性。

交易的專屬 ID。針對與每筆交易相關的「交易」匹配和「商品」匹配，這個值應相同。

(選填)

用於指定聯盟或商店名稱。

(選填)

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

(選填)

指定交易的運費總額。

(選填)

指定交易的稅金總額。

對於商品命中類型，此為必填屬性。

指定項目名稱。

(選填)

指定單一項目 / 單位的價格。

(選填)

指定購買的商品數量。

(選填)

指定 SKU 或項目代碼。

(選填)

指定該項目所屬的類別。

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

(選填)

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

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

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

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

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

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

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

必須設定時間命中類型。

指定使用者的時間類別。

必須設定時間命中類型。

指定使用者的時間變數。

必須設定時間命中類型。

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

(選填)

指定使用者的時間標籤。

(選填)

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

(選填)

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

(選填)

指定網頁的下載時間。這個值以毫秒為單位。

(選填)

指定所有重新導向的執行時間。這個值以毫秒為單位。

(選填)

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

(選填)

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

(選填)

指定 Document.readyState 處於「互動」所需的時間。這個值以毫秒為單位。

(選填)

指定 DOMContentLoaded 事件的啟動時間。這個值以毫秒為單位。

(選填)

指定例外狀況的說明。

(選填)

指定例外狀況是否嚴重。

(選填)

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

(選填)

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