Daha önce kaydedilmiş Google Ads dönüşümlerinde IngestEvents yöntemini kullanarak düzenlemeler yapın.
Veri Yöneticisi API'sinde bir düzenleme, dönüşüm değerini yeniden belirleyebilir veya kullanıcı verilerini tamamlayabilir.
Google Ads API'den geçiş yapıyorsanız ayarlamaların her API'de nasıl işlendiğini karşılaştırmak için Google Ads API'den yeni sürüme geçme başlıklı makaleyi inceleyin.
Desteklenen dönüşüm türleri
Aşağıdaki Google Ads dönüşüm türlerini ayarlayabilirsiniz:
- Çok kaynaklı dönüşümler:
WEBSITEdönüşüm işlemi için web sitenizin Google etiketi tarafından kaydedilen dönüşümler. - Çevrimdışı dönüşümler ve potansiyel müşteriler için gelişmiş dönüşümler:
Bir
UPLOAD_CLICKSdönüşüm işlemi için daha önce yüklenen çevrimdışı etkinlikler.
Ayarlamaların işleyiş şekli
Google Ads, aynı dönüşüm işlemi içinde etkinlikleri eşleştirmek için
transactionId:
transactionId, aynı dönüşüm işlemi için mevcut bir dönüşümle eşleşirse Data Manager API, isteği dönüşüm ayarlaması olarak değerlendirir.transactionIdmevcut bir dönüşümle eşleşmezse Google Ads yeni bir dönüşüm oluşturur. Eşleşmeyen etkinlikler başlıklı makaleyi inceleyin.
Düzenleme gönderme
Mevcut bir dönüşümü ayarlamak için IngestEvents isteği gönderin. Bu istekte şunlar yer almalıdır:
- Orijinal etkinlikle aynı
transactionId. - Orijinal etkinlik ile aynı hedef ve dönüşüm işlemi.
- Ayarlamak istediğiniz alanların güncellenen değerleri.
adIdentifiersveyauserDatagibi en az bir tanımlayıcı dahil olmak üzere bir etkinlik için gereken tüm alanlar. Çevrimdışı dönüşümler veya çok kaynaklı dönüşümler için etkinlik ve tanımlayıcı şartlarını inceleyin.
Orijinal etkinlikte gönderdiğiniz veya yakaladığınız tanımlayıcıları göndermenizi öneririz. transactionId mevcut bir dönüşümle eşleşmiyorsa Google Ads, yeni dönüşümü ilişkilendirmek için bu tanımlayıcıları kullanır.
Bir düzenleme türü belirtmeniz gerekmez. Veri Yöneticisi API'si, transactionId ve sağladığınız alanlara göre isteğin nasıl işleneceğini çıkarır.
Alma istekleri gönderme hakkında daha fazla bilgi için çevrimdışı dönüşümler veya çok kaynaklı dönüşümler için etkinlik gönderme kılavuzlarına bakın.
Desteklenen alanlar
Aşağıdaki tabloda, bir etkinlik mevcut bir dönüşümle eşleştiğinde Google Ads'in her alanı nasıl uyguladığı listelenmiştir:
| Alan | Davranış |
|---|---|
conversionValue, currency |
Üzerine yazılmış. Yeni değer, kaydedilen değerin yerini alır. |
userData |
Orijinal etkinlikte kullanıcı verisi yoksa tamamlanır, aksi takdirde yoksayılır. |
Diğer tüm alanlar (ör. adIdentifiers.gclid) |
Güncellenmedi. Google Ads, orijinal etkinlikle kaydedilen değerleri korur. Zorunlu alanlar yine de bulunmalıdır. |
Dönüşüm değerleri
Kayıtlı bir dönüşümün değerini yeniden belirtmek için yeni bir conversionValue ve currency gönderin. Yeni değer, dönüşüm sayısı artırılmadan raporlama ve teklif verme işlemlerinde daha önce kaydedilen değeri geçersiz kılar.
Kullanıcı verileri
Google Ads'in e-posta adresi veya telefon numarası gibi userData ile nasıl başa çıktığı aşağıda açıklanmıştır:
Eksikse tamamlanır: Orijinal etkinlik kullanıcı verileri olmadan yakalandıysa düzenleme, ilişkilendirmeyi iyileştirmek için kullanıcı verilerini ekler.
Varsa yoksayılır: Google etiketi veya önceki bir yükleme kullanıcı verilerini zaten yakaladıysa yeni kullanıcı verileri yoksayılır. Mevcut kullanıcı verilerinin üzerine yazılmaz veya bu verilere ekleme yapılmaz.
Diğer alanlar
Dönüşüm değeri, para birimi ve kullanıcı verileri dışındaki tanımlayıcılar ve meta veriler (ör. adIdentifiers.gclid) eşleşen etkinlikler için güncellenemez. Google Ads, orijinal etkinlikle kaydedilen değerleri korur.
Yine de bu alanlardan zorunlu olanları (ör. en az bir tanımlayıcı) eklemeniz gerekir. Data Manager API, bunları her etkinlik için doğrular.
Eşleşmeyen etkinlikler
transactionId mevcut bir etkinlikle eşleşmiyorsa istek, düzenleme yerine yeni dönüşüm yükleme olarak değerlendirilir.
Google Ads, sağladığınız tanımlayıcıları (ör. adIdentifiers.gclid veya userData) kullanarak yeni dönüşümü bir reklam tıklamasıyla ilişkilendirmeye çalışır.