Method: customers.uploadCallConversions

지정된 통화 전환을 처리합니다.

발생한 오류 목록: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

HTTP 요청

POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadCallConversions

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
customerId

string

필수 항목입니다. 업로드를 수행하는 고객의 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "conversions": [
    {
      object (CallConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
입력란
conversions[]

object (CallConversion)

필수 항목입니다. 업로드 중인 전환입니다.
partialFailure

boolean

필수 항목입니다. true인 경우 작업이 성공적으로 수행되고 잘못된 작업은 오류를 반환합니다. false인 경우 모든 작업이 모두 유효한 경우에만 하나의 트랜잭션에서 모든 작업이 수행됩니다. 항상 true로 설정되어야 합니다. 부분 실패에 대한 자세한 내용은 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures를 참조하세요.
validateOnly

boolean

true인 경우 요청의 유효성이 검사되지만 실행되지는 않습니다. 결과는 반환되지 않고 오류만 반환됩니다.

응답 본문

ConversionUploadService.UploadCallConversions의 응답 메시지입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (CallConversionResult)
    }
  ]
}
입력란
partialFailureError

object (Status)

부분 실패 모드의 전환 실패와 관련된 오류입니다. 전환 내에서 모든 오류가 발생하면 반환됩니다. 변환 외부에서 오류가 발생하면 (예: 인증 오류) RPC 수준 오류가 반환됩니다. 부분 실패에 대한 자세한 내용은 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures를 참조하세요.
results[]

object (CallConversionResult)

성공적으로 처리된 전환에 대해 반환됩니다. 오류가 발생한 행의 경우 Proto가 비어 있습니다. validateOnly가 true인 경우 결과가 반환되지 않습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/adwords

자세한 내용은 OAuth 2.0 개요를 참고하세요.

CallConversion

통화 전환

JSON 표현 
{
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "consent": {
    object (Consent)
  },
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
입력란
customVariables[]

object (CustomVariable)

전환과 연결된 맞춤 변수입니다.
consent

object (Consent)

이벤트에 대한 동의 설정입니다.
callerId

string

이 통화가 발생한 발신번호 표시입니다. 발신번호 표시는 앞에 '+' 기호가 있는 E.164 형식이어야 합니다(예: '+16502531234').
callStartDateTime

string

통화가 발생한 날짜 시간입니다. 시간대를 지정해야 합니다. 형식은 'yyyy-mm-dd hh:mm:ss+|-hh:mm'입니다(예: '2019-01-01 12:32:45-08:00').
conversionAction

string

이 전환과 연결된 전환 액션의 리소스 이름입니다. 참고: 이 리소스 이름은 고객 ID와 전환 액션 ID로 구성되어 있지만 확인 과정에서 고객 ID를 무시하고 전환 액션 ID를 전환 액션의 단독 식별자로 사용합니다.
conversionDateTime

string

전환이 발생한 날짜 시간입니다. 통화 시간 이후여야 합니다. 시간대를 지정해야 합니다. 형식은 'yyyy-mm-dd hh:mm:ss+|-hh:mm'입니다(예: '2019-01-01 12:32:45-08:00').
conversionValue

number

광고주에게 제공되는 전환 가치입니다.
currencyCode

string

전환 가치와 연결된 통화입니다. ISO 4217 3자리 통화 코드입니다. 예: USD, EUR.

CallConversionResult

성공적으로 처리된 CallConversionUpload의 식별 정보입니다.

JSON 표현 
{
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string
}
입력란
callerId

string

이 통화가 발생한 발신번호 표시입니다. 발신번호 표시는 앞에 '+' 기호가 있는 E.164 형식이어야 합니다.
callStartDateTime

string

통화가 발생한 날짜 시간입니다. 형식은 'yyyy-mm-dd hh:mm:ss+|-hh:mm'입니다(예: '2019-01-01 12:32:45-08:00').
conversionAction

string

이 전환과 연결된 전환 액션의 리소스 이름입니다.
conversionDateTime

string

전환이 발생한 날짜 시간입니다. 형식은 'yyyy-mm-dd hh:mm:ss+|-hh:mm'입니다(예: '2019-01-01 12:32:45-08:00').