驗證事件

選擇平台:

即使事件格式錯誤或缺少必要參數,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 陣列<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 要求中提供的名稱重複了多次。