REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Resource: SKAdNetworkConversionValueSchema

Skema nilai konversi SKAdNetwork untuk 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. Saluran ini HANYA akan menjadi turunan dari aliran data iOS dan maksimum satu turunan tersebut pada aliran data iOS. Format: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

Wajib. Setelan nilai konversi untuk periode postback pertama. Ini berbeda dari nilai untuk periode postback dua dan tiga karena keduanya mengandung nilai konversi terperinci (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 nilai konversi yang berbeda perlu ditentukan 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. Diizinkan mengkonfigurasi jendela 3 tanpa mengatur jendela 2. Jika jendela 1 & 2 setelan disetel dan enable_postback_window_settings untuk periode postback ini disetel ke salah, 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 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)

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 (true) akan dipilih. Aplikasi harus memiliki minimal satu entri jika enable_postback_window_settings disetel ke benar (true). Entri dapat memiliki maksimum 128 entri.

postbackWindowSettingsEnabled

boolean

Jika enable_postback_window_settings disetel ke benar, conversionValues harus diisi dan akan digunakan untuk menentukan waktu dan cara menetapkan Nilai Konversi di perangkat klien dan mengekspor skema ke akun Google Ads tertaut. Jika salah (false), setelan tidak akan digunakan, tetapi akan dipertahankan jika setelan tersebut dapat digunakan pada 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 maksimum nama tampilan yang diizinkan adalah 50 unit kode UTF-16.

coarseValue

enum (CoarseValue)

Wajib. Nilai konversi terperinci.

Nilai ini tidak dijamin unik.

eventMappings[]

object (EventMapping)

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

lockEnabled

boolean

Jika true (benar), SDK akan terkunci ke nilai konversi ini untuk periode postback saat ini.

fineValue

integer

Nilai konversi yang terperinci. Ini hanya berlaku untuk periode postback pertama. Nilainya yang valid adalah [0,63], keduanya inklusif. Ini harus disetel untuk periode postback 1, dan tidak boleh disetel 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

Nilai konversi umum yang ditetapkan pada panggilan updatePostbackConversionValue SDK jika 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 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 GA4. Nilainya 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. Kumpulan nilai akan digabungkan dengan AND agar memenuhi syarat untuk 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 tersebut. 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 tersebut. 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

Memperbarui SKAdNetworkConversionValueSchema.