표의 매핑을 사용하여 측정 프로토콜 데이터 수집 요청 (/mp/collect)을 Data Manager API의 IngestEventsRequest에 매핑합니다.
요청 필드
/mp/collect 요청 (측정 프로토콜) |
IngestEventsRequest (Data Manager API) |
참고 |
|---|---|---|
measurement_id (쿼리 매개변수) |
destinations |
웹 이벤트의 product_destination_id 지도 자세한 내용은 대상 필드를 참고하세요. |
firebase_app_id (쿼리 매개변수) |
destinations |
앱 이벤트의 product_destination_id에 매핑합니다. 자세한 내용은 대상 필드를 참고하세요. |
api_secret (쿼리 매개변수) |
- 동등한 보고서 없음 | 데이터 관리 도구 API에서 요청을 인증하는 방법을 알아보려면 API 액세스 설정을 참고하세요. |
consent |
consent |
Consent 객체로 설정됩니다. |
events |
events |
Event 리소스 목록으로 설정됩니다. 자세한 내용은 이벤트 필드 섹션을 참고하세요. |
client_id |
events.client_id |
웹 이벤트에 필요합니다. |
app_instance_id |
events.app_instance_id |
앱 이벤트에 필요합니다. |
user_id |
events.user_id |
선택사항입니다. 사용자의 고유 식별자입니다. |
timestamp_micros |
events.event_timestamp |
측정 프로토콜에서는 요청 수준 또는 개별 이벤트에 대해 이 값을 제공할 수 있습니다. Data Manager API에는 요청 수준 타임스탬프가 없습니다. 각 이벤트에서 event_timestamp을 이벤트가 발생한 시간으로 설정합니다.
자세한 내용은 타임스탬프 형식을 참고하세요. |
user_properties |
events.user_properties |
UserProperties 객체로 설정됩니다. Data Manager API는 개별 사용자 속성의 타임스탬프 설정을 지원하지 않습니다. 사용자 속성 변경과 관련된 타임스탬프는 이벤트 (event_timestamp)의 타임스탬프에서 추론됩니다. |
user_data |
events.user_data |
UserData 객체로 설정됩니다. 자세한 내용은 사용자 식별자 필드를 참고하세요. |
non_personalized_ads |
events.consent.ad_personalization |
non_personalized_ads이 true이면 ad_personalization를 DENIED로 설정합니다. |
user_location |
events.event_location |
자세한 내용은 사용자 위치 필드를 참고하세요. |
ip_override |
events.event_device_info.ip_address |
|
device |
events.event_device_info |
자세한 내용은 기기 필드를 참고하세요. |
user_agent |
events.event_device_info.user_agent |
|
validation_behavior |
- 동등한 보고서 없음 | 진단을 사용하여 업로드 상태와 다운스트림 처리 중 개별 이벤트의 오류 및 경고를 가져옵니다. IngestEventsRequest이 실패하면 (예: 필수 필드가 누락됨) 이벤트가 처리되지 않으므로 오류를 해결하고 요청을 다시 시도해야 합니다. 자세한 내용은 API 오류 이해하기를 참고하세요. |
/debug/mp/collect |
validate_only |
validate_only를 true로 설정하여 데이터를 수집하지 않고 이벤트를 검증합니다(측정 프로토콜 유효성 검사 서버와 유사). |
| - 동등한 보고서 없음 | encoding |
UserData 업로드에 필요합니다. UserIdentifier 값에 사용된 Encoding로 설정됩니다. |
대상 필드
측정 프로토콜은 measurement_id 또는 firebase_app_id 쿼리 매개변수를 사용하여 특정 데이터 스트림으로 직접 이벤트를 전송합니다.
Data Manager API는 Destination 객체를 사용하여 데이터를 전송할 위치를 지정합니다.
대상에 대한 자세한 내용은 대상 구성을 참고하세요.
측정 프로토콜 필드를 Destination의 상응하는 필드에 매핑하는 방법은 다음과 같습니다.
| 측정 프로토콜 | Destination (Data Manager API) |
참고 |
|---|---|---|
measurement_id (쿼리 매개변수) |
product_destination_id |
Google 애널리틱스 웹 데이터 스트림의 측정 ID로 설정됩니다. |
firebase_app_id (쿼리 매개변수) |
product_destination_id |
Google 애널리틱스 앱 데이터 스트림의 Firebase 앱 ID로 설정됩니다. |
| - 동등한 보고서 없음 | operating_account |
account_id을 Google 애널리틱스 속성 ID로 설정합니다. account_type를 GOOGLE_ANALYTICS_PROPERTY로 설정합니다. |
| - 동등한 보고서 없음 | login_account |
account_id을 Google 애널리틱스 속성 ID로 설정합니다. account_type를 GOOGLE_ANALYTICS_PROPERTY로 설정합니다. |
이벤트 필드
측정 프로토콜 events[] |
Event (Data Manager API) |
참고 |
|---|---|---|
name |
event_name |
event_name가 예약된 이름을 사용하는 경우 API는 INVALID_EVENT_NAME 오류와 함께 이벤트를 거부합니다. |
| - 동등한 보고서 없음 | event_source |
이벤트가 웹브라우저에서 생성된 경우 WEB로 설정하고, 이벤트가 앱에서 생성된 경우 APP로 설정합니다. |
| - 동등한 보고서 없음 | destination_references |
요청 수준 destinations 목록에 Google 애널리틱스 Destination가 두 개 이상 포함된 경우 필수입니다. 이벤트를 수신해야 하는 대상을 지정하는 항목을 추가합니다. |
timestamp_micros |
event_timestamp |
자세한 내용은 타임스탬프 형식을 참고하세요. |
params.currency |
currency |
|
params.value |
conversion_value |
|
params.customer_type |
user_properties.customer_type |
측정 프로토콜에서 customer_type 매개변수는 이벤트 매개변수로 설정됩니다. Data Manager API에서 이벤트의 UserProperties 객체에 있는 customer_type 필드에 설정합니다. |
params.transaction_id |
transaction_id |
일부 이벤트 및 사용 사례에 필수입니다. 자세한 내용은 데이터를 Event 객체로 변환을 참고하세요. |
params.items |
cart_data.items |
자세한 내용은 장바구니 데이터의 상품 필드를 참고하세요. |
params.coupon |
cart_data.coupon_codes |
coupon_codes 필드를 사용하여 장바구니에 적용된 쿠폰을 제공합니다. Google 애널리틱스 쿠폰은 하나만 제공하세요. 이는 개별 상품에 대해 cart_data.items.additional_item_parameters를 사용하여 설정할 수 있는 Item 수준 쿠폰과는 별개입니다. |
params.session_id |
additional_event_parameters |
parameter_name이 session_id로 설정된 항목에 매핑합니다. |
params.engagement_time_msec |
additional_event_parameters |
parameter_name이 engagement_time_msec로 설정된 항목에 매핑합니다. |
기타 params |
additional_event_parameters |
|
사용자 식별자 필드
Measurement Protocol user_data |
UserIdentifier (Data Manager API) |
참고 |
|---|---|---|
sha256_email_address[] |
email_address |
형식이 지정되고 해싱된 이메일 주소로 설정됩니다. 해시된 이메일 주소를 암호화할 수도 있습니다. |
sha256_phone_number[] |
phone_number |
형식이 지정되고 해싱된 전화번호로 설정됩니다. 해싱된 전화번호를 암호화할 수도 있습니다. |
address[] |
address |
AddressInfo 객체로 설정됩니다. 형식 지정 및 해싱 가이드라인을 따릅니다. |
address[].sha256_first_name |
address.given_name |
형식이 지정되고 해싱된 이름으로 설정됩니다. 해시된 성명을 암호화할 수도 있습니다. |
address[].sha256_last_name |
address.family_name |
형식이 지정되고 해싱된 성으로 설정됩니다. 해시된 가족 이름을 암호화할 수도 있습니다. |
address[].country |
address.region_code |
|
address[].postal_code |
address.postal_code |
|
address[].city |
- 동등한 보고서 없음 | 현재 버전의 Data Manager API에서는 지원되지 않습니다. |
address[].region |
- 동등한 보고서 없음 | 현재 버전의 Data Manager API에서는 지원되지 않습니다. |
address[].sha256_street |
- 동등한 보고서 없음 | 현재 버전의 Data Manager API에서는 지원되지 않습니다. |
장바구니 데이터의 상품 필드
측정 프로토콜 items[] |
Item (Data Manager API) |
참고 |
|---|---|---|
item_id |
item_id |
필수사항. |
item_name |
additional_item_parameters |
parameter_name이 item_name로 설정된 항목에 매핑합니다. |
quantity |
quantity |
필수사항. |
price |
unit_price |
필수사항. |
| 기타 항목 필드 | additional_item_parameters |
|
사용자 위치 필드
Measurement Protocol user_location |
EventLocation (Data Manager API) |
참고 |
|---|---|---|
city |
city |
이벤트가 발생한 도시 이름입니다. |
country_id |
region_code |
2자리 CLDR 지역 코드로 설정됩니다. |
region_id |
subdivision_code |
ISO 3166-2 하위 행정 구역 코드로 설정됩니다. |
continent_id |
continent_code |
UN M49 형식의 대륙 코드로 설정됩니다. |
subcontinent_id |
subcontinent_code |
UN M49 형식의 아대륙 코드로 설정됩니다. |
기기 필드
Measurement Protocol device |
DeviceInfo (Data Manager API) |
참고 |
|---|---|---|
category |
category |
|
language |
language_code |
|
screen_resolution |
screen_height 및 screen_width |
측정 프로토콜에서는 screen_resolution이 문자열 ("1280x720")로 제공됩니다. Data Manager API에서는 screen_height 및 screen_width을 별도의 정수 값으로 전송합니다. |
operating_system |
operating_system |
|
operating_system_version |
operating_system_version |
|
model |
model |
|
brand |
brand |
|
browser |
browser |
|
browser_version |
browser_version |