필드 매핑

표의 매핑을 사용하여 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
자세한 내용은 타임스탬프 형식을 참고하세요.
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

사용자 식별자 필드

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는 비동기식으로 이벤트를 처리합니다. 진단을 사용하여 처리 결과를 확인합니다.
이전
업그레이드 단계