Method: customers.uploadConversionAdjustments

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

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

HTTP 요청

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

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

경로 매개변수

매개변수
customerId

string

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

요청 본문

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

JSON 표현 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "jobId": integer
}
입력란
conversionAdjustments[]

object (ConversionAdjustment)

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

boolean

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

boolean

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

integer

선택사항입니다. 작업 ID를 설정하기 위한 입력(선택사항)입니다. 제공되는 경우 2^31보다 작은 음수가 아닌 숫자여야 합니다. 이 필드를 입력하지 않으면 API가 [2^31, (2^63)-1] 범위의 작업 ID를 생성합니다. API는 UploadConversionAdjustmentsResponse의 jobId 필드에 이 요청의 값을 반환합니다.

응답 본문

ConversionAdjustmentUploadService.UploadConversionAdjustments의 응답 메시지입니다.

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

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

object (Status)

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

object (ConversionAdjustmentResult)

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

string (int64 format)

업로드 배치의 작업 ID입니다.

승인 범위

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

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

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

ConversionAdjustment

전환 조정입니다.

JSON 표현 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
입력란
gclidDateTimePair

object (GclidDateTimePair)

조정의 경우 주문 ID를 지정하지 않고 보고된 전환을 고유하게 식별합니다. 조정 유형이 ENHANCEMENT인 경우 이 값은 선택사항이지만 orderId와 함께 설정할 수 있습니다.
adjustmentType

enum (ConversionAdjustmentType)

조정 유형입니다.
restatementValue

object (RestatementValue)

전환 가치를 다시 명시하는 데 필요한 정보입니다. 다시 작성하는 데 필요합니다. 철회에는 이 기능을 제공해서는 안 됩니다. 철회를 요청하면 오류가 반환됩니다. 참고: 다른 조정된 값으로 두 번째 수정을 업로드하려면 더 최근의 새로운 조정 발생 시간이 있어야 합니다. 그렇지 않으면 이전 수정사항의 중복으로 처리되어 무시됩니다.
userIdentifiers[]

object (UserIdentifier)

원래 전환을 개선하기 위한 사용자 식별자입니다. ConversionAdjustmentUploadService가 개선 버전에서 사용자 식별자만 허용합니다. 각 개선사항에 대한 최대 사용자 식별자 수는 5개입니다.
orderId

string

조정할 전환의 주문 ID입니다. 지정된 주문 ID와 함께 전환이 보고되었다면 여기에서 해당 주문 ID를 식별자로 사용해야 합니다. 개선사항을 이용하려면 주문 ID가 필요합니다.
conversionAction

string

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

string

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

string

원래 전환을 개선할 사용자 에이전트입니다. 사용자가 웹페이지에서 전환할 때 사용자의 HTTP 요청 헤더에서 확인할 수 있습니다. 예: 'Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)'. 사용자 에이전트는 사용자 식별자가 있는 향상에서만 지정할 수 있습니다. 전환과 해당 개선사항이 모두 동일한 기기로 기인하거나 둘 다 교차 기기로 기인하도록 하려면 원래 전환을 전송한 요청의 사용자 에이전트와 일치해야 합니다.

GclidDateTimePair

주문 ID를 지정하지 않고 보고된 전환을 고유하게 식별합니다.

JSON 표현 
{
  "gclid": string,
  "conversionDateTime": string
}
입력란
gclid

string

이 조정의 원래 전환과 연결된 Google 클릭 ID (gclid)입니다.
conversionDateTime

string

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

ConversionAdjustmentType

광고주가 이미 보고한 전환을 조정하기 위해 취할 수 있는 다양한 조치 철회는 전환을 무효화합니다. 수정할 경우 전환 가치가 달라집니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서 알 수 없는 값을 나타냅니다.
RETRACTION 총 전환값과 개수가 모두 0이 되도록 전환을 음수로 변환합니다.
RESTATEMENT 전환 가치를 변경합니다.
ENHANCEMENT Google에서 전환수 증가를 위해 사용할 수 있는 제공된 사용자 식별자와 사용자 에이전트로 기존 전환을 보완합니다.

RestatementValue

전환 가치를 다시 지정하는 데 필요한 정보가 포함되어 있습니다.

JSON 표현 
{
  "adjustedValue": number,
  "currencyCode": string
}
입력란
adjustedValue

number

다시 작성된 전환 가치입니다. 수정 후의 전환 가치입니다. 예를 들어 전환 가치를 100에서 70으로 변경하려면 조정된 값 70을 보고해야 합니다. 참고: 다른 조정된 값으로 두 번째 수정을 업로드하려면 더 최근의 새로운 조정 발생 시간이 있어야 합니다. 그렇지 않으면 이전 수정사항의 중복으로 처리되어 무시됩니다.
currencyCode

string

다시 작성된 값의 통화입니다. 제공하지 않은 경우 전환 액션의 기본 통화가 사용되고, 설정되지 않은 경우 계정 통화가 사용됩니다. ISO 4217의 3자리 통화 코드입니다(예: USD 또는 EUR).

ConversionAdjustmentResult

성공적으로 처리된 전환 조정을 식별하는 정보입니다.

JSON 표현 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
입력란
gclidDateTimePair

object (GclidDateTimePair)

전환의 gclid 및 전환 날짜 시간입니다.
orderId

string

조정할 전환의 주문 ID입니다.
adjustmentType

enum (ConversionAdjustmentType)

조정 유형입니다.
conversionAction

string

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

string

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