- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- CallConversion
- CallConversionResult
- Deneyin.
Belirtilen arama dönüşümlerini 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}:uploadCallConversions
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
customerId |
Zorunlu. Yüklemeyi gerçekleştiren müşterinin kimliği. |
İstek içeriği
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi |
---|
{
"conversions": [
{
object ( |
Alanlar | |
---|---|
conversions[] |
Zorunlu. Yüklenen dönüşümler. |
partialFailure |
Zorunlu. Değer true ise başarılı işlemler gerçekleştirilir ve geçersiz işlemler hata döndürür. False (yanlış) değerine ayarlanırsa tüm işlemler, yalnızca hepsinin geçerli olması koşuluyla tek bir işlemde gerçekleştirilir. Her zaman doğru değerine ayarlanmalıdır. Kısmi hata ile ilgili daha fazla bilgi için https://developers.google.com/google-ads/api/docs/best-practices/partial-failures adresine bakın. |
validateOnly |
True (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. |
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 ( |
Alanlar | |
---|---|
partialFailureError |
Kısmi hata modundaki dönüşüm hatalarıyla ilgili hatalar. Dönüşümlerde tüm hatalar oluştuğunda döndürülür. Dönüşümlerin 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 ile ilgili daha fazla bilgi için https://developers.google.com/google-ads/api/docs/best-practices/partial-failures adresine bakın. |
results[] |
Başarıyla işlenen dönüşümler için döndürüldü. Hata alan satırlar için protokol boş olur. VerifyOnly true (doğru) olduğunda sonuç 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
CallConversion
Telefon araması dönüşümü.
JSON gösterimi |
---|
{ "customVariables": [ { object ( |
Alanlar | |
---|---|
customVariables[] |
Bu dönüşümle ilişkilendirilen özelleştirilebilen değişkenler. |
consent |
Etkinlik için izin ayarı. |
callerId |
Bu aramanın yapıldığı arayan kimliği. Arayan kimliğinin önünde "+" işareti bulunan E.164 biçiminde olması gerekir ekleyin, örneğin, "+16502531234". |
callStartDateTime |
Aramanın gerçekleştiği tarih ve saat. Saat dilimi belirtilmelidir. Biçim "yyyy-aa-gg ss:dd:ss+|-ss:dd" şeklindedir. Örneğin, "2019-01-01 12:32:45-08:00". |
conversionAction |
Bu dönüşümle ilişkili dönüşüm işleminin kaynak adı. Not: Bu kaynak adı bir müşteri kimliği ve dönüşüm işlemi kimliğinden oluşsa da doğrulama için müşteri kimliği yoksayılır ve dönüşüm işlemi kimliği, dönüşüm işleminin tek tanımlayıcısı olarak kullanılır. |
conversionDateTime |
Dönüşümün gerçekleştiği tarih ve saat. Arama saatinden sonra olmalıdır. Saat dilimi belirtilmelidir. Biçim "yyyy-aa-gg ss:dd:ss+|-ss:dd" şeklindedir. Örneğin, "2019-01-01 12:32:45-08:00". |
conversionValue |
Reklamveren için dönüşümün değeri. |
currencyCode |
Dönüşüm değeriyle ilişkilendirilen para birimi. Bu, ISO 4217 standardında 3 karakterli para birimi kodudur. Örneğin: USD, EUR. |
CallConversionResult
Başarıyla işlenmiş bir CallConversionUpload değerini belirleme.
JSON gösterimi |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
Alanlar | |
---|---|
callerId |
Bu aramanın yapıldığı arayan kimliği. Arayan kimliğinin önünde "+" işareti bulunan E.164 biçiminde olması gerekir işaretini tıklayın. |
callStartDateTime |
Aramanın gerçekleştiği tarih ve saat. Biçim "yyyy-aa-gg ss:dd:ss+|-ss:dd" şeklindedir. Örneğin, "2019-01-01 12:32:45-08:00". |
conversionAction |
Bu dönüşümle ilişkili dönüşüm işleminin kaynak adı. |
conversionDateTime |
Dönüşümün gerçekleştiği tarih ve saat. Biçim "yyyy-aa-gg ss:dd:ss+|-ss:dd" şeklindedir. Örneğin, "2019-01-01 12:32:45-08:00". |