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의 값과 다릅니다. 포스트백 기간에는 'Fine'이라는 세분화된 전환 가치 (숫자 값)입니다.

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

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를 업데이트합니다.