- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- ConversionAdjustment
- GclidDateTimePair
- ConversionAdjustmentType
- RestatementValue
- ConversionAdjustmentResult
- Deneyin.
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/v15/customers/{customerId}:uploadConversionAdjustments
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ıyla birlikte veriler içerir:
JSON gösterimi |
---|
{
"conversionAdjustments": [
{
object ( |
Alanlar | |
---|---|
conversionAdjustments[] |
Zorunlu. Yüklenen dönüşüm ayarlamaları. |
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 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 |
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. |
jobId |
İsteğe bağlı. İş kimliğini ayarlamak için isteğe bağlı giriş. Negatif olmayan bir sayı olmalı ve sağlanmışsa 2^31'den küçük olmalıdır. Bu alan sağlanmazsa API, [2^31, (2^63)-1] aralığında bir iş kimliği oluşturur. API, |
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 ( |
Alanlar | |
---|---|
partialFailureError |
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[] |
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 |
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 ( |
Alanlar | |
---|---|
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 |
Düzenleme türü. |
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[] |
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 |
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 |
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 |
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 |
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 |
Bu ayarlama için orijinal dönüşümle ilişkili Google tıklama kimliği (gclid). |
conversionDateTime |
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 |
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 |
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 ( |
Alanlar | |
---|---|
gclidDateTimePair |
Dönüşümün GCLID parametresi ve dönüşüm tarihi. |
orderId |
Ayarlanacak dönüşümün sipariş kimliği. |
adjustmentType |
Düzenleme türü. |
conversionAction |
Bu dönüşüm ayarlamasıyla ilişkili dönüşüm işleminin kaynak adı. |
adjustmentDateTime |
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. |