Method: customers.uploadConversionAdjustments

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

Oluşturulan hataların listesi: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

HTTP isteği

POST https://googleads.googleapis.com/v14/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

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
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 tümü geçerliyse ve yalnızca geçerliyse 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 değerine ayarlanırsa istek doğrulanır ancak yürütülmez. Sonuçlar değil, yalnızca hatalar döndürülü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 ayarlaması 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 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şlenmiş dönüşüm ayarlamaları için iade edilir. 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)

Düzenlemeler için, sipariş kimliği belirtilmedikçe raporlanmış bir dönüşümü benzersiz bir şekilde tanımlar. Ayarlama Türü ENHANCEMENT ise bu değer isteğe bağlıdır ancak sipariş kimliğine ek olarak ayarlanabilir.
adjustmentType

enum (ConversionAdjustmentType)

Düzenleme türü.
restatementValue

object (RestatementValue)

Dönüşüm değerini yeniden belirtmek için gereken bilgiler. Yeniden belirlemeler için gereklidir. Geri çekme işlemleri için verilmemelidir. Geri çekme için sağlanırsa hata döndürülür. NOT: Farklı bir düzenlenmiş değerle ikinci bir değer ayarlaması yüklemek istiyorsanız, ayarlamanın yeni ve daha yeni bir zamanı olması gerekir. Aksi takdirde, önceki yeniden belirlemenin kopyası olarak değerlendirilir ve yoksayılır.
userIdentifiers[]

object (UserIdentifier)

Orijinal dönüşümü geliştirecek kullanıcı tanımlayıcıları. ConversionAdjustUploadService yalnızca geliştirmelerdeki kullanıcı tanımlayıcılarını kabul eder. Her geliştirme için maksimum kullanıcı tanımlayıcısı sayısı 5'tir.
orderId

string

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

string

Bu dönüşüm ayarlamasıyla ilişkili dönüşüm işleminin kaynak adı. Not: Bu kaynak adı, bir müşteri kimliği ve bir dönüşüm işlemi kimliğinden oluşsa da doğrulama işleminde müşteri kimliği yok sayı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" (ör. "2019-01-01 12:32:45-08:00") şeklindedir.
userAgent

string

Orijinal dönüşümü geliştirecek kullanıcı aracısı. Bu değer, kullanıcınız web sayfanızda dönüşüm gerçekleştirirken kullanıcının HTTP istek başlığında bulunabilir. Ö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 dönüşüm, orijinal dönüşümü gönderen isteğin kullanıcı aracısıyla eşleşmelidir. Böylece, hem dönüşüm hem de geliştirme aynı cihazla ya da her ikisi de cihazlar arası olarak ilişkilendirilir.

GclidDateTimePair

Sipariş kimliği belirtilmedikçe 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" (ör. "2019-01-01 12:32:45-08:00") şeklindedir.

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ü, hem toplam değerinin hem de sayısının sıfır olacak şekilde olumsuzlar.
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 kullanıcı tanımlayıcıları ve kullanıcı aracısıyla mevcut dönüşümü tamamlar.

RestatementValue

Dönüşüm değerini yeniden belirlemek için gereken bilgileri içerir.

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

number

Yeniden ayarlanan dönüşüm değeri. Bu, yeniden belirleme işleminden sonraki dönüşümün değeridir. Örneğin, bir dönüşümün 100 olan değerini 70 olarak değiştirmek için 70 şeklinde düzenlenmiş bir değer raporlanmalıdır. NOT: Farklı bir düzenlenmiş değerle ikinci bir değer ayarlaması yüklemek istiyorsanız, ayarlamanın yeni ve daha yeni bir zamanı olması gerekir. Aksi takdirde, önceki yeniden belirlemenin kopyası olarak değerlendirilir ve yoksayılır.
currencyCode

string

Yeniden ayarlanan değerin para birimi. Sağlanmazsa dönüşüm işlemindeki varsayılan para birimi kullanılır. Ayarlanmamışsa hesap para birimi kullanılır. ISO 4217 standartları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 parametresi ve dönüşüm tarihi.
orderId

string

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

enum (ConversionAdjustmentType)

Düzenleme türü.
conversionAction

string

Bu dönüşüm ayarlamasıyla 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" (ör. "2019-01-01 12:32:45-08:00") şeklindedir.