驗證事件

選擇平台：

Firebase gtag.js

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

注意： 驗證伺服器「不會」驗證 api_secret 或 firebase_app_id。 仔細檢查這些值，確保正確無誤。

您可以直接呼叫驗證伺服器，也可以使用 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 驗證伺服器的無效事件：

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: {},
    }]
  })
});

提示： 如果您希望資料在歐盟境內處理，請將傳遞至 fetch 方法的網址改為以 https://region1.google-analytics.com 開頭，而非 https://www.google-analytics.com。

驗證回應

以下是驗證伺服器對先前事件的回應：

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