REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

리소스: SKAdNetworkConversionValueSchema

iOS 스트림의 SKAdNetwork 전환 가치 스키마입니다.

JSON 표현 
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
필드
name

string

식별자. 스키마의 리소스 이름입니다. iOS 스트림의 하위 요소만 될 수 있으며 iOS 스트림에는 이러한 하위 요소가 최대 하나만 있을 수 있습니다. 형식: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

필수 항목입니다. 첫 번째 포스트백 기간의 전환 가치 설정입니다. 이러한 설정은 '세부' 전환 가치 (숫자 값)를 포함한다는 점에서 포스트백 기간 2 및 3의 값과 다릅니다.

이 포스트백 기간의 전환 가치를 설정해야 합니다. 다른 기간은 선택사항이며 설정되지 않거나 사용 중지된 경우 이 기간의 설정을 상속할 수 있습니다.
postbackWindowTwo

object (PostbackWindow)

두 번째 포스트백 기간의 전환 가치 설정입니다.

이 필드는 이 포스트백 기간에 다른 전환 가치를 정의해야 하는 경우에만 구성해야 합니다.

이 포스트백 기간에 enable_postback_window_settings가 false로 설정된 경우 postbackWindowOne의 값이 사용됩니다.
postbackWindowThree

object (PostbackWindow)

세 번째 포스트백 기간의 전환 가치 설정입니다.

이 필드는 사용자가 이 포스트백 기간에 다른 전환 가치를 정의하도록 선택한 경우에만 설정해야 합니다. 기간 2를 설정하지 않고 기간 3을 구성할 수 있습니다. 기간 1 및 2 설정이 설정되어 있고 이 포스트백 기간에 enable_postback_window_settings가 false로 설정된 경우 스키마는 postbackWindowTwo의 설정을 상속합니다.
applyConversionValues

boolean

사용 설정된 경우 GA SDK는 이 스키마 정의를 사용하여 전환 가치를 설정하고 스키마는 이 속성에 연결된 모든 Google Ads 계정으로 내보내집니다. 사용 중지된 경우 GA SDK는 전환 가치를 자동으로 설정하지 않으며 스키마도 Google Ads로 내보내지지 않습니다.

PostbackWindow

SKAdNetwork 전환 포스트백 기간의 설정입니다.

JSON 표현 
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
필드
conversionValues[]

object (ConversionValues)

반복 필드의 순서는 전환 가치 설정의 우선순위를 지정하는 데 사용됩니다. 색인이 낮은 항목의 우선순위가 더 높습니다. true로 평가되는 첫 번째 전환 가치 설정이 선택됩니다. enable_postback_window_settings가 true로 설정된 경우 항목이 하나 이상 있어야 합니다. 최대 128개의 항목을 포함할 수 있습니다.
postbackWindowSettingsEnabled

boolean

enable_postback_window_settings가 true인 경우 conversionValues를 채워야 하며 클라이언트 기기에서 전환 가치를 설정하는 시점과 방법을 결정하고 연결된 Google Ads 계정으로 스키마를 내보내는 데 사용됩니다. false인 경우 설정은 사용되지 않지만 향후 사용될 수 있으므로 보관됩니다. postbackWindowOne의 경우 항상 true여야 합니다.

ConversionValues

SKAdNetwork 전환 가치 스키마의 포스트백 기간에 대한 전환 가치 설정입니다.

JSON 표현 
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
필드
displayName

string

SKAdNetwork 전환 가치의 표시 이름입니다. 허용되는 최대 표시 이름 길이는 50 UTF-16 코드 단위입니다.
coarseValue

enum (CoarseValue)

필수 항목입니다. 대략적인 전환 가치입니다.

이 값은 고유하지 않습니다.
eventMappings[]

object (EventMapping)

이 전환 가치를 달성하기 위해 충족해야 하는 이벤트 조건입니다. 이 목록의 조건은 함께 AND로 연산됩니다. 포스트백 기간이 사용 설정된 경우 항목이 1개 이상, 3개 이하여야 합니다.
lockEnabled

boolean

true인 경우 SDK는 현재 포스트백 기간에 이 전환 가치로 잠겨야 합니다.
fineValue

integer

세부적인 전환 가치입니다. 이는 첫 번째 포스트백 기간에만 적용됩니다. 유효한 값은 [0,63]입니다(0과 63 포함). 포스트백 기간 1에 설정해야 하며 포스트백 기간 2 및 3에는 설정해서는 안 됩니다. 이 값은 고유하지 않습니다.

첫 번째 포스트백 기간의 구성이 두 번째 또는 세 번째 포스트백 기간에 재사용되는 경우 이 필드는 영향을 미치지 않습니다.

CoarseValue

ConversionValues.event_mappings 조건이 충족될 때 updatePostbackConversionValue SDK 호출에 설정된 대략적인 전환 가치입니다. 자세한 내용은 SKAdNetwork.CoarseConversionValue를 참고하세요.

열거형
COARSE_VALUE_UNSPECIFIED 대략적인 값이 지정되지 않았습니다.
COARSE_VALUE_LOW 대략적인 값이 낮습니다.
COARSE_VALUE_MEDIUM 대략적인 값이 중간입니다.
COARSE_VALUE_HIGH 대략적인 값이 높습니다.

EventMapping

이벤트를 일치시키는 이벤트 설정 조건입니다.

JSON 표현 
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
필드
eventName

string

필수 항목입니다. Google 애널리틱스 이벤트의 이름입니다. 항상 설정해야 합니다. 허용되는 최대 표시 이름 길이는 40 UTF-16 코드 단위입니다.
minEventCount

string (int64 format)

다음 네 가지 최솟값/최댓값 중 하나 이상을 설정해야 합니다. 설정된 값은 이벤트를 검증하기 위해 함께 AND로 연산됩니다. 이벤트가 발생한 최소 횟수입니다. 설정하지 않으면 최소 이벤트 수가 확인되지 않습니다.
maxEventCount

string (int64 format)

이벤트가 발생한 최대 횟수입니다. 설정하지 않으면 최대 이벤트 수가 확인되지 않습니다.
minEventValue

number

이벤트로 인해 발생한 최소 수익입니다. 수익 통화는 속성 수준에서 정의됩니다. 설정하지 않으면 최소 이벤트 값이 확인되지 않습니다.
maxEventValue

number

이벤트로 인해 발생한 최대 수익입니다. 수익 통화는 속성 수준에서 정의됩니다. 설정하지 않으면 최대 이벤트 값이 확인되지 않습니다.

메서드

create

 SKAdNetworkConversionValueSchema를 만듭니다.

delete

 타겟 SKAdNetworkConversionValueSchema를 삭제합니다.

get

 단일 SKAdNetworkConversionValueSchema를 조회합니다.

list

 스트림에서 SKAdNetworkConversionValueSchema를 나열합니다.

patch

 SKAdNetworkConversionValueSchema를 업데이트합니다.