Google Ads'te Data Manager API'ye geçiş nasıl yapılır?

Google Ads'te Data Manager API'ye geçiş, veri kaynağını ve yükleme kodunu yeni API akışına uyarlayarak yapılır. 15 Haziran 2026 sonrasında çevrimdışı dönüşüm ve potansiyel müşteri gelişmiş dönüşüm yükleyen reklamverenler, mevcut entegrasyonlarını bu tarihe kadar incelemelidir.

Geçiş yalnızca API adresini değiştirmekten ibaret değildir. Dönüşüm aksiyonu, tıklama kimliği, kullanıcı verisi, izin durumu, zaman damgası ve hata yönetimi birlikte kontrol edilmelidir.

15 Haziran 2026 sonrasında hangi Google Ads yüklemeleri değişiyor?

15 Haziran 2026 sonrasında değişiklik, özellikle çevrimdışı dönüşüm ve potansiyel müşteri gelişmiş dönüşümü verilerinin Google Ads'e aktarım akışını etkiliyor. Web sitesinde tamamlanan dönüşümler bu kapsamdan ayrı değerlendirilebilir.

Çevrimdışı dönüşüm örneğinde kullanıcı reklamı tıklar, form doldurur ve daha sonra satış ekibiyle görüşür. Satışın gerçekleştiği bilgisi CRM'den Google Ads'e gönderilir. Potansiyel müşteri gelişmiş dönüşümünde ise form sırasında alınan birinci taraf kullanıcı bilgileri dönüşüm sinyalini destekler.

Bu iki senaryoda veri kaynağı genellikle CRM, çağrı merkezi, satış yazılımı veya özel bir sunucudur. API geçişi, bu sistemlerden Google Ads'e giden verinin yeni Data Manager akışında işlenmesini gerektirir.

Eski yöntemin çalışıyor olması, geçişin gereksiz olduğu anlamına gelmez. Bir entegrasyon bugün hata vermeden veri gönderebilir; ancak yeni tarih sonrasında desteklenmeyen veya sınırlanan akış, raporlama sürekliliğini bozabilir.

Önce hangi yükleme türünü kullandığınızı belirleyin. Yalnızca Google Ads etiketiyle web dönüşümü ölçüyorsanız geçiş kapsamınız farklıdır. CRM'den satış sonucu gönderiyorsanız çevrimdışı dönüşüm akışını ayrıca incelemelisiniz.

Google'ın ürün dokümantasyonunda endpoint, şema ve kimlik doğrulama ayrıntıları zamanla güncellenebilir. Bu nedenle uygulamadan önce hesabınızın ilgili duyurusunu ve güncel Data Manager API referansını kontrol edin.

Data Manager API geçişinden önce hangi hesap ve veriler kontrol edilmeli?

Geçişten önce Google Ads hesabını, dönüşüm aksiyonlarını ve veri kaynağını birlikte envantere almak gerekir. Sadece yazılım ekibinin API kodunu incelemesi yeterli değildir.

İlk olarak müşteri hesabı kimliğini ve yönetici hesap ilişkisini kaydedin. Verinin hangi müşteri hesabına gönderildiği, hangi dönüşüm aksiyonunda işlendiği ve hangi kullanıcı tarafından yetkilendirildiği açık olmalıdır.

Ardından son dönemde gönderilen kayıtları çıkarın. Her kayıtta dönüşüm zamanı, dönüşüm aksiyonu, tıklama kimliği veya kullanıcı eşleştirme alanı, değer, para birimi ve kaynak sistem bulunmalıdır.

Yanlış: CRM'deki tüm satış kayıtlarını doğrudan API'ye göndermek. Doğru: Yalnızca reklam etkileşimiyle ilişkilendirilebilen ve ilgili dönüşüm aksiyonuna ait kayıtları göndermek.

Bir dönüşümün birden fazla kez gönderilmesini önlemek için benzersiz kayıt kimliği veya işlem kimliği kullanın. Aynı satış kaydı farklı zamanlarda tekrar gönderilirse, raporlama ve optimizasyon sonuçları şişebilir.

Bu aşamada dönüşüm kurulumunuzun tamamını da inceleyin. Google Ads dönüşüm takibi; GA4, Google Tag Manager ve doğrudan Ads etiketiyle farklı biçimlerde kurulabilir. Mevcut yapıyı görmek için Google Ads dönüşüm takibi kurulum rehberindeki kontrol noktalarını kullanabilirsiniz.

Data Manager API için hangi erişim ve kimlik doğrulama hazırlıkları gerekir?

Data Manager API geçişi için Google Cloud projesi, OAuth 2.0 yetkilendirmesi ve Google Ads API erişim bilgileri hazırlanmalıdır. Kullanılan kesin servis ve yetki kapsamları güncel Google dokümantasyonundan doğrulanmalıdır.

İlk adım, üretim ve test ortamlarını ayırmaktır. Üretim hesabının kimlik bilgilerini geliştirici bilgisayarında düz metin olarak saklamayın. Ortam değişkeni, gizli anahtar kasası veya eşdeğer bir güvenli yöntem kullanın.

Google Ads API erişiminde geliştirici tokenı, müşteri kimliği ve yetkili kullanıcı hesabı önemlidir. Yönetici hesap üzerinden işlem yapılıyorsa login-customer-id ve işlem yapılacak alt hesap ayrımı doğru kurulmalıdır.

Yetkiyi mümkün olan en dar kapsamda verin. API kullanıcısının CRM'deki tüm müşteri verilerine erişmesi gerekmeyebilir. Yalnızca gerekli alanları okuyan ve gönderim yapan bir servis hesabı ya da uygulama kullanılması riskleri azaltır.

Potansiyel müşteri gelişmiş dönüşümünde kullanıcı bilgileri özel dikkat ister. E-posta ve telefon gibi alanların Google'ın istediği biçime getirilmesi, gerektiğinde hash uygulanması ve kullanıcı izninin kayıt altına alınması gerekir.

İzin yoksa veriyi zorla göndermek geçişi başarılı yapmaz. Consent durumu, veri toplama metni, CRM kaydı ve API yüklemesi arasında tutarlı bir süreç oluşturulmalıdır. Hukuki değerlendirme, teknik kurulumdan ayrı yürütülmelidir.

Çevrimdışı dönüşüm ve gelişmiş dönüşüm verileri nasıl eşleştirilir?

Data Manager API'ye geçişte en kritik iş, CRM alanlarını yeni veri şemasıyla eşleştirmektir. Her alan için kaynak, format, zorunluluk ve dönüşüm amacı yazılı olarak belirlenmelidir.

Çevrimdışı dönüşümde temel eşleştirme çoğunlukla reklam etkileşimiyle ilişkilendirme bilgisine dayanır. GCLID gibi tıklama kimlikleri kullanılabilir; bazı senaryolarda uygun diğer reklam tıklama tanımlayıcıları gerekebilir.

CRM'deki dönüşüm zamanı, Google'ın beklediği tarih-saat biçimine çevrilmelidir. Sunucu saat dilimi ile Google Ads hesabının saat dilimi karıştırılmamalıdır. Dönüşüm zamanı, satışın sisteme girildiği an değil, iş kuralında tanımlanan gerçek olay olmalıdır.

Örneğin form gönderimi bir dönüşüm, sözleşme imzası başka bir dönüşüm aksiyonu olabilir. İki olayı aynı isimle göndermek, teklif stratejisinin hangi müşteri aşamasına göre optimize edildiğini belirsizleştirir.

Potansiyel müşteri gelişmiş dönüşümünde kullanıcı verisi alanlarının biçimi ayrıca kontrol edilir. E-posta adreslerinde boşluk ve büyük-küçük harf normalizasyonu, telefonlarda ülke kodu ve alan biçimi önem taşır.

Kaynak veriyle gönderilen veri arasında bir eşleştirme tablosu hazırlayın. Bu tablo; CRM alan adı, API alanı, örnek değer, boş kalma davranışı ve doğrulama kuralını içermelidir.

Data Manager API geçişi hangi sırayla yapılmalı?

Data Manager API geçişi, önce düşük riskli bir test akışı kurularak ve ardından sınırlı üretim trafiğiyle doğrulanarak yapılmalıdır. Tüm CRM gönderimini tek seferde değiştirmek yerine kademeli ilerleyin.

1. Çevrimdışı dönüşüm ve gelişmiş dönüşüm kullanan hesapları listeleyin.
2. Her hesabın dönüşüm aksiyonu, veri kaynağı ve mevcut yükleme yöntemini kaydedin.
3. CRM alanlarını güncel Data Manager API şemasıyla eşleştirin.
4. Test müşteri hesabı veya güvenli test senaryosu oluşturun.
5. OAuth, geliştirici tokenı, müşteri kimliği ve servis yapılandırmasını tanımlayın.
6. Tek bir dönüşüm kaydıyla doğrulama yapın.
7. Hata yanıtlarını, kabul edilen kayıtları ve tekrar gönderim davranışını loglayın.
8. Sonuçları mevcut Ads raporları ve CRM kayıtlarıyla karşılaştırın.
9. Başarılı testten sonra küçük bir üretim grubu gönderin.
10. Eski akışı hemen silmeden izleme dönemini tamamlayın.

İlk testte çok sayıda kayıt kullanmayın. Tek bir geçerli kayıt, bir eksik tıklama kimliği ve bir hatalı tarih içeren küçük veri seti daha fazla bilgi sağlar.

Uygulama kodu HTTP yanıtını yalnızca başarı veya başarısızlık olarak kaydetmemelidir. Hangi satırın, hangi alan nedeniyle reddedildiği ve yeniden denenip denenemeyeceği loglanmalıdır.

Yeniden deneme mekanizması da kontrollü olmalıdır. Geçici ağ hatasıyla veri doğrulama hatası aynı şekilde tekrar gönderilmemelidir. Aksi halde hatalı kayıtlar kuyruğu doldurabilir.

Data Manager API geçişi nasıl test edilir?

Geçiş testi, API'nin yanıt vermesinden çok dönüşümün doğru hesaba ve doğru aksiyona işlendiğini kanıtlamalıdır. Teknik başarı ile reklam raporlama başarısı aynı şey değildir.

İlk kontrol, gönderilen kayıt sayısıdır. Örneğin testte 10 kayıt varsa sistemin kaçını kabul ettiği, kaçını reddettiği ve kaçını tekrar denediği ayrı görünmelidir.

İkinci kontrol, veri doğruluğudur. Bir kaydın dönüşüm zamanı, değeri, para birimi ve aksiyon adı CRM'deki kaynak kayıtla karşılaştırılmalıdır. Alanlardan biri değişiyorsa farkın nedeni belgelenmelidir.

Üçüncü kontrol, eşleştirme performansıdır. Kullanıcı verisi kullanan akışlarda her kayıt reklamla ilişkilendirilmeyebilir. Sonuçlar, yeterli veri biriktikten sonra değerlendirilmelidir; tek günlük veriyle kesin karar vermeyin.

Testte aynı kaydı ikinci kez gönderin ve davranışı izleyin. Sisteminizin işlem kimliği, idempotency mantığı veya uygulama tarafındaki kayıt kontrolü tekrarlı dönüşümü engellemelidir.

Üretim geçişinden sonra Ads arayüzündeki dönüşüm teşhislerini ve CRM'deki satış sayılarını birlikte izleyin. İki sistemin raporlama zamanı ve ilişkilendirme penceresi farklıysa birebir eşleşme beklemek doğru olmayabilir.

Mevcut kurulumunuzu taşımadan önce Google Ads dönüşümlerini Data Manager'a taşıma rehberindeki geçiş mantığını ayrıca karşılaştırın. Bu sayfa, dönüşüm aksiyonlarının yeniden düzenlenmesi gereken durumlarda yardımcı olur.

Data Manager API geçişinde en sık hangi hatalar görülür?

En sık hatalar, yanlış müşteri hesabı, eksik tıklama kimliği, hatalı tarih biçimi ve kullanıcı verisinin yanlış hazırlanmasıdır. Hata mesajını okumadan kodu tekrar çalıştırmak sorunu çözmez.

Yanlış müşteri kimliği kullanılırsa istek teknik olarak yetkili görünse bile kayıt beklenen hesaba gitmeyebilir. Yönetici hesapla alt hesap arasındaki kimlikleri yapılandırma dosyasında ayrı alanlarda tutun.

Dönüşüm aksiyonu adı veya kimliği doğru değilse veri doğru müşteri hesabına gitse bile yanlış hedefe bağlanabilir. Geçiş öncesinde her aksiyonun adı, amacı, sayım yöntemi ve dahil edilme durumu kaydedilmelidir.

Tıklama kimliği CRM'e hiç alınmadıysa geriye dönük API değişikliği bunu oluşturmaz. Bu durumda form, çağrı veya satış sürecinde kimliğin ilk temas noktasından itibaren saklanması gerekir.

Telefon numarasını ülke kodu olmadan, e-postayı boşluklarla veya kullanıcı bilgisini izinsiz göndermek eşleştirme sorunlarına yol açabilir. Normalizasyon kuralları veri gönderiminden önce uygulanmalıdır.

Bir diğer hata, başarı yanıtını dönüşümün raporda hemen görüneceği şeklinde yorumlamaktır. İşleme, ilişkilendirme ve raporlama gecikmeleri olabilir. Bu nedenle operasyonel alarm ile performans değerlendirme penceresi birbirinden ayrılmalıdır.

Geçiş e-ticaret ürün verilerini de kapsıyorsa bu işi Data Manager API ile karıştırmayın. Ürün katalogları ve alışveriş verileri için ayrıca Merchant API'ye geçiş adımlarını incelemek gerekir.

Data Manager API geçişinden sonra hangi kontroller yapılmalı?

Geçişten sonra en az bir tam satış döngüsü boyunca veri akışı, hata oranı ve dönüşüm hacmi izlenmelidir. İzleme süresi, işletmenin satış döngüsüne göre belirlenmelidir.

Günlük teknik kontrolde gönderilen kayıt sayısı, kabul edilen kayıt sayısı, reddedilen kayıt sayısı ve yeniden denenen kayıt sayısı yer almalıdır. Bu dört metrikten biri yoksa sorunları erken fark etmek zorlaşır.

Haftalık kontrolde CRM'deki nitelikli müşteri veya satış sayısını Google Ads dönüşümleriyle karşılaştırın. Farkları doğrudan entegrasyon hatası saymayın; dönüşüm penceresi, reklam ilişkilendirmesi ve veri işleme süresi de incelenmelidir.

Teklif stratejisi değişikliği için acele etmeyin. Yeni akışın veri kalitesi doğrulanmadan dönüşüm aksiyonunu kampanyalarda birincil hedef yapmak, algoritmaya hatalı sinyal gönderebilir.

• Üretim kimlik bilgileri test ortamından ayrıldı mı?
• Her kayıt doğru müşteri hesabına ve dönüşüm aksiyonuna gidiyor mu?
• Tıklama kimliği veya uygun kullanıcı eşleştirme verisi korunuyor mu?
• Dönüşüm zamanı ve saat dilimi doğrulandı mı?
• Kullanıcı verisi için izin ve hash süreci belgeli mi?
• Tekrarlı gönderimleri engelleyen kontrol çalışıyor mu?
• API hataları satır bazında loglanıyor mu?
• Eski akış için geri dönüş planı hazır mı?

Bu kontrol listesi tamamlanmadan eski entegrasyonu kaldırmayın. Ancak iki akışı paralel çalıştırırken aynı dönüşümü çift saymadığınızdan emin olun.

Data Manager API geçiş planı nasıl belgelenmeli?

Geçiş planı; sorumlu kişiler, veri alanları, test sonuçları, hata prosedürü ve geri dönüş koşullarını içeren kısa bir teknik belge olmalıdır. Sözlü bilgi, ekip değişikliğinde yeterli olmaz.

Belgede her veri kaynağı için sahiplik tanımlayın. CRM yöneticisi kaynak veriden, yazılım ekibi API gönderiminden, reklam hesabı yöneticisi ise dönüşüm aksiyonunun iş amacından sorumlu olabilir.

Geri dönüş planı da yazılı olmalıdır. Yeni akışta kritik hata görülürse hangi koşulda gönderim duracak, hangi kişi bilgilendirilecek ve eski yapı nasıl devreye alınacak belirlenmelidir.

Geçiş kaydında tarihleri kesinleştirmeden önce Google'ın güncel resmi duyurularını kontrol edin. Kullanılan endpoint veya alan adları değişmişse bu makaledeki genel yöntemi güncel teknik referansla eşleştirin.

Ajanslar birden fazla reklamveren hesabı yönetiyorsa her hesap için aynı şablonu kullanabilir. Fakat müşteri kimliği, dönüşüm aksiyonu, veri kaynağı ve izin süreci hesap bazında ayrı doğrulanmalıdır.

Son olarak ekip, Data Manager geçişini Google Ads hesabını baştan kurmakla karıştırmamalıdır. Kampanya bütçesi, teklif stratejisi ve reklam metinleri ancak veri akışı doğrulandıktan sonra ayrıca değerlendirilmelidir.