플랫폼 선택:
Google 애널리틱스 측정 프로토콜은
HTTP
오류 코드(이벤트 형식이 잘못되었거나 이벤트가 누락된 경우 포함)
매개변수입니다. 이벤트가 유효한지 확인하려면 이를 프로덕션에 배포하기 전에
측정 프로토콜 유효성 검사 서버를 테스트해야 합니다.
이벤트가 올바르게 구성되었음을 확인한 후에는 올바른 키를 사용하고 있는지
검증하기 위해 구현을 확인해야 합니다.
유효성 검사 서버를 직접 호출하거나 Google 애널리틱스 이벤트 빌더. Google 애널리틱스 이벤트 작성 도구를 이용하면 이벤트를 구성하고, 측정 프로토콜 유효성 검사 서버를 사용하여 검증할 수 있어야 합니다
이 가이드에서는 Google 애널리틱스 4 유효성 검사 서버의 측정 프로토콜로 이벤트를 전송하고 응답을 해석하는 방법을 설명합니다.
유효성 검사를 위해 이벤트 전송
측정 프로토콜로 전송된 이벤트와 측정 프로토콜 유효성 검사 서버로 전송된 이벤트 요청의 유일한 차이점은 URL입니다.
서버 | URL |
---|---|
측정 프로토콜 | /mp/collect |
측정 프로토콜 유효성 검사 서버 | /debug/mp/collect |
다른 모든 요청 필드는 동일하며, 프로토콜 참조에서 유효한 요청을 작성하는 방법에 대한 자세한 내용을 참고하세요.
다음 코드에서는 측정 프로토콜 유효성 검사 서버로 전송된 잘못된 이벤트를 보여줍니다.
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 |
Array<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 |
요청에 같은 이름을 두 번 이상 입력했습니다. |