이 문서에서는 Google 애널리틱스 측정 프로토콜 조회를 확인하는 방법을 설명합니다.
개요
측정 프로토콜 조회의 형식이 잘못되었거나 필수 매개변수가 누락된 경우에도 Google 애널리틱스 측정 프로토콜은 HTTP 오류 코드를 반환하지 않습니다. 조회의 형식이 올바르고 모든 필수 매개변수가 포함되어 있는지 확인하려면 조회를 프로덕션에 배포하기 전에 검증 서버에서 테스트하면 됩니다.
이 가이드에서는 조회를 측정 프로토콜 유효성 검사 서버로 전송하는 프로세스와 응답을 해석하는 방법을 설명합니다.
유효성 검사를 위해 조회 전송
조회는 현재 측정 프로토콜에서 지원하는 방법을 통해
측정 프로토콜 유효성 검사 서버로 전송할 수 있습니다. 유일한 차이점은 URL입니다. 조회를 측정 프로토콜 유효성 검사 서버로 전송하려면
/collect
대신 엔드포인트 /debug/collect
를
사용하세요. 다음 예는 측정 프로토콜 유효성 검사 서버로 전송된 잘못된 조회를 보여줍니다.
https://www.google-analytics.com/debug/collect?tid=fake&v=1
측정 프로토콜 조회를 구성하는 방법에 대한 자세한 내용은 프로토콜 참조를 참고하세요.
응답 해석
측정 프로토콜 유효성 검사 서버의 응답은 JSON 형식입니다. 다음 예는 위에 표시된 조회에 대한 응답을 보여줍니다.
{ "hitParsingResult": [ { "valid": false, "hit": "GET /debug/collect?tid=fake\u0026v=1 HTTP/1.1", "parserMessage": [ { "messageType": "ERROR", "description": "The value provided for parameter 'tid' is invalid. Please see http://goo.gl/a8d4RP#tid for details.", "parameter": "tid" }, { "messageType": "ERROR", "description": "Tracking Id is a required field for this hit. Please see http://goo.gl/a8d4RP#tid for details.", "parameter": "tid" } ] } ] }
응답 루트 hitParsingResult
는 길이가 원래 요청에서 전송된 조회수에 해당하는 배열입니다.
배열의 각 객체에는 valid
, hit
, parserMessage
키가 포함됩니다. 조회가 유효하지 않은 경우 parserMessage
에 유효성 검사 문제를 설명하는 객체 배열이 포함됩니다. 조회가 유효하면 parserMessage
는 빈 배열이 됩니다.
다음 표는 hitParsingResult
배열에 있는 각 항목의 속성을 설명합니다.
키 | 유형 | 설명 |
---|---|---|
valid |
Boolean |
유효한 조회의 경우 true , 무효 조회의 경우 false 입니다. |
hit |
string |
요청의 경로, 메서드 및 프로토콜을 포함하는 문자열입니다. |
parserMessage |
Array |
파서 메시지 목록입니다. 조회가 유효하면 이 배열은 비어 있습니다. |
parserMessage.messageType |
string |
가능한 값은 'INFO', 'WARN', 'ERROR'입니다. |
parserMessage.description |
string |
유효성 검사 문제를 해결하기 위한 추가 세부정보 또는 단계입니다. |
parserMessage.parameter |
string|undefined |
유효성 검사 문제를 일으키는 매개변수 (해당하는 경우) |