Dijital Pazarlama

Meta Conversions API (CAPI) Kurulumu: Pixel ve Sunucu Olayları, event_id Tekilleştirme ve Eşleşme Kalitesi

15 Kasım 2026 45 dakika okuma
#Meta Conversions API#Meta Pixel#CAPI#Meta Ads#Dönüşüm Takibi
Paylaş
Bu içeriği yapay zekâ (AI) ile özetleyin

Meta Conversions API (CAPI) kurulumunu platformdan bağımsız olarak, olayın içinde neyin gittiğine kadar anlatan teknik rehber: Pixel ile sunucu olaylarını event_id ile tekilleştirme, fbp ve fbc çerezleri, e-posta ve telefonun normalize edilip SHA-256 ile hash'lenmesi, action_source, event_source_url ve event_time kuralları, test_event_code ile doğrulama, Event Match Quality'yi yükseltme, standart olay eşlemesi, CAPI Gateway, GTM sunucu konteyneri ve doğrudan API karşılaştırması, ikas ve Shopify entegrasyonlarının sınırları, KVKK dikkat noktaları ve en yaygın hatalar.

Kısa cevap: Meta Conversions API (CAPI), web sitenizdeki dönüşümleri ziyaretçinin tarayıcısı yerine sunucunuzdan Meta'ya ileten bağlantıdır ve Pixel'in yerine değil, onunla birlikte kurulur. Doğru kurulumda aynı olay (örneğin bir satın alma) hem tarayıcıdaki Pixel'den hem sunucudan gönderilir; ikisi aynı event_name ve aynı event_id değerini taşıdığı için Meta onu bir kez sayar. Sunucu olayında e-posta ve telefon gibi müşteri bilgileri normalize edilip SHA-256 ile hash'lenir, tıklama ve tarayıcı kimliği için fbc ve fbp çerez değerleri, ayrıca IP adresi ve tarayıcı bilgisi (user agent) eklenir. Zaman damgası saniye cinsinden ve UTC olarak gider, web olaylarında action_source "website" olur ve olayın gerçekleştiği adres event_source_url alanına yazılır. Kurulumu Events Manager'daki test kodu (test_event_code) ile doğrular, Event Match Quality puanını izleyerek eşleşmeyi iyileştirir, canlıya geçerken test kodunu mutlaka kaldırırsınız. ikas ve Shopify'ın yerleşik entegrasyonları bu işin büyük bölümünü sizin yerinize yapar ama sınırları vardır; özel yazılım bir sitede ise kurulumu doğrudan API ile kendiniz yönetirsiniz.

Bu rehber, CAPI'yi bir panelde "bağla" düğmesine basmanın ötesinde, olayın içinde tam olarak neyin gittiğini anlamak isteyenler için yazıldı. ikas panelinde Pixel kimliğini ve erişim anahtarını hangi alana yapıştıracağınızı adım adım merak ediyorsanız ikas'ta GA4, Meta Pixel ve Search Console kurulumu rehberimiz o işi anlatıyor. Burada ise platformdan bağımsız olarak bir CAPI olayının anatomisini, tekilleştirmenin kurallarını, hash'leme ve normalizasyon ayrıntılarını, kurulum yollarının karşılaştırmasını, KVKK tarafındaki dikkat noktalarını ve sahada en sık gördüğümüz hataları ele alıyoruz. Yer yer Alis Dijital'in kendi sitesinde çalışan Pixel + CAPI kurulumundan edindiğimiz deneyimi de paylaşıyoruz.

Meta Conversions API (CAPI) nedir, Pixel'den farkı ne?

Conversions API, Meta'nın sunucudan sunucuya çalışan olay gönderim arayüzüdür; Pixel ise ziyaretçinin tarayıcısında çalışan bir JavaScript kodudur. İkisi de aynı amaca hizmet eder: sitenizde olan bir eylemi (ürün görüntüleme, sepete ekleme, form doldurma, satın alma) Meta'ya bildirmek ki reklam sistemi hangi reklamın sonuç getirdiğini ölçebilsin ve teslimatı bu sinyale göre optimize edebilsin.

Fark, olayın nereden çıktığındadır. Pixel olayı tarayıcıdan gönderir; reklam engelleyici, tarayıcının izleme kısıtlamaları, yavaş bağlantıda yarım kalan sayfa yüklemesi ya da ziyaretçinin çerezleri reddetmesi bu gönderimi engelleyebilir. CAPI olayı ise sizin sunucunuzdan, Meta'nın Graph API uç noktasına doğrudan gider. Bu yüzden tarayıcıda yaşanan kayıplardan etkilenmez ve tarayıcının hiç görmediği olayları (örneğin ödeme sağlayıcısının sunucunuza bildirdiği onaylanmış bir ödemeyi) da gönderebilir.

Tarayıcı olayı ile sunucu olayı aynı satışı nasıl anlatır?

Bir müşteri Instagram reklamına tıklayıp sitenize geldiğinde ve bir ürün satın aldığında, teşekkür sayfası açılırken Pixel bir Purchase olayı gönderir. Aynı anda ya da birkaç saniye önce, ödeme sağlayıcınız ödemenin onaylandığını sunucunuza bildirir ve sunucunuz da CAPI ile bir Purchase olayı gönderir. Meta'ya aynı satış için iki ayrı haber ulaşır. Bu iki haberin aynı satışa ait olduğunu Meta'nın anlayabilmesi için ikisinin de aynı olay adını ve aynı olay kimliğini taşıması gerekir; buna tekilleştirme (deduplication) denir ve rehberin ilerleyen bölümünde ayrıntısıyla anlatılıyor.

CAPI Pixel'in yerine geçer mi?

Hayır. Meta'nın Conversions API en iyi uygulamalar dokümanı, CAPI'nin Pixel'e ek olarak kullanılmasını ve aynı olayların iki araçla birlikte paylaşılmasını öneriyor; Meta bunu "yedekli kurulum" (redundant setup) olarak adlandırıyor. Pixel'in tarayıcıda topladığı bazı bilgiler (sayfa bağlamı, otomatik toplanan tarayıcı sinyalleri) sunucuda kendiliğinden bulunmaz; sunucu ise tarayıcının kaçırdığı olayları yakalar. İkisi birbirinin açığını kapatır.

ÖzellikMeta Pixel (tarayıcı)Conversions API (sunucu)
Nerede çalışır?Ziyaretçinin tarayıcısında, JavaScript olarakSizin sunucunuzda ya da platformun sunucusunda
Reklam engelleyiciden etkilenir mi?Evet, gönderim engellenebilirHayır, tarayıcıdan bağımsızdır
Yarım kalan sayfa yüklemesiOlay hiç çıkmayabilirSunucu olayı sayfadan bağımsız gider
IP ve tarayıcı bilgisiKendiliğinden eklenirSizin eklemeniz gerekir
fbp ve fbc çerezleriPixel kendisi okur ve yazarİstekten okuyup sizin göndermeniz gerekir
Müşteri bilgisi (e-posta, telefon)Gelişmiş eşleştirme açıksa Pixel hash'lerSiz normalize edip SHA-256 ile hash'lersiniz
Tarayıcının görmediği olaylarGönderemezGönderebilir (ödeme onayı, CRM, mağaza içi satış)
Kurulum emeğiDüşük, çoğu platformda tek alanPlatforma göre tek alandan yazılım geliştirmeye kadar

Pixel'in ne olduğunu ve Meta reklamlarında ölçümün kampanya kurgusuyla ilişkisini temelden okumak isteyenler için Instagram ve Facebook'ta ilk kampanya rehberimiz iyi bir başlangıç noktası.

CAPI kurmadan önce hangi kararları vermelisiniz?

CAPI kurulumunun en çok zaman kazandıran adımı, teknik işe girişmeden önce hangi olayların hangi kanaldan gideceğine, olay kimliklerinin nerede üretileceğine ve hesap sahipliğine karar vermektir. Bu kararlar baştan verilmezse kurulum çalışır görünür ama rakamlar ya şişer ya eksik kalır ve hatanın kaynağını bulmak haftalar alır.

Hangi olaylar iki kanaldan, hangileri tek kanaldan gidecek?

Her olayı hem Pixel'den hem CAPI'den göndermek zorunda değilsiniz. Meta'nın tekilleştirme dokümanı, aynı olayı iki kanaldan hiç göndermiyorsanız o olay için tekilleştirme kurmanıza gerek olmadığını belirtir. Pratikte kararı olayın değeri ve hacmi belirler. Satın alma ve form gibi az sayıda ama çok değerli olaylar mutlaka iki kanaldan, sağlam bir olay kimliğiyle gitmelidir. Sayfa görüntüleme gibi çok yüksek hacimli olaylarda ise sunucuya ek yük getirmek her zaman karşılığını vermez.

Kendi sitemizde bu kararı şöyle verdik: sayfa görüntüleme (PageView) yalnız tarayıcıdaki Pixel'den gidiyor; ürün ve hizmet görüntüleme, sepete ekleme ve ödeme başlatma olayları hem Pixel'den hem sunucudan aynı kimlikle gidiyor; form gönderimi (Lead) ve ödeme (Purchase) ise asıl olarak sunucuda doğrulanan bilgiyle gönderiliyor ve tarayıcı aynı kimlikle Pixel olayını atıyor. Bu, her işletmeye uyan tek doğru değil ama "neden böyle?" sorusuna cevabı olan bilinçli bir tasarım.

Veri kümesi (dataset), erişim anahtarı ve sahiplik

Meta, Pixel'i Events Manager'da artık "veri kümesi" (dataset) adı altında yönetiyor; ikas'ın yardım sayfası da Pixel kimliğini "Dataset ID" olarak anıyor. CAPI için ayrıca bir erişim anahtarı (access token) gerekir. ikas'ın yardım merkezine göre bu anahtar Events Manager'da veri kümesinin Ayarlar sekmesindeki Conversions API bölümünde, "Generate Access Token" düğmesiyle üretilir.

Bu anahtar bir şifre gibi korunmalıdır: kimin elindeyse veri kümenize olay yazabilir. Anahtarı tarayıcıya giden koda, tema dosyasına ya da herkese açık bir depoya koymayın; sunucu tarafındaki gizli ayarlarda (ortam değişkeni ya da şifreli entegrasyon kaydı) saklayın. Veri kümesinin ve reklam hesabının şirketinize ait Business hesabında durması, ajans değişse bile ölçüm geçmişinizin sizde kalmasını sağlar.

Alan adı doğrulaması ve izinli alan adları

Meta'nın sunucu olayı parametreleri dokümanı, event_source_url değerinin doğrulanmış alan adınızla eşleşmesi gerektiğini belirtir. Bu yüzden kurulumdan önce alan adınızı Business hesabınızda doğrulayın. ikas'ın yardım sayfası ayrıca Events Manager'da izinli alan adları listesi (allowlist) oluşturmayı öneriyor; böylece Pixel'iniz başka sitelerden gelen verileri kabul etmez. Bu ayar, birinin Pixel kimliğinizi kendi sitesine koyup veri kümenizi kirletmesini önler.

Kurulumdan önce hazır olması gerekenleri bir liste hâlinde toparlayalım:

  • Şirkete ait Business hesabı ve yönetici erişimi (kişisel profile bağlı hesaplar ileride sorun çıkarır).
  • Veri kümesi (Pixel) kimliği ve Events Manager'dan üretilmiş CAPI erişim anahtarı.
  • Doğrulanmış alan adı ve izinli alan adları listesi.
  • Olay planı: hangi olay, hangi anda, hangi kanaldan, hangi kimlikle gidecek (aşağıdaki eşleme tablosu bu iş için).
  • Çerez onayı kararı: pazarlama çerezlerini reddeden ziyaretçide hangi olayların gitmeyeceği (KVKK bölümüne bakın).
  • Test planı: test kodu, test siparişi ve test formu; kimin, ne zaman kontrol edeceği.

Kurulum yolları: yerleşik entegrasyon, CAPI Gateway, GTM sunucu konteyneri ve doğrudan API

CAPI'yi kurmanın tek bir yolu yoktur; altyapınıza, teknik ekibinize ve ne kadar kontrol istediğinize göre dört ana yoldan birini seçersiniz. Hazır bir e-ticaret altyapısı kullanıyorsanız ilk bakmanız gereken yer platformun yerleşik entegrasyonudur. Özel yazılım bir siteniz varsa doğrudan API en esnek yoldur. İkisinin arasında Meta'nın kendi CAPI Gateway çözümü ve Google Tag Manager'ın sunucu konteyneri durur.

YolKim barındırır?Maliyet türüevent_id kontrolüKime uygun?
Platformun yerleşik entegrasyonu (ikas, Shopify)PlatformGenelde pakete dahilPlatformda, sizde değilHazır altyapı kullanan mağazaların çoğu
Events Manager'daki tek tıklık Meta seçeneğiMetaSektör kaynaklarına göre ücretsizOtomatik, sizde değilYalnız web olayı olan, özelleştirme istemeyenler
Conversions API GatewaySizin bulut hesabınız ya da bir iş ortağıBulut kaynağı veya iş ortağı ücretiOtomatik üretilirKod yazmadan sunucu kanalı isteyen, bulut yönetebilen ekipler
GTM sunucu konteyneri (sGTM)Sizin sunucunuz (Google Cloud veya başka)Barındırma, trafiğe göreSizde, etiket yapılandırmasıylaBirden çok reklam platformunu tek akıştan beslemek isteyenler
Doğrudan Conversions APIKendi uygulama sunucunuzGeliştirme emeğiTamamen sizdeÖzel yazılım siteler, CRM ve çevrim dışı olaylar

Conversions API Gateway nedir?

Meta'nın geliştirici dokümanına göre Conversions API Gateway, Events Manager üzerinden kod yazmadan yapılandırılan, kendi kontrolünüzdeki bir bulut hesabında çalışan bir sunucu bileşenidir. Pixel her tarayıcı olayını hem Meta'ya hem güvenli bir bağlantıyla Gateway'e gönderir; Gateway bu olayları Conversions API biçimine çevirip Meta'ya iletir ve iki kanalı eşleştirmek için olay kimliğini kendisi üretir. Doküman, Gateway'in tek maliyetinin ilgili bulut kaynağı ya da iş ortağı ücreti olduğunu, birden çok Pixel'i ve tek kurulumda birden çok alan adını destekleyebildiğini belirtiyor.

Gateway'in sınırı, Pixel'e bağlı olmasıdır: tarayıcının hiç görmediği bir olayı (ödeme sağlayıcısından gelen sunucu bildirimi, CRM'de kapanan bir satış) kendi başına üretmez. Yani Gateway "Pixel'in gördüğünü sunucudan da gönder" işini iyi yapar, ama "tarayıcının kaçırdığı satışı yakala" işinde doğrudan API kadar güçlü değildir.

Events Manager'daki tek tıklık seçenek

Sektör kaynaklarının Nisan 2026'da aktardığına göre Meta, Events Manager'a veri kümesi kurulumu sırasında "Set up with Meta" adıyla sunulan, Pixel'in gönderdiği olayları sunucu tarafında da ileten tek tıklık bir seçenek ekledi. Aktarılan bilgilere göre bu seçenek yalnız web olaylarını kapsıyor, olay ya da parametre seçmenize izin vermiyor ve Pixel'in gönderdiği her şeyi aynen yansıtıyor. Bu bilgiyi Meta'nın geliştirici dokümanlarında ayrıntılı bir sayfa olarak doğrulayamadık; hesabınızda bu seçeneğin görünüp görünmediğini ve güncel adını Events Manager'da kontrol edin. Mantığı Gateway'e benzer: Pixel'in kaçırdığı tarayıcı olaylarını kurtarmaya yardımcı olabilir, ama sunucunuzun bildiği bilgiyi (onaylanmış ödeme, sipariş numarası, CRM durumu) eklemez.

Google Tag Manager sunucu konteyneri ile CAPI

Meta'nın sunucu taraflı GTM rehberine göre bu kurulumda web konteynerindeki GA4 etiketi verileri sizin etiketleme sunucunuza gönderir, sunucu konteynerindeki GA4 istemcisi bu isteği karşılar ve Meta'nın Template Gallery'de yayımladığı Conversions API etiketi olayı CAPI biçimine çevirip Meta'ya iletir. Google, etiketleme sunucusunun kendi alan adınızın bir alt alan adında (birinci taraf bağlamında) çalıştırılmasını güçlü biçimde öneriyor; Meta'nın rehberi de alan adı birinci tarafsa tarayıcı kimliği ve tıklama kimliğinin otomatik taşındığını belirtiyor.

sGTM'nin avantajı tek bir veri akışından GA4, Meta ve diğer platformları beslemek ve verinin hangi platforma ne kadar gideceğini merkezden yönetmektir. Bedeli, ayrı bir sunucunun bakımı, barındırma maliyeti ve yapılandırma bilgisidir. Meta'nın rehberi, kullanıcı bilgilerini sunucu konteynerine taşıyabilmek için GA4 tarafında birinci taraf veri toplama ayarının açılması, olay kimliğinin de bir olay parametresi olarak eklenmesi gerektiğini anlatıyor. Bu ayrıntılar atlandığında sGTM kurulumu çalışır ama eşleşme kalitesi düşük ve tekilleştirmesi bozuk kalır. Sunucu konteynerinin mimarisini, birinci taraf alt alan adını ve Consent Mode v2 ile birlikte nasıl çalıştığını sunucu taraflı izleme rehberimizde ele aldık.

Doğrudan Conversions API ile kurulum

Doğrudan kurulumda kendi sunucu kodunuz olayı hazırlar ve Meta'nın dokümanında verilen biçimdeki uç noktaya, yani graph.facebook.com/{sürüm}/{veri-kümesi-kimliği}/events adresine, erişim anahtarıyla birlikte POST eder. Meta'nın Business SDK'ları bu işi kolaylaştırır ve dokümana göre iletişim bilgilerini otomatik hash'ler; SDK kullanmadan düz HTTP isteğiyle de kurulabilir. Graph API sürümleri belirli bir takvimle emekliye ayrıldığı için sürüm numarasını kodda sabitleyip unutmayın; bu yazının hazırlandığı Kasım 2026'da Meta'nın örnek isteği v27.0 sürümünü kullanıyordu.

Bu yolun gücü, olayın her alanını sizin belirlemenizdir: olay kimliğini sipariş numarasından türetebilir, ödeme onaylanmadan satın alma göndermeyebilir, test siparişlerini filtreleyebilir, CRM'de kapanan bir teklifi aylar sonra bile ilgili olay olarak bildirebilirsiniz. Özel yazılım bir web sitesi ya da sipariş akışı kuruyorsanız, ölçüm katmanının da bu yazılımın parçası olarak tasarlanması gerekir; özel yazılım ve web sitesi hizmetimizde bunu kurulumun bir adımı olarak ele alıyoruz.

Hangi yolu seçmelisiniz?

  1. ikas ya da Shopify kullanıyorsanız önce platformun yerleşik entegrasyonunu kurun ve test edin. Çoğu mağaza için yeterlidir; üstüne ikinci bir CAPI katmanı eklemek çift sayım riskini artırır.
  2. Yerleşik entegrasyon yoksa ve yazılımcınız yoksa Events Manager'daki Meta seçeneklerine (tek tıklık seçenek ya da Gateway) bakın.
  3. Birden çok reklam platformunu tek akıştan yönetmek istiyorsanız ve sunucu bakımını üstlenebilecek bir ekibiniz varsa sGTM'yi değerlendirin.
  4. Özel yazılım bir siteniz, CRM'den gelen satışlarınız ya da telefonla, WhatsApp'tan, mağazada kapanan siparişleriniz varsa doğrudan API'yi seçin; bu olayları başka hiçbir yol taşıyamaz.

Bir CAPI olayının anatomisi: zorunlu ve önerilen alanlar

Her CAPI olayı üç parçadan oluşur: olayın kendisini tanımlayan üst alanlar (ad, zaman, kimlik, kaynak, adres), kişiyi eşleştirmeye yarayan user_data ve olayın ticari ayrıntısını taşıyan custom_data. Meta'nın sunucu olayı parametreleri dokümanına göre event_name, event_time ve action_source zorunludur; web olaylarında ayrıca event_source_url ve client_user_agent zorunlu sayılır. event_id teknik olarak isteğe bağlıdır ama tekilleştirme için önerilir; pratikte Pixel ile birlikte çalışan her kurulumda zorunlu kabul edilmelidir.

Aşağıdaki tablo, bir e-ticaret satın alma olayında gönderilen alanları örnek değerlerle gösteriyor. Değerler örnektir; hash'ler kısaltılmıştır.

AlanÖrnek değerNot
event_namePurchasePixel'deki olay adıyla birebir aynı olmalı (büyük-küçük harf dahil)
event_time1794742200Saniye cinsinden Unix zamanı, UTC; bu örnek 15 Kasım 2026, Türkiye saatiyle 14:30
event_idSIP-10045Pixel'deki eventID ile aynı; satın almada sipariş numarası idealdir
action_sourcewebsiteOlayın nerede gerçekleştiği
event_source_urlhttps://ornekmagaza.com/siparis-tamamlandiWeb olaylarında zorunlu; doğrulanmış alan adıyla eşleşmeli
user_data.em["8041b582…"]Normalize edilmiş e-postanın SHA-256 özeti
user_data.ph["7e330815…"]Ülke kodlu, yalnız rakamdan oluşan telefonun SHA-256 özeti
user_data.fbpfb.1.1794741000123.1234567890_fbp çerezinin değeri, hash'lenmez
user_data.fbcfb.1.1794740000456.IwAR…_fbc çerezi ya da adresteki fbclid'den üretilen değer, hash'lenmez
user_data.client_ip_address203.0.113.10Ziyaretçinin gerçek IP'si, asla hash'lenmez
user_data.client_user_agentMozilla/5.0 (…)Web olaylarında zorunlu, hash'lenmez
custom_data.value1250.00Satın almada zorunlu
custom_data.currencyTRYSatın almada zorunlu, üç harfli para birimi kodu
custom_data.content_ids["SKU-123"]Katalogdaki ürün kimliğiyle birebir aynı olmalı
custom_data.content_typeproductKimlikler ürünse product, ürün grubuysa product_group

action_source hangi değerleri alır?

action_source, dönüşümün nerede gerçekleştiğini söyler ve Meta'nın dokümanı bu alanı kullanarak değerin bildiğiniz kadarıyla doğru olduğunu kabul ettiğinizi belirtir. Web sitesindeki her olay için değer "website"tır. Diğer değerler, sitenin dışında kapanan satışları doğru sınıflandırmak içindir.

DeğerNe zaman kullanılır?Türkiye'deki tipik örnek
websiteOlay web sitenizde gerçekleştiyseSiteden satın alma, form gönderimi
appMobil uygulamanızda gerçekleştiyseUygulama içi satın alma
phone_callTelefonda kapandıysaReklamdan arayıp telefonda verilen sipariş
chatMesajlaşma uygulaması, SMS ya da canlı sohbet üzerindenWhatsApp'tan alınan sipariş
business_messagingMessenger, Instagram ya da WhatsApp'a yönlendiren reklamlardanWhatsApp'a tıklatan reklamdan gelen konuşma
physical_storeFiziksel mağazada yüz yüzeShowroom satışı
emailE-posta üzerindenE-postayla onaylanan sipariş
system_generatedOtomatik gerçekleşen işlemlerAbonelik yenilemesi
otherHiçbirine uymuyorsaNadiren gerekir

event_time: saniye, UTC ve 7 gün kuralı

event_time, olayın gerçekten gerçekleştiği anın saniye cinsinden Unix zaman damgasıdır ve Meta'nın dokümanı bunun GMT (UTC) olarak gönderilmesini şart koşar. Olayı gönderdiğiniz an ile olayın gerçekleştiği an farklı olabilir; event_time ikincisini göstermelidir. Doküman, event_time'ın gönderim anından en fazla 7 gün önce olabileceğini, bir istekteki herhangi bir olay 7 günden eskiyse isteğin tamamının hata döneceğini ve hiçbir olayın işlenmeyeceğini belirtir. Fiziksel mağaza olaylarında ise Meta, işlemlerin dönüşümden sonraki 62 gün içinde yüklenmesini öneriyor.

Türkiye 2016'dan bu yana yıl boyu UTC+3 kullanıyor. Bu yüzden yerel saati UTC sanarak zaman damgası üretmek, olayları üç saat ileriye kaydırır: Türkiye saatiyle 14:30'da gerçekleşen bir satın alma doğru hesaplandığında 1794742200 olur, yerel saat yanlışlıkla UTC kabul edilirse 1794753000 olur. JavaScript'in Date.now() fonksiyonu milisaniye döndürdüğü için bin ile bölmeyi unutmak da yaygın bir hatadır; 13 haneli bir değer saniye değil milisaniyedir.

event_source_url ve referrer_url

event_source_url, olayın gerçekleştiği sayfanın tam adresidir ve web olaylarında zorunludur. Sunucuda bu adresi bilmek her zaman kolay değildir: form gönderimi bir API rotasına gidiyorsa, isteğin geldiği sayfa ya tarayıcıdan gövdede gönderilir ya da istek başlığındaki referrer bilgisinden okunur. Meta ayrıca isteğe bağlı bir referrer_url alanı tanımlar; bu, olayı tetikleyen sayfanın tarayıcıda gördüğü yönlendiren adrestir, yani genellikle bir önceki sayfa.

Burada gözden kaçan bir gizlilik noktası var: adresinde kişisel bilgi ya da erişim anahtarı taşıyan sayfalar (sipariş takip bağlantısı, kişiye özel ödeme bağlantısı, şifre sıfırlama sayfası) event_source_url ile birlikte Meta'ya da gider. Kendi sitemizde adresinde böyle bir bilgi taşıyan sayfalarda pazarlama etiketlerini hiç yüklemiyoruz. Siz de en azından bu adreslerdeki sorgu parametrelerini göndermeden önce temizleyin.

event_id ile tekilleştirme nasıl çalışır?

Meta, tarayıcıdan gelen Pixel olayı ile sunucudan gelen CAPI olayını hem olay adı hem olay kimliği eşleştiğinde aynı olay sayar ve yalnız birini tutar. Meta'nın Pixel ve sunucu olaylarını tekilleştirme dokümanına göre Pixel'deki eventID değeri CAPI'deki event_id ile, Pixel'deki olay adı da CAPI'deki event_name ile eşleşmelidir. Bu iki koşuldan biri tutmazsa Meta iki ayrı olay görür ve aynı satış raporlarda iki kez sayılır.

Tekilleştirmenin bir zaman penceresi vardır. Doküman, olayların yalnız belirli bir event_id ile gelen ilk olaydan sonraki 48 saat içinde ulaşırlarsa tekilleştirildiğini ve Meta'nın genellikle ilk ulaşan olayı tutup sonrakileri attığını belirtir. Sunucu olayı parametreleri dokümanı bir ayrıntı daha ekler: tarayıcı ve sunucu olayı yaklaşık aynı anda, yani birbirinden 5 dakika içinde gelirse Meta tarayıcı olayını tercih eder. Bu yüzden sunucu olayını da tarayıcı olayına yakın zamanda göndermek, iki kanalın birbirini tamamlamasını kolaylaştırır.

Pixel tarafında eventID nereye yazılır?

Meta'nın dokümanına göre Pixel'de eventID, fbq track çağrısının dördüncü argümanıdır. Yani satın alma için tarayıcıda yazılan çağrı kavramsal olarak şöyledir: fbq('track', 'Purchase', {value: 1250, currency: 'TRY'}, {eventID: 'SIP-10045'}). Üçüncü argüman olayın ticari ayrıntısını (custom_data karşılığı), dördüncü argüman olay kimliğini taşır. En sık yapılan hata, eventID'yi üçüncü argümanın içine bir alan gibi koymaktır; bu durumda Pixel olayı kimliksiz gider ve tekilleştirme çalışmaz.

Tek bir sayfada birden fazla Pixel varsa trackSingle çağrısı da aynı şekilde olay kimliği alır. Kodla değil de bir etiket yöneticisiyle çalışıyorsanız, Pixel etiketindeki "Event ID" alanının gerçekten doldurulduğunu ve sunucuya giden değerle aynı değişkenden beslendiğini kontrol edin.

event_id nerede ve nasıl üretilmeli?

Olay kimliği, olayın doğduğu yerde bir kez üretilmeli ve iki kanala da aynı değer olarak taşınmalıdır. Meta, sipariş numarası ya da işlem kimliği gibi doğal bir kimlik varsa onun kullanılmasını, yoksa iki kanala aynı gönderildiği sürece rastgele bir değerin de olur olduğunu söylüyor. Pratik kurallar şunlar:

  • Purchase: sipariş numarası ya da ödeme işlem kimliği. Sunucu ödemeyi onayladığında bu kimlikle CAPI olayı gider, teşekkür sayfası aynı kimlikle Pixel olayını atar. Sayfa yenilense bile kimlik değişmediği için ikinci satın alma sayılmaz.
  • Lead: form tarayıcıda gönderilmeden hemen önce rastgele bir kimlik (örneğin UUID) üretilir, form verisiyle birlikte sunucuya gönderilir; sunucu CAPI Lead'ini bu kimlikle atar, tarayıcı da gönderim başarılı olunca aynı kimlikle Pixel Lead'ini atar.
  • ViewContent, AddToCart, InitiateCheckout: tarayıcı kimliği üretir, Pixel olayını atar ve aynı kimliği sunucudaki bir röle uç noktasına gönderir; sunucu IP, tarayıcı bilgisi ve çerezleri ekleyip CAPI olayını yollar.
  • Asla: her kanalda ayrı kimlik üretmek, kimliği zaman damgasından türetip iki tarafın farklı saniyeye denk gelmesine izin vermek ya da tüm olaylara aynı sabit kimliği vermek. Son durumda Meta farklı olayları birbirinin kopyası sanıp atar.

Alternatif yöntem: external_id ve fbp ile tekilleştirme

Meta ikinci bir yöntem de tanımlar: olay adıyla birlikte fbp ve/veya external_id değerlerini iki kanaldan tutarlı biçimde göndermek. Ancak doküman bu yöntemin genel olarak yalnız önce tarayıcıdan, sonra sunucudan gelen olaylarda çalıştığını ve son 48 saatte tarayıcı olayı alınmamışsa sunucu olayının atılmayacağını belirtiyor. Yani sunucu olayı önce ulaşırsa bu yöntem tekilleştirme yapmaz. Bu yüzden asıl dayanağınız event_id olmalı; Meta'nın en iyi uygulamalar rehberi de mümkün olan her olayda event_id, external_id ve fbp'nin birlikte gönderilmesini öneriyor.

SenaryoMeta ne görür?Sonuç
Aynı olay adı, aynı event_id, 48 saat içindeTek olayDoğru: bir kez sayılır
Aynı olay adı, farklı event_idİki olayÇift sayım
Pixel'de eventID yok, sunucuda event_id varİki olay (fbp ve external_id yöntemi devreye girmezse)Büyük olasılıkla çift sayım
Aynı event_id, farklı olay adı (örneğin Lead ve FormSubmit)İki farklı olayÇift sayım ya da yanlış olay
Aynı event_id, ikinci olay 48 saatten sonraİki olayGecikmeli gönderimde çift sayım
Olay yalnız tek kanaldan gidiyorTek olayTekilleştirmeye gerek yok
Tüm olaylara aynı sabit event_idİlk olaydan sonrakiler kopya sanılırOlay kaybı

fbp ve fbc çerezleri: tıklamayı sunucuya nasıl taşırsınız?

fbp tarayıcıyı, fbc ise reklam tıklamasını tanımlayan iki birinci taraf çerezidir ve CAPI'de hash'lenmeden, olduğu gibi gönderilir. Meta'nın fbp ve fbc dokümanına göre Pixel birinci taraf çerezleri kullandığında tarayıcıya _fbp çerezini kendisi yazar; biçimi fb.alt-alan-adı-sırası.oluşturma-zamanı.rastgele-sayı şeklindedir. Bir reklama tıklandığında adrese eklenen fbclid parametresi de _fbc çerezine fb.alt-alan-adı-sırası.oluşturma-zamanı.fbclid biçiminde yazılır. Oluşturma zamanı milisaniye cinsindendir; alt alan adı sırası, çerezin tanımlandığı alana göre com için 0, ornek.com için 1, www.ornek.com için 2'dir.

fbc, CAPI olayını belirli bir reklam tıklamasına bağlayan en güçlü sinyallerden biridir. Meta, fbc'nin CAPI'ye gönderilen her olayla birlikte gönderilmesini öneriyor. Sunucu olaylarında bu çerezleri istek başlığındaki cookie bilgisinden okursunuz; formu ya da ödemeyi işleyen sunucu rotası bu çerezleri görmüyorsa, fbc ve fbp olaysız kalır ve eşleşme zayıflar.

fbc'yi sunucuda kendiniz nasıl üretirsiniz?

Meta'nın dokümanı, Pixel çalışmıyor ama sayfa adresinde fbclid parametresi varsa fbc değerinin sunucuda üretilmesini de tarif ediyor. Adımlar kısaca şöyle:

  1. fbclid değerini isteğin sorgu dizesinden okuyun.
  2. Değeri hiç değiştirmeyin; doküman tıklama kimliğinin büyük-küçük harfe duyarlı olduğunu, küçük ya da büyük harfe çevrilmemesi gerektiğini vurguluyor.
  3. Oluşturma zamanı olarak bu fbclid'i ilk gördüğünüz anın milisaniye zaman damgasını kullanın.
  4. Değeri sunucuda üretip çerez olarak saklamıyorsanız alt alan adı sırası olarak 1 kullanın.
  5. Parçaları birleştirin: fb.1.oluşturma-zamanı.fbclid.

Çerezi kendiniz yazacaksanız Meta'nın tarif ettiği ömür 90 gündür. Doküman ayrıca yeni bir _fbc çerezinin yalnız iki durumda yazılmasını söyler: hiç _fbc çerezi yoksa ve adreste fbclid varsa, ya da adresteki fbclid mevcut çerezdekinden farklıysa. Yani aynı tıklamanın çerezini her sayfada yeniden yazmazsınız, ama aynı kişi yeni bir reklama tıklayıp geldiğinde eskisinin üzerine yazarsınız.

Çerez sunucuya ulaşmadıysa ne olur?

Kendi kurulumumuzda karşılaştığımız bir durum: ziyaretçinin siteye ilk girişinde Pixel _fbp çerezini yazar, ama bu çerez henüz o sayfadan sunucuya giden ilk isteklerde bulunmayabilir. Sunucu yalnız istek başlığındaki çereze bakarsa ilk olaylar fbp'siz gider. Bu yüzden tarayıcının sunucuya gönderdiği olay isteğinin gövdesine fbp ve fbc değerlerini de ekliyoruz; sunucu önce istekteki çereze, o yoksa gövdedeki değere bakıyor. Basit bir yedek ama soğuk ilk ziyaretlerde eşleşme kalitesini korumaya yardım ediyor.

Tek sayfa uygulamalarda ve gecikmeli yüklenen Pixel'de fbclid kaybı

Sayfa hızı için Pixel kütüphanesini ilk etkileşime kadar ertelemek yaygın bir optimizasyondur ve Pixel'in kendi taban kodu olayları bir kuyrukta beklettiği için eventID'ler korunur. Ancak test ortamımızda şunu ölçtük: Pixel kütüphanesi, tıklama kimliğini çalıştığı andaki adresten okuyor. Ziyaretçinin ilk hareketi site içi bir bağlantıya tıklamaksa ve site tek sayfa uygulaması (SPA) gibi adresi sayfayı yenilemeden değiştiriyorsa, kütüphane geldiğinde fbclid artık adreste olmuyor ve olaylar fbc'siz gidiyor.

Bu kaybı iki önlemle kapattık. Birincisi, sayfa ilk açıldığında adresteki fbclid'i Meta'nın belgelediği biçimde ve 90 günlük ömürle hemen _fbc çerezine yazıyoruz; aynı tıklamanın çerezi zaten varsa dokunmuyor, farklı bir tıklamanınkiyse üzerine yazıyoruz. İkincisi, açılış adresi bir reklam tıklama kimliği taşıyorsa etiketleri ilk etkileşimi beklemeden hemen yüklüyoruz. Sayfa hızını ölçüm doğruluğuna feda etmeden ikisini dengelemenin yolu, bu tür sınır durumları bilinçli olarak ele almaktır; hız tarafını Core Web Vitals rehberimizde ayrıca anlattık.

user_data: e-posta ve telefon nasıl normalize edilip SHA-256 ile hash'lenir?

CAPI'de iletişim bilgileri (e-posta, telefon, ad, soyad ve diğer kişisel alanlar) önce Meta'nın tarif ettiği biçimde normalize edilir, sonra SHA-256 ile hash'lenir; IP adresi, tarayıcı bilgisi, fbp ve fbc ise hash'lenmez. Meta'nın müşteri bilgisi parametreleri dokümanına göre sistem, hash'lenmemiş iletişim bilgisini kabul etmeyecek şekilde tasarlanmıştır ve her olayda doğru biçimlenmiş en az bir user_data parametresi bulunmalıdır.

Normalizasyonun neden bu kadar önemli olduğunu tek bir örnek açıklar: hash fonksiyonu tek bir karakter farkında tamamen farklı bir sonuç üretir. "ornek@alanadi.com" adresinin SHA-256 özeti 8041b582… ile başlar; başında boşluk ya da büyük harf olan " Ornek@AlanAdi.com " ise normalize edilmeden hash'lenirse bambaşka bir özet çıkar ve Meta bu kişiyi tanıyamaz. Aynı şekilde 905321234567 ile 05321234567 numaralarının özetleri (7e330815… ve 6343d57b…) birbirine hiç benzemez.

AlanAnahtarNormalizasyon kuralı (Meta)Türkiye örneği (hash öncesi)
E-postaemBaştaki ve sondaki boşlukları sil, tamamını küçük harfe çevirornek@alanadi.com
TelefonphSembol, harf ve baştaki sıfırları sil; ülke kodunu mutlaka ekle905321234567
AdfnKüçük harf, noktalama yok; özel karakterler UTF-8ayşe
SoyadlnAd ile aynı kurallaryılmaz
ŞehirctKüçük harf, boşluk ve noktalama yok; özel karakter varsa UTF-8kayseri
İl/eyaletstABD dışı için küçük harf, boşluk ve noktalama yokkayseri
Posta koduzpKüçük harf, boşluk ve tire yok38000
Ülkecountryİki harfli ISO 3166-1 kodu, küçük harf; tüm müşteriler aynı ülkeden olsa da gönderilmelitr
Doğum tarihidbYYYYAAGG biçimi19900215
CinsiyetgeTek küçük harf: f ya da mf
Harici kimlikexternal_idHash'lenmesi önerilir; diğer kanallarda da aynı biçimde gönderilmeliMüşteri numaranız

Türkiye telefon numaraları için doğru biçim

Meta'nın dokümanı telefon numaralarının eşleştirmede kullanılabilmesi için ülke kodu içermesi gerektiğini açıkça yazıyor. Türkiye'de müşteriler numarayı çoğu zaman "0532 123 45 67", "532 123 45 67" ya da "+90 (532) 123-45-67" gibi farklı biçimlerde girer. Hepsinin hash öncesi hâli aynı olmalıdır: 905321234567. Kendi kurulumumuzda kural şu: önce rakam dışındaki her şeyi siliyoruz; 5 ile başlayan 10 haneli bir numaraysa başına 90 ekliyoruz; 0 ile başlayan 11 haneli bir numaraysa baştaki sıfırı atıp 90 ekliyoruz. Artı işareti de sembol olduğu için silinir. Yurt dışı müşteriniz varsa ülke kodunu numaranın girildiği ülke seçiminden almak, tahmin etmekten daha güvenlidir.

Türkçe karakter tuzağı: İ ve I

Meta'nın dokümanı Türkçeye özgü bir kural vermiyor; ad ve soyad için küçük harf, noktalama olmaması ve özel karakterlerin UTF-8 olması gerektiğini söylüyor ve a-z harflerini öneriyor. Ancak Türkçede küçük harfe çevirme, çoğu programlama dilinin varsayılan davranışıyla aynı sonucu vermez. JavaScript'te "İsmail" metni varsayılan toLowerCase() ile küçültüldüğünde, "i" harfinin ardına görünmeyen bir birleştirici nokta karakteri eklenmiş 7 karakterlik bir metin çıkar; Türkçe yerel ayarla küçültüldüğünde ise beklenen 6 karakterlik "ismail" elde edilir. "IŞIK" ise varsayılan davranışla "işik", Türkçe yerel ayarla "ışık" olur.

Bu farkların hash'i tamamen değiştirdiğini biliyoruz; Meta'nın kendi tarafında Türkçe adları nasıl normalize ettiğini ise dokümandan bilemiyoruz. Bu yüzden önerimiz temkinli: görünmeyen birleştirici karakterlerin hash'e girmesine izin vermeyin, tüm kanallarda (Pixel gelişmiş eşleştirme, CAPI, müşteri listesi yüklemeleri) aynı normalizasyon fonksiyonunu kullanın ve eşleşme kalitesini ad-soyada değil, çok daha güçlü sinyaller olan e-posta ve telefona dayandırın.

Hangi alanlar asla hash'lenmez?

Meta'nın dokümanına göre client_ip_address asla hash'lenmemelidir ve ziyaretçinin gerçek IP adresi olmalıdır; IPv6 kullanan ziyaretçilerde IPv6 adresi tercih edilir. client_user_agent, fbp ve fbc de hash'lenmez. Sunucu bir yük dengeleyicinin ya da CDN'in arkasındaysa, isteğin görünen IP'si ziyaretçinin değil, aradaki katmanın IP'si olabilir; gerçek IP genellikle X-Forwarded-For gibi bir başlığın ilk değerindedir. Bu başlığın hangi katman tarafından yazıldığını ve güvenilir olup olmadığını altyapınıza göre doğrulayın.

Hash'i kim yapmalı?

CAPI olaylarında hash sunucuda, olay Meta'ya gönderilmeden hemen önce yapılmalıdır. Ham e-posta ve telefon sunucunuzda zaten vardır (formu siz aldınız, siparişi siz kaydettiniz); onları tarayıcıda hash'leyip sunucuya taşımaya gerek yoktur. Tarayıcı tarafında Pixel'in gelişmiş eşleştirme özelliği ayrı bir konudur: Meta'nın dokümanına göre Pixel'in init çağrısına eklenen değerler Pixel tarafından SHA-256 ile otomatik hash'lenir ve otomatik gelişmiş eşleştirme Events Manager'dan açılır. ikas'ın yardım sayfasının önerdiği "Automatic Website Matching" ayarı da bu özelliğe karşılık gelir.

Event Match Quality (EMQ) nedir, nasıl yükseltilir?

Event Match Quality, bir sunucu olayındaki müşteri bilgilerinin o olayı bir Meta hesabıyla eşleştirmede ne kadar etkili olabileceğini gösteren 10 üzerinden bir puandır. Meta'nın en iyi uygulamalar dokümanına göre EMQ şimdilik yalnız web olayları için gösteriliyor ve reklam atfında ve teslimat optimizasyonunda yalnız eşleşen olaylar kullanılabiliyor. Yani eşleşmeyen bir satın alma, Meta'ya ulaşsa bile reklamın başarısına yazılamaz.

Puanı Events Manager'da veri kümenizi seçip ilgili olayın ayrıntılarına girdiğinizde görürsünüz. Ekran hangi müşteri parametrelerini gönderdiğinizi ve olayların yüzde kaçında bu parametrelerin bulunduğunu da gösterir. Meta'nın incelediğimiz dokümanlarında EMQ için herkese uyan bir hedef puan yer almıyor; bu yüzden asıl hedef, kendi olaylarınızın puanını zaman içinde izleyip eksik parametreyi tamamlamaktır.

KaldıraçNe yapar?Dikkat
E-posta (em)En güçlü kişi tanımlayıcılarından biriYalnız gerçekten bildiğiniz olaylarda; normalizasyon şart
Telefon (ph)Formunuzda e-posta istenmiyorsa çoğu zaman elinizdeki en güçlü kişi sinyalidirÜlke kodu olmadan işe yaramaz
fbcOlayı reklam tıklamasına bağlarfbclid'i değiştirmeyin, SPA'da kaybetmeyin
fbpTarayıcıyı tanımlar, tekilleştirmeye de yardım ederSoğuk ilk ziyarette sunucuya ulaşmayabilir
IP ve tarayıcı bilgisiWeb olaylarında temel eşleşme sinyaliCDN arkasında gerçek IP'yi alın; tarayıcı bilgisi web olaylarında zorunlu
external_idAynı müşteriyi oturumlar ve kanallar arasında birleştirirHer kanalda aynı biçimde gönderin
Ad, soyad, şehir, ülkeEk eşleşme sinyalleriTürkçe karakter normalizasyonuna dikkat

EMQ'yu düşüren gizli sebepler

EMQ düşük çıktığında sorun çoğu zaman "parametreyi göndermiyoruz" değil, "gönderiyoruz ama yanlış gönderiyoruz"dur. Sahada en sık gördüğümüz sebepler şunlar:

  • Ülke kodsuz telefon: 05321234567 biçiminde hash'lenen numara eşleşmez.
  • Hash'lenmiş IP: IP adresini de "kişisel veri" diye hash'lemek, Meta'nın kullanamayacağı bir değer üretir.
  • Sunucunun kendi IP'si: CDN ya da yük dengeleyici arkasında tüm olaylar aynı IP ile gider.
  • Çift hash: platform zaten hash'lemişken değeri bir kez daha hash'lemek.
  • Kayıp fbc: ödeme sağlayıcısına gidip dönen ya da farklı bir alt alan adında tamamlanan ödemelerde çerezin sunucuya taşınmaması.
  • Boş değerin hash'i: boş metnin SHA-256 özeti de geçerli görünen bir dizedir; alan boşsa hiç göndermeyin.

Eşleşme kalitesi, reklam tarafında hangi sonuçları gördüğünüzü doğrudan etkiler; ölçüm altyapısı zayıf bir hesabın neden satış getirmediğini Meta Ads neden satış getirmiyor yazımızda daha geniş bir çerçevede anlattık.

Standart olay eşlemesi: Lead, Purchase, ViewContent, AddToCart, InitiateCheckout

Doğru olay eşlemesi, her standart olayın sitenizdeki tek bir net ana bağlanması ve iki kanalda aynı kimlikle gitmesidir. Meta'nın Pixel olay referansında Lead "bir kayıt tamamlandığında", Purchase "bir satın alma yapıldığında ya da ödeme akışı tamamlandığında", ViewContent "önem verdiğiniz bir sayfanın (örneğin ürün sayfası ya da açılış sayfası) ziyaret edilmesi", AddToCart "bir ürün sepete eklendiğinde", InitiateCheckout ise "kişi ödeme akışına girdiğinde, akışı tamamlamadan önce" olarak tanımlanıyor.

OlayNe zaman tetiklenir?KanalÖnemli custom_dataevent_id kaynağı
ViewContentÜrün ya da hizmet detay sayfası açıldığındaPixel + CAPIcontent_ids, content_type, value, currencyTarayıcıda üretilen rastgele kimlik
AddToCartÜrün sepete gerçekten eklendiğindePixel + CAPIcontents (id ve adet), value, currencyTarayıcıda üretilen rastgele kimlik
InitiateCheckoutÖdeme akışının ilk adımına geçildiğindePixel + CAPIcontent_ids, num_items, value, currencySepet ya da ödeme oturumu kimliği
LeadForm sunucuda başarıyla kaydedildiğindeCAPI + Pixelİsteğe bağlı value, currencyForm gönderiminden önce üretilen kimlik
PurchaseÖdeme sunucuda onaylandığındaCAPI + Pixelvalue ve currency (zorunlu), contents, content_idsSipariş numarası

Lead: form ne zaman "gönderilmiş" sayılır?

Lead olayını formun gönder düğmesine basıldığı anda değil, sunucu formu doğrulayıp kaydettiğinde göndermek gerekir. Aksi hâlde doğrulamadan dönen, eksik ya da hatalı formlar da Lead sayılır ve reklam sistemi gerçek talep getirmeyen kitleye doğru optimize olur. Kendi sitemizde iletişim formu, teklif penceresi ve araç sayfalarındaki form aynı akışı kullanıyor: tarayıcı olay kimliğini üretip form verisiyle gönderiyor, sunucu kaydı tamamladıktan sonra hash'lenmiş e-posta, telefon ve ad-soyad, fbp, fbc, IP ve tarayıcı bilgisiyle CAPI Lead'ini atıyor, tarayıcı da başarılı yanıttan sonra aynı kimlikle Pixel Lead'ini gönderiyor.

WhatsApp'a ya da telefona yönlendiren bir düğmeye tıklamak ise Lead değildir; Meta'nın standart olay listesinde bunun karşılığı, kişinin telefon, SMS, e-posta ya da sohbetle işletmeyle temas başlattığını anlatan Contact olayıdır. İki olayı ayrı tutmak, reklam optimizasyonunda form doldurma ile mesajlaşma niyetini birbirine karıştırmamanızı sağlar.

Purchase: sunucu bildirimi ve teşekkür sayfası

Satın alma olayının en güvenilir kaynağı, ödeme sağlayıcınızın sunucunuza gönderdiği ödeme onayı bildirimidir. Bu bildirim geldiğinde sipariş numarası olay kimliği olarak kullanılarak CAPI Purchase olayı gönderilir. Müşteri teşekkür sayfasına ulaştığında tarayıcı aynı sipariş numarasıyla Pixel Purchase olayını atar. Müşteri teşekkür sayfasını kapatıp hiç görmese bile satış sunucudan bildirilmiş olur; sayfayı birkaç kez yenilese bile aynı kimlik tekrar sayılmaz.

Havale, EFT ve kapıda ödemede Purchase ne zaman gönderilmeli?

Türkiye'de siparişlerin önemli bir kısmı kartla değil havale, EFT ya da kapıda ödemeyle verilir ve bu siparişler oluşturuldukları anda kesinleşmiş satış değildir. Burada iki yaklaşım vardır. Birincisi, sipariş oluştuğu anda Purchase göndermek: ölçüm hızlıdır ama iptal edilen ve ödenmeyen siparişler de satış sayılır. İkincisi, sipariş oluşunca ayrı bir özel olay (örneğin "SiparisOlusturuldu") gönderip ödeme gerçekten alındığında sunucudan Purchase göndermek: rakam daha doğrudur ama 7 günlük event_time sınırını aşan gecikmeli ödemeler bildirilemez.

Hangisini seçerseniz seçin, kural tutarlılıktır: aynı olay adını bir sipariş türünde ödeme anında, başka bir türde sipariş anında kullanırsanız raporlar okunmaz hâle gelir. Platform entegrasyonlarının bu siparişleri nasıl ele aldığını ise mutlaka bir test siparişiyle görün; GA4 tarafındaki karşılığını e-ticaret siteleri için GA4 rehberimizde anlattık.

ViewContent, AddToCart ve InitiateCheckout: katalogla konuşan olaylar

Bu üç olayın asıl değeri, Advantage+ katalog reklamlarında (eski adıyla dinamik ürün reklamları) hangi ürünün görüntülendiğini ve sepete eklendiğini Meta'ya söylemeleridir. Meta'nın olay referansına göre katalog reklamları için ViewContent ve Purchase'da contents ya da content_ids, AddToCart'ta ise contents gereklidir. Bu kimlikler katalogdaki ürün kimliğiyle birebir aynı değilse Meta olayı ürüne bağlayamaz ve yeniden hedefleme kitleleri boş kalır. Katalog tabanlı yeniden hedeflemenin stratejik tarafı remarketing rehberimizde ayrıntılı olarak var.

custom_data: value, currency, contents ve katalog eşleşmesi nasıl doğru gönderilir?

custom_data, olayın ticari ayrıntısını taşır ve satın almada value ile currency zorunludur. Meta'nın Pixel olay referansına göre Purchase, currency ve value alanlarının zorunlu olduğu tek standart olaydır; Meta'nın teknik kurulum rehberi değerin sıfır ya da daha büyük olması gerektiğini de belirtir. Para birimi üç harfli koddur (TRY, EUR, USD) ve olayın değeri bu para biriminde yazılır.

Meta'nın teknik kurulum en iyi uygulamaları rehberi, içerik kimliğinin katalogdaki ürün kimliği ya da ürün grubu kimliğiyle tam olarak eşleşmesi gerektiğini ve katalog eşleşme oranı için yüzde 90'ın üzerini hedef gösterdiğini yazıyor. Eşleşme oranını Commerce Manager'da katalogun olaylar bölümünden izleyebilirsiniz. Katalogda varyant kimliği (örneğin beden ve renk kırılımı) kullanılıyorsa olaylarda da varyant kimliği, ürün grubu kimliği kullanılıyorsa olaylarda content_type olarak product_group kullanılmalıdır.

value alanında KDV, kargo ve indirim nasıl ele alınmalı?

Meta, value alanına neyin dahil edileceğini sizin iş tanımınıza bırakır; önemli olan tutarlılıktır. Bazı işletmeler KDV dahil sepet tutarını, bazıları kargo hariç net tutarı gönderir. Kararı verirken reklam panelinde göreceğiniz ROAS'ın neyi ölçeceğini düşünün: KDV dahil tutar gönderirseniz ROAS'ınız, cebinize kalan gelirden daha yüksek görünür. Kâr eşiğinizi bu kararla birlikte hesaplamak için aşağıdaki aracı kullanabilirsiniz.

Ücretsiz AraçBaşabaş ROAS Hesaplama
Başabaş ROAS Hesaplama
₺
₺
Ürünün size birim alış / üretim maliyeti.
Ek Giderler (komisyon, kargo, KDV, paketleme…)
% giderler satış fiyatı üzerinden hesaplanır. Fiyatı KDV dahil girdiyseniz %20 KDV'nin fiyat içindeki payı %16,67'dir.
Şirket ya da defter tutan bir işletmeyseniz (şahıs şirketi dahil) yurt dışı platformlara (ör. Meta) ödediğiniz reklam bedeli üzerinden stopaj ödersiniz. Ticari faaliyeti olmayan bireysel hesaplarda gerekmez.
16:30
Başabaş ROAS

Hesaplama Sonucu

Soldaki alanları doldurup Hesapla butonuna basın; sonucunuz birkaç saniye içinde burada hazır olsun.

Başabaş ROAS, reklamlarınızın kâra geçmesi için aşması gereken eşiktir. Reklam panelinizdeki gerçek ROAS bu değerin üzerindeyse kârdasınız, altındaysa her satışta zarar edersiniz.
Aracın tam sayfasını aç

İmkânsız değerleri göndermeyin: geçmiş olay geri alınmaz

Kendi deneyimimizden öğrendiğimiz en pahalı derslerden biri şu: bir mağazada sahte ya da bozuk bir sipariş kaydı gerçek dışı yükseklikte bir satın alma değeriyle reklam platformuna gitti ve o günün raporları kalıcı olarak bozuldu. Gönderilmiş bir olayı sonradan düzeltmenin ya da geri çekmenin pratik bir yolu olmadığı için koruma, olay gönderilmeden önce yapılmalıdır.

Bu yüzden kendi kurulumumuzda tüm olaylar Meta'ya çıkmadan önce aynı süzgeçten geçiyor: değer sonlu, sıfır ya da pozitif ve işletmenin gerçekçi üst sınırının altında olmalı; adet makul bir aralıkta tam sayı olmalı; para birimi üç harfli koda uymalı; tanımsız alanlar atılıyor. Satın almada değer geçersizse olay hiç gönderilmiyor, çünkü değersiz bir Purchase hem reddedilme riski taşıyor hem de dönüşüm sayısını anlamsızca şişiriyor. Değeri düzeltmiyoruz ya da tahmin etmiyoruz; yalnız imkânsız olanı dışarıda bırakıyoruz.

E-Kitap

E-Ticaret Satışlarınızı Nasıl Artırabilirsiniz?

Ücretsiz E-Kitap

E-Ticaret Satışlarınızı Nasıl Artırabilirsiniz?

A'dan Z'ye Kapsamlı Rehber — ücretsiz indirin, e-ticarette bir adım öne geçin.

test_event_code ile Events Manager'da doğrulama nasıl yapılır?

CAPI kurulumunu doğrulamanın resmî yolu, Events Manager'daki Test Olayları (Test Events) ekranının ürettiği test kodunu sunucu olaylarınıza test_event_code parametresiyle eklemek ve olayların bu ekrana düşüp düşmediğini izlemektir. Meta'nın Conversions API kullanım dokümanına göre test kodu Events Manager'da veri kümenizin Test Olayları sekmesinde üretilir; kod istekle birlikte gönderildiğinde olay etkinliği Test Olayları penceresinde görünmeye başlar. Doküman ayrıca olayların Events Manager'da genellikle 20 dakika içinde doğrulanabildiğini belirtir.

  1. Events Manager'da veri kümenizi açın ve Test Olayları sekmesine geçin.
  2. Sunucu olayları için gösterilen test kodunu kopyalayın.
  3. Kodu sunucu tarafında yalnız test süresince isteğin üst düzeyine test_event_code olarak ekleyin (olayların içine değil, data dizisinin yanına).
  4. Aynı ekranda tarayıcı olaylarını da görmek için sitenizi bu ekrandan açılan test bağlantısıyla ziyaret edin.
  5. Bir ürün görüntüleyin, sepete ekleyin, ödemeye geçin, test formu doldurun ve mümkünse küçük tutarlı gerçek bir test siparişi verin.
  6. Her olayın hem tarayıcıdan hem sunucudan geldiğini, olay adlarının aynı olduğunu ve tekilleştirildiğinin gösterildiğini kontrol edin.
  7. Olay ayrıntısında hangi müşteri parametrelerinin geldiğine bakın; beklediğiniz e-posta, telefon, fbp ve fbc alanları yoksa sebebini bulun.
  8. Test bitince test_event_code'u kaldırın ve kaldırıldığını bir sonraki olayda doğrulayın.

Test olayları gerçekten "test" mi?

Değil, ve bu ayrıntı çoğu kurulumda atlanır. Meta'nın dokümanı test_event_code alanının yalnız test için kullanılması ve canlı istekten kaldırılması gerektiğini, bu kodla gönderilen olayların atılmadığını, Events Manager'a aktığını ve hedefleme ile reklam ölçümünde kullanıldığını açıkça yazıyor. Yani test sırasında verdiğiniz siparişler gerçek satış gibi raporlara girer. Test siparişlerini küçük tutarlı tutun, sayısını ve saatini not edin ki ilk günlerin raporlarını okurken ayırabilesiniz.

Test kodunu bir yönetim panelinden açılıp kapatılabilen bir ayar olarak tasarladıysanız (kendi kurulumumuzda böyle), "test bitti" adımını kontrol listenize yazın. Açık unutulan test kodu olayları kaybettirmez ama canlı trafiğin Test Olayları ekranını doldurmasına ve "canlıya geçtik mi, geçmedik mi?" karışıklığına yol açar.

Payload Helper, Tanılama sekmesi ve Pixel Helper

Meta'nın Payload Helper aracı, sunucunuzdan gönderilecek olayın nasıl yapılandırılması gerektiğini alanları doldurarak görmenizi sağlar; ilk doğrudan API kurulumunda olay yapısını kontrol etmek için kullanışlıdır. Events Manager'daki Tanılama (Diagnostics) sekmesi ise eksik parametre, biçim hatası, tekilleştirme sorunu ve alan adı uyuşmazlığı gibi uyarıları toplar. Tarayıcı tarafında Meta Pixel Helper tarayıcı eklentisi, sayfada hangi Pixel'in hangi olayı hangi parametrelerle ve olay kimliğiyle gönderdiğini gösterir; aynı sayfada iki Pixel ya da aynı olayın iki kez atıldığını görmenin en hızlı yolu budur.

ikas'ta yerleşik Pixel ve Conversions API entegrasyonu ne yapar, sınırları neler?

ikas, Meta Pixel'i ve Conversions API'yi kod yazmadan, satış kanalının eklentiler bölümünden bağlamanıza izin verir; tekilleştirme ve olay gönderimi platformun kendi altyapısında yürür. ikas'ın yardım merkezindeki Facebook Pixel sayfasına göre kurulum dört parçadan oluşur:

  1. Meta Events Manager'da Web türünde bir veri kümesi (Pixel) oluşturulur.
  2. Veri kümesi kimliği (Dataset ID) kopyalanır, ikas panelinde Sales Channel > Extensions yolundaki Web Analytics & Tracking Tools bölümünde Facebook Pixel Code alanına yapıştırılır.
  3. Events Manager'da veri kümesinin Ayarlar sekmesindeki Conversions API bölümünden erişim anahtarı üretilir ve aynı bölümdeki Facebook Conversion API satırına yapıştırılır.
  4. Events Manager'da otomatik web sitesi eşleştirmesi açılır, kodsuz otomatik olay takibi kapatılır ve izinli alan adları listesine mağazanın alan adı eklenir.

Son adımdaki "kodsuz otomatik olay takibi" ayarının kapatılması önemlidir: bu özellik açık kalırsa Meta, sayfadaki düğme tıklamalarından kendi olaylarını türetebilir ve ikas'ın gönderdiği standart olaylarla karışan, çift ya da yanlış olaylar ortaya çıkabilir.

ikas entegrasyonunun bilinen sınırları

ikas'ın yardım sayfası, hangi olayların sunucudan gönderildiğini, olay kimliğinin nasıl üretildiğini ve test olaylarının nasıl doğrulanacağını ayrıntılandırmıyor. Bu bir eksiklik değil, hazır bir altyapının doğası: kontrol platformdadır. Bunun pratik sonuçları şunlar:

  • Olay kimliğini siz belirleyemezsiniz. Tekilleştirmenin çalıştığını ancak Events Manager'da gözlemleyerek doğrularsınız.
  • Üstüne ikinci bir CAPI katmanı eklemeyin. ikas'ın yerleşik CAPI'si açıkken aynı olayları Google Tag Manager, bir Gateway ya da üçüncü taraf bir uygulama üzerinden ikinci kez göndermek, farklı olay kimlikleri yüzünden çift sayım üretir.
  • Tema koduna elle Pixel eklemeyin. Aynı veri kümesi kimliğiyle ikinci bir taban kod, tarayıcı olaylarını iki kez gönderir.
  • Havale, EFT ve kapıda ödeme siparişlerinin satın alma olayına ne zaman dönüştüğünü bir test siparişiyle görün.
  • Çerez onayıyla ilişkiyi kendiniz test edin: pazarlama çerezlerini reddeden bir ziyaretçide hangi olayların gittiğini Pixel Helper ve Test Olayları ekranında kontrol edin.

ikas panelinde GA4, GTM ve Search Console'u da aynı oturumda bağlayacaksanız ikas ölçüm kurulumu rehberimiz panel adımlarını sırasıyla veriyor. ikas altyapısında kurulum, tasarım ve büyüme işlerinin tamamı için ikas partneri sayfamıza göz atabilirsiniz.

Shopify'da Facebook & Instagram uygulaması CAPI'yi nasıl kurar?

Shopify'da Meta Pixel ve Conversions API, Meta'nın Facebook & Instagram satış kanalı uygulaması üzerinden, bir veri paylaşım seviyesi seçilerek kurulur. Shopify'ın Facebook veri paylaşımı yardım sayfasına göre bu ayar Shopify yönetim panelinde Sales channels > Facebook & Instagram > Settings > Data sharing settings yolundadır ve üç seviye sunar.

SeviyeShopify'ın tanımıPratik anlamı
StandardMeta Pixel, online mağazadaki müşteri gezinme davranışından veri toplar; tarayıcıdaki reklam engelleyici Pixel'in veri paylaşmasını engelleyebilirYalnız tarayıcı tarafı ölçüm
EnhancedPixel'e ek olarak Conversions API kullanılır; Conversions API satın alma olayını Shopify ve Facebook sunucuları arasında gönderirSatın alma için sunucu kanalı; ad, konum, e-posta ve telefon gibi müşteri bilgileri paylaşılır
MaximumConversions API ve Pixel kullanılır, mağaza Facebook'un en güncel reklam teknolojisiyle güncellenirEnhanced ile aynı veri kategorileri, Meta ağında kullanıcı eşleştirmesi için

Shopify'ın sayfası Pixel'in otomatik izlediği olayları PageView, ViewContent, Search, AddToCart, InitiateCheckout, AddPaymentInfo ve Purchase olarak sıralıyor; Conversions API için ise yalnız satın alma olayını anıyor, diğer olayların sunucudan gidip gitmediğini söylemiyor. Bu yüzden kurulumdan sonra Events Manager'da hangi olayların sunucu kaynağından geldiğini kendiniz kontrol edin.

Shopify'da çift sayımı önlemek

Shopify'ın Meta Pixel yardım sayfası, temaya daha önce elle eklenmiş Pixel kodu varsa uygulamanın Pixel'ini kullanmadan önce kaldırılmasını, aksi hâlde mağazada birden fazla Pixel bulunacağını ve raporlarda tekrarlı ya da yanlış veri oluşabileceğini belirtiyor. Aynı sayfa, Facebook reklamlarınızı yöneten ajansların ya da uygulamaların da tekrarlı veri üretebileceği uyarısını yapıyor. Pratikte Shopify mağazalarında en sık gördüğümüz çift sayım kaynağı, uygulamanın Pixel'iyle birlikte bir "Pixel ve CAPI" uygulamasının ya da eski tema kodunun aynı anda çalışmasıdır.

Gizlilik tarafında Shopify, veri paylaşımının bir tercih olduğunu ve gizlilik politikanızın bu paylaşımı müşterilerinize anlatacak şekilde güncel olması gerektiğini vurguluyor. Shopify yönetim panelindeki müşteri gizliliği ayarları, satış yaptığınız her ülke ve bölge için ayrı yapılandırılabiliyor; Türkiye için çerez bildiriminin ve pazarlama izninin nasıl çalıştığını mağazanızda ayrıca kontrol edin. Shopify'da sıfırdan mağaza kuruyorsanız Shopify mağaza açma rehberimiz ölçüm kurulumunu da içeren adımları anlatıyor; uçtan uca kurulum desteği için Shopify Partner sayfamıza bakabilirsiniz.

ikas ve Shopify entegrasyonlarının karşılaştırması

KonuikasShopify
Kurulum yeriSatış kanalı eklentileri, Web Analytics ve Tracking ToolsFacebook & Instagram satış kanalı, veri paylaşım ayarları
CAPI nasıl açılır?Events Manager'dan üretilen erişim anahtarı yapıştırılırEnhanced ya da Maximum seviyesi seçilir
Yardım sayfasında belirtilen sunucu olayıAyrıntı verilmiyorSatın alma olayı
event_id kontrolüPlatformdaPlatformda
En sık çift sayım sebebiÜstüne GTM ya da ikinci CAPI katmanı eklemekTema kodu ya da ikinci bir Pixel uygulaması
DoğrulamaEvents Manager ve Pixel Helper ile, test siparişiyleEvents Manager ve Pixel Helper ile, test siparişiyle

Özel yazılım sitede CAPI'yi doğrudan API ile kurmak: kendi kurulumumuzdan notlar

Özel yazılım bir sitede CAPI'yi doğrudan API ile kurmak, ölçümün her ayrıntısını kontrol etmenizi sağlar ama bu kontrolün sorumluluğunu da size yükler. Alis Dijital'in kendi web sitesinde Pixel ve CAPI birlikte çalışıyor; aşağıdaki notlar, bu kurulumu tasarlarken ve canlıda izlerken verdiğimiz kararlardan derlendi. Kimlikler, anahtarlar ve iç yapı ayrıntıları bilerek genel tutuldu.

Yapı: üç tür olay, üç tür akış

  • Sayfa görüntüleme yalnız tarayıcıdan gidiyor. Hacmi yüksek, ticari değeri düşük olduğu için sunucuya ek yük getirmeye değer bulmadık.
  • Görüntüleme, sepete ekleme ve ödeme başlatma tarayıcıda doğuyor. Tarayıcı olay kimliğini üretip Pixel'e gönderiyor ve aynı kimlikle sunucudaki bir röle uç noktasına bildiriyor; sunucu IP, tarayıcı bilgisi, fbp ve fbc ekleyip olayı CAPI'ye iletiyor.
  • Form (Lead) ve ödeme (Purchase) sunucuda doğuyor. Sunucu, kendi doğruladığı bilgiyle CAPI olayını gönderiyor; tarayıcı yalnız aynı kimlikle Pixel olayını atıyor. Satın almada olay kimliği sipariş numarası.

Röle uç noktası: beyaz liste, hız sınırı, boyut sınırı

Tarayıcıdan olay kabul eden bir sunucu uç noktası, doğası gereği kimlik doğrulamasız ve herkese açıktır. Bu yüzden kötüye kullanılmaya açıktır: biri bu adrese sahte "sepete ekleme" ya da milyarlık değerli olaylar yollayarak reklam optimizasyonunuzu zehirleyebilir. Kendi kurulumumuzda röle yalnız belirli olay adlarını kabul ediyor (satın alma ve form bu yoldan hiç gelmiyor), olay kimliği ve adres uzunluğu sınırlı, ticari veri gövdesinin boyutu kısıtlı, IP başına dakikalık bir istek sınırı var ve değerler Meta'ya çıkmadan önce yukarıda anlattığımız süzgeçten geçiyor.

Gönderim "en iyi çaba" ile yapılmalı

CAPI isteği başarısız olduğunda kullanıcının formu ya da siparişi asla başarısız olmamalıdır. Bizim kurulumumuzda CAPI yapılandırılmamışsa (erişim anahtarı boşsa) sunucu kanalı sessizce devre dışı kalıyor ve yalnız Pixel çalışıyor; istek hata dönerse kayda geçiyor ama kullanıcı akışı etkilenmiyor. Yapılandırma her olayda veritabanından okunmasın diye kısa süreli önbelleğe alınıyor. Olay kimliği tarayıcıda zaten üretildiği için, CAPI'nin geçici olarak çalışmadığı bir anda bile Pixel olayı kimliğiyle gider ve sonradan yapılacak bir yeniden gönderim tekilleştirilebilir.

Sayfa hızıyla ölçüm arasındaki denge

Pazarlama etiketlerinin (GA4, Google Ads, Meta Pixel ve diğerleri) ilk yüklemede ana iş parçacığını meşgul ettiğini ölçünce bu etiketleri ziyaretçinin ilk gerçek etkileşimine kadar erteledik. Olay kuyrukları sayfa ayrıştırılırken hemen kuruluyor, kütüphaneler sırayla ve birer birer yükleniyor, hiç etkileşmeyen ziyaretçi için de sayfa yüklendikten birkaç saniye sonra devreye giriyor. Bu tasarımın bilinçli bir bedeli var: hiç etkileşmeden çok kısa sürede ayrılan ziyaretçi ölçülmeyebiliyor. Reklam tıklamasıyla gelen ziyaretçide ise, önceki bölümde anlattığımız fbclid kaybı yüzünden etiketler beklemeden yükleniyor. Ölçüm ile hız arasında her zaman bir takas vardır; önemli olan bu takasın nerede yapıldığını bilmek ve belgelemektir.

Hassas adreslerde etiket yüklememek

Adresinde kişiye özel bir erişim anahtarı taşıyan sayfalar (kişiye özel ödeme bağlantısı, sipariş takip sayfası) pazarlama etiketlerinden ayrı tutulmalıdır; aksi hâlde bu adresler event_source_url ve sayfa görüntüleme olaylarıyla üçüncü taraflara gider. Kendi sitemizde böyle bir sayfada etiket yükleyicisi hiç basılmıyor, site içinde bu sayfalara geçildiğinde de yükleme duraklatılıyor. Bir sınırı da açıkça not ettik: o an zaten çalışmakta olan bir kütüphane geri alınamıyor ve kendi sayfa değişimi dinleyicisiyle bu adresi görebiliyor. Mükemmel değil ama riski bilinen bir alana daraltıyor.

Toplu gönderim, gecikme ve hata yönetimi nasıl kurgulanmalı?

CAPI olayları gerçekleştikleri anda, tek tek ya da küçük gruplar hâlinde gönderilmelidir. Meta'nın kullanım dokümanı olayların gerçekleştikleri anda ve ideal olarak bir saat içinde gönderilmesini öneriyor; tek bir istekte data dizisine en fazla 1.000 olay konabiliyor. Gece toplu gönderim gibi gecikmeli kurgular reklam optimizasyonunun tazelik ihtiyacını zayıflatır; gecikme 48 saati aşarsa tekilleştirme de çalışmaz.

Hata yönetiminde iki kural bilinmelidir. Birincisi, doküman bir toplu istekteki herhangi bir olay geçersizse isteğin hata döndüğünü belirtiyor; önerilen yol, geçersiz olayları düzeltip paketi yeniden göndermektir ve event_id taşıyan, daha önce kaydedilmiş olaylar tekrar olarak ayıklanır. İkincisi, 7 günden eski bir event_time tüm isteği reddettirir. Bu yüzden yeniden deneme kuyruğunuzda bekleyen olayları yaşlarına göre ayıklayın ve her yeniden denemede aynı event_id'yi kullanın.

BelirtiOlası sebepÇözüm
Tüm istek reddediliyorPaketteki bir olayın event_time değeri 7 günden eski ya da biçimi bozukZaman damgasını saniye ve UTC olarak üretin; eski olayları pakete koymayın
Kimlik doğrulama hatasıErişim anahtarı yanlış, iptal edilmiş ya da başka veri kümesine aitEvents Manager'dan yeni anahtar üretin, doğru veri kümesi kimliğiyle eşleştirin
Olaylar geliyor ama reklam raporlarında yokAlan adı doğrulanmamış, veri kümesi reklam hesabına bağlı değil ya da olaylar kişiyle eşleşmiyorAlan adını doğrulayın, veri kümesini reklam hesabına bağlayın, EMQ'yu kontrol edin
Satın almalar iki katı görünüyorevent_id eşleşmiyor ya da iki ayrı entegrasyon çalışıyorPixel Helper ve Test Olayları ekranında olay kimliklerini karşılaştırın
Satın almalar yarı yarıya eksikSunucu olayı ödeme onayına bağlı değil, yalnız teşekkür sayfasına güveniliyorÖdeme sağlayıcısının sunucu bildirimine CAPI Purchase bağlayın
Gece yarısı civarı siparişler yanlış güne düşüyorZaman damgasında saat dilimi kaymasıOlay anını UTC'ye doğru çevirin; Türkiye UTC+3

KVKK açısından CAPI'de nelere dikkat edilmeli?

Bu bölüm genel bilgilendirme amaçlıdır ve hukuki tavsiye değildir; kendi işleme faaliyetiniz için bir hukukçuya danışmanızı öneririz. Bu çerçevede üç konu öne çıkıyor: davranışsal reklam çerezleri için açık rıza, hash'lenmiş verinin kişisel veri niteliği ve verinin yurt dışına aktarımı.

Kişisel Verileri Koruma Kurumu'nun Çerez Uygulamaları Hakkında Rehberi (Temmuz 2025 baskısı), davranışsal reklamcılık için kullanılan çerezlerin açık rıza gerektirdiğini belirtiyor. Rehbere göre açık rıza aktif, olumlayıcı bir eylemle alınmalı; yalnız siteye girilmiş olması çerezlere rıza verildiği anlamına gelmiyor; açık rızayla işlenmesi gereken çerezler yönetim panelinde ilk elde pasif gelmeli ve çevrim içi reklam çerezleri için rıza kullanım koşulları ya da gizlilik bildirimi gibi belgelere iliştirilerek alınamıyor. Rehber, çerez panelinde "kabul et", "reddet" ve "tercihler" düğmelerinin renk, büyüklük ve punto bakımından eşit sunulmasını iyi uygulama örneği olarak gösteriyor.

Hash'lemek anonimleştirmek değildir

SHA-256 ile hash'lenmiş bir e-posta, ham e-postayı göstermez ama aynı e-postayı bilen biri onu aynı özete çevirebilir; CAPI'nin çalışmasının sebebi de zaten budur: Meta, hash'i kendi elindeki verilerle eşleştirerek kişiyi bulur. Dolayısıyla hash'lenmiş verinin kişiyle ilişkilendirilebilir olmaya devam ettiğini ve kişisel veri olarak ele alınması gerektiğini varsaymak en güvenli yaklaşımdır. Hash, aktarım sırasında ham verinin açığa çıkmasını önleyen bir güvenlik önlemidir; rıza ya da aydınlatma yükümlülüğünün yerine geçmez.

Sunucu tarafı ölçüm rızanın etrafından dolaşmanın yolu değildir

CAPI tarayıcıdaki çerez reddinden teknik olarak etkilenmediği için "reddeden ziyaretçinin verisini sunucudan gönderelim" fikri zaman zaman gündeme gelir. Bizim yaklaşımımız net: ziyaretçi pazarlama ve reklam çerezlerini reddettiyse, bu kişinin reklam amaçlı olaylarının sunucu kanalından da gönderilmemesi gerekir. Pratikte bu, rıza durumunun sunucuya da taşınması ve CAPI gönderiminden önce kontrol edilmesi anlamına gelir. Çerez onayı aracınızın bu bilgiyi sunucu tarafında nasıl sağladığını kurulumdan önce netleştirin.

Yurt dışına aktarım

KVKK'nın çerez rehberi, Türkiye'de faaliyet gösteren sitelerin yurt dışında yerleşik şirketler aracılığıyla çerez kullandığı ve bu yolla yurt dışına veri aktardığı durumlarda, aktarımın 6698 sayılı Kanun'un 9'uncu maddesine ve 10 Temmuz 2024 tarihli Resmî Gazete'de yayımlanan Kişisel Verilerin Yurt Dışına Aktarılmasına İlişkin Usul ve Esaslar Hakkında Yönetmelik'e uygun yapılması gerektiğini hatırlatıyor. Meta'ya gönderilen olay verisi de bu çerçevede değerlendirilmelidir. Aydınlatma metninizde bu aktarımı, amacını ve alıcı grubunu açıkça anlatın.

Aydınlatma metni ve çerez politikası hazırlarken başlangıç taslağı için çerez politikası oluşturucumuzu ve KVKK aydınlatma metni oluşturucumuzu kullanabilirsiniz; konunun web sitesi tarafını ise KVKK uyumlu web sitesi rehberimizde ayrıntılı olarak ele aldık.

En yaygın CAPI hataları nelerdir ve nasıl düzeltilir?

CAPI kurulumlarında gördüğümüz hataların büyük çoğunluğu teknik olarak küçük ama sonuç olarak pahalıdır: satışlar iki kez sayılır, reklam sistemi şişmiş sinyale göre optimize olur ve bütçe kararları yanlış rakamla verilir. Aşağıdaki hatalar, denetlediğimiz kurulumlarda en sık karşımıza çıkanlar.

Çift sayım: iki entegrasyon aynı anda

En pahalı hata budur. Platformun yerleşik entegrasyonu açıkken aynı olayların bir de GTM, bir uygulama ya da tema kodu üzerinden gönderilmesi, her biri kendi olay kimliğini ürettiği için tekilleştirilemeyen çift olaylar doğurur. Belirtisi, Meta'daki satın alma sayısının mağaza panelindeki sipariş sayısının belirgin biçimde üstünde olmasıdır. Çözüm, her olay için tek bir kaynak belirlemek ve diğerlerini kapatmaktır.

eventID'siz Pixel olayı

Sunucu olayına event_id eklenip tarayıcıdaki Pixel çağrısına eklenmemesi, en sık görülen tekilleştirme hatasıdır. Çoğu zaman sebep, eventID'nin fbq çağrısının dördüncü argümanı yerine üçüncü argümanın (olay parametrelerinin) içine yazılmasıdır. Pixel Helper'da olayın ayrıntısına bakarak olay kimliğinin gidip gitmediğini görebilirsiniz.

Farklı olay adı

Tarayıcıda standart "Lead", sunucuda özel "FormSubmit" göndermek, Meta açısından iki farklı olaydır ve tekilleştirme çalışmaz. Büyük-küçük harf farkına da güvenmeyin: "Purchase" ile "purchase" aynı olay olarak görülmeyebilir. Olay adlarını iki kanalda birebir aynı yazın.

Saat dilimi ve milisaniye

event_time'ın milisaniye gönderilmesi ya da yerel saatin UTC sanılması, olayları anlamsız bir zamana ya da üç saat ileriye kaydırır. Türkiye saatiyle gece yarısına yakın verilen siparişler başka güne yazılır, günlük raporlar mağaza paneliyle tutmaz.

Test kodunun açık unutulması

Test kodu canlıda açık kalırsa olaylar kaybolmaz ama Test Olayları ekranı canlı trafikle dolar ve hangi olayın test, hangisinin gerçek olduğu karışır. Meta'nın dokümanı test kodunun canlı istekten kaldırılması gerektiğini açıkça söylüyor.

Diğer sık hatalar

  • Erişim anahtarının tarayıcı koduna konması: anahtarı gören herkes veri kümenize olay yazabilir.
  • Ülke kodsuz telefon ve normalize edilmemiş e-posta: olay gider ama eşleşmez.
  • IP adresinin hash'lenmesi ya da sunucunun kendi IP'sinin gönderilmesi: eşleşme sinyali kaybolur.
  • event_source_url'nin boş bırakılması ya da doğrulanmamış bir alan adını göstermesi: web olaylarında zorunlu alan eksik kalır.
  • Yanlış action_source: WhatsApp'tan kapanan siparişi "website" olarak göndermek, kanalların performansını karıştırır.
  • Purchase'ta değer ya da para biriminin eksik olması: satın almada bu iki alan zorunludur.
  • Katalogla uyuşmayan content_ids: katalog reklamları ve yeniden hedefleme kitleleri boş kalır.
  • Kodsuz otomatik olay takibinin açık kalması: düğme tıklamalarından türeyen olaylar standart olaylarla karışır.
HataBelirtiHızlı kontrol
İki entegrasyon aynı andaMeta satın alma sayısı sipariş sayısının çok üstündePixel Helper'da aynı olaydan kaç tane gittiğine bakın
eventID'siz Pixel olayıTekilleştirme uyarısı, şişmiş dönüşümPixel Helper'da olay kimliği alanı
Farklı olay adıAynı olay iki ayrı satırdaEvents Manager'daki olay listesi
Saat dilimi kaymasıGünlük rakamlar panelle tutmuyorTest olayının saatini kendi saatinizle karşılaştırın
Test kodu açıkCanlı olaylar Test Olayları ekranındaSunucu isteğinde test_event_code alanı
Ülke kodsuz telefonDüşük EMQ, telefon parametresi var ama etkisizHash öncesi değerin 90 ile başlaması

CAPI kurulumunu canlıya almadan önce kontrol listesi

Canlıya geçmeden önce aşağıdaki maddelerin her birini işaretleyebiliyorsanız kurulumunuz sağlam bir zemindedir. Liste platformdan bağımsızdır; ikas ve Shopify'da olay kimliği gibi bazı maddeleri doğrudan değil, Events Manager'daki gözlemle doğrularsınız.

Kontrol listesi0/16 tamamlandı

Kurulumdan sonraki ilk 30 günde hangi göstergeleri izlemelisiniz?

Kurulumdan sonraki ilk ay, rakamlara güvenip güvenemeyeceğinizi kanıtlama dönemidir; bütçe kararlarını bu güven oluşmadan değiştirmemek gerekir. İlk hafta her gün, sonra haftada bir şu kontrolleri yapın:

  1. Sipariş ve form mutabakatı: Meta'daki satın alma ve Lead sayısını, aynı gün aralığında mağaza panelinizdeki sipariş ve form kayıtlarıyla karşılaştırın. Atıf farkları normaldir, ama Meta'nın gördüğü toplam olay sayısı gerçek siparişlerin belirgin biçimde üstündeyse çift sayım vardır.
  2. Tekilleştirme durumu: Events Manager'da her olayın hem tarayıcı hem sunucu kaynağından geldiğini ve tekilleştirildiğini izleyin.
  3. EMQ eğilimi: olay bazında puanın düşüp düşmediğine, hangi parametrenin olayların ne kadarında bulunduğuna bakın.
  4. Tanılama uyarıları: yeni çıkan uyarıları aynı hafta içinde kapatın.
  5. Katalog eşleşmesi: Commerce Manager'da olayların katalogla eşleşme oranını kontrol edin.

Meta'nın raporladığı satışlar ile GA4'ün raporladıkları farklı olacaktır; iki aracın atıf mantığı farklıdır ve bu kendi başına hata değildir. Kanalların karşılaştırılabilir okunması için kampanya bağlantılarınızı tutarlı etiketlemek de gerekir; bunu UTM parametreleri rehberimizde anlattık. Ölçüm temiz hâle geldikten sonra maliyet metriklerini doğru okumak için CPM, CPC, CTR ve CPA rehberimize göz atabilirsiniz; büyük kampanya dönemlerinden önce kurulumu bir kez daha test etmek ise Efsane Cuma hazırlık rehberimizde listelediğimiz adımlardan biri.

Kayseri'deki bir üretici için örnek kurulum senaryosu

Aşağıdaki senaryo kurgusaldır ve bir müşterinin sonuçlarını değil, tipik bir kurulum kararlarını anlatır. Kayseri'de mobilya üreten, perakende satışını ikas üzerindeki mağazasından, bayi ve proje taleplerini ise ayrı bir kurumsal sitedeki teklif formundan alan bir işletme düşünelim. Satışların bir kısmı da WhatsApp üzerinden kapanıyor.

  • ikas mağazası: Pixel ve CAPI ikas'ın yerleşik entegrasyonuyla bağlanır; kodsuz otomatik olay takibi kapatılır, alan adı doğrulanır, tema kodunda eski Pixel kalmadığı kontrol edilir. Havale ile verilen siparişlerin Purchase'a ne zaman dönüştüğü test siparişiyle görülür.
  • Kurumsal sitedeki teklif formu: doğrudan API ile kurulur. Form sunucuda kaydedildiğinde Lead olayı hash'lenmiş telefon ve e-postayla gider; tarayıcı aynı kimlikle Pixel Lead'ini atar. Telefonlar 90 ile başlayacak biçimde normalize edilir.
  • WhatsApp düğmesi: Lead değil Contact olayı olarak, yalnız tarayıcıdan gönderilir.
  • WhatsApp'tan kapanan satış: sipariş sisteme girildiğinde action_source değeri chat olan bir Purchase olayı sunucudan, sipariş numarasıyla ve 7 gün içinde gönderilir.
  • Aynı veri kümesi: iki site aynı veri kümesini kullanıyorsa ikisinin alan adı da izinli listeye eklenir ve olay adları iki sitede aynı anlamda kullanılır.

Bu kurguda üretici, mağaza satışını, bayi talebini ve mesajlaşma niyetini ayrı olaylar olarak görür; reklam sistemi de "form dolduran" ile "mesaj atan" kitleyi birbirine karıştırmadan optimize olur. Reklam kanalını seçerken iki büyük platformun farkını düşünüyorsanız Google Ads mı Meta Ads mı karar rehberimiz işinize yarar; Google tarafında dönüşüm ölçümünü de aynı titizlikle kurmak için Google Ads yönetimi hizmetimize bakabilirsiniz.

Meta Conversions API kurulumunda nasıl destek alabilirsiniz?

CAPI kurulumunu kendiniz yapabilirsiniz; bu rehberdeki kontrol listesi ve Meta'nın dokümanları bunun için yeterli bir yol haritası çizer. Yine de ölçüm hatalarının bedeli, çoğu zaman kurulumun maliyetinden yüksektir: şişmiş bir dönüşüm sayısı bütçeyi yanlış kampanyaya akıtır, eksik bir sayı da işe yarayan kampanyayı kapattırır.

Alis Dijital olarak Kayseri merkezli bir e-ticaret ve dijital pazarlama ajansıyız; ikas partneri ve Shopify Partner olarak hazır altyapılarda, özel yazılım sitelerde ise doğrudan API ile Pixel ve CAPI kurulumunu, olay planını, tekilleştirme ve eşleşme kalitesi denetimini yapıyoruz. Meta Ads yönetimi hizmetimizde ölçüm altyapısı kampanya kurulumunun ilk adımıdır; ölçüm, reklam ve dönüşüm tarafını birlikte ele almak isterseniz dijital pazarlama danışmanlığı ve dijital pazarlama ajansı sayfalarımıza göz atabilirsiniz. Mevcut kurulumunuzun bir kontrolünü istiyorsanız iletişim sayfamızdan bize yazmanız yeterli.

Sıkça Sorulan Sorular

Meta Conversions API (CAPI) nedir, ne işe yarar?

Meta Conversions API, sitenizdeki satın alma, form ve sepete ekleme gibi olayları ziyaretçinin tarayıcısı yerine sunucunuzdan Meta'ya ileten bağlantıdır. Reklam engelleyici, tarayıcı kısıtlamaları ya da yarım kalan sayfa yüklemesi yüzünden Pixel'in kaçırdığı olayları yakalar; ödeme sağlayıcısının sunucunuza bildirdiği onaylı ödeme gibi tarayıcının hiç görmediği olayları da gönderebilir. Böylece Meta, reklamlarınızın gerçek sonuçlarını daha eksiksiz görür ve teslimatı bu sinyale göre optimize eder.

CAPI kurarsam Meta Pixel'i kaldırabilir miyim?

Hayır, Meta CAPI'nin Pixel'in yerine değil, onunla birlikte kullanılmasını ve aynı olayların iki kanaldan paylaşılmasını öneriyor. Pixel tarayıcıdaki sayfa bağlamını ve otomatik sinyalleri toplar, CAPI ise tarayıcının kaçırdığı olayları sunucudan tamamlar. İkisi aynı olay adı ve aynı event_id ile gönderildiğinde Meta olayı bir kez sayar. Pixel'i kaldırmak, tarayıcı tarafındaki eşleşme sinyallerini ve bazı olayları kaybetmek demektir. Doğru kurgu, iki kanalı birbirinin yedeği olarak birlikte çalıştırmaktır.

event_id nedir, neden bu kadar önemli?

event_id, aynı olayın tarayıcıdan ve sunucudan gelen iki kopyasını Meta'nın eşleştirmesini sağlayan ortak kimliktir. Pixel'de fbq track çağrısının dördüncü argümanına eventID olarak, CAPI'de event_id alanına yazılır ve ikisi birebir aynı olmalıdır. Satın almada sipariş numarası, formda gönderimden önce üretilen rastgele bir kimlik idealdir. Kimlik eşleşmezse aynı satış raporlarda iki kez görünür ve reklam sistemi şişmiş sinyale göre optimize olur. Her olay için kimliği bir kez üretip iki kanala aynen taşıyın.

Pixel ve CAPI aynı olayı gönderirse satışlar iki kez sayılır mı?

Olay adı ve event_id iki kanalda da aynıysa sayılmaz; Meta bu iki olayı tek olay olarak kabul eder ve genellikle ilk ulaşanı tutar. Tekilleştirme, aynı kimlikle gelen ilk olaydan sonraki 48 saat içinde ulaşan kopyalar için yapılır. Çift sayım çoğunlukla Pixel çağrısında eventID'nin unutulmasından, olay adlarının farklı yazılmasından ya da platform entegrasyonunun üstüne ikinci bir CAPI katmanı eklenmesinden kaynaklanır. Bu yüzden her olay için tek bir kaynak belirleyin.

CAPI'de e-posta ve telefon nasıl hash'lenir?

Önce Meta'nın kuralına göre normalize edilir, sonra SHA-256 ile hash'lenir. E-postada baştaki ve sondaki boşluklar silinir ve tamamı küçük harfe çevrilir. Telefonda sembol, harf ve baştaki sıfırlar atılır, ülke kodu mutlaka eklenir; Türkiye'deki 0532 123 45 67 numarası hash öncesinde 905321234567 olmalıdır. Tek bir karakter farkı bile bambaşka bir hash ürettiği için normalizasyonu atlamak, olayın gitmesine rağmen kişiyle eşleşmemesine yol açar.

fbp ve fbc nedir, hash'lenmeli mi?

fbp tarayıcıyı, fbc ise reklam tıklamasını tanımlayan iki birinci taraf çerezidir ve CAPI'de hash'lenmeden, olduğu gibi gönderilir. fbp'yi Pixel kendisi yazar; fbc, reklam tıklamasıyla adrese eklenen fbclid parametresinden fb.1.zaman.fbclid biçiminde üretilir. fbclid büyük-küçük harfe duyarlıdır ve değiştirilmemelidir. Meta, fbc'nin CAPI'ye gönderilen her olayla birlikte gönderilmesini öneriyor, çünkü olayı ilgili reklam tıklamasına bağlayan en güçlü sinyallerden biridir. Çerez sunucu isteğinde yoksa değeri tarayıcıdan da taşıyın.

Event Match Quality puanı kaç olmalı?

Meta'nın dokümanlarında Event Match Quality için herkese uyan bir hedef puan yer almıyor; puan 10 üzerinden verilir ve şimdilik yalnız web olaylarında gösterilir. Önemli olan, reklam atfında ve optimizasyonda yalnız eşleşen olayların kullanılabilmesidir. Puanı yükseltmenin yolu e-posta, ülke kodlu telefon, fbc, fbp, gerçek IP ve tarayıcı bilgisini doğru biçimde göndermektir. En sık düşüş sebepleri ülke kodsuz telefon, hash'lenmiş IP ve kayıp fbc'dir.

test_event_code canlıda açık kalırsa ne olur?

Olaylar kaybolmaz ama canlı trafik Events Manager'daki Test Olayları ekranına da düşer ve hangi olayın test, hangisinin gerçek olduğu karışır. Meta'nın dokümanı test kodunun yalnız test için kullanılmasını ve canlı istekten kaldırılmasını istiyor. Ayrıca bu kodla gönderilen olaylar atılmaz, hedefleme ve reklam ölçümünde kullanılır; yani test siparişleriniz gerçek satış gibi raporlara girer. Test bittiğinde kodu kaldırıp bir sonraki olayda kontrol edin.

ikas'ta Conversions API nasıl açılır?

Events Manager'da veri kümesinin Ayarlar sekmesindeki Conversions API bölümünden erişim anahtarı üretilir ve ikas panelinde satış kanalının eklentiler bölümündeki Facebook Conversion API satırına yapıştırılır. Pixel kimliği aynı bölümdeki Facebook Pixel Code alanına girilir. ikas'ın önerisine göre Events Manager'da otomatik web sitesi eşleştirmesi açılmalı, kodsuz otomatik olay takibi kapatılmalı ve izinli alan adları tanımlanmalıdır. Panel adımlarının tamamı ikas ölçüm kurulumu rehberimizde var.

Shopify'da hangi veri paylaşım seviyesini seçmeliyim?

Sunucu tarafı ölçüm istiyorsanız Standard yerine Enhanced ya da Maximum seviyesini seçmeniz gerekir; Standard yalnız tarayıcıdaki Pixel'i kullanır. Shopify'ın yardım sayfasına göre Enhanced, Pixel'e ek olarak Conversions API'yi kullanır ve satın alma olayını sunucular arasında gönderir; Maximum aynı veri kategorileriyle Meta'nın en güncel reklam teknolojisini de devreye alır. Hangisini seçerseniz seçin gizlilik politikanızı güncelleyin ve temada elle eklenmiş eski Pixel kodu bırakmayın.

CAPI Gateway mı, GTM sunucu konteyneri mi, doğrudan API mi seçmeliyim?

ikas ya da Shopify kullanıyorsanız önce platformun yerleşik entegrasyonunu kullanın; çoğu mağaza için yeterlidir. Kod yazmadan sunucu kanalı isteyen ve bulut hesabı yönetebilen ekipler için CAPI Gateway, birden çok reklam platformunu tek akıştan beslemek isteyenler için GTM sunucu konteyneri uygundur. Özel yazılım bir siteniz, CRM'den ya da WhatsApp'tan kapanan satışlarınız varsa doğrudan API tek gerçek seçenektir; Meta Ads yönetimi hizmetimizde bu kararı hesabınıza göre birlikte veriyoruz.

Çerezleri reddeden ziyaretçinin olayları CAPI ile gönderilebilir mi?

Bizim yaklaşımımız hayır: pazarlama ve reklam çerezlerini reddeden ziyaretçinin reklam amaçlı olayları sunucu kanalından da gönderilmemelidir. KVKK'nın Çerez Uygulamaları Hakkında Rehberi davranışsal reklam çerezleri için açık rıza arıyor; CAPI'nin tarayıcıdaki reddi teknik olarak aşabilmesi, bu yükümlülüğü ortadan kaldırmaz. Rıza durumunu sunucuya taşıyıp CAPI gönderiminden önce kontrol edin. Bu bilgi genel niteliktedir, hukuki tavsiye değildir; ayrıntı için KVKK uyumlu web sitesi rehberimize bakabilirsiniz.

İlgili Hizmetlerimiz

Okuduğunuz için teşekkürler...