이벤트 유효성 검사

개요

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

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

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

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

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

서버 URL
측정 프로토콜 /mp/collect
측정 프로토콜 유효성 검사 서버 /debug/mp/collect

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

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

유효성 검사 응답

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

{
  "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 요청에 같은 이름을 두 번 이상 입력했습니다.