Meta CAPI Gateway nasıl kurulur?

Meta CAPI Gateway, Meta Events Manager içinden veri kaynağı oluşturularak ve seçilen bulut hesabına Gateway dağıtılarak kurulur. Kurulumdan sonra web sitesi veya e-ticaret altyapısı, dönüşüm olaylarını tarayıcı yerine sunucu üzerinden Meta'ya iletir. Pixel ile aynı olaylar gönderiliyorsa deduplikasyon için event_id kullanılmalıdır. Aksi halde tek satın alma veya form gönderimi iki kez sayılabilir.

Bu yapı, tarayıcı kısıtlamaları ve izin tercihleri nedeniyle eksilen sinyalleri azaltır. Ancak CAPI, kullanıcı izni olmadan veri gönderme yöntemi değildir. KVKK, çerez politikası ve Meta veri gereklilikleri birlikte değerlendirilmelidir.

Meta CAPI Gateway nedir ve doğrudan Conversions API'den farkı nedir?

Meta CAPI Gateway, Conversions API olaylarını kendi sunucunuz yerine yönetilen bir Gateway katmanı üzerinden Meta'ya taşıyan kurulum modelidir. Gateway, seçtiğiniz bulut altyapısında çalışır. Web sitesi, e-ticaret platformu veya sunucu uygulaması olayları bu katmana iletir.

Doğrudan Conversions API kurulumunda geliştirici, Meta Graph API uç noktalarına istek gönderen sunucu kodunu kendisi yönetir. Erişim belirteci, veri biçimi, hata kayıtları, tekrar denemeler ve sunucu güvenliği uygulamanın sorumluluğundadır. Gateway yaklaşımında bu operasyonun bir bölümü hazır arayüz ve dağıtım akışıyla yönetilir.

Gateway, Pixel'in alternatifi olarak değil, sunucu taraflı tamamlayıcısı olarak düşünülmelidir. Pixel tarayıcıdan, CAPI ise sunucudan sinyal gönderir. İki kaynak aynı olayı iletiyorsa Meta'nın hangi olayları birleştireceğini event_id belirler.

Ürün kataloğu, kampanya optimizasyonu ve ölçüm altyapısını birlikte planlamak gerekir. Meta Pixel'in temel çalışma mantığını bilmiyorsanız, önce Meta Pixel kurulumu ve kullanımı rehberindeki olay yapısını inceleyin.

Meta CAPI Gateway kurulumu için hangi hesaplar ve bilgiler gerekir?

Meta CAPI Gateway kurulumu için bir Meta işletme hesabı, reklam hesabı, veri kaynağı ve Gateway'in dağıtılacağı bulut hesabı gerekir. İşletme hesabında yönetici yetkisi olmadan veri kaynağı veya erişim belirteci oluşturma ekranları görünmeyebilir.

İlk olarak Meta Business Settings bölümünde işletme yöneticisi erişiminizi kontrol edin. Ardından Events Manager içinde kullanılacak Pixel'i veya veri setini belirleyin. Aynı işletmeye bağlı birden fazla Pixel varsa doğru veri kaynağını seçmek önemlidir. Yanlış Pixel seçimi, reklam kampanyalarının hatalı sinyalle optimize edilmesine neden olur.

Gateway için desteklenen bulut sağlayıcının hesabı, faturalandırma yöntemi ve dağıtım yetkileri de hazırlanmalıdır. Bulut hesabında kaynak oluşturma izni yoksa kurulum sihirbazı tamamlanmaz. Bu aşamada tahmini maliyeti Meta değil, seçilen bulut sağlayıcının fiyatlandırma sayfası belirler.

Web sitesinin alan adı, kullanılan e-ticaret veya CRM altyapısı, gönderilecek dönüşüm olayları ve mevcut Pixel kurulumu not edilmelidir. Örneğin bir mağazada PageView, ViewContent, AddToCart, InitiateCheckout ve Purchase olayları; lead sitesinde PageView, Lead ve CompleteRegistration olayları kullanılabilir.

Kurulumdan önce şu bilgileri yazılı hale getirin:

• Doğru Meta işletme hesabı ve Business Manager yönetici erişimi.
• Doğru Pixel veya veri seti kimliği.
• Meta reklam hesabı ve ilgili kampanyalar.
• Gateway'in kurulacağı bulut hesabı ve dağıtım yetkisi.
• Web sitesi, ödeme ve CRM tarafında gönderilecek olaylar.
• Çerez izin platformunun hangi durumlarda ölçüme izin verdiği.

İzin mimarisi bilinmeden kurulan Gateway, teknik olarak çalışsa bile hukuki ve ölçüm açısından sorun çıkarabilir. Bu nedenle önce olay haritası, ardından teknik bağlantı hazırlanmalıdır.

Meta CAPI Gateway adım adım nasıl kurulur?

Meta CAPI Gateway adım adım; veri kaynağı seçimi, Gateway dağıtımı, alan adı yönlendirmesi, olay bağlantısı ve test aşamalarından oluşur. Meta arayüzündeki menü adları zaman içinde değişebilir.

1. Meta Events Manager'a yönetici yetkisiyle giriş yapın.
2. Kurulacak Pixel'i veya veri setini seçin.
3. Settings bölümünde Conversions API veya Gateway kurulum seçeneğini açın.
4. Gateway oluşturma akışını başlatın ve kullanılacak bulut sağlayıcıyı seçin.
5. Bulut hesabında istenen yetkilendirmeyi verin.
6. Dağıtım bölgesini, kaynak adını ve gerekli hesap bilgilerini onaylayın.
7. Meta'nın oluşturduğu Gateway bağlantısının tamamlanmasını bekleyin.
8. Olay gönderecek altyapıyı Gateway uç noktasına bağlayın.
9. Events Manager içindeki Test Events ekranında örnek olay gönderin.
10. Gerçek kampanyaya geçmeden önce Diagnostics uyarılarını kontrol edin.

Dağıtım tamamlandığında Gateway adresi veya bağlantı bilgileri arayüzde gösterilir. Bu bilgiyi web geliştiricisine veya e-ticaret platformunu yöneten kişiye iletin. Gateway tek başına satın alma veya form verisi üretmez; kaynağın olayı doğru biçimde göndermesi gerekir.

Shopify, WooCommerce, ikas veya benzeri altyapılarda bağlantı yöntemi platforma göre değişir. Hazır entegrasyon varsa Meta'nın önerdiği partner bağlantısı kullanılabilir. Özel yazılımda ise geliştirici, CAPI olay şemasını uygulamalıdır.

Kurulum sırasında test amacıyla üretim satın alması oluşturmayın. Bunun yerine test ürününü, düşük tutarlı kontrollü siparişi veya form testini kullanın. Gerçek satış verisinin bozulmaması için test kayıtlarının raporlardan nasıl ayrılacağını önceden belirleyin.

Gateway'in çalışması, reklam hesabında hemen daha düşük maliyet anlamına gelmez. Önce olay kalitesi, eşleşme oranı, izin kapsamı ve optimizasyon hedefi birlikte incelenmelidir.

Gateway ile Pixel aynı anda nasıl kullanılır?

Gateway ile Pixel aynı anda kullanılır ve iki taraftan gelen aynı olaylar event_id alanıyla eşleştirilirse çift sayım önlenir. Sadece sunucu olayına geçmek, tarayıcıdaki bazı davranış sinyallerini kaybettirebilir.

Örneğin kullanıcı ürün sayfasını açtığında Pixel ViewContent gönderirken sunucu da aynı ViewContent olayını Gateway'e iletebilir. Her iki istekte event_name aynı olmalı ve event_id aynı olmalıdır. Purchase olayında da sipariş numarasını doğrudan event_id yapmak yerine benzersiz ve tutarlı bir olay kimliği üretmek tercih edilir.

Yanlış: Pixel ve CAPI isteklerinde farklı event_id kullanıp Meta'nın aynı satın almayı otomatik olarak birleştirmesini beklemek. Doğru: Tarayıcı ve sunucu olayını aynı işlem sırasında üretmek, aynı event_name ve event_id değerlerini iki kaynağa göndermek.

Event_id her siparişte veya form gönderiminde yeniden üretilmelidir. Sabit bir event_id kullanılırsa farklı kullanıcıların olayları birleştirilebilir. Aynı kullanıcı aynı formu iki kez gönderdiyse, gerçekten iki ayrı dönüşüm olup olmadığı iş kurallarıyla belirlenmelidir.

Deduplication kontrolü Events Manager içindeki olay ayrıntıları ve tanı ekranlarından yapılır. Tarayıcı ve sunucu olayları ayrı ayrı görünüyorsa entegrasyon tamamlanmamıştır. Sunucu olaylarının oranı aşırı düşükse bağlantı, izin veya veri gönderim kodu incelenmelidir.

Bir e-ticaret işletmesi için önerilen kontrol sırası şöyledir: önce Purchase, sonra InitiateCheckout ve AddToCart, ardından ViewContent. Lead işletmesinde Lead ve CompleteRegistration olaylarının CRM'deki gerçek kayıtlarla karşılaştırılması gerekir.

Pixel kurulumu ve CAPI birlikte yapılandırılırken reklam hesabının dönüşüm tanımı da kontrol edilmelidir. Kampanya Purchase için optimize ediliyorsa, aynı olayın hem doğru değer hem de doğru para birimiyle gönderildiği doğrulanmalıdır.

Meta CAPI Gateway hangi dönüşüm olaylarını göndermelidir?

Meta CAPI Gateway'e gönderilecek olaylar, işletmenin ölçmek istediği gerçek müşteri adımlarına göre seçilmelidir. Her tıklamayı veya sayfa hareketini dönüşüm gibi göndermek veri kalitesini düşürür.

E-ticaret sitesinde PageView ziyaretin, ViewContent ürün incelemenin, AddToCart sepete eklemenin, InitiateCheckout ödeme başlangıcının ve Purchase tamamlanan satışın karşılığıdır. Purchase olayında value ve currency alanları gönderilmelidir. Değer bilgisi eksikse reklam getirisi değerlendirmesi bozulur.

Lead kampanyasında Lead yalnızca formun başarılı şekilde kaydedildiği anda gönderilmelidir. Form sayfasının açılması Lead değildir. CRM'de satış ekibinin kabul ettiği nitelikli lead ayrı bir olay olarak tasarlanabilir. Ancak bu olayın Meta'ya aktarılması için CRM ve izin yapısının uyumlu olması gerekir.

Her olayın zorunlu veya önerilen alanları farklıdır. Genel olarak event_name, event_time, action_source ve event_id temel alanlardır. Kullanıcı eşleştirmesi için e-posta, telefon, IP adresi, tarayıcı bilgisi veya fbc ve fbp gibi alanlar kullanılabilir.

E-posta ve telefon gibi tanımlayıcılar Meta'ya gönderilmeden önce gerekli biçimde normalize edilip hash'lenmelidir. Hash uygulamak, izin gerekliliğini ortadan kaldırmaz. Ham kişisel verileri log dosyalarında bırakmak da güvenlik riski oluşturur.

Sunucu tarafında gönderilen olayın event_time değeri, gerçek olay zamanını temsil etmelidir. Saat dilimi hatası, reklam raporlarında gün kaymasına yol açabilir. Olay sırası da önemlidir; Purchase, InitiateCheckout'tan önce görünmemelidir.

Olay listesini hazırlarken iş hedefiyle veri ihtiyacını karşılaştırın. Sadece PageView göndermek, satış optimizasyonu için yetersizdir. Tüm etkileşimleri göndermek ise raporlama ve tanı ekranlarında gereksiz karmaşa yaratabilir.

Çerez izni ve KVKK açısından CAPI Gateway nasıl yönetilir?

CAPI Gateway, çerez izni ve KVKK yükümlülüklerini ortadan kaldırmaz; yalnızca veri aktarımının teknik kanalını değiştirir. Kullanıcının ölçüm izni vermediği durumda hangi olayların gönderilmeyeceği açıkça tanımlanmalıdır.

Çerez yönetim platformu, kullanıcı tercihlerini sitenin veri katmanına veya sunucuya iletmelidir. Kullanıcı reklam ve analiz çerezlerine izin vermediyse Pixel ve CAPI davranışı buna göre sınırlandırılabilir. Bu karar, hukuk danışmanlığı ve işletmenin aydınlatma metinleriyle birlikte uygulanmalıdır.

İzin verildikten sonra oluşan olaylarda fbp, fbc, e-posta veya telefon gibi eşleştirme alanları gönderilebilir. İzin yokken bu alanları toplamaya devam etmek, teknik ölçüm hedefi uğruna veri minimizasyonunu ihlal edebilir.

Lead formlarında açık rıza, aydınlatma metni ve iletişim izni aynı şey değildir. Kullanıcı formu göndermiş olabilir; bu durum reklam kişiselleştirme izni verdiği anlamına gelmez. Formdaki tercih alanları ayrı kaydedilmelidir.

Sunucu loglarında e-posta, telefon ve sipariş bilgileri gereksiz süre tutulmamalıdır. Yetki, saklama süresi ve silme prosedürü belirlenmelidir. Gateway sağlayıcısının veri işleme ve bölgesel barındırma koşulları ayrıca incelenmelidir.

İzin yönetimi çalışmıyorsa CAPI kurulumu beklenen ölçüm artışını sağlamaz. Çünkü sistem, tarayıcıda engellenen veriyi sınırsız biçimde geri getiremez. CAPI'nin amacı izinli olayların daha güvenilir aktarılmasıdır.

Bu nedenle teknik dokümana üç durum eklenmelidir: izin verilmiş kullanıcı, izin reddetmiş kullanıcı ve tercih belirtmemiş kullanıcı. Her durumda hangi event_name ve user_data alanlarının gönderileceği test edilmelidir.

Meta CAPI Gateway kurulumu nasıl test edilir ve hata bulunur?

Meta CAPI Gateway kurulumu, Test Events ve Diagnostics ekranlarında olayların doğru göründüğü doğrulanmadan tamamlanmış sayılmaz. İlk testte tek bir PageView veya kontrollü Lead gönderin.

Test olayının Events Manager içinde görünmesi, bağlantının çalıştığını gösterir. Ancak event_id, event_time, action_source, value, currency ve eşleştirme alanları da incelenmelidir. Sadece olay sayısını kontrol etmek yeterli değildir.

Diagnostics ekranında missing parameter, deduplication, event match quality ve invalid user data uyarıları görülebilir. Uyarının metnini kopyalayıp hangi event_name için oluştuğunu belirleyin. Aynı hata tüm olaylarda mı, yalnızca Purchase olayında mı görülüyor?

Purchase testi için sipariş tutarı, para birimi ve sipariş kimliği kontrol edilmelidir. Test siparişi mağaza panelinde oluşmuş, Gateway'de görünmüş ve Pixel ile yalnızca bir kez eşleşmiş olmalıdır. Meta raporu ile mağaza raporunu aynı tarih aralığında karşılaştırın.

Lead testi için formun başarılı gönderim koşulunu kontrol edin. Hata mesajı alan veya zorunlu alanı doldurmayan kullanıcı Lead olarak sayılmamalıdır. CRM'e kaydedilen lead sayısı ile Meta'daki Lead sayısı birebir olmak zorunda değildir; farkın nedeni belgelenmelidir.

Tarayıcı geliştirici araçlarında Pixel isteğini, sunucu loglarında Gateway isteğini ayrı izleyin. Aynı event_id iki kanalda bulunuyor mu, event_name aynı mı ve event_time değerleri tutarlı mı kontrol edin.

Test sırasında aşağıdaki sıra kullanılabilir:

1. İzin tercihi verin ve test kullanıcısıyla sayfayı açın.
2. Ürün görüntüleme veya form gönderimi gerçekleştirin.
3. Pixel isteğinde event_name ve event_id değerini kontrol edin.
4. Gateway logunda aynı değerleri arayın.
5. Events Manager'da olayın eşleşme ve deduplikasyon durumunu inceleyin.
6. Hataları düzelttikten sonra aynı senaryoyu yeni event_id ile tekrarlayın.

Gerçek kampanyayı açmadan önce en az bir satın alma ve bir lead akışını uçtan uca test edin. Test tamamlanmazsa düşük veri kalitesi, kampanya optimizasyonundan önce teknik hata olarak ele alınmalıdır.

Meta CAPI Gateway kurulumunda en sık hangi hatalar yapılır?

Meta CAPI Gateway kurulumunda en sık görülen hatalar yanlış veri kaynağı, eksik event_id, izinsiz veri aktarımı ve test edilmemiş dönüşüm olaylarıdır. Bu hatalar raporların güvenilirliğini doğrudan etkiler.

İlk hata, farklı sitelerin veya markaların olaylarını aynı Pixel'e bağlamaktır. Birden fazla alan adı aynı veri kaynağını kullanacaksa olay ayrımı, izin yapısı ve raporlama ihtiyacı önceden kararlaştırılmalıdır. Aksi halde kampanya sonuçları markalar arasında karışabilir.

İkinci hata, Pixel ve CAPI'yi aynı olay için farklı kimliklerle çalıştırmaktır. Bu durum Purchase sayısını yapay biçimde artırabilir. Meta'da görülen dönüşüm artışı, mağaza veya CRM verisiyle doğrulanmadan başarı kabul edilmemelidir.

Üçüncü hata, PageView sayısındaki artışı dönüşüm kalitesi zannetmektir. Sunucu taraflı PageView gönderimi, satış veya lead üretmez. Optimize edilecek olayın gerçek iş sonucuna yakın olması gerekir.

Dördüncü hata, value ve currency alanlarını sabit veya yanlış göndermektir. Türkiye'de kullanılan para birimi, işletmenin gerçek satış para birimiyle uyumlu olmalıdır. İade, iptal ve vergi dahil tutarların nasıl raporlanacağı yazılı kurala bağlanmalıdır.

Beşinci hata, CRM'den gelen lead olaylarını zaman damgası ve kullanıcı eşleştirme bilgisi olmadan aktarmaktır. CRM aktarımı yapılacaksa olayın hangi form veya reklam etkileşiminden geldiği belirlenmelidir.

Altıncı hata, Gateway kurulduktan sonra bakım planı oluşturmamaktır. Alan adı değişikliği, ödeme altyapısı güncellemesi, çerez yöneticisi değişimi veya form kodu yenilemesi ölçümü bozabilir. Her sürüm değişikliğinden sonra kısa bir test senaryosu çalıştırılmalıdır.

Meta CAPI Gateway performansı nasıl izlenir?

Meta CAPI Gateway performansı, olay hacmi, eşleşme kalitesi, deduplikasyon durumu ve işletme verisiyle karşılaştırma üzerinden izlenir. Tek bir göstergeye bakarak kurulumun başarılı olduğu söylenemez.

Haftalık kontrolde Events Manager Diagnostics uyarıları, son alınan olay zamanı ve olay kaynakları incelenmelidir. Özellikle Purchase ve Lead olaylarının kesildiği günler, site veya CRM değişiklikleriyle karşılaştırılmalıdır.

Reklam hesabındaki dönüşümler, mağaza siparişleri veya CRM kayıtlarıyla aynı tarih aralığında kıyaslanmalıdır. Aradaki fark için kesin bir sektör oranı vermek doğru değildir. Atıf penceresi, izin durumu, reklam engelleyiciler, iptaller ve platform modellemesi sonucu etkileyebilir.

Bir tablo oluşturup şu alanları haftalık kaydedin: Meta Purchase, mağaza siparişi, Meta Lead, CRM lead, sunucu olay sayısı, tarayıcı olay sayısı ve Diagnostics uyarıları. Böylece ani sapmalar kolayca görülür.

Eşleşme kalitesi düşükse kullanıcı verilerinin izinli şekilde aktarılıp aktarılmadığını, e-posta ve telefon biçimlendirmesini, fbp ve fbc değerlerinin korunup korunmadığını kontrol edin. Bu alanları rastgele doldurmak yerine yalnızca gerçek kullanıcı etkileşiminden üretin.

Deduplikasyon oranı sorunluysa event_id'nin iki kaynakta aynı olup olmadığını inceleyin. Sunucu olayları sürekli artıyor ancak Pixel olaylarıyla birleşmiyorsa iki farklı entegrasyon aynı dönüşümü gönderiyor olabilir.

Kampanya performansı da teknik izlemenin parçasıdır. CAPI sonrası sonuçları önceki dönemle karşılaştırırken bütçe, kreatif, hedef kitle, teklif stratejisi ve dönüşüm penceresini sabit tutmaya çalışın. Değişkenler aynı değilse yalnızca Gateway etkisi çıkarılamaz.

Meta CAPI Gateway ne zaman kullanılmalı ve ne zaman yeterli olmaz?

Meta CAPI Gateway, Pixel verisinin tarayıcı kısıtlamaları nedeniyle eksildiği ve işletmenin sunucu taraflı olay gönderebildiği durumlarda kullanılmalıdır. Özellikle e-ticaret Purchase ve CRM'e kaydedilen Lead olayları için anlamlıdır.

Ödeme işlemi harici bir sağlayıcıda tamamlanıyorsa CAPI, ödeme sonucunu sunucudan doğrulayarak daha tutarlı aktarım sağlayabilir. Form kayıtları CRM'e düşüyorsa, nitelikli lead olayının reklam sistemiyle ilişkilendirilmesi de mümkün olabilir.

Ancak Gateway, kötü tanımlanmış dönüşüm stratejisini düzeltmez. İşletme hangi olayın satış, hangi olayın nitelikli lead olduğunu bilmiyorsa önce ölçüm planı hazırlanmalıdır. Yanlış olayları daha güvenilir göndermek, yanlış optimizasyonu güçlendirir.

Çerez izni alınamayan veya kişisel veri aktarımı hukuken uygun olmayan durumlarda Gateway kullanılamaz. Ayrıca geliştirici erişimi olmayan, olayları sunucuya taşıyamayan çok basit sitelerde doğrudan fayda sınırlı kalabilir.

Yüksek hacimli ve özel veri akışları olan işletmeler doğrudan CAPI veya sunucu tarafı etiketleme çözümünü tercih edebilir. Ürün, abonelik, offline satış ve CRM olaylarının karmaşık biçimde birleştiği yapılarda özel mimari gerekebilir.

Meta reklam maliyetlerini değerlendirirken ölçüm kalitesi de hesaba katılmalıdır. CPM, CPC ve CPL tanımlarını karşılaştırmak için Meta reklam maliyetleri rehberine bakabilirsiniz. Ölçüm eksikse düşük CPL görünen kampanya gerçekte daha fazla niteliksiz lead üretiyor olabilir.

Kurulumdan sonra reklam politikaları ve veri kullanımı da kontrol edilmelidir. Özellikle sağlık, finans ve kişisel özelliklerle ilgili kampanyalarda Meta reklam politikalarındaki yasaklı ve kısıtlı içerik kurallarını inceleyin.

Özetle Gateway, sunucu taraflı ölçüm için teknik bir taşıma katmanıdır. Başarılı sonuç için doğru event tasarımı, izin yönetimi, event_id deduplikasyonu, test ve düzenli karşılaştırma birlikte uygulanmalıdır.