Method: customers.uploadCallConversions

Belirli telefon araması dönüşümlerini işler.

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

HTTP isteği

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

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

object (CallConversion)

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

ConversionUploadService.UploadCallConversions 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 (CallConversionResult)
    }
  ]
}
Alanlar
partialFailureError

object (Status)

Kısmi hata modundaki dönüşüm hatalarıyla ilgili hatalar. Dönüşümlerin içinde tüm hatalar oluştuğunda döndürülür. Dönüşümler dışında herhangi bir hata oluşursa (örneğin, 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 (CallConversionResult)

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.

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.

CallConversion

Telefon araması dönüşümü.

JSON gösterimi 
{
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "consent": {
    object (Consent)
  },
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
Alanlar
customVariables[]

object (CustomVariable)

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

object (Consent)

Etkinlikle ilgili izin ayarı.
callerId

string

Bu aramanın yapıldığı arayan kimliği. Arayan kimliğinin "+" işaretiyle birlikte E.164 biçiminde olması beklenir. Örneğin, "+16502531234".
callStartDateTime

string

Aramanı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.
conversionAction

string

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

string

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

number

Dönüşümün reklamveren için değeri.
currencyCode

string

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

CallConversionResult

Başarıyla işlenmiş bir Arama Dönüşümü Yüklemesi için tanımlama bilgileri.

JSON gösterimi 
{
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string
}
Alanlar
callerId

string

Bu aramanın yapıldığı arayan kimliği. Arayan kimliğinin "+" işaretinden önce E.164 biçiminde olması beklenir.
callStartDateTime

string

Aramanın 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.
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" (ör. "2019-01-01 12:32:45-08:00") şeklindedir.