REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Resource: SKAdNetworkConversionValueSchema

Skema nilai konversi SKAdNetwork untuk aliran iOS.

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

string

ID. Nama resource skema. Ini akan menjadi turunan dari HANYA streaming iOS, dan paling banyak ada satu turunan tersebut di bawah streaming 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 berisi nilai konversi yang "Presisi" (nilai numerik).

Nilai konversi untuk periode postback ini harus ditetapkan. Jendela lainnya 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 ada kebutuhan untuk menentukan nilai konversi yang berbeda untuk periode postback ini.

Jika enable_postback_window_settings disetel ke salah (false) 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. Anda diizinkan mengonfigurasi jendela 3 tanpa menyetel jendela 2. Jika setelan periode 1 & 2 ditetapkan dan enable_postback_window_settings untuk periode postback ini disetel ke salah (false), skema akan mewarisi setelan dari postbackWindowTwo.

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 otomatis menetapkan nilai konversi, dan skema 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)

Urutan kolom berulang akan digunakan untuk memprioritaskan setelan nilai konversi. Entri yang diindeks lebih rendah diprioritaskan lebih tinggi. Setelan nilai konversi pertama yang dievaluasi sebagai benar akan dipilih. Harus memiliki setidaknya satu entri jika enable_postback_window_settings disetel ke benar (true). Dapat memiliki maksimum 128 entri.

postbackWindowSettingsEnabled

boolean

Jika enable_postback_window_settings bernilai benar (true), conversionValues harus diisi dan akan digunakan untuk menentukan kapan dan cara menetapkan Nilai Konversi di perangkat klien dan mengekspor skema ke akun Google Ads yang tertaut. Jika salah (false), setelan tidak digunakan, tetapi dipertahankan jika mungkin digunakan pada masa mendatang. Hal 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 umum.

Nilai ini tidak dijamin unik.

eventMappings[]

object (EventMapping)

Kondisi peristiwa yang harus dipenuhi agar Nilai Konversi ini tercapai. Kondisi dalam daftar ini digabungkan dengan logika AND. Harus memiliki minimal 1 entri dan maksimal 3 entri, jika jendela postback diaktifkan.

lockEnabled

boolean

Jika benar, SDK harus dikunci ke nilai konversi ini untuk periode postback saat ini.

fineValue

integer

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

Jika konfigurasi untuk periode postback pertama digunakan kembali untuk periode postback kedua atau ketiga, kolom ini tidak akan berpengaruh.

CoarseValue

Kumpulan nilai konversi kasar yang ditetapkan pada panggilan SDK updatePostbackConversionValue saat kondisi ConversionValues.event_mappings terpenuhi. Untuk mengetahui informasi selengkapnya, lihat SKAdNetwork.CoarseConversionValue.

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

EventMapping

Kondisi setelan peristiwa agar cocok dengan peristiwa.

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

string

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

minEventCount

string (int64 format)

Setidaknya salah satu dari empat nilai min/maks berikut harus ditetapkan. Nilai yang ditetapkan akan di-AND-kan bersama untuk memenuhi syarat peristiwa. Frekuensi minimum terjadinya peristiwa. Jika tidak ditetapkan, jumlah minimum peristiwa tidak akan diperiksa.

maxEventCount

string (int64 format)

Jumlah maksimum frekuensi terjadinya peristiwa. Jika tidak disetel, jumlah peristiwa maksimum tidak akan diperiksa.

minEventValue

number

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

maxEventValue

number

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

Metode

create

Membuat SKAdNetworkConversionValueSchema.

delete

Menghapus target SKAdNetworkConversionValueSchema.

get

Mencari satu SKAdNetworkConversionValueSchema.

list

Mencantumkan SKAdNetworkConversionValueSchema di aliran.

patch

Memperbarui SKAdNetworkConversionValueSchema.