驗證事件

選擇平台:

即使事件格式錯誤或缺少必要參數,Google Analytics Measurement Protocol 也不會傳回 HTTP 錯誤代碼。為確保事件有效,請先在 Measurement Protocol 驗證伺服器進行測試,再部署到實際執行環境。確認事件結構正確無誤後,請驗證導入狀態,確保您使用的是正確的鍵。

您可以直接呼叫驗證伺服器,或使用 Google Analytics 事件產生器。Google Analytics 事件建立工具可讓您以互動方式建構事件,並使用 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": []
}

回應

類型 說明
validationMessages Array<ValidationMessage> 驗證訊息陣列。

ValidationMessage

類型 說明
fieldPath 字串 無效欄位的路徑。
description 字串 錯誤說明。
validationCode ValidationCode 與錯誤相應的驗證碼。

ValidationCode

說明
VALUE_INVALID fieldPath 的值無效。詳情請參閱限制
VALUE_REQUIRED 未提供 fieldPath 的必要值。
NAME_INVALID 提供的名稱無效。詳情請參閱限制
NAME_RESERVED 提供的名稱是保留名稱。請參閱保留名稱
VALUE_OUT_OF_BOUNDS 輸入的值過大。詳情請參閱限制
EXCEEDED_MAX_ENTITIES 要求中的參數過多,詳情請參閱限制
NAME_DUPLICATED 要求中多次提供相同名稱。