Facebook Dönüşümler API'si: Bilmeniz Gerekenler

E-ticarete başladığınızda ilk hedefiniz geniş kitlelere ulaşmak ve satışlarınızı artırmaktır. Geniş kitlelere ulaşabilmek ve satışlarınızı artırabilmeniz için yararlanabileceğiniz pek çok farklı yol bulunuyor. Bunlardan biri de “Facebook Dönüşümler API'si” olarak biliniyor.

Dönüşümler API’si sayesinde e-ticaret sitenizi ziyaret eden kişilere Facebook ve Instagram üzerinden reklam gösterebilirsiniz. Bunu yaparken, hedef kitlenizi kendiniz oluşturabilirsiniz. Örneğin; alışveriş yapanlar, sepette ürün bırakanlar ya da sitede belirli bir süre geçirenler gibi.

Tahmin edilebileceği üzere Facebook Dönüşümler API'si ile ilgili pek çok soru sorulmaktadır. Yazımızın devamını okuyarak, Facebook Dönüşümler API'si ile ilgili daha fazla bilgi sahibi olabilirsiniz.

Dönüşümler API’si Nedir?

Dönüşümler API’si; Meta teknolojileri genelinde pazarlama verilerinizle birlikte reklam hedeflerinizi optimize etmeye, sonuçları ölçmeye ve eylem başına ücreti azaltmayı hedefleyen, Facebook (Meta) tarafından geliştirilen sunucu tabanlı bir uygulamadır. Kısaca sisteminiz (mağaza sunucusu, CRM, ödeme sağlayıcısı vb.) ile Meta sunucuları arasında doğrudan güvenli bir bağlantı kurmanızı sağlar. Böylece yalnızca tarayıcı çerezlerine dayanmadan satış, sepete ekleme, ödeme başlatma gibi kritik olayları iletebilir ve reklamlarınızı gerçek verilere göre optimize edebilirsiniz.

Meta Piksel ile Dönüşümler API’si Arasındaki Farklar

• Veri toplama yöntemi: Piksel tarayıcı tabanlıdır; CAPI sunucu tabanlıdır. CAPI, çerez kısıtlamaları ve tarayıcı engellemelerinden daha az etkilenir.
• Güvenilirlik: Sunucu çıkışlı olaylar, ağ kesintileri ve reklam engelleyicilerden daha az etkilenir; olay teslim oranı artar.
• Kontrol ve esneklik: CAPI ile ne zaman, hangi olayları, hangi parametrelerle göndereceğinizi daha detaylı kurgulayabilirsiniz.
• Gizlilik uyumu: Kullanıcı izinleri ve KVKK/GDPR gereklilikleri doğrultusunda yalnızca izin verilen veriler hash’lenerek gönderilir.
• En iyi uygulama: Piksel + CAPI birlikte çalışır. Olayları çift iletip “event_id” ile eşleştirerek yinelenenleri engelleyip en doğru ilişkilendirmeyi elde edersiniz.

Kimler Dönüşümler API’sini Kullanmalı?

• iOS 14+ ve çerez kısıtlamaları sonrası performansı dalgalanan e-ticaret siteleri
• Sepete ekleme, ödeme başlatma, alışveriş gibi olayların eksik ölçüldüğünü fark eden reklamverenler
• ROAS ve eylem başına maliyeti (CPA) optimize etmek isteyen, yüksek hacimli kampanyalar yürüten markalar
• CRM, POS, çağrı merkezi gibi çevrimdışı/çevrimiçi kaynakları tekleştirmek isteyen işletmeler

Facebook Dönüşümler API'si Kurulumu

Facebook Dönüşümler API'si, Facebook CAPI olarak da bilinmektedir. Facebook Dönüşümler API'si, sunucu tabanlı çalışmaktadır.

Web sitenizi ziyaret eden kullanıcıların tarayıcılarında çerez depolamadığı için kullanıcı tarafından alınan gizlilik önlemleri bu noktada geçersiz bir hale gelir. Böylece web site sunucusundan direkt olarak Facebook sunucularına kullanıcının bilgileri iletilir. Bu sayede reklam performansınız ciddi bir şekilde artar.

Kurulum Yöntemleri

1) İş Ortağı (Partner) Entegrasyonu: Teknik bilgi gereksinimi en az olan yoldur. Uyumlu platformlarda piksel ve CAPI tek tıkla eşlenir, gerekli olaylar otomatik gönderilir.

2) Manuel Sunucu Entegrasyonu: Kendi sunucunuzdan Meta’ya HTTP istekleri ile olay gönderirsiniz. Geliştirici kaynağı gerektirir ancak en fazla kontrolü sağlar.

3) Google Tag Manager Sunucu Tarafı: Kendi sGTM konteyneriniz üzerinden sunucuya gelen web olaylarını işleyip CAPI’ye gönderirsiniz. Ölçeklenebilir ve esnektir.

Adım Adım Temel Kurulum

• Facebook Business paneline giriş yapın.
• Karşınıza çıkan ekranda sırasıyla “Olay Yöneticisi”, “Veri Kaynakları”, “Piksel Kurulumuna Devam Et” seçeneklerine tıklayın.
• Ardından ekrandaki bilgilendirme pencerelerini geçmek için “İleri” seçeneğine tıklayın.
• Dönüşümler API’sini seçerek, İnternet Sitesi hareketlerini bağlayın.
• Dönüşümler API’si ayarlama yöntemini seçin.
• İşletmeniz için istediğiniz olayları ve parametreleri seçmeli ve ardından ilgili adımları tamamlayın.
• Daha sonra “Ayarlar” ekranında “Erişim Jetonu Oluşturun” dedikten sonra size verilen Token’ı kopyalayın.

Bu adımları takip ederek Facebook Dönüşümler API'si kurulumu gerçekleştirebilirsiniz. Ancak bu süreç web sitenizin altyapısına göre değişiklik gösterebilir. Bu yüzden Facebook Dönüşümler API'si’nden faydalanmak istiyorsanız, profesyonel firmalarla iletişime geçmeniz daha sağlıklı olacaktır. Bu sayede herhangi bir sorun yaşamadan Facebook Dönüşümler API'si kurulumu gerçekleştirebilirsiniz.

Önemli Olaylar ve Parametreler

• Önerilen olaylar: PageView, ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase, Lead, CompleteRegistration.
• Zorunlu/önerilen alanlar: event_name, event_time, event_source_url, action_source (website, app, phone_call vb.), event_id (piksel ve CAPI’de deduplikasyon için).
• Kullanıcı verileri (user_data): em (e-posta), ph (telefon), fn (ad), ln (soyad), external_id, fbc/fbp, ip_address, user_agent. Gizlilik için SHA-256 hash uygulanmalıdır.
• E-ticaret parametreleri: content_ids, content_type, contents (id, quantity, item_price), currency, value.

Doğrulama, Test ve Deduplikasyon

• Test Olayları: Olay Yöneticisi > Test Olayları ile canlıya almadan önce tetiklemeleri doğrulayın.
• Event Match Quality: Kullanıcı eşleşme kalitesini artırmak için em/ph gibi hash’li alanları gönderin.
• Diagnostics: Eksik parametreler, gecikmeler ve hatalar için Olay Teşhisleri bölümünü düzenli kontrol edin.
• Deduplikasyon: Piksel ve CAPI aynı olayı gönderebilir. Her iki tarafta aynı “event_id” değeri kullanarak tekrarları önleyin.

iOS 14+ ve AEM (Toplanan Olay Ölçümü)

iOS 14+ sonrası, AEM kapsamında alan adınıza önceliklendirilmiş sınırlı sayıda olay atanır. CAPI, bu olayların iletimini güvenilir kıldığından optimizasyon ve ilişkilendirme kalitesi artar. Satın alma (Purchase) ve ödeme başlatma (InitiateCheckout) gibi kritik olayları üst sıralara koymayı değerlendirin.

Dönüşümler API’sinin Avantajları

Facebook Dönüşümler API’sinin avantajlarını şu şekilde sıralayabiliriz;

• Pikselden ayrı olarak uygulanması durumunda Dönüşümler API’si ne zaman paylaştığınız ve ne paylaştığınız gibi konular hakkında daha fazla kontrol edebilmenizi sağlar. Bu sayede veri kontrolü artırılmaktadır.
• Müşterilerinizin keşiften dönüşüme tüm yolculuğu boyunca reklam performansını ve ilişkilendirilmesinin ölçümünde yardımcı olur. Bu sayede ölçümlerinizi iyileştirebilirsiniz.
• Eşleşen olayları ve eşleştirme kalitenizi artırabilmeniz için daha fazla müşteri bilgisi parametresi ekleyebilmenizi sağlar. Bu sayede eylem başına ücretlerinizi azaltabilirsiniz.
• Reklamlarınızdan daha iyi verim alabilmeniz için reklamları optimize edebilirsiniz. Bunu yaparken çeşitli parametrelerden yararlanabilir ve değer oluşturabilecek müşterilere daha kolay ulaşabilirsiniz.
• Dönüşümler API’sinden elde edilen veriler, çeşitli bağlantı sorunlarından ve reklam engelleyicilerinden Meta Piksel’e göre daha az etkilenir. Bu yüzden Piksel ile birlikte Dönüşümler API’sini kullanarak, eylem başına ücretlerinizi azaltabilirsiniz.

Ek Katma Değerler

• Stabil raporlama: Tarayıcı kaynaklı eksik ölçümlerin minimize edilmesi, daha tutarlı ROAS ve CPA verileri.
• Gelişmiş hedefleme: Sepeti terk edenler, yüksek değerli alıcılar gibi özel hedef kitlelerin daha doğru inşası.
• Çevrimdışı/çoklu kaynak: CRM, mağaza POS ve çağrı merkezi satışlarını CAPI ile ilişkilendirme.

Temasis Akıllı E-Ticaret Altyapısı ile Dönüşümler API Entegrasyonu

Temasis Akıllı E-Ticaret Altyapısı, performans odaklı reklamcılık için gerekli veri katmanını ve entegrasyon seçeneklerini dikkate alarak tasarlanmıştır. Dönüşümler API (CAPI) ile birlikte Meta Piksel altyapınızı daha sağlıklı kurgulamanıza ve kampanya optimizasyonlarınızı güçlendirmenize yardımcı olur.

Temasis ile Öne Çıkan Yetkinlikler

• Kolay kurulum: Piksel ve CAPI ayarlarını Olay Yöneticisi ile uyumlu biçimde yapılandırmanıza yardımcı olan pratik adımlar.
• Doğru olay haritalama: Ürün görüntüleme, sepete ekleme, ödeme başlatma, satın alma gibi e-ticaret olaylarının standart parametrelerle iletilmesi.
• Gelişmiş eşleştirme: KVKK’ya uygun şekilde hash’lenmiş kullanıcı verileriyle eşleşme kalitesinin artırılması.
• Ürün kataloğu uyumu: Meta Commerce Manager için ürün feed’lerinin düzenli ve hatasız aktarılmasına uygun yapı.
• Performans takibi: CAPI ve Piksel verilerini karşılaştırarak eksik olayların yakalanmasına yardımcı olabilecek raporlama kurguları.

Temasis ile kurulan sağlam bir veri temelinde, reklam bütçenizi satışa en çok katkı sağlayan kampanyalara kaydırabilir, görünürlüğü yüksek ama dönüşümü düşük olan kitleleri hızla ayıklayabilirsiniz. Altyapı ekibi ve profesyonel çözüm ortakları, kurulum ve optimizasyon sürecinde yol arkadaşınız olabilir.

Gizlilik, KVKK ve Uyum

Dönüşümler API kurulumunda gizlilik ilkeleri kritik öneme sahiptir. Kullanıcıya açık, anlaşılır bir çerez ve gizlilik politikası sunmalı; tercih yönetimi paneli üzerinden izinleri toplamalısınız. Facebook’a gönderilen kişisel veriler, Meta dokümantasyonunda belirtildiği üzere SHA-256 ile hash’lenmelidir. İzin verilmeyen veriler asla paylaşılmamalıdır. KVKK ve GDPR uyumunu gözetmek; verilerin saklama sürelerini ve amaçlarını politika dokümanlarınızda belirtmek sorumluluğunuzdadır.

En İyi Uygulamalar ve Optimizasyon İpuçları

• Piksel + CAPI birlikte: En sağlıklı ilişkilendirme ve daha yüksek olay teslimatı için her ikisini aynı anda çalıştırın.
• Event_id kullanımı: Çift iletilen olayların deduplikasyonu için her olayda benzersiz event_id gönderin.
• Parametre kapsamı: value, currency, content_ids gibi sinyal taşıyan alanları eksiksiz sağlayın.
• Match quality’i artırın: em, ph, external_id gibi hash’li kullanıcı verilerini izinli biçimde iletin.
• Test ve izleme: Test Olayları ve Diagnostics bölümlerini düzenli kontrol edin; hataları hızlıca giderin.
• AEM önceliklendirme: En kritik dönüşümleri (Purchase, InitiateCheckout) öncelik listesinde üst sıralara alın.
• UTM standardizasyonu: Kampanya kaynak ve medium etiketlerinizde tutarlılık sağlayarak raporlamayı netleştirin.
• Gecikme yönetimi: Sunucu tarafı olayları mümkün olduğunca gerçek zamana yakın gönderin.

Sık Sorulan Sorular

CAPI’yi piksel olmadan kullanabilir miyim?

Kullanabilirsiniz; ancak en iyi uygulama piksel ve CAPI’yi birlikte çalıştırmaktır. Böylece hem tarayıcı hem sunucu kaynaklı veriyle daha doğru ilişkilendirme elde edilir.

Kurulumdan sonra sonuçları ne zaman görürüm?

Genellikle birkaç gün içinde olay teslimatında artış ve atribüsyon tutarlılığı gözlemlenir. Kampanya optimizasyonlarının etkisi 1–2 haftalık öğrenme sürecinde daha belirgin hale gelir.

Hangi olayları göndermeliyim?

E-ticaret için minimumda PageView, ViewContent, AddToCart, InitiateCheckout ve Purchase olaylarını öneririz. Satış huninizde anlamlı diğer olayları (AddPaymentInfo, Lead vb.) da ekleyebilirsiniz.

KVKK uyumunu nasıl sağlarım?

İzin yönetimi çözümü kullanın, politikalarınızı güncel tutun ve yalnızca izin verilen verileri hash’lenmiş biçimde paylaşın. Kullanıcı talep ederse verilerin işlenmesini durdurma ve silme süreçlerini uygulayın.

Feed ve Dinamik Reklamlarla ilişkisi nedir?

Ürün feed’iniz Meta Commerce Manager’a düzgün aktarılırsa, CAPI ile iletilen satın alma ve görüntüleme sinyalleri, Dinamik Reklamların doğru ürünleri doğru kişilere göstermesini kolaylaştırır.

Örnek Senaryo: Sepeti Terk Edenlere Yeniden Hedefleme

Bir kullanıcı ürün sayfasını görüntüledi (ViewContent) ve ürünü sepete ekledi (AddToCart) ancak satın alma yapmadı. CAPI sayesinde bu olaylar güvenilir şekilde Meta’ya iletilir. Siz de “Sepeti Terk Edenler” özel kitlesi oluşturarak kupon ya da ücretsiz kargo mesajıyla Instagram ve Facebook’ta yeniden hedefleme kampanyası başlatırsınız. Sağlam ölçüm altyapısı, kampanyanın dönüşüme katkısını net biçimde gösterir ve bütçeyi en çok geri dönüş sağlayan kitlelere taşımanızı kolaylaştırır.

Kurulum Sırasında Yaygın Hatalar ve Çözümler

• Eksik event_id: Piksel ve CAPI aynı olayı eşleştiremiyor. Çözüm: Her iki tarafta da aynı event_id değerini gönderin.
• Yanlış para birimi/value: Raporlarda tutarsız ROAS. Çözüm: “currency” ISO kodunu ve “value” değerini doğru formatta yollayın.
• Düşük Match Quality: Yetersiz kullanıcı verisi. Çözüm: İzinli ve hash’li em, ph, external_id parametrelerini ekleyin.
• Gecikmeli iletim: Zaman aşımı nedeniyle ilişkilendirme kaçıyor. Çözüm: Olayları mümkün olduğunca gerçek zamanda gönderin.
• Yetki hataları: Erişim jetonu geçersiz. Çözüm: Olay Yöneticisi > Ayarlar’dan token’ı yenileyin ve güvenli saklayın.

Meta Altyapısında Raporlama ve Başarı Ölçümü

Kurulum tamamlandıktan sonra, Olay Yöneticisi’nde “Olay Sayısı”, “Eşleşme Kalitesi” ve “Tanılama” panellerini takip edin. Reklam Yöneticisi’nde kampanyalarınızı dönüşüm odaklı (Örn. Satın Alma) optimize edin, Kitle ve Yerleşim testleri ile A/B deneyleri yapın. CAPI sinyalleri oturdukça öğrenme kısıtlamaları azalır, daha istikrarlı maliyetler ve daha doğru atribüsyon görürsünüz.

Sonuç: Sağlam Ölçüm, Daha İyi Optimizasyon

Dönüşümler API’si; çerez kısıtlamaları, reklam engelleyiciler ve tarayıcı farklılıklarından doğan eksik ölçümü telafi ederek reklam yatırımlarınızı daha verimli yönetmenize yardımcı olur. Piksel ile birlikte kurgulandığında, veri kayıpları azalır, kampanya optimizasyonları güçlenir ve gerçek satış verisine dayalı kararlar almak kolaylaşır.

Altyapınızın gereksinimlerine göre partner, manuel veya sGTM yöntemiyle ilerleyebilir; KVKK uyumunu gözeterek hash’li kullanıcı verileriyle eşleşme kalitesini yükseltebilirsiniz. Temasis Akıllı E-Ticaret Altyapısı, bu yolculukta ihtiyaç duyduğunuz teknik zemini ve pratik kurulum adımlarını destekleyerek, Meta ekosisteminde ölçüm ve optimizasyon kalitenizi artırmanıza yardımcı olur. Doğru kurulum ve düzenli optimizasyonla, eylem başına maliyetlerinizin düştüğünü ve reklam yatırımlarınızdan daha yüksek geri dönüş aldığınızı görebilirsiniz.