- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- ClickConversion
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ExternalAttributionData
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- CartData
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 항목
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ConversionEnvironment
- ClickConversionResult
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 실습
지정된 클릭 전환을 처리합니다.
발생한 오류 목록: AuthenticationError AuthorizationError ConversionUploadError HeaderError InternalError PartialFailureError QuotaError RequestError
HTTP 요청
POST https://googleads.googleapis.com/v17/customers/{customerId}:uploadClickConversions
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
customerId |
필수 항목입니다. 업로드를 수행하는 고객의 ID입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"conversions": [
{
object ( |
필드 | |
---|---|
conversions[] |
필수 항목입니다. 업로드 중인 전환입니다. |
partialFailure |
필수 항목입니다. true인 경우 성공한 작업이 수행되고 잘못된 작업이 오류를 반환합니다. false인 경우 모든 작업이 유효한 경우에만 하나의 트랜잭션으로 수행됩니다. 이 값은 항상 true로 설정해야 합니다. 부분 실패에 대한 자세한 내용은 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures를 참고하세요. |
validateOnly |
true인 경우 요청의 유효성만 확인하고 요청을 실행하지는 않습니다. 오류만 반환되고 결과는 반환되지 않습니다. |
debugEnabled |
true인 경우 API는 모든 업로드 확인을 수행하고 오류가 발견되면 오류를 반환합니다. false인 경우 기본 입력 유효성 검사만 수행하고, 후속 업로드 확인을 건너뛰고, 제공된 이 설정은 기본값은 false입니다. |
jobId |
선택사항입니다. 작업 ID를 설정하기 위한 입력(선택사항)입니다. 제공되는 경우 2^31 미만의 음수가 아닌 숫자여야 합니다. 이 필드가 제공되지 않으면 API는 [2^31, (2^63)-1] 범위의 작업 ID를 생성합니다. API는 |
응답 본문
ConversionUploadService.UploadClickConversions
의 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "partialFailureError": { object ( |
필드 | |
---|---|
partialFailureError |
부분 실패 모드의 변환 실패와 관련된 오류입니다. 전환 내에서 모든 오류가 발생하면 반환됩니다. 전환 외부에서 발생하는 오류 (예: 인증 오류)가 있으면 RPC 수준 오류가 반환됩니다. 부분 실패에 대한 자세한 내용은 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures를 참고하세요. |
results[] |
성공적으로 처리된 전환에 대해 반환됩니다. 오류가 발생한 행의 경우 Proto가 비어 있습니다. validateOnly가 true인 경우 결과가 반환되지 않습니다. |
jobId |
업로드 배치의 작업 ID입니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/adwords
자세한 내용은 OAuth 2.0 개요를 참고하세요.
ClickConversion
클릭 전환
JSON 표현 |
---|
{ "gbraid": string, "wbraid": string, "externalAttributionData": { object ( |
필드 | |
---|---|
gbraid |
앱 전환과 연결되고 iOS 14부터 iOS 기기에서 발생한 클릭에 대한 클릭 식별자입니다. |
wbraid |
웹 전환과 연결되고 iOS 14부터 iOS 기기에서 발생한 클릭에 대한 클릭 식별자입니다. |
externalAttributionData |
외부 기여 전환에 대한 추가 데이터입니다. 이 필드는 외부 기여 전환 액션이 있는 전환에 필요하지만 달리 설정해서는 안 됩니다. |
customVariables[] |
이 전환과 연결된 맞춤 변수입니다. |
cartData |
이 전환과 연결된 장바구니 데이터입니다. |
userIdentifiers[] |
이 전환과 연결된 사용자 식별자입니다. 전환 업로드에는 해싱된 이메일 및 해싱된 전화 번호만 지원됩니다. 전환당 사용자 식별자의 최대 개수는 5개입니다. |
conversionEnvironment |
이 전환이 기록된 환경입니다(예: 앱 또는 웹). |
consent |
이벤트의 동의 설정입니다. |
gclid |
이 전환과 연결된 Google 클릭 ID (GCLID)입니다. |
conversionAction |
이 전환과 연결된 전환 액션의 리소스 이름입니다. 참고: 이 리소스 이름은 고객 ID와 전환 액션 ID로 구성되어 있지만, 확인 절차에서는 고객 ID를 무시하고 전환 액션 ID를 전환 액션의 유일한 식별자로 사용합니다. |
conversionDateTime |
전환이 발생한 날짜 시간입니다. 클릭 시간 이후여야 합니다. 시간대를 지정해야 합니다. 형식은 'yyyy-mm-dd hh:mm:ss+|-hh:mm'입니다(예: '2019-01-01 12:32:45-08:00'). |
conversionValue |
광고주에 대한 전환 가치입니다. |
currencyCode |
전환 가치와 연결된 통화입니다. ISO 4217 3자리 통화 코드입니다. 예: USD, EUR |
orderId |
전환과 연결된 주문 ID입니다. 주문 ID는 전환 액션당 하나의 전환에만 사용할 수 있습니다. |
ExternalAttributionData
외부 기여 전환에 대한 추가 정보를 포함합니다.
JSON 표현 |
---|
{ "externalAttributionCredit": number, "externalAttributionModel": string } |
필드 | |
---|---|
externalAttributionCredit |
Google Ads 클릭이 기여한 전환의 비율을 나타냅니다. |
externalAttributionModel |
기여 분석 모델 이름을 지정합니다. |
CartData
장바구니 데이터에 대한 추가 정보가 포함됩니다.
JSON 표현 |
---|
{
"merchantId": string,
"feedCountryCode": string,
"feedLanguageCode": string,
"localTransactionCost": number,
"items": [
{
object ( |
필드 | |
---|---|
merchantId |
상품이 업로드된 판매자 센터 ID입니다. |
feedCountryCode |
상품이 업로드된 피드와 연결된 국가 코드입니다. |
feedLanguageCode |
상품이 업로드된 피드와 연결된 언어 코드입니다. |
localTransactionCost |
전체 장바구니에 대한 무료 배송 및 쿠폰 할인과 같은 모든 거래 수준 할인의 합계입니다. 통화 코드는 ClickConversion 메시지의 통화 코드와 동일합니다. |
items[] |
구매한 상품의 데이터입니다. |
항목
구매한 상품의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "productId": string, "quantity": integer, "unitPrice": number } |
필드 | |
---|---|
productId |
상품의 쇼핑 ID입니다. 판매자 센터 제품 식별자와 같아야 합니다. |
quantity |
판매된 상품의 개수입니다. |
unitPrice |
세금, 배송비, 거래별 할인을 제외한 단가입니다. 통화 코드는 ClickConversion 메시지의 통화 코드와 동일합니다. |
ConversionEnvironment
업로드된 전환의 전환 환경입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
APP |
전환이 앱에서 기록되었습니다. |
WEB |
전환이 웹사이트에서 기록되었습니다. |
ClickConversionResult
성공적으로 처리된 ClickConversion의 정보 식별
JSON 표현 |
---|
{
"gbraid": string,
"wbraid": string,
"userIdentifiers": [
{
object ( |
필드 | |
---|---|
gbraid |
앱 전환과 연결되고 iOS 14부터 iOS 기기에서 발생한 클릭에 대한 클릭 식별자입니다. |
wbraid |
웹 전환과 연결되고 iOS 14부터 iOS 기기에서 발생한 클릭에 대한 클릭 식별자입니다. |
userIdentifiers[] |
이 전환과 연결된 사용자 식별자입니다. 전환 업로드에는 해싱된 이메일 및 해싱된 전화 번호만 지원됩니다. 전환당 사용자 식별자의 최대 개수는 5개입니다. |
gclid |
이 전환과 연결된 Google 클릭 ID (gclid)입니다. |
conversionAction |
이 전환과 연결된 전환 액션의 리소스 이름입니다. |
conversionDateTime |
전환이 발생한 날짜 시간입니다. 형식은 'yyyy-mm-dd hh:mm:ss+|-hh:mm'입니다(예: '2019-01-01 12:32:45-08:00'). |