驗證事件

選擇您的平台：

即使事件格式錯誤或缺少必要參數，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 要求中有重複提供相同的名稱。