이 가이드에서는 Google 애널리틱스 보고서에서 측정 프로토콜 이벤트를 확인할 수 있도록 Google 애널리틱스 측정 프로토콜 웹 및 앱 스트림 이벤트를 Google 애널리틱스 서버로 전송하는 방법을 설명합니다.
이 가이드에서 확인할 플랫폼을 선택하세요.
요청 형식 지정하기
Google 애널리틱스 4용 측정 프로토콜은 HTTP POST
요청만 지원합니다.
이벤트를 전송하려면 다음 형식을 사용하세요.
POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
요청 URL에 다음을 포함해야 합니다.
api_secret: Google 애널리틱스 UI에서 생성된 API 비밀번호입니다.새 비밀번호를 만들려면 관리자 > 데이터 스트림 > 스트림 선택 > 측정 프로토콜 > 생성으로 이동합니다.
measurement_id: 스트림과 연결된 측정 ID로, 관리자 > 데이터 스트림 > 스트림 선택 > 측정 ID 아래의 Google 애널리틱스 UI에서 찾을 수 있습니다.measurement_id는 스트릠 ID가 아닙니다.
전체 참조를 보려면 쿼리 매개변수를 참고하세요.
요청 본문에 다음을 포함해야 합니다.
client_id: 클라이언트의 고유 식별자입니다. Firebaseapp_instance_id와는 다릅니다. gtag.js('get')를 사용하세요.
user_id: (선택사항) 사용자의 고유 식별자입니다. utf-8 문자만 포함할 수 있습니다. 이 식별자에 관한 자세한 내용은 교차 플랫폼 분석용 User-ID를 참고하세요.consent: (선택사항) 동의 설정을 지정하는 방법을 알아보세요.events: 이벤트 항목의 배열입니다. 하나의 요청에 여러 이벤트를 포함할 수 있습니다.실시간 보고서와 같은 보고서에 사용자 활동을 표시하려면
event에 대한params의 일부로engagement_time_msec및session_id가 제공되어야 합니다.engagement_time_msec매개변수는 이벤트의 참여 시간(밀리초)을 반영해야 합니다.예를 들면 다음과 같습니다.
{
"client_id": "123456.7654321",
"events": [
{
"name": "campaign_details",
"params": {
"campaign_id": "google_1234",
"campaign": "Summer_fun",
"source": "google",
"medium": "cpc",
"term": "summer+travel",
"content": "logolink",
"session_id": "123",
"engagement_time_msec": "100"
}
}
]
}
session_start는 예약된 이벤트 이름이지만 새 session_id를 만들면 session_start를 전송할 필요 없이 새 세션이 생성됩니다. 세션수 집계 방법을 알아보세요.
직접 해 보기
Google 애널리틱스 서버로 tutorial_begin 이벤트를 전송할 때 사용할 수 있는 예는
다음과 같습니다.
const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
method: "POST",
body: JSON.stringify({
client_id: 'XXXXXXXXXX.YYYYYYYYYY',
events: [{
name: 'tutorial_begin',
params: {},
}]
})
});
제한사항
Google 애널리틱스로 측정 프로토콜을 전송하는 데는 다음 제한사항이 적용됩니다.
- 요청은 최대 25개의 이벤트를 포함할 수 있습니다.
- 이벤트는 최대 25개의 매개변수를 포함할 수 있습니다.
- 이벤트는 최대 25개의 사용자 속성을 포함할 수 있습니다.
- 사용자 속성 이름은 24자(영문 기준) 이하여야 합니다.
- 사용자 속성 값은 36자(영문 기준) 이하여야 합니다.
- 이벤트 이름은 40자(영문 기준) 이하여야 하고 영숫자 및 밑줄 문자만 사용할 수 있으며 알파벳으로 시작해야 합니다.
- 항목 매개변수를 포함한 매개변수 이름은 40자(영문 기준) 이하여야 하고 영숫자 및 밑줄 문자만 사용할 수 있으며 알파벳으로 시작해야 합니다.
- 상품 매개변수 값을 포함한 매개변수 값은 표준 Google 애널리틱스 4 속성의 경우 100자(영문 기준) 이하여야 하며, Google 애널리틱스 360 속성의 경우 500자(영문 기준) 이하여야 합니다.
- 항목 매개변수는 최대 10개의 맞춤 매개변수를 포함할 수 있습니다.
- POST 본문은 130KB보다 작아야 합니다.
- 측정 프로토콜 이벤트의 이벤트 수준 기여 분석은 전환 이벤트의 전환 추적 기간이 63일을 초과하더라도 Google Ads 및 기타 미디어 통합으로 전환 내보내기를 위해 가장 최근에 태그된 온라인 이벤트가 발생한 후 최대 63일까지 지원됩니다. 반면 온라인 이벤트 태그 지정을 위한 이벤트 수준 기여 분석은 전체 전환 추적 기간 동안 지원됩니다.
- 리마케팅을 위해 연결된 쿠키 또는 기기 ID를 사용하여 가장 최근의 온라인 이벤트가 발생한 후
다음 기간(일)까지 측정 프로토콜 이벤트에 참여할 수 있습니다.
- 웹 스트림: 30일
- 앱 스트림: 42일
- Google 애널리틱스 4로 전송된 앱 측정 프로토콜 이벤트는 Google Ads에서 앱 사용자를 위한 검색 잠재고객을 채우지 않습니다.