Meta Pixel Kurulumu ve Dönüşüm API

01Meta Pixel Nedir, Neden Gerekir?

Meta Pikseli (eski adıyla Facebook pixel), sitenize eklenen ve ziyaretçilerin yaptığı işlemleri Meta'ya bildiren bir JavaScript kodudur. Facebook ve Instagram reklamlarının hangi satışı, formu ya da üyeliği getirdiğini bu sayede görürsünüz.

Pikselin asıl gücü ölçümün ötesindedir. Meta'nın reklam sistemi, satın alma gibi olaylardan öğrenerek reklamı dönüşüm yapma ihtimali yüksek kişilere gösterir. Sitenizi ziyaret eden ya da ürün inceleyen kişilere yeniden ulaşmak için özel hedef kitleler de piksel verisiyle oluşturulur.

Tarayıcı tabanlı ölçüm; reklam engelleyiciler, tarayıcı gizlilik ayarları ve bağlantı kesintileri nedeniyle bazı olayları kaçırabilir. Bu boşluğu kapatmak için piksel, sunucudan gönderilen Dönüşüm API'si ile birlikte kullanılır.

02Kurulumdan Önce Hazırlık

Pikseli ve reklam hesabını işletmenin kendi portföyünde açın; ajansa yalnızca ortak erişimi verin. Böylece iş birliği değişse bile biriken ölçüm verisi ve hedef kitleler işletmede kalır. Meta Pikseli, GA4'ün yerine geçmez; ikisini birlikte kullanmak için Google Analytics 4 kurulumu rehberimize de göz atın.

• İşletmeye ait bir Meta işletme portföyü (Business Manager) ve reklam hesabı
• Siteye ya da etiket yöneticisine erişim yetkisi
• Ölçmek istediğiniz olayların listesi: ürün görüntüleme, sepete ekleme, ödeme başlatma, satın alma, form gönderimi
• Çerez onay yapınızın ölçüm kodlarını onaya bağlayıp bağlamadığı bilgisi

03Piksel Oluşturma ve Temel Kod

Meta Etkinlik Yöneticisi'ni açın, Veri kaynaklarını bağla adımında Web seçeneğini işaretleyin ve pikselinize bir ad verin. Ardından kurulum yöntemini seçersiniz: kodu elle eklemek, iş ortağı entegrasyonu kullanmak ya da Google Tag Manager üzerinden kurmak.

Elle kurulumda Meta'nın verdiği temel kodu her sayfanın head bölümüne ekleyin. Kod, sayfa her yüklendiğinde PageView olayını gönderir. Aşağıdaki örnekte PIXEL_ID yerine kendi piksel kimliğiniz gelmelidir; kodu her zaman Etkinlik Yöneticisi'nden kopyalayın.

<!-- Meta Pixel Code -->
<script>
!function(f,b,e,v,n,t,s)
{if(f.fbq)return;n=f.fbq=function(){n.callMethod?
n.callMethod.apply(n,arguments):n.queue.push(arguments)};
if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
n.queue=[];t=b.createElement(e);t.async=!0;
t.src=v;s=b.getElementsByTagName(e)[0];
s.parentNode.insertBefore(t,s)}(window, document,'script',
'https://connect.facebook.net/en_US/fbevents.js');
fbq('init', 'PIXEL_ID');
fbq('track', 'PageView');
</script>
<noscript><img height="1" width="1" style="display:none"
src="https://www.facebook.com/tr?id=PIXEL_ID&ev=PageView&noscript=1"
/></noscript>
<!-- End Meta Pixel Code -->

Google Tag Manager ile

GTM kullanıyorsanız temel kodu Özel HTML etiketiyle ekleyip tüm sayfalarda çalıştırabilirsiniz. Olayları data layer tetikleyicilerine bağlamak ölçümü tasarım değişikliklerine karşı dayanıklı kılar; ayrıntılar Google Tag Manager kurulumu yazımızda.

Altyapı panelinden

Bazı altyapılar piksel kimliğini panelden almayı ve olayları kendisi göndermeyi destekler. Aurora'nın e-ticaret altyapısında Meta bağlantısı ürün kataloğunu eşler ve dönüşümleri çift sayım olmadan ölçer; kodlar panelden eklenir.

04Standart Olaylar ve Parametreler

Meta'nın tanımladığı standart olay adlarını kullanmak, reklam optimizasyonunun ve raporların kendiliğinden çalışmasını sağlar. Satın alma olayında tutar ve para birimi zorunludur; ürün kimlikleri ise katalog reklamlarının doğru ürünü göstermesine yardım eder.

fbq('track', 'AddToCart', {
  content_ids: ['URN-12'],
  content_type: 'product',
  value: 1499.90,
  currency: 'TRY'
});

// Satın alma: eventID tekilleştirme için gerekir
fbq('track', 'Purchase', {
  value: 1499.90,
  currency: 'TRY',
  content_ids: ['URN-12'],
  content_type: 'product'
}, { eventID: 'SIP-10045' });

05Dönüşüm API'si (Conversions API) Kurulumu

Conversions API, olayları ziyaretçinin tarayıcısı yerine doğrudan sizin sunucunuzdan Meta'ya gönderir. Reklam engelleyicilerden etkilenmez ve sipariş gibi kesinleşmiş verileri kaynağından iletir. Meta, en iyi sonuç için pikselin ve API'nin birlikte kullanılmasını önerir.

Kurulum için Etkinlik Yöneticisi'nde pikselin ayarlar sekmesinden bir erişim belirteci (access token) oluşturun. Bu belirteç bir paroladır: yalnızca sunucuda saklayın, tarayıcı koduna ya da herkese açık bir depoya asla koymayın. Ardından sunucunuz her önemli olayda Graph API'nin events uç noktasına bir istek gönderir.

Kendi sunucusu olmayan küçük siteler için Meta'nın iş ortağı entegrasyonları ve Conversions API Gateway gibi daha az kod gerektiren seçenekler de vardır. Reklam trafiğini karşılayan bir landing page tasarımı projesinde ise piksel ve API kurulumunu sayfa yayına girmeden test ortamında doğrulamak en sağlıklı yoldur; böylece kampanyanın ilk gününden itibaren veri kaybı yaşanmaz.

• event_time, olayın Unix zaman damgasıdır (saniye cinsinden) ve olayın gerçekleştiği anı göstermelidir.
• E-posta ve telefon gibi kişisel veriler SHA-256 ile karmalanarak gönderilir; telefonu önce ülke koduyla birlikte yalnız rakam olarak biçimlendirin.
• Graph API sürüm numarasını Meta'nın geliştirici belgelerinden kontrol edin; eski sürümler zamanla kullanımdan kalkar.

curl -X POST "https://graph.facebook.com/v<SURUM>/<PIXEL_ID>/events?access_token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "data": [{
      "event_name": "Purchase",
      "event_time": 1767225600,
      "event_id": "SIP-10045",
      "action_source": "website",
      "event_source_url": "https://ornek.com/tesekkurler/",
      "user_data": {
        "em": ["<SHA256_ILE_KARMALANMIS_EPOSTA>"],
        "client_ip_address": "203.0.113.10",
        "client_user_agent": "Mozilla/5.0 ...",
        "fbp": "fb.1.1767225000000.1234567890"
      },
      "custom_data": { "value": 1499.90, "currency": "TRY" }
    }],
    "test_event_code": "TEST12345"
  }'

printf '%s' 'ornek@alanadi.com' | sha256sum

06Tekilleştirme: Olaylar Neden İki Kez Sayılır?

Aynı satın alma hem pikselden hem API'den gönderildiğinde Meta'nın bunların tek bir olay olduğunu anlaması gerekir. Bu işleme tekilleştirme (deduplication) denir ve iki koşula dayanır: olay adının ve olay kimliğinin iki kaynakta birebir aynı olması.

Yukarıdaki örneklerde tarayıcı tarafında eventID, sunucu tarafında event_id alanına aynı sipariş numarası yazıldığına dikkat edin. Bu eşleşme kurulmazsa raporlarda satışlar iki kat görünür ve reklam sistemi yanlış verilerle öğrenir.

Tekilleştirmenin çalıştığını Etkinlik Yöneticisi'nde olay ayrıntılarından görebilirsiniz: aynı olay hem tarayıcı hem sunucu kaynağıyla alınmış ve tekilleştirilmiş olarak listelenir. İki kaynak arasındaki küçük bir zaman farkı sorun değildir.

07Olayları Test Etme ve Doğrulama

Etkinlik Yöneticisi'ndeki Test Etkinlikleri sekmesi, olayları gerçek zamanlı olarak gösterir. Tarayıcı olaylarını görmek için sitenizin adresini girip açılan pencerede işlem yapın; sunucu olayları için ekranda görünen test kodunu isteğinizdeki test_event_code alanına ekleyin ve canlıya geçerken bu alanı kaldırın.

Meta Pixel Helper tarayıcı eklentisi de hangi sayfada hangi olayın, hangi parametrelerle çalıştığını gösterir. Kurulumdan birkaç gün sonra Etkinlik Yöneticisi'ndeki olay eşleşme kalitesi puanına bakın; puan düşükse sunucu olaylarına daha fazla karmalanmış müşteri bilgisi eklemeniz gerekebilir.

08Gizlilik ve Onay

Piksel ve Dönüşüm API'si kişisel veri işler. Ziyaretçi onay vermeden reklam ölçüm kodlarının çalıştırılmaması, gönderilen verinin aydınlatma metninizde açıklanması ve yalnızca gerekli bilgilerin paylaşılması gerekir. Sağlık gibi hassas kategorilerde Meta'nın ek kısıtlamaları da vardır.

Bu yazı genel bilgi verir. Çerez onay akışınız, aydınlatma metniniz ve yurt dışına veri aktarımı konusunda güncel KVKK mevzuatını ve hukuk danışmanınızı kontrol edin. Reklam performansını hangi metriklerle okuyacağınızı merak ediyorsanız sosyal medya metrikleri yazımız iyi bir başlangıçtır.