選擇平台:
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 |
要求中多次提供相同的名稱。 |