필드 매핑

표의 매핑을 사용하여 Google Ads API의 UploadClickConversionRequest을 데이터 관리 도구 API의 IngestEventsRequest에 매핑합니다.

요청 필드

UploadClickConversionRequest (Google Ads API)	IngestEventsRequest (데이터 관리 도구 API)	참고
customer_id developer-token 요청 헤더 login-customer_id 요청 헤더 linked-customer-id 요청 헤더 conversion_action	destinations	고객 및 전환 액션 필드를 참고하세요.
- 동등한 보고서 없음	consent	요청에 있는 이벤트의 선택적 기본 동의 설정입니다. Event의 consent 필드를 설정하여 개별 이벤트의 이 값을 재정의할 수 있습니다.
- 동등한 보고서 없음	encoding	필수: UserIdentifier 값에 사용된 Encoding로 설정합니다.
- 동등한 보고서 없음	encryption_info	요청에 암호화된 값이 포함되어 있는지 설정합니다. 자세한 내용은 암호화를 참고하세요.
job_id	- 동등한 보고서 없음	응답에서 반환된 request_id을 사용하여 진단을 가져옵니다.
partial_failure	- 동등한 보고서 없음	데이터 관리 도구 API는 부분 실패를 지원하지 않습니다. IngestEventsRequest의 필드 중 하나라도 검증에 실패하면 Data Manager API는 전체 요청을 거부합니다.
validate_only	validate_only
conversions	events	전환 또는 이벤트 목록입니다. 자세한 내용은 전환 필드 섹션을 참고하세요.

고객 및 전환 액션 필드

Google Ads API에는 developer-token 요청 헤더가 필요하며, 다양한 인증 시나리오에 대해 login-customer-id 및 linked-customer-id 요청 헤더를 설정합니다.

Data Manager API에는 개발자 토큰이 필요하지 않으며 요청 헤더 대신 Destination 필드를 사용하여 로그인 및 연결된 고객 정보를 지정합니다. 대상에 대한 자세한 내용은 대상 구성을 참고하세요.

단일 conversion_action의 Google Ads API 필드를 Destination의 상응하는 필드에 매핑하는 방법은 다음과 같습니다.

Google Ads API	Destination (데이터 관리 도구 API)	참고
요청의 customer_id	operating_account	account_id를 Google Ads 전환 계정의 고객 ID로 설정합니다. operating_account의 account_type를 GOOGLE_ADS로 설정합니다. 데이터 관리 도구 API에는 Google Ads API에 사용하는 것과 다른 고객 ID가 필요할 수 있습니다. 자세한 내용은 대상 계정 요구사항의 차이점을 참고하세요.
developer-token 요청 헤더	- 동등한 보고서 없음	데이터 관리 도구 API에는 개발자 토큰이 필요하지 않습니다.
login-customer-id 요청 헤더	login_account	account_id을 로그인 계정의 고객 ID로 설정합니다. 로그인 계정이 Google Ads 계정인 경우 account_type을 GOOGLE_ADS로 설정하고, 로그인 계정이 데이터 파트너 계정인 경우 DATA_PARTNER로 설정합니다.
linked-customer-id 요청 헤더	linked_account	account_id를 연결된 계정의 고객 ID로 설정합니다. account_type를 DATA_PARTNER로 설정합니다.
ClickConversion의 conversion_action	product_destination_id	전환 액션의 숫자 ID로 설정됩니다. ConversionAction의 리소스 이름을 사용하지 마세요.
- 동등한 보고서 없음	reference	Destination의 사용자 정의 식별자입니다. 단일 요청에서 여러 전환 액션에 대한 전환을 전송하는 경우 이 필드를 설정합니다.

전환 필드

ClickConversion (Google Ads API)	Event (데이터 관리 도구 API)	참고
cart_data	cart_data	자세한 내용은 장바구니 데이터 필드를 참고하세요.
consent	consent	두 API 모두 유사한 Consent 객체 (ad_user_data, ad_personalization)를 사용합니다. Data Manager API의 경우 요청 수준 consent 필드를 설정하여 요청의 모든 이벤트에 대한 동의를 설정할 수도 있습니다.
conversion_action	destination_references	단일 요청에서 여러 전환 액션의 전환을 전송하는 경우 이 필드를 대상의 해당 reference로 설정합니다.
conversion_date_time	event_timestamp	JSON 형식을 사용하는 경우 Google Ads API 날짜 및 시간 형식과 약간 다른 RFC 3339 형식의 값으로 설정합니다. 프로토콜 버퍼를 사용하는 경우 Timestamp를 사용하고 seconds 및 (선택사항) nanoseconds 필드를 설정합니다. 자세한 내용은 타임스탬프 형식을 참고하세요.
conversion_environment	- 동등한 보고서 없음
conversion_value	conversion_value	마이크로 단위의 값이 아닌 통화 값으로 설정합니다. 예를 들어 전환 가치가 5.23달러인 경우 5.23 값을 사용합니다.
currency_code	currency
custom_variables	custom_variables	자세한 내용은 맞춤 변수 필드를 참고하세요.
customer_type
- 동등한 보고서 없음	event_source
- 동등한 보고서 없음	event_device_info
external_attribution_data	- 동등한 보고서 없음
gbraid	ad_identifiers.gbraid
gclid	ad_identifiers.gclid
- 동등한 보고서 없음	last_updated_timestamp
order_id	transaction_id
session_attributes_encoded	ad_identifiers.session_attributes	자세한 내용은 세션 속성 추가를 참고하세요.
session_attributes_key_value_pairs	experimental_fields	자세한 내용은 세션 속성 추가를 참고하세요.
user_identifiers	user_data.user_identifiers	자세한 내용은 사용자 식별자 필드를 참고하세요.
user_ip_address	landing_page_device_info.ip_address
wbraid	ad_identifiers.wbraid

장바구니 데이터 필드

CartData (Google Ads API)	CartData (데이터 관리 도구 API)	참고
feed_country_code	merchant_feed_label	피드 라벨로 설정됩니다.
feed_language_code	merchant_feed_language_code
items	items
local_transaction_cost	transaction_discount
merchant_id	merchant_id

장바구니 데이터의 상품 필드

Item (Google Ads API)	Item (데이터 관리 도구 API)	참고
product_id	merchant_product_id
quantity	quantity
unit_price	unit_price
- 동등한 보고서 없음	item_id
- 동등한 보고서 없음	additional_item_parameters

맞춤 변수 필드

CustomVariable (Google Ads API)	CustomVariable (데이터 관리 도구 API)	참고
- 동등한 보고서 없음	destination_references	Google Ads API에는 전환 액션별로 별도의 요청이 필요합니다. Data Manager API는 단일 요청에서 여러 전환 액션에 대한 전환 전송을 지원하며, 이 destination_references 필드를 사용하여 특정 맞춤 변수를 수신해야 하는 연결 대상을 나타낼 수도 있습니다.
conversion_custom_variable	variable	리소스 이름 대신 변수 이름으로 설정됩니다.
value	value

사용자 식별자 필드

도움말: Data Manager API에서 사용자 식별자를 UserData 객체에 추가한 다음 Event의 user_data 필드를 설정합니다. Google Ads API에서는 사용자 식별자가 user_identifiers 필드의 ClickConversion에 직접 추가됩니다.

UserIdentifier (Google Ads API)	UserIdentifier (데이터 관리 도구 API)
address_info	address	형식 지정 및 해싱 가이드라인을 따릅니다. 주소의 해시된 속성을 암호화할 수도 있습니다.
hashed_email	email_address	형식이 지정되고 해싱된 이메일 주소로 설정됩니다. 해시된 이메일 주소를 암호화할 수도 있습니다.
hashed_phone_number	phone_number	형식이 지정되고 해싱된 전화번호로 설정됩니다. 해싱된 전화번호를 암호화할 수도 있습니다.
기타 입력란: mobile_id third_party_user_id user_identifier_source	관련 없음	두 API 모두 오프라인 전환 또는 리드용 향상된 전환에 대해 이러한 식별자를 지원하지 않으며, Data Manager API는 전환 이벤트를 추가 데이터 소스로 전송할 때 이러한 식별자를 지원하지 않습니다.

응답 필드

UploadClickConversionResponse (Google Ads API)	IngestEventsResponse (데이터 관리 도구 API)	참고
job_id	- 동등한 보고서 없음	응답에서 반환된 request_id을 사용하여 진단을 가져옵니다.
partial_failure_error	- 동등한 보고서 없음	데이터 관리 도구 API는 부분 실패를 지원하지 않습니다. IngestEventsRequest의 필드 중 하나라도 검증에 실패하면 Data Manager API는 전체 요청을 거부합니다.
request-id 응답 헤더	request_id	요청 ID는 응답 헤더가 아닌 Data Manager API의 응답 필드로 반환됩니다.
results	- 동등한 보고서 없음	Data Manager API는 비동기식으로 이벤트를 처리합니다. 진단을 사용하여 처리 결과를 확인합니다.