- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- CallConversion
- CallConversionResult
- Deneyin.
Belirli telefon araması 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
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{
"conversions": [
{
object ( |
Alanlar | |
---|---|
conversions[] |
Zorunlu. Yüklenen dönüşümler. |
partialFailure |
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 |
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. 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[] |
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 ( |
Alanlar | |
---|---|
customVariables[] |
Bu dönüşümle ilişkilendirilen özelleştirilebilen değişkenler. |
consent |
Etkinlikle ilgili izin ayarı. |
callerId |
Bu aramanın yapıldığı arayan kimliği. Arayan kimliğinin "+" işaretiyle birlikte E.164 biçiminde olması beklenir (ör. "+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 (ör. "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ı 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 |
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" şeklindedir (ör. "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ına uygun 3 karakterli para birimi kodudur. Örneğin: USD, EUR. |
CallConversionResult
Başarıyla işlenmiş bir CallConversionUpload için tanımlayıcı bilgiler.
JSON gösterimi |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
Alanlar | |
---|---|
callerId |
Bu aramanın yapıldığı arayan kimliği. Arayan kimliğinin "+" işaretinden önce E.164 biçiminde olması beklenir. |
callStartDateTime |
Aramanı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"). |
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 (ör. "2019-01-01 12:32:45-08:00"). |