Dönüşüm API'si (CAPI)
Dönüşüm API'si (CAPI), pazarlama olaylarını arka ucunuzdan doğrudan Meta, TikTok veya Google gibi bir reklam platformuna gönderen sunucudan sunucuya bir arayüzdür. Tarayıcıyı atlayarak daha eksiksiz ve güvenilir dönüşüm verisi sağlar.
Önemli noktalar
- Her olay ad, zaman damgası, eylem kaynağı, hash'lenmiş kullanıcı verisi ve değer alanları taşır.
- Doğrulama, tarayıcı üzerinden değil reklam hesabına bağlı bir erişim jetonuyla yapılır.
- Eklenen her hash'lenmiş kimlik ve saklanan tıklama tanımlayıcısı eşleşme oranını yükseltir.
- Geriye tarihleme penceresi dışında gelen olaylar kaydedilir ama hiçbir teklifi etkilemez.
- Eşleşmeyen olaylar sessizce başarısız olur; bozuk entegrasyonlar bu yüzden sağlıklı görünebilir.
Derinlemesine
Dönüşüm API'si üzerinden giden şey, küçük ve katı biçimli bir veri paketidir. Her olay bir ad, bir zaman damgası, olayın web sitesinde mi uygulamada mı telefonda mı yoksa mağazada mı gerçekleştiğini söyleyen bir eylem kaynağı, hash'lenmiş kimlikleri tutan bir user_data bloğu ve değer, para birimi ile bildirmek istediğiniz her şeyi içeren bir custom_data bloğu taşır. Çağrı, reklam hesabına bağlı bir erişim jetonuyla doğrulanır; böylece platform, bir zamanlar tarayıcı etiketine güvendiği gibi sunucunuza güvenir. Jeton eksik ya da süresi dolmuşsa çağrı anında geri çevrilir.
Her şey, ekleyebildiğiniz kullanılabilir kimlik sayısına bağlıdır. SHA-256 ile hash'lenmiş e-posta ve telefon en güçlü eşleşmeyi sağlar; ad, şehir, posta kodu ve ülke ağırlığı artırır; iniş anında yakalanan tıklama tanımlayıcısı ile veritabanınızdan iletilen çerez değeri eşleşmeyi bir kat daha yükseltir. Zamanlama da aynı ölçüde önemlidir: platformlar olayları yalnızca belirli bir geriye tarihleme penceresinde kabul eder ve günler sonra ulaşan bir gece yığını kaydedilse bile ilişkilendirme penceresinin dışına düşerek teklifleri hiç etkilemeyebilir. Bu yüzden gönderimi bir zaman çizelgesine değil, olayın kendisine bağlayın.
Doğal kullanım, tarayıcının bilemeyeceği olayları bildirmektir. Bir anlaşma satışça kabul edildi aşamasına geçtiğinde CRM web kancası tetiklenir ve servisiniz bu aşama değişimini, yakalama anında saklanan özgün tıklama tanımlayıcısıyla birlikte gönderir. Telefonla alınan randevular ve mağaza satışları da uygun eylem kaynağıyla aynı yoldan girer. Bir karne hunisinde puanlama gönderimden sonra yapıldığı için nitelikli olay, kademeyi değer olarak taşıyacak biçimde bir teşekkür sayfası adresinden tahmin edilmek yerine doğrudan arka uçtan yayılır. Böylece bildirilen değer, puanlamayla tam olarak aynı kaynaktan gelir ve iki taraf asla çelişmez.
Zayıf kimlikli bir olay yüksek sesle reddedilmez; kabul edilir, eşleştirilmez ve raporlamadan sessizce çıkarılır. Ekiplerin yarısı çalışmayan bir entegrasyonu sağlıklı sanmasının nedeni tam olarak budur. API, var olmayan bir kimliği de yaratamaz: hiç reklam tıklamamış trafiğin ilişkilendirilecek bir dayanağı yoktur. Ayrıca haftada yalnızca birkaç kez gerçekleşen derin huni olayı, platformun optimizasyonunun öğrenmesi için çoğu zaman fazlasıyla seyrektir. Bu iki sınır daha iyi veri toplayarak da yapılandırma ayarlarıyla da ortadan kaldırılamaz. Seyrek olaylarda bir adım yukarıdaki olayı optimizasyona vermek daha gerçekçidir.
Pratikte örnek
Nasıl ölçülür
İşe platformun kendi tanılama araçlarıyla başlayın. Büyük uygulamaların hepsi, ayrıştırdığı alanları geri yansıtan bir test olayı aracı, olay bazında bir kalite göstergesi ve eksik ya da bozuk parametreler için bir uyarı listesi sunar. Kimliğini doğrulayabileceğiniz bir kişi için test dönüşümü gönderin, beklediğiniz alanlarla göründüğünü onaylayın ve izleyen hafta boyunca eşleşmedi olarak işaretlenen üretim olaylarının payını kontrol edin.
Ardından tesisatı değil sonucu ölçün. Platformun bildirdiği dönüşümleri, aynı aralıkta kendi veritabanınızda sayılan olaylarla karşılaştırın ve kimlik alanları ekledikçe bu oranı izleyin. Yayın tarafına da bakın: optimizasyonu sunucudan bildirilen bir olaya çevirdikten sonra o olayın maliyeti ile kabul edilen lead sayısı birlikte, daha zengin sinyalin satın almayı gerçekten iyileştirip iyileştirmediğini söyler. Tek başına okunan bir dönüşüm sayısı bu soruya yanıt vermez.
Sık yapılan hatalar
En sık görülen teknik hata, hash'lemeden önce kötü normalleştirmedir. Platformlar küçük harfe indirilmiş, kırpılmış ve tanımlı biçime uygun değerler bekler; boşluklu ya da ülke kodu tutarsız yazılmış bir telefon numarası, hiçbir zaman eşleşmeyecek bir hash üretir. Her platformun normalleştirme kurallarını birebir izleyin ve kaydını doğrulayabileceğiniz bilinen bir kişiyle test edin. Zaten hash'lenmiş bir değeri ikinci kez hash'lemek de aynı sessiz hataya yol açar ve yeniden düzenlemelerde kolayca sızar.
İkinci hata, aşağı akışta kimsenin umursamadığı bir olayı seçmektir. Ekipler arayüzü bir haftada kurar, her sayfa görüntülemeyi sunucudan gönderir ve sonunda eskisiyle aynı sığ eylemi, yalnızca daha güvenilir biçimde optimize eder. Geliri en iyi öngören tek olaya karar verin, onu bir değerle gönderin ve geri kalanını raporlama için saklayın. Bir satış temsilcisinin elle işaretlediği CRM aşamasından tetiklenen dönüşümler de sinyale gecikme ve yanlılık katar.
Sıkça sorulan sorular
CAPI ile sunucu taraflı izleme arasındaki fark nedir?
Sunucu taraflı izleme, olayları kendi sunucunuzda toplamanın genel yaklaşımıdır. CAPI ise bu sunucu olaylarını alan, örneğin Meta veya TikTok'a ait belirli bir platform arayüzüdür; yani genellikle kurulumun bir hedefidir.
CAPI'ye neden hash'lenmiş kimlikler göndermem gerekir?
E-posta veya telefon numarasını hash'lemek, platformun ham kişisel veriyi açığa çıkarmadan dönüşümü bir kullanıcıyla eşleştirmesini sağlar. Eşleşme oranını artırırken veriyi aktarım sırasında korur.
CAPI dönüşümlerimi iki kez sayabilir mi?
Evet, piksel ve CAPI aynı olayı ortak bir event_id olmadan bildirirse. Platformun tekilleştirip her dönüşümü yalnızca bir kez sayması için her zaman tutarlı bir event_id ayarlayın.
Dönüşüm API'si ile sunucu taraflı izleme aynı şey mi?
Tam olarak değil. Sunucu taraflı izleme, olayları kontrol ettiğiniz altyapıda toplamayı anlatır; Dönüşüm API'si ise tek bir reklam platformunun bu olayları kabul eden sunucudan sunucuya uç noktasıdır. Bir Dönüşüm API'sini hiç konteyner kurmadan doğrudan uygulamanızdan çağırabilirsiniz ve böyle bir arayüzü hiç bulunmayan analiz araçlarına sunucu tarafından iletim de yapabilirsiniz.
İyi bir eşleşme için hangi verileri göndermeliyim?
En büyük katkıyı hash'lenmiş e-posta ve telefon numarası sağlar; ardından ad, soyad, şehir, posta kodu ve ülke gelir. İniş adresindeki tıklama tanımlayıcısını ve platformun çerez değerini sakladıysanız ikisini de iletin; bunlar kişisel veriye hiç dayanmadan eşleşir. Doğru biçimlendirilmiş alan sayısı arttıkça eşleşme oranı istikrarlı biçimde yükselir.
Bir dönüşümü en geç ne zaman gönderebilirim?
Her platform genellikle birkaç günlük bir geriye tarihleme penceresi tanımlar; bu sürenin ardından olay reddedilir. Kabul edilmek ise yararlı olmakla aynı şey değildir: ilişkilendirme penceresi kapandıktan sonra ulaşan bir olay, kendisine yol açan reklam etkileşimine yazılmaz. Çevrimdışı dönüşümleri haftalık yığın yerine kayıt oluşur oluşmaz gönderin.
Hem piksele hem Dönüşüm API'sine ihtiyacım var mı?
Web olayları için ikisini birlikte çalıştırmak önerilen kalıptır. Tarayıcı etiketi sunucunun göremediği sinyalleri sağlar, arayüz tarayıcının kaybettiği olayları kapatır ve ortak bir olay kimliği üzerinden tekilleştirme çift saymayı önler. Telefonla yapılan bir satış gibi gerçekten çevrimdışı olaylarda tarayıcı tarafı hiç yoktur; orada tek yol arayüzdür.
Dönüşüm API'si gizlilik kurallarını ihlal eder mi?
Kendiliğinden etmez, ancak sizi hiçbir yükümlülükten de kurtarmaz. Bir reklam platformuna kişisel veri gönderiyorsunuz; bunun için hukuki dayanak, şeffaf bilgilendirme ve geri çekilen onaylara uyum gerekir. Hash'leme ifşayı azaltır ama veriyi anonim yapmaz, çünkü platform tam da bu hash'ler üzerinden eşleştirir. İtiraz eden kullanıcıların olaylarını göndermeyin, platform filtrelesin diye beklemeyin.
API'yi açtıktan sonra dönüşüm sayılarım neden düştü?
Genellikle tekilleştirme artık çalıştığı için. Entegrasyondan önce tek yol bildirim yapıyordu; sonrasında iki yol bildirir ve platform eşleşen çiftleri tek dönüşüme indirger, bu da önceden şişkin olan bir rakamı düzeltir. Düşüşler daha katı eşleşme koşullarından da gelebilir; kullanılabilir kimliği olmayan olaylar, tarayıcı etiketinin saydığı gibi sayılmak yerine elenir.