İçeriğe geç
Worgoo
Projenizi anlatın
Menü
Dijital Blog

Meta Piksel ve Conversion API Kurulumu

Meta Piksel ve Conversion API kurulumunu olay tabanlı anlatan rehber: tarayıcı ve sunucu tarafı ölçümün birlikte test edilmesi.

Ürün kataloğunu anlatan mor ve krem kâğıt düzeni

Meta Piksel tarayıcıdaki etkileşimleri, Conversions API ise sunucu veya desteklenen entegrasyon üzerinden olayları Meta’ya aktarır. Birlikte kurulumda aynı satın alma iki kanaldan gelebilir; bunun tek olay olarak işlenmesi için eşleştirme gerekir. Kurulumun hedefi, seçilen eylemleri doğru zamanda ve tanımlı veri alanlarıyla göndermek, ardından gerçek sipariş akışıyla doğrulamaktır.

İki katmanın görev dağılımını baştan yazın

Önce bir olay sözlüğü hazırlayın: olay adı, gerçek tetiklenme koşulu, tarayıcı ve sunucu kaynağı, kimliği üreten sistem ve sorumlu ekip. Purchase için işletmenin tamamlanmış sipariş tanımı açık olmalı; ödeme bekleyen kayıt ile tahsil edilmiş siparişin aynı sayılıp sayılmayacağı tesadüfe bırakılmamalıdır.

Aynı Purchase olayının hem Piksel hem CAPI ile iletilmesi olağandır. İki kaynak için olay adı ve kimliğini eşleştirin. Olayın sunucudan gelmesi, iptal ve iadelerin bütün raporlardan otomatik düşeceği anlamına gelmez; satış sonrası durumları ve mali raporlamayı ayrıca tasarlayın.

OlayTarayıcı (Piksel)Sunucu (CAPI)Not
Sayfa görüntülemeUygun sayfalardaKurguya göre mümkünVeri toplama tercihlerini uygula
Sepete eklemeBaşarılı ekleme sonrasındaKurguya göre mümkünSepeti açmak ekleme değildir
Satın almaKimlikli gönderim olabilirSipariş tanımına göreAynı işlem için aynı olay adı ve kimliği
LeadBaşarılı form sonucundaSunucu kabulü sonrasındaDüğme tıklaması başvuru değildir

Piksel kurulumu ve olay eşlemesi

Önce sitedeki mevcut etiket, eklenti ve platform bağlantılarını sayın; yeni entegrasyon mevcut olayları ikinci kez göndermemeli. Pikseli veri toplama tercihleri ve sayfanın niteliğine uygun çalıştırın. Ürün incelemesi ViewContent, başarılı sepete ekleme AddToCart, ödeme başlangıcı InitiateCheckout gibi ayrı koşullara bağlanabilir. Hangi ekranın açıldığı kadar işlemin gerçekten tamamlanıp tamamlanmadığını da kontrol edin.

Kurulumdan sonra Events Manager'da olayların geldiğini görün ama tek başına orada durdurmayın: gerçek bir test siparişini uçtan uca yürütün ve her adımın doğru olayı tetiklediğini doğrulayın. Onay sayfası yenilendiğinde yeni bir satın alma kaydediliyorsa ölçümünüz şişer; bu hatayı test siparişiyle yakalamak en hızlı yoldur.

Yenileme ve yeniden denemeyi aynı işlemle eşleştirin

Onay ekranı yenilendiğinde yeni Purchase kimliği üretmeyin. Aynı siparişin tekrar webhook veya ağ denemeleri, kalıcı olay kaydı üzerinden aynı kimlikle işlenmelidir. Sunucuya taşımak tek başına tekrarları kapatmaz; işlemin bir kez oluşması ve yeniden iletilmesi arasındaki ayrımı kodda koruyun.

Conversions API için aktarım yolunu seçin

Platformun partner entegrasyonu, doğrudan sunucu bağlantısı veya uygun bir ağ geçidi değerlendirilebilir. Kararı hazır bağlantının desteklediği olaylar, bakım sorumluluğu, veri kontrolü ve mevcut altyapıyla uyum üzerinden verin. Doğrudan geliştirme her mağaza için otomatik olarak daha güvenilir değildir; izleme ve bakım yükünü de üstlenmek gerekir.

Olay zamanı, kaynak, ad ve kimlik alanlarının yanında yalnız amaç için uygun eşleştirme verilerini kullanın. E-posta ve telefon gibi alanlarda Meta’nın normalleştirme ve hash kurallarını izleyin; bütün alanlara aynı işlemi uygulamayın. Hash uygulanması veriyi anonim hale getirmez. Veri toplama tercihleri ve ilgili kurallar sunucu akışında da korunmalı; erişim anahtarı tarayıcı koduna yazılmamalıdır.

Olay kuyruğunu ve tekrar gönderimi tasarlayın

Sunucu gönderimi ağ hatalarıyla karşılaşabilir; başarısız olayı yeniden gönderme düzeni kurun ama aynı olayın iki kez gitmemesi için bir olay kimliği tutun. Bu, özellikle satın alma olayında rapor güvenliğini belirleyen teknik detaydır.

İkileme ve doğrulama testleri

Tarayıcı ve sunucu aynı işlemi gönderiyorsa event_name ile event_id değerleri eşleşmelidir. Farklı gerçek işlemler için farklı kimlikler, aynı olayın yeniden iletiminde aynı kimlik kullanılmalıdır. Entegrasyonun Meta’ya kabul edilmiş yanıt alması, satın almanın reklam raporuna atfedildiğini tek başına kanıtlamaz. Testi işlem düzeyinde yürütün.

  • Kontrollü test siparişinin kimliğini ve tetiklenme zamanını kaydedin.
  • Piksel ve sunucu kaydının aynı olay adına ve kimliğine sahip olduğunu doğrulayın.
  • Onay ekranını yenileyin, ödeme başarısızlığını ve tekrar bildirimi deneyin.
  • Test olaylarında kaynak ve tekrar ayıklamayı inceleyin; sorunlu bileşeni test ortamında izole edin.
  • Gönderim hatalarını, gecikmeyi ve veri toplama tercihine göre beklenen eksikleri ayrı raporlayın.

Olay alımı ile reklama atfı ayırın

Events Manager’daki alınan olaylar ile Ads Manager’da reklama atfedilen satın almalar aynı rapor değildir. Mağazanın bütün siparişlerinin reklama yazılması beklenmez. Saat dilimi, rapor dönemi, atıf penceresi, gönderim gecikmesi ve iptal tanımlarını eşitlemeden sayıları karşılaştırmayın. Açıklanamayan farkı “normal” diye kapatmak yerine örnek işlem üzerinden araştırın.

Reklam tarafına bağlanırken tanımları netleştirin

Optimizasyon olayını işletmenin ulaşmak istediği sonuç, olayın doğruluğu ve kullanılabilir sinyal hacmi birlikte belirler. Satın alma temel hedef olabilir; form odaklı işlerde nitelikli başvuru farklı bir tanım gerektirir. Farklı paydalı huni oranlarından en küçük yüzdeyi seçmek doğru yöntem değildir. Üst aşama bir eylemi kullanıyorsanız gerçek satışla ilişkisini ayrıca izleyin.

Kampanya raporunda kullanılan atıf penceresini, zaman dilimini ve karşılaştırma dönemini belirtin. Bir kanalın kendisine atfettiği satışları diğer kanalların sayılarıyla toplamak tekil toplam satış vermez. Meta Ads yönetimi kampanya hedeflerini, özel yazılım çalışması ise sunucu akışının güvenilirliğini aynı olay sözlüğüne bağlayabilir.

Bakım: ölçümün bozulması sessiz olur

Tema, ödeme sağlayıcısı veya eklenti değişikliği ölçümü sessizce bozabilir. Her ilgili sürümden sonra test akışını tekrarlayın; düzenli inceleme sıklığını işlem hacmine göre belirleyin. Ani olay kaybı ya da beklenmedik artış için izleme kurmak, yalnız ay sonu raporuna bakmaktan daha erken uyarı verir.

  • Başarılı ve başarısız ödeme senaryolarını yeniden deneyin.
  • Olay hacmini kampanya, stok ve site değişiklikleriyle birlikte yorumlayın.
  • Gönderim hatalarında yeniden deneme ve kalıcı hata kuyruğunu inceleyin.
  • Sipariş verisi, alınan olaylar ve reklama atfedilen satışları ayrı sütunlarda tutun.

Sonuç

Kurulumdan önce olay sözlüğünü yazın, her gerçek işleme kararlı bir kimlik verin ve tarayıcı-sunucu eşleşmesini test siparişiyle doğrulayın. Ardından aktarım sağlığı ile reklam atfını ayrı izleyin. Worgoo E-Ticaret kapsamında bu çalışma; mağaza altyapısı, veri tercihleri ve reklam yönetiminin ortak sorumluluğudur.

Sık sorulan sorular

CAPI eklenince bütün eksik satışlar ölçülür mü?

Hayır. Sunucu bağlantısı aktarım dayanıklılığına katkı sağlayabilir; veri tercihleri, eşleştirme, gecikme ve atıf sınırları devam eder. CAPI, tarayıcıdaki tercihleri aşma veya bütün satışları reklama yazma yöntemi değildir.

Aynı satın alma iki kez görünüyorsa ne kontrol edilir?

Önce ayrı entegrasyonların aynı olayı tetikleyip tetiklemediğine bakın. Tarayıcı ve sunucuda event_name ve event_id eşleşmesini, yenilemede yeni kimlik üretilmesini ve sipariş bildirimlerinin tekrarını test edin.

Hazır eklenti kullanırsam geliştirme gerekmez mi?

Desteklenen hazır bağlantı özel geliştirme ihtiyacını azaltabilir. Yine de olay koşulları, para birimi, değer, veri tercihleri ve tekrar ayıklama kendi mağazanızda test edilmelidir. Eklenti güncellemeleri sonrası bu kontrolü yenileyin.

E-posta bilgisini hash etmek anonimleştirme midir?

Hayır. Hash, eşleştirme amacıyla kullanılan teknik bir dönüşümdür; kimlikle ilişki kurulabilen veriyi otomatik olarak anonim yapmaz. Gönderilecek alanları, amaçları ve veri tercihlerini ayrıca değerlendirin.

Kaynaklar

Semih Bayındır

Yazar hakkında

Semih Bayındır

Senior Digital Marketing Specialist

Semih Bayındır, Worgoo’da Senior Digital Marketing Specialist olarak görev yapar.

Profil ve çalışmaları

İlgili hizmetler

Meta AdsÖzel Yazılım

İlgili sektörler

Worgoo E-Ticaret

Proje Talebi