측정 프로토콜 참조

이 페이지에서는 측정 프로토콜의 전송 메커니즘과 데이터 매개변수를 설명합니다.

전송

모든 데이터는 HTTPS POST 요청을 사용하여 안전하게 전송되어야 합니다.

다음 엔드포인트로 요청을 보냅니다.

https://www.google-analytics.com/mp/collect

EU에서 데이터를 수집하려면 다음 엔드포인트를 대신 사용하세요.

https://region1.google-analytics.com/mp/collect

다음은 샘플 POST 요청입니다.

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
PAYLOAD_DATA

PAYLOAD_DATA을 요청의 페이로드로 바꿉니다.

측정 프로토콜은 HTTP 요청이 수신된 경우 2xx 상태 코드를 반환합니다. 측정 프로토콜은 페이로드의 형식이 잘못된 경우 또는 데이터가 잘못되었거나 Google 애널리틱스에서 처리되지 않은 경우 오류 코드를 반환하지 않습니다.

페이로드

페이로드는 두 부분으로 구성됩니다.

1. 검색어 매개변수
2. JSON POST 본문

쿼리 매개변수

JSON POST 본문

일반 이벤트 매개변수

측정 프로토콜에는 다음과 같은 일반적인 이벤트 매개변수가 있습니다.

동의

consent 속성은 동의 유형과 상태를 구성합니다. consent를 지정하지 않으면 Google 애널리틱스에서 클라이언트 또는 앱 인스턴스의 해당 온라인 상호작용의 동의 설정을 사용합니다.

지리 정보

user_location 및 ip_override 속성은 지리 정보를 제공합니다. user_location가 ip_override보다 우선합니다.

다음은 user_location 필드의 구조입니다. 속성을 최대한 많이 제공하세요. 최소한 country_id 및 region_id을 권장합니다.

다음은 샘플 user_location입니다.

"user_location": {
  "city": "Mountain View",
  "region_id": "US-CA",
  "country_id": "US",
  "subcontinent_id": "021",
  "continent_id": "019"
}

ip_override는 user_location의 대안입니다. ip_override를 대신 보내면 Google 애널리틱스에서 IP 주소로부터 지리적 정보를 파생합니다. user_location를 전송하면 Google 애널리틱스에서 ip_override를 무시합니다.

user_location 또는 ip_override를 전송하지 않으면 Google 애널리틱스에서 client_id

전송된 지리적 정보와 관계없이 Google 애널리틱스에서는 속성의 세부 위치 데이터 설정을 요청에 적용합니다.

기기 정보

기기 정보를 보내려면 device 필드를 사용하세요. 다음은 device 필드의 구조입니다. 속성을 최대한 많이 제공하세요. 최소 category을 권장합니다.

다음 스니펫은 device 설정의 예를 보여줍니다.

"device": {
  "category": "mobile",
  "language": "en",
  "screen_resolution": "1280x2856",
  "operating_system": "Android",
  "operating_system_version": "14",
  "model": "Pixel 9 Pro",
  "brand": "Google",
  "browser": "Chrome",
  "browser_version": "136.0.7103.60"
}

를 지정하는지 여부와 관계없이 Google 애널리틱스에서는 속성의 세부 기기 데이터 설정을 요청에 적용합니다.

맞춤 매개변수

측정 프로토콜 페이로드에 맞춤 사용자 범위, 이벤트 범위, 상품 범위 매개변수를 포함할 수 있습니다.

• 사용자 범위 맞춤 매개변수는 user_properties에 포함될 수 있습니다.
• 이벤트 범위 맞춤 매개변수는 events[].params에 포함될 수 있습니다.
• 상품 범위 맞춤 매개변수는 items에 포함될 수 있습니다.

특정 이벤트의 권장 값

일부 이벤트에는 권장 매개변수가 있습니다. 지원되는 모든 이벤트의 권장 매개변수는 이벤트를 참고하세요.

예약된 이름

일부 이벤트, 매개변수, 사용자 속성 이름은 예약되어 있으므로 사용할 수 없습니다.

예약된 이벤트 이름

다음 이벤트 이름은 예약되어 있으므로 사용할 수 없습니다.

• ad_activeview
• ad_click
• ad_exposure
• ad_query
• ad_reward
• adunit_exposure
• app_clear_data
• app_exception
• app_install
• app_remove
• app_store_refund
• app_update
• app_upgrade
• dynamic_link_app_open
• dynamic_link_app_update
• dynamic_link_first_open
• error
• firebase_campaign
• firebase_in_app_message_action
• firebase_in_app_message_dismiss
• firebase_in_app_message_impression
• first_open
• first_visit
• in_app_purchase
• notification_dismiss
• notification_foreground
• notification_open
• notification_receive
• notification_send
• os_update
• session_start
• user_engagement

예약된 매개변수 이름

다음 매개변수 이름은 예약되어 있으므로 사용할 수 없습니다.

• firebase_conversion

매개변수 이름은 다음으로 시작할 수 없습니다.

• _ (underscore)
• firebase_
• ga_
• google_
• gtag.

예약된 사용자 속성 이름

다음 사용자 속성 이름은 예약되어 있으므로 사용할 수 없습니다.

• first_open_time
• first_visit_time
• last_deep_link_referrer
• user_id
• first_open_after_install

또한 사용자 속성 이름은 다음으로 시작할 수 없습니다.

• _ (underscore)
• firebase_
• ga_
• google_