驗證事件

選擇平台：

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 的無效事件 驗證伺服器：

const firebase_app_id = `X:XX:XX:XX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    app_instance_id: 'app_instance_id',
    events: [{
      // Event names must start with an alphabetic character.
      name: '_badEventName',
      params: {},
    }]
  })
});

驗證回應

以下是驗證伺服器對上個事件的回應：

{
  "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 要求中多次提供相同的名稱。