REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Kaynak: SKAdNetworkConversionValueSchema

Bir iOS akışının SKAdNetwork dönüşüm değeri şeması.

JSON gösterimi
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
Alanlar
name

string

Yalnızca çıkış. Şemanın kaynak adı. Bu, YALNIZCA bir iOS akışının alt öğesidir ve iOS akışı altında en fazla bir tane olabilir. Biçim: mülkleri/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

Zorunlu. İlk geri gönderme aralığı için dönüşüm değeri ayarları. Bunlar, "Ayrıntılı" ayrıntılı dönüşüm değeri (sayısal bir değer) içerdikleri için ikinci ve üçüncü geri gönderme aralığının değerlerinden farklıdır.

Bu geri gönderme aralığının dönüşüm değerleri ayarlanmalıdır. Diğer pencereler isteğe bağlıdır ve ayarlanmamışsa ya da devre dışı bırakılırsa bu pencerenin ayarlarını devralabilir.

postbackWindowTwo

object (PostbackWindow)

İkinci geri gönderme aralığının dönüşüm değeri ayarları.

Bu alan, yalnızca bu geri gönderme aralığı için farklı dönüşüm değerleri tanımlamanız gerekiyorsa yapılandırılmalıdır.

Bu geri gönderme aralığı için enable_postback_window_settings değeri false olarak ayarlanırsa postbackWindowOne değerleri kullanılır.

postbackWindowThree

object (PostbackWindow)

Üçüncü geri gönderme aralığı için dönüşüm değeri ayarları.

Bu alan, yalnızca kullanıcı bu geri gönderme aralığı için farklı dönüşüm değerleri tanımlamayı seçtiğinde ayarlanmalıdır. Pencere 2 ayarlanmadan pencere 3'ün yapılandırılmasına izin verilir. 1. ve 2. pencere ayarlarının yapılması ve bu geri gönderme penceresinin enable_postback_window_settings ayarının yanlış değerine ayarlanması durumunda şema, ayarları postbackWindowTwo'dan devralır.

applyConversionValues

boolean

Etkinleştirilirse GA SDK, dönüşüm değerlerini bu şema tanımını kullanarak ayarlar ve şema, bu mülke bağlı tüm Google Ads hesaplarına aktarılır. Devre dışı bırakılırsa GA SDK, dönüşüm değerlerini otomatik olarak ayarlamaz ve şema, Google Ads'e aktarılmaz.

PostbackWindow

SKAdNetwork dönüşüm geri gönderme aralığının ayarları.

JSON gösterimi
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
Alanlar
conversionValues[]

object (ConversionValues)

Yinelenen alanın sıralaması, dönüşüm değeri ayarlarına öncelik vermek için kullanılır. Dizine eklenme oranı daha düşük olan girişlere daha yüksek öncelik verilir. Doğru olarak değerlendirilen ilk dönüşüm değeri ayarı seçilir. enable_postback_window_settings değeri doğru değerine ayarlanırsa en az bir giriş içermelidir. En fazla 128 giriş olabilir.

postbackWindowSettingsEnabled

boolean

enable_postback_window_settings değeri doğruysa conversionValues doldurulmalıdır. Bu değer, bir istemci cihazında Dönüşüm Değerinin ne zaman ve nasıl ayarlanacağını ve şemanın bağlı Ads hesaplarına dışa aktarılacağını belirlemek için kullanılır. Yanlış değerine ayarlanırsa ayarlar kullanılmaz ancak gelecekte kullanılabilmeleri için saklanır. Bu, postbackWindowOne için her zaman doğru olmalıdır.

ConversionValues

SKAdNetwork dönüşüm değeri şeması için geri gönderme aralığının dönüşüm değeri ayarları.

JSON gösterimi
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
Alanlar
displayName

string

SKAdNetwork dönüşüm değerinin görünen adı. İzin verilen maksimum görünen ad uzunluğu 50 UTF-16 kod birimidir.

coarseValue

enum (CoarseValue)

Zorunlu. Genel ayrıntılı dönüşüm değeri.

Bu değerin benzersiz olacağı garanti edilmez.

eventMappings[]

object (EventMapping)

Bu Dönüşüm Değerinin elde edilebilmesi için karşılanması gereken etkinlik koşulları. Bu listedeki koşullar birbirine VE uygulanır. Geri gönderme aralığı etkinse en az 1, en fazla 3 giriş içermelidir.

lockEnabled

boolean

Doğruysa SDK, geçerli geri gönderme aralığı için bu dönüşüm değerine kilitlenmelidir.

fineValue

integer

Ayrıntılı dönüşüm değeri. Bu yalnızca ilk geri gönderme aralığı için geçerlidir. Geçerli değerleri [0,63]'tür (her ikisi de dahil). Bu aralık, geri gönderme aralığı 1, geri gönderme aralığı 2 ve 3 için ayarlanmamalıdır. Bu değerin benzersiz olacağı garanti edilmez.

İlk geri gönderme aralığının yapılandırması ikinci veya üçüncü geri gönderme aralıkları için yeniden kullanılırsa bu alanın hiçbir etkisi olmaz.

CoarseValue

ConversionValues.event_mappings koşulları karşılandığında updatePostbackConversionValue SDK çağrısında ayarlanan yaklaşık dönüşüm değeri. Daha fazla bilgi için SKAdNetwork.CoarseConversionValue konusuna bakın.

Sıralamalar
COARSE_VALUE_UNSPECIFIED Yaklaşık değer belirtilmedi.
COARSE_VALUE_LOW Yaklaşık düşük değer.
COARSE_VALUE_MEDIUM Ortanın yaklaşık değeri.
COARSE_VALUE_HIGH Yaklaşık yüksek değer.

EventMapping

Bir etkinlikle eşleşecek etkinlik ayarı koşulları.

JSON gösterimi
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
Alanlar
eventName

string

Zorunlu. GA4 etkinliğinin adı. Her zaman ayarlanmalıdır. İzin verilen maksimum görünen ad uzunluğu 40 UTF-16 kod birimidir.

minEventCount

string (int64 format)

Aşağıdaki dört min/maks. değerden en az biri ayarlanmalıdır. Ayarlanan değerler bir etkinliğin uygun olması için birlikte VE uygulanır. Etkinliğin minimum gerçekleşme sayısı. Ayarlanmazsa minimum etkinlik sayısı kontrol edilmez.

maxEventCount

string (int64 format)

Etkinliğin maksimum gerçekleşme sayısı. Ayarlanmazsa maksimum etkinlik sayısı kontrol edilmez.

minEventValue

number

Etkinlik sonucunda elde edilen minimum gelir. Gelirin para birimi mülk düzeyinde tanımlanır. Ayarlanmazsa minimum etkinlik değeri kontrol edilmez.

maxEventValue

number

Etkinlik sayesinde elde edilen maksimum gelir. Gelirin para birimi mülk düzeyinde tanımlanır. Ayarlanmazsa maksimum etkinlik değeri kontrol edilmez.

Yöntemler

create

SKAdNetworkConversionValueSchema oluşturur.

delete

Hedef SKAdNetworkConversionValueSchema'yı siler.

get

Tek bir SKAdNetworkConversionValueSchema arar.

list

Bir akıştaki SKAdNetworkConversionValueSchema'yı listeler.

patch

SKAdNetworkConversionValueSchema'yı günceller.