驗證事件

選擇平台:

Google Analytics Measurement Protocol 不會傳回 HTTP 個錯誤代碼,即使事件格式錯誤或缺少必要的資料也沒問題 參數。為確保事件有效,您應根據 Measurement Protocol 驗證伺服器後再部署至實際工作環境。 確認事件的結構正確後, 請驗證實作方式,確保使用的金鑰正確無誤。

您可以直接呼叫驗證伺服器,也可以使用 Google Analytics 事件建立工具:您可以透過 Google Analytics 事件建立工具 建立事件,並使用 Measurement Protocol 驗證伺服器 進行驗證

本指南說明如何將事件傳送至 Google 的 Measurement Protocol Analytics 4 驗證伺服器並解讀回應。

傳送事件以供驗證

傳送給 Measurement Protocol 的事件在要求中的唯一差異 而 Measurement Protocol Validation 伺服器就是網址。

伺服器 網址
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 陣列<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 要求中多次提供相同的名稱。