Method: customers.uploadClickConversions

Belirli tıklama dönüşümlerini işler.

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

HTTP isteği

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

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 
{
  "conversions": [
    {
      object (ClickConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "debugEnabled": boolean,
  "jobId": integer
}
Alanlar
conversions[]

object (ClickConversion)

Zorunlu. Yüklenen dönüşümler.
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.
debugEnabled

boolean

Değer true ise API tüm yükleme kontrollerini gerçekleştirir ve bulunursa hata döndürür. Politika, yanlış değerine ayarlanırsa yalnızca temel giriş doğrulamasını gerçekleştirir, sonraki yükleme kontrollerini atlar ve sağlanan userIdentifiers için tıklama bulunmamış olsa bile başarılı sonucu döndürür.

Bu ayar yalnızca GCLID, GBRAID veya WBRAID yerine userIdentifiers kullanılan potansiyel müşteri yüklemeleri için gelişmiş dönüşümleri etkiler. Potansiyel müşteriler için gelişmiş dönüşümleri yüklerken, Google Ads kampanyalarından gelmeyebilecek olanlar da dahil olmak üzere tüm dönüşüm etkinliklerini API'ye yüklemeniz gerekir. Bu alan true olarak ayarlanırsa Google Ads kampanyasından olmayan bir etkinliğin yüklenmesi CLICK_NOT_FOUND hatasıyla sonuçlanır. Bu tür etkinliklerde bu hatalar beklendiğinden, yüklemelerinizin doğru şekilde biçimlendirildiğini doğrulayabilmek için bu alanı false olarak ayarlayın, ancak bir Google Ads kampanyasına ait olmayan tüm dönüşümlerde CLICK_NOT_FOUND hatayı yoksayın. Bu sayede yalnızca ele alabileceğiniz hatalara odaklanabilirsiniz.

Varsayılan değer, false (yanlış) değeridir.
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 UploadClickConversionsResponse öğesinin jobId alanında döndürür.

Yanıt gövdesi

ConversionUploadService.UploadClickConversions 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 (ClickConversionResult)
    }
  ],
  "jobId": string
}
Alanlar
partialFailureError

object (Status)

Kısmi hata modundaki dönüşüm hatalarıyla ilgili hatalar. Tüm hatalar dönüşümlerde oluştuğunda döndürülür. Dönüşümler 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 (ClickConversionResult)

Başarıyla işlenen dönüşümler için döndürülür. 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.

ClickConversion

Tıklama dönüşümü.

JSON gösterimi 
{
  "gbraid": string,
  "wbraid": string,
  "externalAttributionData": {
    object (ExternalAttributionData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "cartData": {
    object (CartData)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "conversionEnvironment": enum (ConversionEnvironment),
  "consent": {
    object (Consent)
  },
  "gclid": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string,
  "orderId": string
}
Alanlar
gbraid

string

iOS 14 ile başlayan ve iOS cihazlardan gelen, uygulama dönüşümleriyle ilişkili tıklamalar için tıklama tanımlayıcısı.
wbraid

string

iOS 14 ile başlayan ve iOS cihazlardan gelen ve web dönüşümleriyle ilişkili tıklamalar için tıklama tanımlayıcısı.
externalAttributionData

object (ExternalAttributionData)

Harici olarak ilişkilendirilen dönüşümler hakkında ek veriler. Bu alan, harici olarak ilişkilendirilmiş bir dönüşüm işlemi olan dönüşümler için gereklidir ancak başka bir şekilde ayarlanmamalıdır.
customVariables[]

object (CustomVariable)

Bu dönüşümle ilişkilendirilen özelleştirilebilen değişkenler.
cartData

object (CartData)

Bu dönüşümle ilişkilendirilen alışveriş sepeti verileri.
userIdentifiers[]

object (UserIdentifier)

Bu dönüşümle ilişkilendirilen kullanıcı tanımlayıcıları. Dönüşüm yüklemelerinde yalnızca hashedEmail ve hashedPhoneNumber desteklenir. Her dönüşüm için maksimum kullanıcı tanımlayıcısı sayısı 5'tir.
conversionEnvironment

enum (ConversionEnvironment)

Bu dönüşümün kaydedildiği ortam, ör. Uygulama veya Web.
consent

object (Consent)

Etkinlikle ilgili izin ayarı.
gclid

string

Bu dönüşümle ilişkilendirilmiş Google tıklama kimliği (gclid).
conversionAction

string

Bu dönüşümle 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.
conversionDateTime

string

Dönüşümün gerçekleştiği tarih ve saat. Tıklama zamanından 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").
conversionValue

number

Reklamveren için dönüşümün değeri.
currencyCode

string

Dönüşüm değeriyle ilişkilendirilen para birimi. Bu, ISO 4217 standardına uygun 3 karakterli para birimi kodudur. Örneğin: USD, EUR.
orderId

string

Dönüşümle ilişkilendirilen sipariş kimliği. Sipariş kimliği, dönüşüm işlemi başına yalnızca bir dönüşüm için kullanılabilir.

ExternalAttributionData

Harici olarak ilişkilendirilen dönüşümler hakkında ek bilgiler içerir.

JSON gösterimi 
{
  "externalAttributionCredit": number,
  "externalAttributionModel": string
}
Alanlar
externalAttributionCredit

number

Dönüşümün Google Ads tıklamasıyla ilişkilendirilen oranını gösterir.
externalAttributionModel

string

İlişkilendirme modelinin adını belirtir.

CartData

Alışveriş sepeti verileri hakkında ek bilgiler içerir.

JSON gösterimi 
{
  "merchantId": string,
  "feedCountryCode": string,
  "feedLanguageCode": string,
  "localTransactionCost": number,
  "items": [
    {
      object (Item)
    }
  ]
}
Alanlar
merchantId

string (int64 format)

Öğelerin yüklendiği Merchant Center Kimliği.
feedCountryCode

string

Öğelerin yüklendiği feed ile ilişkili ülke kodu.
feedLanguageCode

string

Öğelerin yüklendiği feed ile ilişkili dil kodu.
localTransactionCost

number

İşlem düzeyindeki tüm indirimlerin toplamıdır (ör. alışveriş sepetinin tamamı için ücretsiz kargo ve kupon indirimleri). Para birimi kodu, ClickConversion mesajındaki ile aynıdır.
items[]

object (Item)

Satın alınan ürünlerin verileri.

Öğe

Satın alınan ürünlerle ilgili verileri içerir.

JSON gösterimi 
{
  "productId": string,
  "quantity": integer,
  "unitPrice": number
}
Alanlar
productId

string

Öğenin alışveriş kimliği. Merchant Center ürün tanımlayıcısına eşit olmalıdır.
quantity

integer

Satılan ürünlerin sayısıdır.
unitPrice

number

Vergi, gönderim bedeli ve işlem düzeyindeki tüm indirimler hariç birim fiyat. Para birimi kodu, ClickConversion mesajındaki ile aynıdır.

ConversionEnvironment

Yüklenen dönüşümün dönüşüm ortamı.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
APP Dönüşüm bir uygulamada kaydedildi.
WEB Dönüşüm bir web sitesinde kaydedildi.

ClickConversionResult

Başarıyla işlenmiş bir ClickConversion için tanımlayıcı bilgiler.

JSON gösterimi 
{
  "gbraid": string,
  "wbraid": string,
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "gclid": string,
  "conversionAction": string,
  "conversionDateTime": string
}
Alanlar
gbraid

string

iOS 14 ile başlayan ve iOS cihazlardan gelen, uygulama dönüşümleriyle ilişkili tıklamalar için tıklama tanımlayıcısı.
wbraid

string

iOS 14 ile başlayan ve iOS cihazlardan gelen ve web dönüşümleriyle ilişkili tıklamalar için tıklama tanımlayıcısı.
userIdentifiers[]

object (UserIdentifier)

Bu dönüşümle ilişkilendirilen kullanıcı tanımlayıcıları. Dönüşüm yüklemelerinde yalnızca hashedEmail ve hashedPhoneNumber desteklenir. Her dönüşüm için maksimum kullanıcı tanımlayıcısı sayısı 5'tir.
gclid

string

Bu dönüşümle ilişkili Google tıklama kimliği (gclid).
conversionAction

string

Bu dönüşümle ilişkili dönüşüm işleminin kaynak adı.
conversionDateTime

string

Dönüşümün 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").