개요
측정 프로토콜을 사용하여 Google 애널리틱스로 데이터를 전송하는 작업은 다음과 같이 두 부분으로 구성되어 있습니다.
이 문서에서는 전송 및 페이로드의 형식을 지정하는 방법을 설명합니다.
전송
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>
요청의
BODY
로, 페이로드를 참고하세요.
응답 코드
측정 프로토콜은 HTTP
요청이 수신된 경우 항상 2xx
상태 코드를
반환합니다. 측정 프로토콜은 페이로드 데이터의 형식이 잘못된 경우 또는
페이로드의 데이터가 잘못되었거나 Google 애널리틱스에서 처리되지 않은 경우
오류 코드를 반환하지 않습니다.
페이로드
측정 프로토콜 데이터를 사용하여 Google 애널리틱스로 데이터를 전송하는 작업은 다음과 같이 두 부분으로 구성되어 있습니다.
- 쿼리 매개변수
JSON
POST
본문
쿼리 매개변수
매개변수 이름 | 설명 |
---|---|
|
필수사항. Google 애널리틱스 UI를 통해
생성된
새 보안 비밀을 만들려면 Google 애널리틱스 UI에서 다음과 같이 이동합니다.
이러한 설정은 조직에서 비공개로 유지하는 것이 좋습니다. 측정
프로토콜을 클라이언트 측에 배포하는 경우, 과도한 스팸이 발생하지 않도록
|
|
측정 ID로, 데이터 스트림의 식별자입니다. Google 애널리틱스 UI에서 다음과 같이 이동하여 찾을 수 있습니다.
관리 > 데이터 스트림 > 스트림 선택 > 측정 ID |
JSON POST 본문
키 | 유형 | 설명 |
---|---|---|
|
string |
필수사항. 웹 클라이언트의 사용자 인스턴스를 고유하게 식별합니다. 측정 프로토콜에 이벤트 전송을 참고하세요. |
|
string |
선택사항. 사용자의 고유 식별자입니다. 이 식별자에 관한 자세한 내용은 교차 플랫폼 분석용 User-ID를 참고하세요. |
|
number |
선택사항. 이벤트와 연결할 시간의
Unix 타임스탬프(단위: 마이크로초)입니다. 과거에 발생한 이벤트만 기록하도록
설정해야 합니다. 이 값은 |
|
object |
선택사항. 측정에 대한 사용자 속성입니다. 자세한 내용은 사용자 속성을 참고하세요. |
|
object |
선택사항입니다. 요청에 대한 동의 설정을 설정합니다. 자세한 내용은 동의 섹션을 참고하세요. |
|
boolean |
선택사항입니다. 사용자의 데이터가 허용되지 않음을 나타내려면 true 로 설정합니다.
개인 맞춤 광고에 사용될 수 있습니다
<ph type="x-smartling-placeholder">
|
|
array |
필수사항. 이벤트 항목의 배열입니다. 요청당 최대 25개의 이벤트를 전송할 수 있습니다. 이벤트 참조에서 모든 유효한 이벤트를 확인하세요. |
|
string |
필수사항. 이벤트 이름입니다. 이벤트 참조에서 모든 옵션을 확인하세요. |
|
object |
선택사항. 이벤트의 매개변수입니다. 이벤트에서 각 이벤트에 대한 추천 매개변수를 참고하세요. |
동의
consent
속성은 동의 유형 및 상태를 구성합니다.
consent
를 지정하지 않으면 Google 애널리틱스에서 동의를 사용합니다.
클라이언트 또는 앱 인스턴스에 해당하는 온라인 상호작용의 설정을 변경할 수 있습니다.
키 | 유형 | 설명 |
---|---|---|
|
string |
선택사항. 요청의 사용자 데이터 전송에 대한 동의를 설정합니다. Google에 제공할 수 있습니다.
|
|
string |
선택사항. 사용자의 개인 맞춤 광고에 대한 동의를 설정합니다.
|
맞춤 매개변수
사전 정의된 매개변수 외에도 맞춤 사용자 범위, 이벤트 범위, 상품 범위 매개변수 내부에 저장됩니다.
- 사용자 범위 맞춤 매개변수는 페이로드의
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_