REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Resource: SKAdNetworkConversionValueSchema

Skema nilai konversi SKAdNetwork dari aliran 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 HANYA dari streaming iOS, dan maksimal ada satu turunan tersebut dalam streaming iOS. Format: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

Wajib. Setelan nilai konversi untuk periode postback pertama. Nilai ini berbeda dengan nilai untuk periode postback kedua dan ketiga karena berisi nilai konversi terperinci "Halus" (nilai numerik).

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

postbackWindowTwo

object (PostbackWindow)

Setelan nilai konversi untuk periode postback kedua.

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

Jika enable_postback_window_settings ditetapkan ke 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 untuk mengonfigurasi jendela 3 tanpa menyetel jendela 2. Jika setelan jendela 1 & 2 ditetapkan dan enable_postback_window_settings untuk periode postback ini ditetapkan 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)

Pengurutan kolom berulang akan digunakan untuk memprioritaskan setelan nilai konversi. Entri yang diindeks lebih rendah akan diprioritaskan lebih tinggi. Setelan nilai konversi pertama yang dievaluasi menjadi benar akan dipilih. Setelan ini harus memiliki minimal satu entri jika enable_postback_window_settings disetel ke benar (true). Panjang maksimumnya adalah 128 entri.

postbackWindowSettingsEnabled

boolean

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

coarseValue

enum (CoarseValue)

Wajib. Nilai konversi umum.

Tidak ada jaminan bahwa nilai ini akan bersifat unik.

eventMappings[]

object (EventMapping)

Kondisi peristiwa yang harus dipenuhi agar Nilai Konversi ini tercapai. Kondisi dalam daftar ini digabungkan menggunakan fungsi AND. Kolom ini harus memiliki minimal 1 entri dan maksimal 3 entri, jika periode postback diaktifkan.

lockEnabled

boolean

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

fineValue

integer

Nilai konversi terperinci. Hal 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. Tidak ada jaminan bahwa nilai ini akan bersifat unik.

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

CoarseValue

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 media yang kasar.
COARSE_VALUE_HIGH Nilai dibulatkan 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 digabungkan dengan AND untuk memenuhi syarat 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. 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.