Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

CustomerSkAdNetworkConversionValueSchema를 만들거나 업데이트합니다.

발생한 오류 목록: AuthenticationError AuthorizationError FieldError InternalError MutateError

HTTP 요청

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

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

경로 매개변수

매개변수
customerId

string

공유 조합을 수정 중인 고객의 ID입니다.

요청 본문

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

JSON 표현
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean
}
필드
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

수행할 연산입니다.

validateOnly

boolean

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

응답 본문

customerSkAdNetworkConversionValueSchemas.mut의 응답 메시지입니다.

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

JSON 표현
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  }
}
필드
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

변형에 대한 모든 결과입니다.

승인 범위

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

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

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

CustomerSkAdNetworkConversionValueSchemaOperation

CustomerSkAdNetworkConversionValueSchema에 대한 단일 업데이트 작업입니다.

JSON 표현
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
필드
update

object (CustomerSkAdNetworkConversionValueSchema)

업데이트 작업: 스키마에 유효한 리소스 이름이 있어야 합니다.

CustomerSkAdNetworkConversionValueSchema

CustomerSkAdNetworkConversionValueSchema입니다.

JSON 표현
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
필드
resourceName

string

출력 전용. 스키마의 리소스 이름입니다. CustomerSkAdNetworkConversionValueSchema 리소스 이름의 형식은 customer/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}입니다.

schema

object (SkAdNetworkConversionValueSchema)

출력 전용. 지정된 리소스의 스키마입니다.

SkAdNetworkConversionValueSchema

CustomerLink 전용 SkAdNetworkConversionValueSchema입니다.

JSON 표현
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ]
}
필드
appId

string

필수 항목입니다. 출력 전용. Apple App Store 앱 ID입니다.

measurementWindowHours

integer

출력 전용. 설치 후 앱 기여 분석 파트너 또는 광고주가 updateConversionValue 호출을 중지한 후의 기간 (시간 단위로 측정)입니다.

fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

출력 전용. 세밀한 전환 가치 매핑

FineGrainedConversionValueMappings

세분화된 전환 가치를 매핑

JSON 표현
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
필드
fineGrainedConversionValue

integer

출력 전용. 세분화된 전환 가치 유효한 값의 범위는 [0,63]입니다.

conversionValueMapping

object (ConversionValueMapping)

출력 전용. 세분화된 전환 가치가 매핑되는 전환 이벤트입니다.

ConversionValueMapping

하나의 전환 가치에서 하나 이상의 전환 이벤트로의 매핑을 나타냅니다.

JSON 표현
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
필드
minTimePostInstallHours

string (int64 format)

출력 전용. 측정 기간 동안 사용자가 마지막으로 활동한 시간 범위의 최솟값입니다.

maxTimePostInstallHours

string (int64 format)

출력 전용. 측정 기간 중 사용자가 마지막으로 활성 상태였던 기간의 최대 시간입니다.

mappedEvents[]

object (Event)

출력 전용. 전환 가치는 다양한 속성을 가진 여러 이벤트에 매핑될 수 있습니다.

이벤트

전환 가치가 매핑되는 Google 전환 이벤트를 정의합니다.

JSON 표현
{
  "mappedEventName": string,
  "currencyCode": string,

  // Union field revenue_rate can be only one of the following:
  "eventRevenueRange": {
    object (RevenueRange)
  },
  "eventRevenueValue": number
  // End of list of possible types for union field revenue_rate.

  // Union field event_rate can be only one of the following:
  "eventOccurrenceRange": {
    object (EventOccurrenceRange)
  },
  "eventCounter": string
  // End of list of possible types for union field event_rate.
}
필드
mappedEventName

string

출력 전용. 이 전환 가치로 표시되는 Google 이벤트 이름입니다.

currencyCode

string

출력 전용. event_revenue에 대해 보고되는 통화입니다. 3자리 ISO 4217 통화 코드(예: 'USD')

통합 필드 revenue_rate. 이벤트 수익의 범위 또는 특정 값입니다. revenue_rate은 다음 중 하나여야 합니다.
eventRevenueRange

object (RevenueRange)

출력 전용. 이벤트 수익 범위입니다.

eventRevenueValue

number

출력 전용. 특정 이벤트 수익 값입니다.

통합 필드 event_rate. 이벤트 카운터의 범위 또는 특정 값입니다. event_rate은 다음 중 하나여야 합니다.
eventOccurrenceRange

object (EventOccurrenceRange)

출력 전용. 이벤트 카운터 범위입니다.

eventCounter

string (int64 format)

출력 전용. 특정 이벤트 카운터 값

RevenueRange

수익 값의 범위를 정의합니다.

JSON 표현
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
필드
minEventRevenue

number

출력 전용. 수익 범위의 경우 이 전환 가치가 업데이트될 currencyCode의 최솟값입니다. 값이 0이면 설정되지 않은 것으로 간주됩니다.

maxEventRevenue

number

출력 전용. 수익 범위의 경우 이 전환 가치가 업데이트될 currencyCode의 최댓값입니다. 값이 0이면 설정되지 않은 것으로 간주됩니다.

EventOccurrenceRange

이벤트 카운터 값의 범위를 정의합니다.

JSON 표현
{
  "minEventCount": string,
  "maxEventCount": string
}
필드
minEventCount

string (int64 format)

출력 전용. 이벤트 카운터 범위의 경우 정의된 범위의 최솟값입니다. 값이 0이면 설정되지 않은 것으로 간주됩니다.

maxEventCount

string (int64 format)

출력 전용. 이벤트 카운터 범위의 경우 정의된 범위의 최댓값입니다. 값이 0이면 설정되지 않은 것으로 간주됩니다.

MutateCustomerSkAdNetworkConversionValueSchemaResult

CustomerSkAdNetworkConversionValueSchema 변경의 결과입니다.

JSON 표현
{
  "resourceName": string,
  "appId": string
}
필드
resourceName

string

수정된 고객의 리소스 이름입니다.

appId

string

수정된 SkanConversionValue의 앱 ID입니다.