選擇您的平台:
即使事件格式錯誤或缺少必要參數,Google Analytics (分析) 4 的 Google Analytics (分析) Measurement Protocol 也不會傳回 HTTP
錯誤代碼。為確保事件有效,請先對 Measurement Protocol 驗證伺服器進行測試,再將事件部署至實際工作環境。驗證事件的結構正確無誤後,請驗證實作方式,確保使用的金鑰正確無誤。
您可以直接呼叫驗證伺服器,或使用 GA4 事件建構工具。您可以使用 GA4 事件建立工具,以互動方式建構事件,並使用 Measurement Protocol 驗證伺服器進行驗證。
本指南說明如何將事件傳送至 Google Analytics (分析) 4 驗證伺服器的 Measurement Protocol,並解讀回應。
傳送事件進行驗證
針對傳送至 Measurement Protocol 的事件和 Measurement Protocol 驗證伺服器,其要求的唯一差別在於網址。
伺服器 | 網址 |
---|---|
Measurement Protocol | /mp/collect |
Measurement Protocol 驗證伺服器 | /debug/mp/collect |
其他所有要求欄位則都相同。如要進一步瞭解如何建立有效要求,請參閱通訊協定參考資料。
以下程式碼顯示傳送至 Measurement Protocol 驗證伺服器的無效事件:
驗證回應
以下是驗證伺服器對先前事件的回應:
{
"validationMessages": [
{
"fieldPath": "events",
"description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
"validationCode": "NAME_INVALID"
}
]
}
回應
鍵 | 類型 | 說明 |
---|---|---|
validationMessages |
Array<ValidationMessage> | 驗證訊息陣列。 |
ValidationMessage
鍵 | 類型 | 說明 |
---|---|---|
fieldPath |
字串 | 無效欄位的路徑。 |
description |
字串 | 錯誤說明。 |
validationCode |
ValidationCode | 與該錯誤相對應的 ValidationCode。 |
ValidationCode
值 | 說明 |
---|---|
VALUE_INVALID |
為「fieldPath 」提供的值無效。詳情請參閱限制一節。 |
VALUE_REQUIRED |
未提供「fieldPath 」的必要值。 |
NAME_INVALID |
提供的名稱無效。詳情請參閱限制一節。 |
NAME_RESERVED |
所提供的名稱是其中一個預留名稱。請參閱保留名稱一節。 |
VALUE_OUT_OF_BOUNDS |
提供的值太大。詳情請參閱限制一節。 |
EXCEEDED_MAX_ENTITIES |
要求中的參數過多。詳情請參閱限制一節。 |
NAME_DUPLICATED |
要求中有重複提供相同的名稱。 |