REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Resource: SKAdNetworkConversionValueSchema

Skema nilai konversi SKAdNetwork dari aliran data iOS.

Representasi JSON
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
Kolom
name

string

Hanya output. Nama resource skema. Ini akan menjadi turunan dari HANYA aliran data iOS, dan maksimal bisa ada satu turunan tersebut dalam aliran iOS. Format: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

Wajib. Setelan nilai konversi untuk periode postback pertama. Nilai ini berbeda dari nilai untuk periode postback dua dan tiga karena nilai tersebut berisi nilai konversi yang terperinci (nilai numerik).

Nilai konversi untuk periode postback ini harus ditetapkan. Jendela lain bersifat opsional dan dapat mewarisi setelan jendela ini jika tidak disetel atau dinonaktifkan.

postbackWindowTwo

object (PostbackWindow)

Setelan nilai konversi untuk periode postback kedua.

Kolom ini hanya boleh dikonfigurasi jika Anda perlu menentukan nilai konversi yang berbeda untuk periode postback ini.

Jika enable_postback_window_settings disetel ke salah untuk periode postback ini, nilai dari postbackWindowOne akan digunakan.

postbackWindowThree

object (PostbackWindow)

Setelan nilai konversi untuk periode postback ketiga.

Kolom ini hanya boleh ditetapkan jika pengguna memilih untuk menentukan nilai konversi yang berbeda untuk periode postback ini. Diperbolehkan untuk mengonfigurasi jendela 3 tanpa menyetel jendela 2. Jika setelan jendela 1 & 2 telah disetel dan enable_postback_window_settings untuk jendela postback ini disetel ke salah (false), skema akan mewarisi setelan dari postbackWindowDua.

applyConversionValues

boolean

Jika diaktifkan, GA SDK akan menetapkan nilai konversi menggunakan definisi skema ini, dan skema akan diekspor ke akun Google Ads yang ditautkan ke properti ini. Jika dinonaktifkan, GA SDK tidak akan menetapkan nilai konversi secara otomatis, dan skemanya juga tidak akan diekspor ke Google Ads.

PostbackWindow

Setelan untuk periode postback konversi SKAdNetwork.

Representasi JSON
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
Kolom
conversionValues[]

object (ConversionValues)

Pengurutan kolom berulang akan digunakan untuk memprioritaskan setelan nilai konversi. Entri terindeks yang lebih rendah diprioritaskan lebih tinggi. Setelan nilai konversi pertama yang bernilai benar akan dipilih. Kolom ini harus memiliki setidaknya satu entri jika enable_postback_window_settings disetel ke benar (true). Kolom ini dapat memiliki maksimum 128 entri.

postbackWindowSettingsEnabled

boolean

Jika enable_postback_window_settings benar, conversionValues harus diisi dan akan digunakan untuk menentukan waktu dan cara menetapkan Nilai Konversi di perangkat klien serta mengekspor skema ke akun Google Ads tertaut. Jika salah (false), setelan tidak akan digunakan, tetapi akan dipertahankan jika mungkin digunakan di masa mendatang. Ini harus selalu benar untuk postbackWindowOne.

ConversionValues

Setelan nilai konversi untuk periode postback untuk skema nilai konversi SKAdNetwork.

Representasi JSON
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
Kolom
displayName

string

Nama tampilan nilai konversi SKAdNetwork. Panjang nama tampilan maksimum yang diizinkan adalah 50 unit kode UTF-16.

coarseValue

enum (CoarseValue)

Wajib. Nilai konversi yang terperinci.

Nilai ini tidak dijamin akan unik.

eventMappings[]

object (EventMapping)

Kondisi peristiwa yang harus dipenuhi agar Nilai Konversi ini dapat dicapai. Kondisi dalam daftar ini merupakan kondisi AND. Kolom ini harus memiliki minimal 1 entri dan maksimal 3 entri, jika periode postback diaktifkan.

lockEnabled

boolean

Jika benar, SDK harus mengunci nilai konversi ini selama periode postback saat ini.

fineValue

integer

Nilai konversi yang terperinci. Ini hanya berlaku untuk periode postback pertama. Nilai yang valid adalah [0,63], keduanya inklusif. Nilai ini harus ditetapkan untuk periode postback 1, dan tidak boleh ditetapkan untuk periode postback 2 & 3. Nilai ini tidak dijamin akan unik.

Jika konfigurasi untuk periode postback pertama digunakan kembali untuk periode postback kedua atau ketiga, kolom ini tidak akan memiliki pengaruh apa pun.

CoarseValue

Nilai konversi umum yang ditetapkan pada panggilan updatePostbackConversionValue SDK saat kondisi ConversionValues.event_mappings terpenuhi. Untuk informasi selengkapnya, lihat SKAdNetwork.CoarseConversionValue.

Enum
COARSE_VALUE_UNSPECIFIED Nilai kasar tidak ditentukan.
COARSE_VALUE_LOW Nilai kasar rendah.
COARSE_VALUE_MEDIUM Nilai kasar sedang.
COARSE_VALUE_HIGH Nilai kasar dari tinggi.

EventMapping

Kondisi setelan peristiwa yang cocok dengan peristiwa.

Representasi JSON
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
Kolom
eventName

string

Wajib. Nama peristiwa GA4. Parameter ini harus selalu ditetapkan. Panjang nama tampilan maksimum yang diizinkan adalah 40 unit kode UTF-16.

minEventCount

string (int64 format)

Minimal salah satu dari empat nilai min/maks berikut harus ditetapkan. Nilai-nilai yang ditetapkan akan digabungkan dengan menggunakan AND untuk memenuhi syarat suatu peristiwa. Frekuensi minimum peristiwa terjadi. Jika tidak ditetapkan, jumlah peristiwa minimum tidak akan diperiksa.

maxEventCount

string (int64 format)

Frekuensi maksimum peristiwa terjadi. Jika tidak ditetapkan, jumlah peristiwa maksimum tidak akan diperiksa.

minEventValue

number

Pendapatan minimum yang dihasilkan karena peristiwa. Mata uang pendapatan akan ditentukan di tingkat properti. Jika tidak ditetapkan, nilai peristiwa minimum tidak akan diperiksa.

maxEventValue

number

Pendapatan maksimum yang dihasilkan karena peristiwa. Mata uang pendapatan akan ditentukan di tingkat properti. Jika tidak ditetapkan, nilai peristiwa maksimum tidak akan diperiksa.

Metode

create

Membuat SKAdNetworkConversionValueSchema.

delete

Menghapus target SKAdNetworkConversionValueSchema.

get

Mencari satu SKAdNetworkConversionValueSchema.

list

Mencantumkan SKAdNetworkConversionValueSchema di aliran data.

patch

Mengupdate SKAdNetworkConversionValueSchema.