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개의 하위 요소가 있을 수 있습니다. 형식: 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

필수 항목입니다. GA4 이벤트의 이름입니다. 항상 설정되어 있어야 합니다. 허용되는 최대 표시 이름 길이는 40개의 UTF-16 코드 단위입니다.
minEventCount

string (int64 format)

다음 4개의 최솟값/최댓값 중 하나 이상을 설정해야 합니다. 값 세트는 AND로 함께 처리되어 이벤트 자격을 갖출 수 있습니다. 이벤트가 발생한 최소 횟수입니다. 설정하지 않으면 최소 이벤트 수가 확인되지 않습니다.
maxEventCount

string (int64 format)

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

number

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

number

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

방법

create

 SKAdNetworkConversionValueSchema를 만듭니다.

delete

 타겟 SKAdNetworkConversionValueSchema를 삭제합니다.

get

 단일 SKAdNetworkConversionValueSchema를 조회합니다.

list

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

patch

 SKAdNetworkConversionValueSchema를 업데이트합니다.