Method: customers.uploadConversionAdjustments

Belirtilen dönüşüm ayarlamalarını işler.

Atılan hataların listesi: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

HTTP isteği

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

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

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Yüklemeyi gerçekleştiren müşterinin kimliği.

İstek içeriği

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

JSON gösterimi 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "jobId": integer
}
Alanlar
conversionAdjustments[]

object (ConversionAdjustment)

Zorunlu. Yüklenen dönüşüm ayarlamaları.
partialFailure

boolean

Zorunlu. Doğru değerine ayarlanırsa başarılı işlemler gerçekleştirilir ve geçersiz işlemler hata döndürür. Yanlış değerine ayarlanırsa tüm işlemler, yalnızca hepsinin geçerli olması durumunda tek bir işlemde gerçekleştirilir. Her zaman doğru değerine ayarlanmalıdır. Kısmi hata hakkında daha fazla bilgi için https://developers.google.com/google-ads/api/docs/best-practices/partial-failures adresine bakın.
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.
jobId

integer

İsteğe bağlı. İş kimliğini ayarlamak için isteğe bağlı giriş. Değer sağlanırsa, 2^31'den küçük, negatif olmayan bir sayı olmalıdır. Bu alan belirtilmezse API, [2^31, (2^63)-1] aralığında bir iş kimliği oluşturur. API, bu isteğin değerini UploadConversionAdjustmentsResponse öğesinin jobId alanında döndürür.

Yanıt gövdesi

ConversionAdjustmentUploadService.UploadConversionAdjustments için yanıt mesajı.

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

JSON gösterimi 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (ConversionAdjustmentResult)
    }
  ],
  "jobId": string
}
Alanlar
partialFailureError

object (Status)

Kısmi hata modundaki dönüşüm ayarlama hatalarıyla ilgili hatalar. Düzenlemelerin içinde tüm hatalar oluştuğunda döndürülür. Düzenlemelerin dışında herhangi bir hata oluşursa (ör. kimlik doğrulama hataları) RPC düzeyinde bir hata döndürürüz. Kısmi hata hakkında daha fazla bilgi için https://developers.google.com/google-ads/api/docs/best-practices/partial-failures adresine bakın.
results[]

object (ConversionAdjustmentResult)

Başarıyla işlenen dönüşüm ayarlamaları için döndürüldü. Hata alan satırlar için protokol boş olur. verifyOnly doğru olduğunda sonuçlar döndürülmez.
jobId

string (int64 format)

Yükleme grubunun iş kimliği.

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.

ConversionAdjustment

Dönüşüm ayarlaması.

JSON gösterimi 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
Alanlar
gclidDateTimePair

object (GclidDateTimePair)

Ayarlamalar için, sipariş kimliği belirtilmeden raporlanan bir dönüşümü benzersiz bir şekilde tanımlar. TuneType, ENHANCEMENT ise bu değer isteğe bağlıdır ancak orderId'ye ek olarak ayarlanabilir.
adjustmentType

enum (ConversionAdjustmentType)

Düzenleme türü.
restatementValue

object (RestatementValue)

Dönüşümün değerini yeniden belirtmek için gereken bilgiler. Yeniden belirleme işlemleri için gereklidir. Geri çekme işlemleri için sağlanmamalıdır. Geri çekme için sağlanırsa hata döndürülür. NOT: Farklı bir düzenlenmiş değere sahip ikinci bir yeniden belirleme işlemi yüklemek istiyorsanız düzenlemenin yeni ve daha yakın bir zamanda oluşması gerekir. Aksi takdirde, önceki yeniden belirlemenin kopyası olarak değerlendirilir ve yok sayılır.
userIdentifiers[]

object (UserIdentifier)

Orijinal dönüşümü geliştirecek kullanıcı tanımlayıcıları. ConversionSettingUploadService yalnızca geliştirmelerdeki kullanıcı tanımlayıcılarını kabul eder. Her geliştirme için maksimum 5 kullanıcı tanımlayıcısına izin verilir.
orderId

string

Ayarlanacak dönüşümün sipariş kimliği. Dönüşüm, belirtilen bir sipariş kimliği ile raporlandıysa burada tanımlayıcı olarak bu sipariş kimliği kullanılmalıdır. Geliştirmeler için sipariş kimliği gereklidir.
conversionAction

string

Bu dönüşüm ayarlamayla ilişkili dönüşüm işleminin kaynak adı. Not: Bu kaynak adı hem müşteri kimliği hem de dönüşüm işlemi kimliğinden oluşur. Ancak doğrulama işleminde müşteri kimliği yoksayılır ve dönüşüm işleminin tek tanımlayıcısı olarak dönüşüm işlemi kimliği kullanılır.
adjustmentDateTime

string

Düzenlemenin gerçekleştiği tarih ve saat. conversionDateTime tarihinden sonra olmalıdır. Saat dilimi belirtilmelidir. Biçim "yyyy-aa-gg ss:dd:ss+|-ss:dd" şeklindedir (ör. "2019-01-01 12:32:45-08:00").
userAgent

string

Orijinal dönüşümü geliştirecek kullanıcı aracısı. Bu bilgi, kullanıcınız web sayfanızda dönüşüm gerçekleştirdiğinde onun HTTP istek başlığında bulunur. Örnek, "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2, Mac OS X gibi)". Kullanıcı aracısı, yalnızca kullanıcı tanımlayıcıları olan geliştirmelerde belirtilebilir. Bu değer, orijinal dönüşümü gönderen isteğin kullanıcı aracısıyla eşleşmelidir. Böylece, dönüşüm ve geliştirmenin her ikisi de aynı cihazla veya her ikisi de cihazlar arası olarak ilişkilendirilmelidir.

GclidDateTimePair

Sipariş kimliği belirtilmeden bildirilen bir dönüşümü benzersiz olarak tanımlar.

JSON gösterimi 
{
  "gclid": string,
  "conversionDateTime": string
}
Alanlar
gclid

string

Bu ayarlama için orijinal dönüşümle ilişkili Google tıklama kimliği (gclid).
conversionDateTime

string

Bu ayarlama için orijinal dönüşümün gerçekleştiği tarih ve saat. Saat dilimi belirtilmelidir. Biçim "yyyy-aa-gg ss:dd:ss+|-ss:dd" şeklindedir (ör. "2019-01-01 12:32:45-08:00").

ConversionAdjustmentType

Reklamverenlerin daha önce raporladıkları dönüşümleri ayarlamak için yapabileceği farklı işlemler. Geri çekmeler bir dönüşümü geçersiz kılar. Yeniden belirleme işlemleri, bir dönüşümün değerini değiştirir.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Bu sürümde bilinmeyen değeri temsil eder.
RETRACTION Bir dönüşümü, toplam değeri ve sayısı sıfır olacak şekilde olumsuz yapar.
RESTATEMENT Dönüşümün değerini değiştirir.
ENHANCEMENT Google tarafından dönüşüm sayısını artırmak için kullanılabilecek, sağlanan kullanıcı tanımlayıcıları ve kullanıcı aracısıyla mevcut bir dönüşümü tamamlar.

RestatementValue

Bir dönüşümün değerini yeniden belirtmek için gereken bilgileri içerir.

JSON gösterimi 
{
  "adjustedValue": number,
  "currencyCode": string
}
Alanlar
adjustedValue

number

Yeniden ayarlanan dönüşüm değeri. Bu, dönüşümün yeniden belirlemeden sonraki değeridir. Örneğin, bir dönüşümün 100 olan değerini 70 olarak değiştirmek için 70 şeklinde ayarlanmış bir değer raporlanmalıdır. NOT: Farklı bir düzenlenmiş değere sahip ikinci bir yeniden belirleme işlemi yüklemek istiyorsanız düzenlemenin yeni ve daha yakın bir zamanda oluşması gerekir. Aksi takdirde, önceki yeniden belirlemenin kopyası olarak değerlendirilir ve yok sayılır.
currencyCode

string

Yeniden ayarlanan değerin para birimi. Belirtilmezse dönüşüm işleminin varsayılan para birimi kullanılır. Ayarlanmamışsa hesap para birimi kullanılır. ISO 4217 standardına uygun 3 karakterli para birimi kodudur (ör. USD veya EUR).

ConversionAdjustmentResult

Başarıyla işlenmiş bir Dönüşüm Ayarlamayı tanımlayan bilgiler.

JSON gösterimi 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
Alanlar
gclidDateTimePair

object (GclidDateTimePair)

Dönüşümün gclid ve dönüşüm tarihi saati.
orderId

string

Ayarlanacak dönüşümün sipariş kimliği.
adjustmentType

enum (ConversionAdjustmentType)

Düzenleme türü.
conversionAction

string

Bu dönüşüm ayarlamayla ilişkili dönüşüm işleminin kaynak adı.
adjustmentDateTime

string

Düzenlemenin gerçekleştiği tarih ve saat. Biçim "yyyy-aa-gg ss:dd:ss+|-ss:dd" şeklindedir (ör. "2019-01-01 12:32:45-08:00").