측정 프로토콜 참조

개요

측정 프로토콜을 사용하여 Google 애널리틱스로 데이터를 전송하는 작업은 다음과 같이 두 부분으로 구성되어 있습니다.

  1. 전송 - 데이터를 전송하는 위치와 방법
  2. 페이로드 - 전송하는 데이터

이 문서에서는 전송 및 페이로드의 형식을 지정하는 방법을 설명합니다.

전송

URL 엔드포인트

다음 엔드포인트에 대한 HTTP POST 요청을 수행하여 측정 프로토콜을 통해 데이터를 전송합니다.

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

이벤트를 전송하려면 다음 POST 요청을 실행합니다.

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

응답 코드

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

페이로드

측정 프로토콜 데이터를 사용하여 Google 애널리틱스로 데이터를 전송하는 작업은 다음과 같이 두 부분으로 구성되어 있습니다.

  1. 쿼리 매개변수
  2. JSON POST 본문

쿼리 매개변수

매개변수 이름 설명

api_secret

필수사항. Google 애널리틱스 UI를 통해 생성된 API Secret입니다.

새 보안 비밀을 만들려면 Google 애널리틱스 UI에서 다음과 같이 이동합니다.
관리 > 데이터 스트림 > 스트림 선택 > 측정 프로토콜 > 만들기

이러한 설정은 조직에서 비공개로 유지하는 것이 좋습니다. 측정 프로토콜을 클라이언트 측에 배포하는 경우, 과도한 스팸이 발생하지 않도록 api_secret을 정기적으로 순환해야 합니다.

firebase_app_id

필수사항. Firebase 앱 ID로, Firebase 앱의 식별자입니다. Firebase Console에서 다음과 같이 이동하여 찾을 수 있습니다.
프로젝트 설정 > 일반 > 내 앱 > 앱 ID

measurement_id

측정 ID로, 데이터 스트림의 식별자입니다. Google 애널리틱스 UI에서 다음과 같이 이동하여 찾을 수 있습니다.
관리 > 데이터 스트림 > 스트림 선택 > 측정 ID

JSON POST 본문

유형 설명

app_instance_id

string

필수사항. Firebase 앱의 특정 설치를 고유하게 식별합니다. 이 값은 Firebase SDK를 통해 검색해야 합니다.

client_id

string

필수사항. 웹 클라이언트의 사용자 인스턴스를 고유하게 식별합니다. 측정 프로토콜에 이벤트 전송을 참고하세요.

user_id

string

선택사항. 사용자의 고유 식별자입니다. 이 식별자에 관한 자세한 내용은 교차 플랫폼 분석용 User-ID를 참고하세요.

timestamp_micros

number

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

user_properties

object 선택사항. 측정에 대한 사용자 속성입니다. 자세한 내용은 사용자 속성을 참고하세요.

non_personalized_ads

boolean 선택사항. 이러한 이벤트를 개인 맞춤 광고에 사용해서는 안 된다는 것을 나타내려면 true로 설정하세요.

events[]

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

events[].name

string 필수사항. 이벤트 이름입니다. 이벤트 참조에서 모든 옵션을 확인하세요.

events[].params

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

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

예약된 이름

예약된 이벤트 이름

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

  • ad_activeview
  • ad_click
  • ad_exposure
  • ad_impression
  • ad_query
  • adunit_exposure
  • app_clear_data
  • app_install
  • app_update
  • app_remove
  • error
  • first_open
  • first_visit
  • in_app_purchase
  • notification_dismiss
  • notification_foreground
  • notification_open
  • notification_receive
  • os_update
  • screen_view
  • session_start
  • user_engagement

예약된 매개변수 이름

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

  • firebase_conversion

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

  • google_
  • ga_
  • firebase_

예약된 사용자 속성 이름

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

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

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

  • google_
  • ga_
  • firebase_