Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Membuat atau memperbarui CustomerSkAdNetworkConversionValueSchema.

Daftar error yang ditampilkan: AuthenticationError AuthorizationError FieldError InternalError MutateError

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

ID pelanggan yang kumpulan bersamanya sedang diubah.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

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

object (CustomerSkAdNetworkConversionValueSchemaOperation)

Operasi yang akan dilakukan.

validateOnly

boolean

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

Isi respons

Pesan respons untuk customerSkAdNetworkConversionValueSchemas.mutate.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Semua hasil untuk mutate.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

CustomerSkAdNetworkConversionValueSchemaOperation

Operasi pembaruan tunggal 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)
    }
  ]
}
Kolom
appId

string

Wajib. Hanya output. ID aplikasi Apple App Store.

measurementWindowHours

integer

Hanya output. Periode waktu (diukur dalam jam) pasca-penginstalan, yang setelahnya Partner atau pengiklan Atribusi Aplikasi akan berhenti memanggil updateConversionValue.

fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Hanya output. Pemetaan nilai konversi yang mendetail.

FineGrainedConversionValueMappings

Pemetaan untuk nilai konversi yang lebih mendetail.

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

integer

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

conversionValueMapping

object (ConversionValueMapping)

Hanya output. Peristiwa konversi yang dipetakan oleh nilai konversi secara mendetail.

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. Batas maksimum rentang waktu saat pengguna terakhir aktif selama periode pengukuran.

mappedEvents[]

object (Event)

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

Event

Menentukan peristiwa konversi Google yang dipetakan ke 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 diwakili 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. Berupa 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 akan diperbarui dengan nilai konversi ini. Nilai 0 akan dianggap sebagai tidak ditetapkan.

maxEventRevenue

number

Hanya output. Untuk rentang pendapatan, nilai maksimum di 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 rentang yang ditentukan. Nilai 0 akan dianggap sebagai tidak ditetapkan.

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 diubah.