Meta Pikseli ve Dönüşüm API'si birlikte nasıl çalışır?

Meta reklamlarının (Facebook ve Instagram) sizi iyi müşterilere götürebilmesi için mağazanızda olanları bilmesi gerekir: kim ürünü görüntüledi, kim sepete ekledi, kim satın aldı. Bu bilgi Meta'ya iki yoldan gidebilir: ziyaretçinin tarayıcısında çalışan Piksel ve doğrudan sunucunuzdan giden Dönüşüm API'si (Conversions API). Meta ikisinin birlikte kullanılmasını, yani "yedekli kurulumu" öneriyor.

Birlikte kullanmanın iki riski var: aynı satın alımın iki kez sayılması ve izin kurallarının atlanması. Bu yazıda ikisini de nasıl yönettiğinizi, Sepetya içinde neyin otomatik yapıldığını ve neyi sizin kontrol etmeniz gerektiğini anlatıyoruz.

İki yol, tek hedef: Piksel ve Dönüşüm API'si

	Piksel	Dönüşüm API'si
Nerede çalışır?	Ziyaretçinin tarayıcısında	Sunucudan Meta'ya
Neyi etkiler?	Reklam engelleyiciler, tarayıcı kısıtları ve çerez reddi olayları kaçırabilir	Tarayıcıdan bağımsızdır; ama kişi bilgisi gönderdiği için hukuki dayanak ayrıca önem taşır
Ne zaman gider?	Sayfa görüntülenince, sepete eklenince vb.	Satın alımda ödeme alınınca; diğer olaylar tarayıcıdan sunucuya iletilerek

Meta, aynı olayı iki yoldan da aldığında bunları "yinelenen" sayıp tek olaya indirger. Bunun çalışması için iki olayın aynı olay adına ve aynı olay kimliğine sahip olması gerekir.

Çift sayma nasıl önlenir? Olay kimliği

Meta'nın belgelerine göre Piksel'in eventID değeri Dönüşüm API'sindeki event_id ile, Piksel olayının adı da event_name ile eşleşmelidir. Olaylar yalnızca ilk olayın alınmasından sonraki 48 saat içinde tekilleştirilir. Tek kaynaktan (yalnızca tarayıcı ya da yalnızca sunucu) gelen olaylar zaten tekilleştirilmez; Meta, içerikleri anlamlı biçimde farklı değilse genellikle önce gelen olayı tercih eder.

Sepetya bu eşleştirmeyi sizin yerinize yapar:

• Vitrin her olay için benzersiz bir olay kimliği üretir. Piksel bu kimliği eventID olarak, sunucu kopyası event_id olarak kullanır.
• Satın alma olayında kimlik sipariş kimliğidir. Tarayıcıdaki Purchase olayı ile sunucudaki Purchase olayı aynı sipariş kimliğini taşır.
• Olaylardaki ürün kimliği varyant kimliğidir. Sepetya ürün katalog bağlantısı (Meta kataloğu) aynı kimliği kullandığı için, dinamik reklamlarda olay ile katalog satırı birbirini bulur.

Hangi olay hangi yoldan gider?

Vitrin olayı	Meta olayı	Piksel	Sunucu
Sayfa görüntüleme	PageView	Evet	Hayır
Ürün görüntüleme	ViewContent	Evet	Seçilebilir
Sepete ekleme	AddToCart	Evet	Seçilebilir
Ödemeye başlama	InitiateCheckout	Evet	Seçilebilir
Ödeme bilgisi ekleme	AddPaymentInfo	Evet	Seçilebilir
Arama	Search	Evet	Seçilebilir
Üye olma	CompleteRegistration	Evet	Seçilebilir
Satın alma	Purchase	Evet	Sipariş ödenince her zaman

"Seçilebilir" olaylar, Dönüşüm API'si eklentisinin "Sunucudan da gönderilecek olaylar" ayarından açılıp kapatılır; varsayılan olarak hepsi seçilidir.

İzin: hangi olay ne zaman gider?

Burası en çok karıştırılan bölüm, o yüzden net yazalım.

• Piksel: Yalnızca ziyaretçi çerez bannerında pazarlama çerezlerine izin verdikten sonra yüklenir. İzin geri çekilirse Piksel'e "izni geri al" bildirimi gider.
• Satın alma dışındaki sunucu olayları: Yalnızca pazarlama çerezlerine izin veren ziyaretçilerin olayları sunucuya iletilir.
• Satın alma olayı: Sipariş ödendiğinde sunucudan gider ve çerez bannerındaki tercihten bağımsızdır; çünkü siparişin kendi verisinden üretilir.

Sunucu olaylarında müşteri bilgileri (e-posta, telefon, ad, soyad, şehir, posta kodu, ülke ve müşteri kimliği) Meta'nın normalleştirme kurallarına göre SHA-256 ile özetlenerek gönderilir. IP adresi, tarayıcı bilgisi ve _fbp/_fbc çerezleri ise Meta'nın şartı gereği özetlenmeden gider.

Hedefli reklam kuralı (1 Ağustos 2026)

Ticari Reklam ve Haksız Ticari Uygulamalar Yönetmeliği'ne 1 Temmuz 2026'da eklenen ve 1 Ağustos 2026'da yürürlüğe giren 25/A maddesi, tüketicilerin çevrimiçi davranışları, geçmiş tercihleri, konumları ya da demografik verileri analiz edilerek belirli kişi veya gruplara özel reklam gösterilmesini "hedefli reklamcılık" olarak tanımlıyor. Bu tür reklam, reklamın hangi kriterlerle ilgili tüketiciye gösterildiğine ve bu kriterlerin nasıl değiştirilebileceğine ilişkin bilgilerin tüketiciye doğrudan ve kolay erişilebilir biçimde sunulması koşuluyla yapılabiliyor. Tüketicinin çocuk olduğu biliniyorsa ya da makul olarak bilinmesi bekleniyorsa kişisel verilere dayalı profilleme yöntemleriyle hedefli reklam yapılamıyor. Piksel ve Dönüşüm API'siyle yeniden pazarlama ya da benzer kitle reklamı yürütüyorsanız bu bilgilendirmeyi nasıl sağlayacağınızı hukuk danışmanınızla netleştirin.

Olayın içinde ne var?

Tarayıcıdaki ve sunucudaki kopya aynı alanları taşır; Meta'nın iki kopyayı "anlamlı biçimde farklı" saymaması için Sepetya ikisini aynı veriden üretir.

• Değer ve para birimi: Satın almada sipariş toplamı ve sipariş para birimi; diğer olaylarda ilgili ürünlerin tutarı.
• Ürünler: İçerik türü "product"; her ürün için varyant kimliği, adet ve birim fiyat; toplam ürün adedi.
• Arama: Aranan metin.
• Müşteri bilgisi (yalnızca sunucu olaylarında): E-posta, telefon, ad, soyad, şehir, posta kodu, ülke ve müşteri kimliği özetlenmiş (hash) biçimde; IP adresi, tarayıcı bilgisi ve _fbp/_fbc çerezleri özetlenmeden. Bu bilgiler, olayın bir Meta hesabıyla eşleştirilmesine yardımcı olmak içindir.

Bir olayın sunucu kopyası, Meta'nın şartlarını karşılamıyorsa (örneğin tarayıcı bilgisi veya sayfa adresi eksikse) ya da yedi günden eskiyse gönderilmez; çünkü Meta, partideki tek bir geçersiz olay yüzünden bütün partiyi reddeder. Bu elemeler eklenti günlüklerine yazılır.

Kurulum adımları

1. Meta Olay Yöneticisi'nde (Events Manager) veri kaynaklarından Piksel kimliğinizi kopyalayın.
2. Sepetya panelinde Online Mağaza › Eklentiler sayfasını açın. "Web Veri İzleme ve Analiz Araçları" grubunda "Facebook Piksel" kartında Bağla'ya basın ve Piksel kimliğini girin. Piksel kodunu temaya elle yapıştırmanız gerekmez.
3. Aynı grupta "Facebook Conversion API" eklentisini bağlayın. Piksel kimliğini yeniden girin; Olay Yöneticisi'nde Ayarlar › Conversions API bölümünden bir erişim jetonu oluşturup ilgili alana yapıştırın. Jeton şifreli saklanır.
4. "Sunucudan da gönderilecek olaylar" listesini gözden geçirin.
5. Test aşaması bitene kadar "Test olay kodu" alanını kullanın (aşağıda).

Çalıştığını nasıl test edersiniz?

Olay Yöneticisi'nde Test Olayları sekmesi size bir test kodu verir (örneğin TEST12345). Bu kodu eklentideki "Test olay kodu" alanına yazın ve kaydedin. Eklenti sayfasındaki Test olayı gönder düğmesi, bu kodla bir PageView gönderir; olay Test Olayları'nda görünür. Ardından mağazanızda gerçekten bir ürün görüntüleyin, sepete ekleyin ve bir test siparişi verin; her adımın hem tarayıcıdan hem sunucudan geldiğini kontrol edin.

Sorun giderme

Belirti	Olası neden	Ne yapmalı?
Olay Yöneticisi'nde tarayıcı olayı yok	Ziyaretçi pazarlama çerezlerine izin vermedi, Piksel kimliği yanlış ya da bir reklam engelleyici açık	Test tarayıcınızda bannerdan pazarlama iznini verin; kimliğin 15–16 haneli sayı olduğunu kontrol edin.
Sunucu olayı yok	Erişim jetonu hatalı, süresi dolmuş ya da Piksel kimliğiyle uyuşmuyor	"Test olayı gönder"i deneyin; eklentinin günlüklerindeki hata iletisine bakın.
Satın alma iki kez sayılıyor	Piksel ikinci bir yoldan da kurulu (Etiket Yöneticisi, özel kod) ya da ödeme 48 saatten geç işaretlendi	Pikseli tek yoldan kurun; ödemeleri geciktirmeden işaretleyin.
Olaylar Test Olayları'nda kalıyor	Canlıda test olay kodu doldurulu	Test olay kodu alanını boşaltın.

Havale ve kapıda ödemede 48 saat kuralı

Bir ayrıntı daha: kartlı ödemede tarayıcıdaki Purchase olayı ödeme tamamlanınca, sunucudaki Purchase olayı da ödeme onayıyla birlikte gider; ikisi birbirine yakın zamanda geldiği için tekilleşir. Havale/EFT, kapıda ödeme ve mağazada ödemede ise tarayıcı olayı sipariş verildiği anda, sunucu olayı siz ödemeyi "ödendi" olarak işaretlediğinde gönderilir. Aradaki süre 48 saati aşarsa Meta iki olayı tekilleştirmeyebilir ve aynı satın alımı iki kez sayabilir.

• Havale ödemelerini hesabınıza geçtiği gün "ödendi" olarak işaretleyin.
• Kapıda ödemede teslimat sonrası işaretlemeyi geciktirmeyin.
• Meta raporlarındaki satın alma sayısını panelinizdeki siparişlerle düzenli karşılaştırın.

Hangi mağaza hangisini kurmalı?

• Yeni açılmış, reklam bütçesi küçük mağaza: Önce Piksel yeterlidir. Sipariş sayınız ve reklam harcamanız arttıkça Dönüşüm API'sini ekleyin.
• Reklam harcaması düzenli olan mağaza: Piksel ve Dönüşüm API'sini birlikte kurun; olay kaybını azaltmak ve satın almaları ödeme onayına bağlı ölçmek için en sağlam yol budur.
• Veri koruma hassasiyeti yüksek mağaza: Pikseli kurun, sunucudan gidecek olayları yalnızca ihtiyacınız olanlarla sınırlayın ve satın alma olayının hukuki dayanağını önce netleştirin.

Sık yapılan hatalar

• Pikseli hem eklentiyle hem de Google Etiket Yöneticisi ya da "Özel kodlar" ile kurmak. Aynı olay iki kez, farklı kimliklerle gider ve tekilleşmez.
• Yalnızca Dönüşüm API'sini kurup Pikseli bağlamamak. Meta yedekli kurulumu önerir; tarayıcı olayları da gerekir.
• Test olay kodunu canlıda bırakmak.
• Çerez bannerında pazarlama kategorisini kapatıp Piksel'in neden olay göndermediğini aramak. Piksel izin gelene kadar yüklenmez; bu beklenen davranıştır.
• Sunucu olaylarını açıp aydınlatma metnine Meta'ya veri aktarımını yazmamak.

Ürün kataloğunu da bağlayın

Dinamik reklamlar için olaylar kadar katalog da önemlidir. Sepetya Meta katalog eklentisi ürün, fiyat, stok ve kampanya değişikliklerini kataloğa anında gönderir; olaylarla aynı varyant kimliğini kullanır. Google tarafında benzer bir akış için Google Merchant Center ürün feed'i rehberimize bakın.

Reklam ölçümünü kendi mağazanızda kurup denemek isterseniz deneme süresi boyunca tüm adımları görebilirsiniz: ücretsiz deneyin.

Bu yazı hukuki/mali danışmanlık değildir.