Method: customers.uploadConversionAdjustments

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

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

HTTP 요청

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

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

경로 매개변수

매개변수
customerId

string

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

요청 본문

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

JSON 표현 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
필드
conversionAdjustments[]

object (ConversionAdjustment)

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

boolean

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

boolean

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

응답 본문

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가 비어 있습니다. verifyOnly가 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를 지정하지 않고 보고된 전환을 고유하게 식별합니다. AdjustType이 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').