측정 프로토콜 참조

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

전송

모든 데이터는 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 본문입니다.

쿼리 매개변수

매개변수 이름 설명

api_secret

 필수사항: Google 애널리틱스 UI의 API 비밀번호입니다.

관리 > 데이터 스트림 > 스트림 선택 > 측정 프로토콜 > 만들기에서 찾을 수 있습니다.

조직에 비공개로 설정됩니다. 과도한 스팸을 방지하기 위해 정기적으로 업데이트해야 합니다.

JSON POST 본문

키 유형 설명

user_id

 string

선택사항. 사용자의 고유 식별자입니다. 이 식별자에 관한 자세한 내용은 교차 플랫폼 분석용 User-ID를 참고하세요. utf-8 문자만 포함할 수 있습니다.

timestamp_micros

 number

선택사항. 밀리초가 아닌 마이크로초 단위의 Unix 타임스탬프입니다. 이벤트 시간을 나타냅니다. 과거에 발생한 이벤트만 기록하도록 설정해야 합니다. user_property 또는 이벤트 타임스탬프로 재정의할 수 있습니다. 이벤트는 속성의 시간대를 기준으로 최대 3일을 소급 적용할 수 있습니다.

user_properties

 object 선택사항. 측정에 대한 사용자 속성입니다.

user_data

 object 선택사항. 사용자 제공 데이터
object 선택사항. 요청의 동의 설정입니다. 자세한 내용은 동의 섹션을 참고하세요.

non_personalized_ads

 boolean 선택사항입니다. 사용자의 데이터를 개인 맞춤 광고에 사용해서는 안 된다는 것을 나타내려면 true로 설정하세요.

user_location

 object 선택사항. 요청의 지리 정보를 구조화된 형식으로 설정합니다.

ip_override

 string 선택사항. Google 애널리틱스에서 요청의 지역 정보를 파생하는 데 사용하는 IP 주소입니다.

events[]

 array 필수사항: event 항목의 배열입니다. 요청당 최대 25개의 이벤트를 전송할 수 있습니다. 이벤트 참조에서 모든 유효한 이벤트를 확인하세요.

events[].name

 string 필수사항: 이벤트 이름입니다. 모든 옵션은 이벤트를 참고하세요.

events[].params

 object 선택사항. 이벤트의 매개변수입니다. 각 이벤트에 대한 추천 매개변수는 이벤트를 참고하세요.

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

키 유형 설명

ad_user_data

 string

선택사항. 광고 목적으로 요청의 이벤트 및 사용자 속성에서 사용자 데이터를 Google에 전송하는 것에 대한 동의

GRANTED 또는 DENIED.

ad_personalization

 string

선택사항. 사용자의 개인 맞춤 광고에 대한 동의입니다.

GRANTED 또는 DENIED.

지리 정보

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

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

키 유형 설명

city

 string 선택사항. 도시 이름입니다.

region_id

 string 선택사항. ISO 3166 국가 및 하위 집계입니다. 예를 들어 US-CA, US-AR, CA-BC, GB-LND, CN-HK입니다.

country_id

 string 선택사항. ISO 3166-1 alpha-2 형식의 국가입니다. 예를 들면 US, AU, ES, FR입니다.

subcontinent_id

 string 선택사항. UN M49 형식의 아대륙입니다. 예를 들면 다음과 같습니다. 011, 021, 030, 039.

continent_id

 string 선택사항. UN M49 형식의 대륙입니다. 예를 들면 다음과 같습니다. 002, 019, 142, 150.

다음은 샘플 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 애널리틱스는 전송된 지리적 정보와 관계없이 속성의 세분화된 위치 데이터 설정을 요청에 적용합니다.

맞춤 매개변수

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

  • 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_