이벤트 검사

플랫폼을 선택하세요.

Google 애널리틱스 측정 프로토콜은 이벤트의 형식이 잘못되었거나 필수 매개변수가 누락된 경우에도 HTTP 오류 코드를 반환하지 않습니다. 이벤트가 유효한지 확인하려면 이를 프로덕션에 배포하기 전에 측정 프로토콜 유효성 검사 서버를 테스트해야 합니다. 이벤트가 올바르게 구성되었음을 확인한 후에는 올바른 키를 사용하고 있는지 검증하기 위해 구현을 확인해야 합니다.

유효성 검사 서버를 직접 호출하거나 Google 애널리틱스 이벤트 빌더를 사용할 수 있습니다. Google 애널리틱스 이벤트 빌더를 사용하면 이벤트를 양방향으로 구성할 수 있습니다. 또한 Google 애널리틱스 이벤트 빌더는 측정 프로토콜 유효성 검사 서버를 사용하여 구성된 이벤트를 검사합니다.

이 가이드에서는 Google 애널리틱스 4 유효성 검사 서버의 측정 프로토콜로 이벤트를 전송하고 응답을 해석하는 방법을 설명합니다.

유효성 검사를 위해 이벤트 전송

측정 프로토콜로 전송된 이벤트와 측정 프로토콜 유효성 검사 서버로 전송된 이벤트 요청의 유일한 차이점은 URL입니다.

다른 모든 요청 필드는 동일하며, 프로토콜 참조에서 유효한 요청을 작성하는 방법에 대한 자세한 내용을 참고하세요.

다음 코드에서는 측정 프로토콜 유효성 검사 서버로 전송된 잘못된 이벤트를 보여줍니다.

유효성 검사 응답

이전 이벤트에 대한 유효성 검사 서버의 응답은 다음과 같습니다.

{
  "validationMessages": [
    {
      "fieldPath": "events",
      "description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
      "validationCode": "NAME_INVALID"
    }
  ]
}

다음은 유효성 검사 문제가 없는 요청에 대한 유효성 검사 서버의 응답입니다.

{
  "validationMessages": []
}

응답

ValidationMessage

ValidationCode