Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
의견 보내기
필드 매핑
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
표의 매핑을 사용하여 Google Ads API의
UploadClickConversionRequestIngestEventsRequest
요청 필드
UploadClickConversionRequestIngestEventsRequest참고
customer_iddeveloper-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_onlyvalidate_only
conversionsevents전환 또는 이벤트 목록입니다. 자세한 내용은 전환 필드 섹션 을 참고하세요.
고객 및 전환 액션 필드
Google Ads API에는 developer-token 요청 헤더가 필요하며, 다양한 인증 시나리오에 대해
login-customer-id 및 linked-customer-id
요청 헤더 를 설정합니다.
Data Manager API에는 개발자 토큰이 필요하지 않으며, 요청 헤더 대신 Destination의 필드를 사용하여 로그인 및 연결된 고객 정보를 지정합니다. 대상에 대한 자세한 내용은 대상 구성 을 참고하세요.
단일 conversion_action의 Google Ads API 필드를 Destination의 동등한 필드에 매핑하는 방법은 다음과 같습니다.
전환 필드
ClickConversionEvent참고
cart_datacart_data자세한 내용은 장바구니 데이터 필드 를 참고하세요.
consent
consent
두 API 모두 유사한 Consent 객체 (ad_user_data, ad_personalization)를 사용합니다.consent 필드를 설정하여
요청의 모든 이벤트에 대한 동의를 설정할 수도 있습니다.
conversion_actiondestination_references단일 요청에서 여러 전환 액션에 대한 전환을 전송하는 경우 이 필드를 reference의 해당 대상 으로 설정합니다.
conversion_date_timeevent_timestamp
타임스탬프 형식 을 참고하세요.
conversion_environment- 동등한 보고서 없음
conversion_valueconversion_value마이크로 단위의 값이 아닌 통화 값으로 설정합니다. 예를 들어 전환 가치가 $5.23인 경우 5.23 값을 사용합니다.
currency_codecurrency
custom_variablescustom_variables자세한 내용은 맞춤 변수 필드 를 참고하세요.
customer_typeuser_properties.customer_typeCustomerType
- 동등한 보고서 없음
event_source
- 동등한 보고서 없음
event_device_info
external_attribution_data- 동등한 보고서 없음
gbraidad_identifiers.gbraid
gclidad_identifiers.gclid
- 동등한 보고서 없음
last_updated_timestamp
order_idtransaction_id
session_attributes_encodedad_identifiers.session_attributes자세한 내용은 세션 속성 추가 를 참고하세요.
session_attributes_key_value_pairsexperimental_fields자세한 내용은 세션 속성 추가 를 참고하세요.
user_identifiersuser_data.user_identifiers자세한 내용은 사용자 식별자 필드 를 참고하세요.
user_ip_addresslanding_page_device_info.ip_address
wbraidad_identifiers.wbraid
장바구니 데이터 필드
CartDataCartData참고
feed_country_codemerchant_feed_label피드 라벨 로 설정합니다.
feed_language_codemerchant_feed_language_code
itemsitems
local_transaction_costtransaction_discount
merchant_idmerchant_id
장바구니 데이터의 항목 필드
ItemItem참고
product_idmerchant_product_id
quantityquantity
unit_priceunit_price
- 동등한 보고서 없음
item_id
- 동등한 보고서 없음
additional_item_parameters
맞춤 변수 필드
CustomVariableCustomVariable참고
- 동등한 보고서 없음
destination_referencesGoogle Ads API에는 전환 액션별로 별도의 요청이 필요합니다. Data Manager API는 단일 요청에서 여러 전환 액션에 대한 전환 전송을 지원하며 , 이 destination_references 필드를 사용하여 특정 맞춤 변수를 수신해야 하는 대상을 나타낼 수 있습니다.
conversion_custom_variablevariable리소스 이름 대신 변수 이름으로 설정합니다.
valuevalue
사용자 식별자 필드
팁: Data Manager API에서 사용자 식별자를
UserDatauser_data 필드를
Event 설정합니다. Google Ads API에서 사용자 식별자는 user_identifiers 필드의 ClickConversion에 직접 추가됩니다. 응답 필드
의견 보내기
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2026-07-17(UTC)
의견을 전달하고 싶나요?
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2026-07-17(UTC)"],[],[]]
