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.
| Özellik | Meta Pixel (tarayıcı) | Conversions API (sunucu) |
|---|---|---|
| Nerede çalışır? | Ziyaretçinin tarayıcısında, JavaScript olarak | Sizin sunucunuzda ya da platformun sunucusunda |
| Reklam engelleyiciden etkilenir mi? | Evet, gönderim engellenebilir | Hayır, tarayıcıdan bağımsızdır |
| Yarım kalan sayfa yüklemesi | Olay hiç çıkmayabilir | Sunucu olayı sayfadan bağımsız gider |
| IP ve tarayıcı bilgisi | Kendiliğinden eklenir | Sizin eklemeniz gerekir |
| fbp ve fbc çerezleri | Pixel 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'ler | Siz normalize edip SHA-256 ile hash'lersiniz |
| Tarayıcının görmediği olaylar | Gönderemez | Gönderebilir (ödeme onayı, CRM, mağaza içi satış) |
| Kurulum emeği | Düşük, çoğu platformda tek alan | Platforma 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.
| Yol | Kim barındırır? | Maliyet türü | event_id kontrolü | Kime uygun? |
|---|---|---|---|---|
| Platformun yerleşik entegrasyonu (ikas, Shopify) | Platform | Genelde pakete dahil | Platformda, sizde değil | Hazır altyapı kullanan mağazaların çoğu |
| Events Manager'daki tek tıklık Meta seçeneği | Meta | Sektör kaynaklarına göre ücretsiz | Otomatik, sizde değil | Yalnız web olayı olan, özelleştirme istemeyenler |
| Conversions API Gateway | Sizin bulut hesabınız ya da bir iş ortağı | Bulut kaynağı veya iş ortağı ücreti | Otomatik üretilir | Kod 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öre | Sizde, etiket yapılandırmasıyla | Birden çok reklam platformunu tek akıştan beslemek isteyenler |
| Doğrudan Conversions API | Kendi uygulama sunucunuz | Geliştirme emeği | Tamamen 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?
- 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.
- 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.
- Birden çok reklam platformunu tek akıştan yönetmek istiyorsanız ve sunucu bakımını üstlenebilecek bir ekibiniz varsa sGTM'yi değerlendirin.
- Ö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ğer | Not |
|---|---|---|
| event_name | Purchase | Pixel'deki olay adıyla birebir aynı olmalı (büyük-küçük harf dahil) |
| event_time | 1794742200 | Saniye cinsinden Unix zamanı, UTC; bu örnek 15 Kasım 2026, Türkiye saatiyle 14:30 |
| event_id | SIP-10045 | Pixel'deki eventID ile aynı; satın almada sipariş numarası idealdir |
| action_source | website | Olayın nerede gerçekleştiği |
| event_source_url | https://ornekmagaza.com/siparis-tamamlandi | Web 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.fbp | fb.1.1794741000123.1234567890 | _fbp çerezinin değeri, hash'lenmez |
| user_data.fbc | fb.1.1794740000456.IwAR… | _fbc çerezi ya da adresteki fbclid'den üretilen değer, hash'lenmez |
| user_data.client_ip_address | 203.0.113.10 | Ziyaretçinin gerçek IP'si, asla hash'lenmez |
| user_data.client_user_agent | Mozilla/5.0 (…) | Web olaylarında zorunlu, hash'lenmez |
| custom_data.value | 1250.00 | Satın almada zorunlu |
| custom_data.currency | TRY | Satın almada zorunlu, üç harfli para birimi kodu |
| custom_data.content_ids | ["SKU-123"] | Katalogdaki ürün kimliğiyle birebir aynı olmalı |
| custom_data.content_type | product | Kimlikler ü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ğer | Ne zaman kullanılır? | Türkiye'deki tipik örnek |
|---|---|---|
| website | Olay web sitenizde gerçekleştiyse | Siteden satın alma, form gönderimi |
| app | Mobil uygulamanızda gerçekleştiyse | Uygulama içi satın alma |
| phone_call | Telefonda kapandıysa | Reklamdan arayıp telefonda verilen sipariş |
| chat | Mesajlaşma uygulaması, SMS ya da canlı sohbet üzerinden | WhatsApp'tan alınan sipariş |
| business_messaging | Messenger, Instagram ya da WhatsApp'a yönlendiren reklamlardan | WhatsApp'a tıklatan reklamdan gelen konuşma |
| physical_store | Fiziksel mağazada yüz yüze | Showroom satışı |
| E-posta üzerinden | E-postayla onaylanan sipariş | |
| system_generated | Otomatik gerçekleşen işlemler | Abonelik yenilemesi |
| other | Hiçbirine uymuyorsa | Nadiren 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.
| Senaryo | Meta ne görür? | Sonuç |
|---|---|---|
| Aynı olay adı, aynı event_id, 48 saat içinde | Tek olay | Doğ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 olay | Gecikmeli gönderimde çift sayım |
| Olay yalnız tek kanaldan gidiyor | Tek olay | Tekilleştirmeye gerek yok |
| Tüm olaylara aynı sabit event_id | İlk olaydan sonrakiler kopya sanılır | Olay 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:
- fbclid değerini isteğin sorgu dizesinden okuyun.
- 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.
- Oluşturma zamanı olarak bu fbclid'i ilk gördüğünüz anın milisaniye zaman damgasını kullanın.
- Değeri sunucuda üretip çerez olarak saklamıyorsanız alt alan adı sırası olarak 1 kullanın.
- 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.
| Alan | Anahtar | Normalizasyon kuralı (Meta) | Türkiye örneği (hash öncesi) |
|---|---|---|---|
| E-posta | em | Baştaki ve sondaki boşlukları sil, tamamını küçük harfe çevir | ornek@alanadi.com |
| Telefon | ph | Sembol, harf ve baştaki sıfırları sil; ülke kodunu mutlaka ekle | 905321234567 |
| Ad | fn | Küçük harf, noktalama yok; özel karakterler UTF-8 | ayşe |
| Soyad | ln | Ad ile aynı kurallar | yılmaz |
| Şehir | ct | Küçük harf, boşluk ve noktalama yok; özel karakter varsa UTF-8 | kayseri |
| İl/eyalet | st | ABD dışı için küçük harf, boşluk ve noktalama yok | kayseri |
| Posta kodu | zp | Küçük harf, boşluk ve tire yok | 38000 |
| Ülke | country | İki harfli ISO 3166-1 kodu, küçük harf; tüm müşteriler aynı ülkeden olsa da gönderilmeli | tr |
| Doğum tarihi | db | YYYYAAGG biçimi | 19900215 |
| Cinsiyet | ge | Tek küçük harf: f ya da m | f |
| Harici kimlik | external_id | Hash'lenmesi önerilir; diğer kanallarda da aynı biçimde gönderilmeli | Müş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 biri | Yalnı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 |
| fbc | Olayı reklam tıklamasına bağlar | fbclid'i değiştirmeyin, SPA'da kaybetmeyin |
| fbp | Tarayıcıyı tanımlar, tekilleştirmeye de yardım eder | Soğuk ilk ziyarette sunucuya ulaşmayabilir |
| IP ve tarayıcı bilgisi | Web olaylarında temel eşleşme sinyali | CDN arkasında gerçek IP'yi alın; tarayıcı bilgisi web olaylarında zorunlu |
| external_id | Aynı müşteriyi oturumlar ve kanallar arasında birleştirir | Her kanalda aynı biçimde gönderin |
| Ad, soyad, şehir, ülke | Ek eşleşme sinyalleri | Tü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.
| Olay | Ne zaman tetiklenir? | Kanal | Önemli custom_data | event_id kaynağı |
|---|---|---|---|---|
| ViewContent | Ürün ya da hizmet detay sayfası açıldığında | Pixel + CAPI | content_ids, content_type, value, currency | Tarayıcıda üretilen rastgele kimlik |
| AddToCart | Ürün sepete gerçekten eklendiğinde | Pixel + CAPI | contents (id ve adet), value, currency | Tarayıcıda üretilen rastgele kimlik |
| InitiateCheckout | Ödeme akışının ilk adımına geçildiğinde | Pixel + CAPI | content_ids, num_items, value, currency | Sepet ya da ödeme oturumu kimliği |
| Lead | Form sunucuda başarıyla kaydedildiğinde | CAPI + Pixel | İsteğe bağlı value, currency | Form gönderiminden önce üretilen kimlik |
| Purchase | Ödeme sunucuda onaylandığında | CAPI + Pixel | value ve currency (zorunlu), contents, content_ids | Sipariş 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.


