리소스: SKAdNetworkConversionValueSchema
iOS 스트림의 SKAdNetwork 전환 가치 스키마
JSON 표현 |
---|
{ "name": string, "postbackWindowOne": { object ( |
입력란 | |
---|---|
name |
출력 전용입니다. 스키마의 리소스 이름입니다. iOS 스트림의 하위 요소이며 iOS 스트림 아래에 최대 1개의 하위 요소가 있을 수 있습니다. 형식: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema |
postbackWindowOne |
필수 항목입니다. 첫 번째 포스트백 기간에 대한 전환 가치 설정입니다. 이 값은 '세부' 전환 가치 (숫자 값)를 포함한다는 점에서 포스트백 기간 2 및 3의 값과 다릅니다. 이 포스트백 기간에 대한 전환 가치를 설정해야 합니다. 다른 창은 선택사항이며, 설정하지 않거나 사용 중지하면 이 창의 설정을 상속할 수 있습니다. |
postbackWindowTwo |
두 번째 포스트백 기간에 대한 전환 가치 설정입니다. 이 필드는 이 포스트백 기간에 다른 전환 값을 정의해야 하는 경우에만 구성해야 합니다. 이 포스트백 기간에 대해 enable_postback_window_settings가 false로 설정되면 postbackWindowOne의 값이 사용됩니다. |
postbackWindowThree |
세 번째 포스트백 기간에 대한 전환 가치 설정입니다. 이 필드는 사용자가 이 포스트백 기간에 다른 전환 가치를 정의한 경우에만 설정해야 합니다. 창 2를 설정하지 않고 창 3을 구성할 수 있습니다. 기간 1과 기간 2가 설정되고 이 포스트백 기간에 대해 enable_postback_window_settings가 false로 설정되면 스키마가 postbackWindowTwo의 설정을 상속합니다. |
applyConversionValues |
사용 설정하면 GA SDK에서 이 스키마 정의를 사용하여 전환 가치를 설정하고 이 속성에 연결된 모든 Google Ads 계정으로 스키마를 내보냅니다. 사용 중지하면 GA SDK가 전환 가치를 자동으로 설정하지 않으며 스키마도 Google Ads로 내보내지 않습니다. |
PostbackWindow
SKAdNetwork 전환 포스트백 기간의 설정입니다.
JSON 표현 |
---|
{
"conversionValues": [
{
object ( |
입력란 | |
---|---|
conversionValues[] |
반복되는 입력란의 순서는 전환 가치 설정의 우선순위를 정하는 데 사용됩니다. 색인 생성된 항목이 낮을수록 우선순위가 높습니다. true로 평가되는 첫 번째 전환 가치 설정이 선택됩니다. enable_postback_window_settings가 true로 설정된 경우 항목이 하나 이상 있어야 합니다. 최대 128개의 항목을 포함할 수 있습니다. |
postbackWindowSettingsEnabled |
enable_postback_window_settings가 true인 경우 conversionValues가 채워져야 하며 이는 고객 기기에서 전환 가치를 설정하는 시점과 방법을 결정하고 연결된 Google Ads 계정으로 스키마를 내보내는 데 사용됩니다. false인 경우 설정이 사용되지 않지만 나중에 사용될 수 있도록 유지됩니다. postbackWindowOne의 경우 항상 true여야 합니다. |
ConversionValues
SKAdNetwork 전환 가치 스키마에 대한 포스트백 기간에 대한 전환 가치 설정입니다.
JSON 표현 |
---|
{ "displayName": string, "coarseValue": enum ( |
입력란 | |
---|---|
displayName |
SKAdNetwork 전환 가치의 표시 이름입니다. 허용되는 최대 표시 이름 길이는 50 UTF-16 코드 단위입니다. |
coarseValue |
필수 항목입니다. 대략적인 전환 가치입니다. 이 값은 고유하지 않을 수 있습니다. |
eventMappings[] |
이 전환 가치를 달성하기 위해 충족해야 하는 이벤트 조건입니다. 이 목록의 조건은 AND로 연결됩니다. 포스트백 기간이 사용 설정된 경우 최소 1개, 최대 3개의 항목이 있어야 합니다. |
lockEnabled |
true인 경우 SDK는 현재 포스트백 기간에 이 전환 가치로 고정되어야 합니다. |
fineValue |
세분화된 전환 가치입니다. 첫 번째 포스트백 기간에만 적용됩니다. 유효한 값은 모두 [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 |
필수 항목입니다. GA4 이벤트의 이름입니다. 항상 설정되어 있어야 합니다. 허용되는 최대 표시 이름 길이는 40개의 UTF-16 코드 단위입니다. |
minEventCount |
다음 4개의 최솟값/최댓값 중 하나 이상을 설정해야 합니다. 값 세트는 AND로 함께 처리되어 이벤트 자격을 갖출 수 있습니다. 이벤트가 발생한 최소 횟수입니다. 설정하지 않으면 최소 이벤트 수가 확인되지 않습니다. |
maxEventCount |
이벤트가 발생한 최대 횟수입니다. 설정하지 않으면 최대 이벤트 수가 확인되지 않습니다. |
minEventValue |
이벤트로 인해 발생한 최소 수익입니다. 수익 통화는 속성 수준에서 정의됩니다. 설정하지 않으면 최소 이벤트 값이 확인되지 않습니다. |
maxEventValue |
이벤트로 인해 발생한 최대 수익입니다. 수익 통화는 속성 수준에서 정의됩니다. 설정하지 않으면 최대 이벤트 값이 확인되지 않습니다. |
방법 |
|
---|---|
|
SKAdNetworkConversionValueSchema를 만듭니다. |
|
타겟 SKAdNetworkConversionValueSchema를 삭제합니다. |
|
단일 SKAdNetworkConversionValueSchema를 조회합니다. |
|
스트림에 SKAdNetworkConversionValueSchema를 나열합니다. |
|
SKAdNetworkConversionValueSchema를 업데이트합니다. |