Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

필드 매핑

표의 매핑을 사용하여 Google Ads API의 UploadClickConversionRequest를 Data Manager API의 IngestEventsRequest에 매핑합니다.

인증

Data Manager API에는 Google Ads API와 다른 범위의 사용자 인증 정보가 필요합니다. API 액세스 설정의 단계에 따라 Data Manager API 범위를 포함하는 새 사용자 인증 정보를 생성합니다.

요청 필드

`UploadClickConversionRequest` (Google Ads API)	`IngestEventsRequest` (Data Manager 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`	- 동등한 보고서 없음	Data Manager 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` (Data Manager API)	참고
요청의 `customer_id`	`operating_account`	`account_id`를 Google Ads 전환 계정의 고객 ID로 설정합니다. 이는 Google Ads API 요청의 `customer_id`와 다를 수 있습니다. `operating_account`의 `account_type`을 `GOOGLE_ADS`로 설정합니다.
`developer-token` 요청 헤더	- 동등한 보고서 없음	Data Manager API에는 개발자 토큰이 필요하지 않습니다.
`login-customer-id` 요청 헤더	`login_account`	`account_id`를 로그인 계정의 고객 ID로 설정합니다. 로그인 계정이 Google Ads 계정인 경우 `account_type`을 `GOOGLE_ADS`로 설정하고, 로그인 계정이 데이터 파트너 계정인 경우 `DATA_PARTNER`로 설정합니다.
`linked-customer-id` 요청 헤더	`linked_account`	파트너 링크를 사용하여 `operating_account`에 액세스하는 경우 연결된 계정의 고객 ID로 `account_id`를 설정하고 `account_type`를 `DATA_PARTNER`로 설정합니다. 그렇지 않은 경우 `linked_account` 필드를 설정하지 마세요.
`ClickConversion`의 `conversion_action`	`product_destination_id`	전환 액션의 숫자 ID로 설정합니다. `ConversionAction`의 리소스 이름을 사용하지 마세요.
- 동등한 보고서 없음	`reference`	`Destination`의 사용자 정의 식별자입니다. 단일 요청에서 여러 전환 액션에 대한 전환을 전송하는 경우 이 필드를 설정합니다.

전환 필드

`ClickConversion` (Google Ads API)	`Event` (Data Manager 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 형식을 사용하는 경우 RFC 3339 형식의 값으로 설정합니다. 이 형식은 Google Ads API 날짜 및 시간 형식과 약간 다릅니다. 프로토콜 버퍼를 사용하는 경우 `Timestamp`를 사용하고 `seconds` 및 `nanoseconds` 필드 (선택사항)를 설정합니다. 자세한 내용은 타임스탬프 형식을 참고하세요.
`conversion_environment`	- 동등한 보고서 없음
`conversion_value`	`conversion_value`	마이크로 단위의 값이 아닌 통화 값으로 설정합니다. 예를 들어 전환 가치가 $5.23인 경우 `5.23` 값을 사용합니다.
`currency_code`	`currency`
`custom_variables`	`custom_variables`	자세한 내용은 맞춤 변수 필드를 참고하세요.
`customer_type`	`user_properties.customer_type`	`CustomerType` enum의 값으로 설정합니다.
- 동등한 보고서 없음	`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` (Data Manager 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` (Data Manager API)	참고
`product_id`	`merchant_product_id`
`quantity`	`quantity`
`unit_price`	`unit_price`
- 동등한 보고서 없음	`item_id`
- 동등한 보고서 없음	`additional_item_parameters`

맞춤 변수 필드

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

사용자 식별자 필드

`UserIdentifier` (Google Ads API)	`UserIdentifier` (Data Manager 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` (Data Manager API)	참고
`job_id`	- 동등한 보고서 없음	응답에서 반환된 `request_id`를 사용하여 진단을 검색합니다.
`partial_failure_error`	- 동등한 보고서 없음	Data Manager API는 빠른 실패 오류 모델을 사용합니다. `IngestEventsRequest`의 필드 중 하나라도 유효성 검사에 실패하면 Data Manager API는 전체 요청을 거부합니다.
`request-id` 응답 헤더	`request_id`	요청 ID는 응답 헤더가 아닌 Data Manager API의 응답 필드로 반환됩니다.
`results`	- 동등한 보고서 없음	Data Manager API는 이벤트를 비동기식으로 처리합니다. 진단을 사용하여 처리 결과를 확인합니다.

업그레이드 단계