Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Membuat atau memperbarui CustomerSkAdNetworkConversionValueSchema.

Daftar error yang ditampilkan: AuthenticationError AuthorizationError FieldError InternalError MutateError

Permintaan HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

ID pelanggan yang kumpulan bersamanya diubah.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean,
  "enableWarnings": boolean
}
Kolom
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

Operasi yang akan dilakukan.
validateOnly

boolean

Jika true (benar), permintaan divalidasi tetapi tidak dijalankan. Hanya error yang ditampilkan, bukan hasil.
enableWarnings

boolean

Opsional. Jika true (benar), mengaktifkan pengembalian peringatan. Peringatan menampilkan pesan error dan kode error tanpa memblokir eksekusi operasi mutasi.

Isi respons

Pesan respons untuk customerSkAdNetworkConversionValueSchemas.mutate.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  },
  "warning": {
    object (Status)
  }
}
Kolom
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Semua hasil untuk mutasi.
warning

object (Status)

Error non-pemblokiran yang memberikan detail kegagalan validasi skema. Ditampilkan hanya jika enableWarnings = true.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/adwords

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

CustomerSkAdNetworkConversionValueSchemaOperation

Satu operasi pembaruan untuk CustomerSkAdNetworkConversionValueSchema.

Representasi JSON 
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
Kolom
update

object (CustomerSkAdNetworkConversionValueSchema)

Operasi update: Skema diharapkan memiliki nama resource yang valid.

CustomerSkAdNetworkConversionValueSchema

CustomerSkAdNetworkConversionValueSchema.

Representasi JSON 
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
Kolom
resourceName

string

Hanya output. Nama resource skema. Nama resource CustomerSkAdNetworkConversionValueSchema memiliki bentuk: customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}
schema

object (SkAdNetworkConversionValueSchema)

Hanya output. Skema untuk resource yang ditentukan.

SkAdNetworkConversionValueSchema

SkAdNetworkConversionValueSchema khusus CustomerLink.

Representasi JSON 
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ],
  "postbackMappings": [
    {
      object (PostbackMapping)
    }
  ]
}
Kolom
appId

string

Wajib. Hanya output. ID aplikasi Apple App Store.
measurementWindowHours

integer

Hanya output. Periode waktu (diukur dalam jam) setelah penginstalan, setelah Partner Atribusi Aplikasi atau pengiklan berhenti memanggil updateConversionValue.
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Hanya output. Pemetaan nilai konversi yang mendetail. Untuk SkAdNetwork versi >= 4.0 yang mendukung beberapa periode konversi, pemetaan nilai konversi yang terperinci hanya berlaku untuk postback pertama.
postbackMappings[]

object (PostbackMapping)

Hanya output. Pemetaan nilai konversi per postback untuk postback di beberapa periode konversi. Hanya berlaku untuk SkAdNetwork versi >= 4.0.

FineGrainedConversionValueMappings

Pemetaan untuk nilai konversi yang terperinci.

Representasi JSON 
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Kolom
fineGrainedConversionValue

integer

Hanya output. Nilai konversi yang terperinci. Nilai yang valid berada dalam rentang inklusif [0,63].
conversionValueMapping

object (ConversionValueMapping)

Hanya output. Peristiwa konversi yang dipetakan oleh nilai konversi terperinci.

ConversionValueMapping

Mewakili pemetaan dari satu nilai konversi ke satu atau beberapa peristiwa konversi.

Representasi JSON 
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
Kolom
minTimePostInstallHours

string (int64 format)

Hanya output. Rentang waktu minimum saat pengguna terakhir aktif selama periode pengukuran.
maxTimePostInstallHours

string (int64 format)

Hanya output. Rentang waktu maksimum saat pengguna terakhir aktif selama periode pengukuran.
mappedEvents[]

object (Event)

Hanya output. Nilai konversi dapat dipetakan ke beberapa peristiwa dengan berbagai atribut.

Acara

Menentukan peristiwa konversi Google yang menjadi tujuan pemetaan nilai konversi.

Representasi JSON 
{
  "mappedEventName": string,
  "currencyCode": string,

  // Union field revenue_rate can be only one of the following:
  "eventRevenueRange": {
    object (RevenueRange)
  },
  "eventRevenueValue": number
  // End of list of possible types for union field revenue_rate.

  // Union field event_rate can be only one of the following:
  "eventOccurrenceRange": {
    object (EventOccurrenceRange)
  },
  "eventCounter": string
  // End of list of possible types for union field event_rate.
}
Kolom
mappedEventName

string

Hanya output. Nama peristiwa Google yang direpresentasikan oleh nilai konversi ini.
currencyCode

string

Hanya output. Mata uang yang dilaporkan untuk event_revenue. Kode mata uang tiga huruf ISO 4217, misalnya, "USD"
Kolom union revenue_rate. Rentang atau nilai tertentu untuk pendapatan peristiwa. revenue_rate hanya ada berupa salah satu diantara berikut:
eventRevenueRange

object (RevenueRange)

Hanya output. Rentang pendapatan peristiwa.
eventRevenueValue

number

Hanya output. Nilai pendapatan peristiwa tertentu.
Kolom union event_rate. Rentang atau nilai spesifik untuk penghitung peristiwa. event_rate hanya ada berupa salah satu diantara berikut:
eventOccurrenceRange

object (EventOccurrenceRange)

Hanya output. Rentang penghitung peristiwa.
eventCounter

string (int64 format)

Hanya output. Untuk nilai penghitung peristiwa tertentu.

RevenueRange

Menentukan rentang untuk nilai pendapatan.

Representasi JSON 
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
Kolom
minEventRevenue

number

Hanya output. Untuk rentang pendapatan, nilai minimum di currencyCode yang nilai konversinya akan diperbarui. Nilai 0 akan dianggap sebagai tidak ditetapkan.
maxEventRevenue

number

Hanya output. Untuk rentang pendapatan, nilai maksimum dalam currencyCode yang nilai konversinya akan diperbarui. Nilai 0 akan dianggap sebagai tidak ditetapkan.

EventOccurrenceRange

Menentukan rentang untuk nilai penghitung peristiwa.

Representasi JSON 
{
  "minEventCount": string,
  "maxEventCount": string
}
Kolom
minEventCount

string (int64 format)

Hanya output. Untuk rentang penghitung peristiwa, nilai minimum dari rentang yang ditentukan. Nilai 0 akan dianggap sebagai tidak ditetapkan.
maxEventCount

string (int64 format)

Hanya output. Untuk rentang penghitung peristiwa, maksimum dari rentang yang ditentukan. Nilai 0 akan dianggap sebagai tidak ditetapkan.

PostbackMapping

Pemetaan untuk setiap postback dalam beberapa periode konversi.

Representasi JSON 
{
  "postbackSequenceIndex": integer,
  "coarseGrainedConversionValueMappings": {
    object (CoarseGrainedConversionValueMappings)
  },

  // Union field lock_window_trigger can be only one of the following:
  "lockWindowCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "lockWindowFineConversionValue": integer,
  "lockWindowEvent": string
  // End of list of possible types for union field lock_window_trigger.
}
Kolom
postbackSequenceIndex

integer

Hanya output. indeks berbasis 0 yang menunjukkan urutan postback. Nilai yang valid berada dalam rentang inklusif [0,2].
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

Hanya output. Pemetaan nilai konversi untuk semua nilai konversi yang terperinci.
Kolom union lock_window_trigger. Nilai peristiwa atau konversi yang digunakan untuk mengunci periode konversi. lock_window_trigger hanya ada berupa salah satu diantara berikut:
lockWindowCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

Hanya output. Nilai konversi terperinci yang memicu kunci periode konversi.
lockWindowFineConversionValue

integer

Hanya output. Nilai konversi terperinci yang memicu kunci periode konversi.
lockWindowEvent

string

Hanya output. Nama peristiwa yang memicu kunci periode konversi.

CoarseGrainedConversionValueMappings

Pemetaan untuk nilai konversi yang terperinci.

Representasi JSON 
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Kolom
lowConversionValueMapping

object (ConversionValueMapping)

Hanya output. Pemetaan untuk nilai konversi kasar "rendah".
mediumConversionValueMapping

object (ConversionValueMapping)

Hanya output. Pemetaan untuk nilai konversi kasar "sedang".
highConversionValueMapping

object (ConversionValueMapping)

Hanya output. Pemetaan untuk nilai konversi kasar "tinggi".

MutateCustomerSkAdNetworkConversionValueSchemaResult

Hasil untuk mutasi CustomerSkAdNetworkConversionValueSchema.

Representasi JSON 
{
  "resourceName": string,
  "appId": string
}
Kolom
resourceName

string

Nama resource pelanggan yang telah diubah.
appId

string

ID Aplikasi SkanConversionValue yang diubah.