지정된 통화 전환을 처리합니다.
발생한 오류 목록: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
HTTP 요청
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadCallConversions
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인 경우 요청의 유효성이 검사되지만 실행되지는 않습니다. 결과는 아닌 오류만 반환됩니다. |
응답 본문
ConversionUploadService.UploadCallConversions
의 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "partialFailureError": { object ( |
필드 | |
---|---|
partialFailureError |
부분 실패 모드의 변환 실패와 관련된 오류입니다. 전환 내에서 모든 오류가 발생하면 반환됩니다. 전환 외부에서 오류 (예: 인증 오류)가 발생하면 RPC 수준 오류가 반환됩니다. 부분 실패에 대한 자세한 내용은 https://developers.google.com/google-ads/api/docs/best-practices/partial-failures를 참조하세요. |
results[] |
성공적으로 처리된 전환에 대해 반환됩니다. 오류가 발생한 행의 경우 Proto가 비어 있습니다. verifyOnly가 true인 경우 결과가 반환되지 않습니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/adwords
자세한 내용은 OAuth 2.0 개요를 참고하세요.
CallConversion
통화 전환
JSON 표현 |
---|
{ "customVariables": [ { object ( |
필드 | |
---|---|
customVariables[] |
전환과 연결된 맞춤 변수입니다. |
consent |
이벤트에 대한 동의 설정입니다. |
callerId |
전화를 건 발신자 ID입니다. 발신번호 표시는 앞에 '+' 기호가 있는 E.164 형식이어야 합니다(예: '+16502531234'). |
callStartDateTime |
통화가 발생한 날짜 시간입니다. 시간대를 지정해야 합니다. 형식은 'yyyy-mm-dd hh:mm:ss+|-hh:mm'입니다(예: '2019-01-01 12:32:45-08:00'). |
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 |
CallConversionResult
성공적으로 처리된 CallConversionUpload의 식별 정보입니다.
JSON 표현 |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
필드 | |
---|---|
callerId |
전화를 건 발신자 ID입니다. 발신번호 표시는 앞에 '+' 기호가 있는 E.164 형식이어야 합니다. |
callStartDateTime |
통화가 발생한 날짜 시간입니다. 형식은 'yyyy-mm-dd hh:mm:ss+|-hh:mm'입니다(예: '2019-01-01 12:32:45-08:00'). |
conversionAction |
이 전환과 연결된 전환 액션의 리소스 이름입니다. |
conversionDateTime |
전환이 발생한 날짜 시간입니다. 형식은 'yyyy-mm-dd hh:mm:ss+|-hh:mm'입니다(예: '2019-01-01 12:32:45-08:00'). |