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 스트림 아래에 이러한 하위 요소가 최대 1개 있을 수 있습니다. Format: 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]입니다(양 끝값 포함). 포스트백 기간 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를 업데이트합니다.