Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

CustomerSkAdNetworkConversionValueSchema'yı oluşturur veya günceller.

Atılan hataların listesi: AuthenticationError AuthorizationError FieldError InternalError MutateError

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Paylaşılan kümeleri değiştirilen müşterinin kimliği.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean,
  "enableWarnings": boolean
}
Alanlar
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

Gerçekleştirilecek işlem.
validateOnly

boolean

Doğru ise istek doğrulanır ancak yürütülmez. Yalnızca hatalar döndürülür, sonuç döndürülmez.
enableWarnings

boolean

İsteğe bağlı. Değer true ise uyarı vermeyi etkinleştirir. Uyarılar, değiştirme işleminin yürütülmesini engellemeden hata mesajları ve hata kodları döndürür.

Yanıt gövdesi

customerSkAdNetworkConversionValueSchemas.mutate için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  },
  "warning": {
    object (Status)
  }
}
Alanlar
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Değişim için tüm sonuçlar.
warning

object (Status)

Şema doğrulama hatasıyla ilgili ayrıntıları sağlayan engellemeyen hatalar. Yalnızca enableWarnings = true olduğunda döndürülür.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

CustomerSkAdNetworkConversionValueSchemaOperation

CustomerSkAdNetworkConversionValueSchema için tek bir güncelleme işlemi.

JSON gösterimi 
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
Alanlar
update

object (CustomerSkAdNetworkConversionValueSchema)

Güncelleme işlemi: Şemanın geçerli bir kaynak adının olması beklenir.

CustomerSkAdNetworkConversionValueSchema

CustomerSkAdNetworkConversionValueSchema.

JSON gösterimi 
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
Alanlar
resourceName

string

Yalnızca çıkış. Şemanın kaynak adı. CustomerSkAdNetworkConversionValueSchema kaynak adları şu biçimdedir: customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}
schema

object (SkAdNetworkConversionValueSchema)

Yalnızca çıkış. Belirtilen kaynağın şeması.

SkAdNetworkConversionValueSchema

CustomerLink'e özgü SkAdNetworkConversionValueSchema.

JSON gösterimi 
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ],
  "postbackMappings": [
    {
      object (PostbackMapping)
    }
  ]
}
Alanlar
appId

string

Zorunlu. Yalnızca çıkış. Apple App Store uygulama kimliği.
measurementWindowHours

integer

Yalnızca çıkış. Uygulama İlişkilendirme Ortağının veya reklamverenin updateConversionValue çağrısını durdurduğu, yükleme sonrası bir zaman aralığı (saat cinsinden ölçülür).
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Yalnızca çıkış. Ayrıntılı dönüşüm değeri eşlemeleri. Birden fazla dönüşüm aralığını destekleyen 4.0 ve sonraki SkAdNetwork sürümlerinde, ayrıntılı dönüşüm değeri eşlemeleri yalnızca ilk geri gönderme için geçerlidir.
postbackMappings[]

object (PostbackMapping)

Yalnızca çıkış. Birden fazla dönüşüm aralığında geri göndermeler için geri gönderme başına dönüşüm değeri eşlemeleri. Yalnızca 4.0 ve sonraki SkAdNetwork sürümleri için geçerlidir.

FineGrainedConversionValueMappings

Ayrıntılı dönüşüm değeri eşlemeleri.

JSON gösterimi 
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Alanlar
fineGrainedConversionValue

integer

Yalnızca çıkış. Ayrıntılı dönüşüm değeri. Geçerli değerler, kapsayıcı aralıkta [0,63] yer alır.
conversionValueMapping

object (ConversionValueMapping)

Yalnızca çıkış. Ayrıntılı dönüşüm değerinin eşlendiği dönüşüm etkinlikleri.

ConversionValueMapping

Bir dönüşüm değerinden bir veya daha fazla dönüşüm etkinliğine eşlemeyi gösterir.

JSON gösterimi 
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
Alanlar
minTimePostInstallHours

string (int64 format)

Yalnızca çıkış. Kullanıcının ölçüm aralığı sırasında en son etkin olduğu minimum zaman aralığı.
maxTimePostInstallHours

string (int64 format)

Yalnızca çıkış. Ölçüm aralığı sırasında kullanıcının en son etkin olduğu zaman aralığının maksimum değeri.
mappedEvents[]

object (Event)

Yalnızca çıkış. Dönüşüm değeri, çeşitli özelliklere sahip birden fazla etkinlikle eşlenebilir.

Etkinlik

Dönüşüm değerinin eşlendiği bir Google dönüşüm etkinliğini tanımlar.

JSON gösterimi 
{
  "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.
}
Alanlar
mappedEventName

string

Yalnızca çıkış. Bu dönüşüm değeriyle temsil edilen Google etkinliği adı.
currencyCode

string

Yalnızca çıkış. event_geliri için raporlanan para birimi. ISO 4217 standardında üç harfli para birimi kodu (ör. "USD")
Birleştirme alanı revenue_rate. Etkinlik geliri için bir aralık veya belirli bir değer. revenue_rate şunlardan yalnızca biri olabilir:
eventRevenueRange

object (RevenueRange)

Yalnızca çıkış. Etkinlik geliri aralığı.
eventRevenueValue

number

Yalnızca çıkış. Belirli etkinlik gelir değeri.
Birleştirme alanı event_rate. Etkinlik sayacı için bir aralık veya belirli bir değer. event_rate şunlardan yalnızca biri olabilir:
eventOccurrenceRange

object (EventOccurrenceRange)

Yalnızca çıkış. Etkinlik sayacı aralığı.
eventCounter

string (int64 format)

Yalnızca çıkış. Belirli etkinlik sayacı değerleri içindir.

RevenueRange

Gelir değerleri için bir aralık tanımlar.

JSON gösterimi 
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
Alanlar
minEventRevenue

number

Yalnızca çıkış. Gelir aralıkları için, bu dönüşüm değerinin güncelleneceği currencyCode cinsinden minimum değer. 0 değeri, ayarlanmamış olarak kabul edilir.
maxEventRevenue

number

Yalnızca çıkış. Gelir aralıkları için, bu dönüşüm değerinin güncelleneceği currencyCode cinsinden maksimum değer. 0 değeri, ayarlanmamış olarak kabul edilir.

EventOccurrenceRange

Etkinlik sayacı değerleri için bir aralık tanımlar.

JSON gösterimi 
{
  "minEventCount": string,
  "maxEventCount": string
}
Alanlar
minEventCount

string (int64 format)

Yalnızca çıkış. Etkinlik sayacı aralıkları için tanımlanan aralığın minimum değeri. 0 değeri, ayarlanmamış olarak kabul edilir.
maxEventCount

string (int64 format)

Yalnızca çıkış. Etkinlik sayacı aralıkları için tanımlanan aralığın maksimum değeri. 0 değeri, ayarlanmamış olarak kabul edilir.

PostbackMapping

Birden fazla dönüşüm aralığındaki her geri gönderme için eşlemeler.

JSON gösterimi 
{
  "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.
}
Alanlar
postbackSequenceIndex

integer

Yalnızca çıkış. Geri gönderme sırasını gösteren 0 tabanlı dizin. Geçerli değerler, kapsayıcı aralıkta [0,2] yer alır.
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

Yalnızca çıkış. Tüm ayrıntılı dönüşüm değerleri için dönüşüm değeri eşlemeleri.
Birleştirme alanı lock_window_trigger. Dönüşüm aralığını kilitlemek için kullanılan etkinlik veya dönüşüm değeri. lock_window_trigger şunlardan yalnızca biri olabilir:
lockWindowCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

Yalnızca çıkış. Dönüşüm aralığı kilidini tetikleyen yaklaşık ayrıntılı dönüşüm değeri.
lockWindowFineConversionValue

integer

Yalnızca çıkış. Dönüşüm aralığı kilidini tetikleyen ayrıntılı dönüşüm değeri.
lockWindowEvent

string

Yalnızca çıkış. Dönüşüm aralığı kilidini tetikleyen etkinlik adı.

CoarseGrainedConversionValueMappings

Genel taneli dönüşüm değerleri için eşlemeler.

JSON gösterimi 
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Alanlar
lowConversionValueMapping

object (ConversionValueMapping)

Yalnızca çıkış. "Düşük" yaklaşık dönüşüm değeri için eşleme.
mediumConversionValueMapping

object (ConversionValueMapping)

Yalnızca çıkış. "Orta" yaklaşık dönüşüm değeri için eşleme.
highConversionValueMapping

object (ConversionValueMapping)

Yalnızca çıkış. "Yüksek" yaklaşık dönüşüm değeri için eşleme.

MutateCustomerSkAdNetworkConversionValueSchemaResult

CustomerSkAdNetworkConversionValueSchema dönüşümünün sonucu.

JSON gösterimi 
{
  "resourceName": string,
  "appId": string
}
Alanlar
resourceName

string

Değiştirilen müşterinin kaynak adı.
appId

string

Değiştirilen SkanConversionValue öğesinin uygulama kimliği.