Meta Dönüşüm API Kurulumu: Pixel ile Birlikte Sunucu Taraflı Ölçüm

Hizmet

Meta Conversions API kurulumu, Pixel tekilleştirme ve test

Ajans

Reklam Time 360

Merkez

Esenyurt, İstanbul. İstanbul geneli ve Türkiye genelinde uzaktan hizmet.

Çalışma saatleri

Her gün 09:00–21:00

Telefon

0535 596 78 27

Meta Dönüşüm API'si (Conversions API) nedir?

Kısa cevap: Conversions API, web sitenizdeki, uygulamanızdaki veya CRM'inizdeki satış, form ve arama gibi olayları sunucunuzdan doğrudan Meta'ya gönderen bağlantıdır. Kısaltması CAPI'dir; Türkçe arayüzde "Dönüşüm API'si" olarak geçer.

Meta Pixel olayı ziyaretçinin tarayıcısından gönderir. Conversions API ise aynı olayı sizin sunucunuzdan, tarayıcıya bağlı kalmadan iletir. Meta'nın geliştirici belgelerine göre sunucudan gelen olaylar Pixel olayları gibi işlenir; ölçüm, raporlama ve reklam optimizasyonunda kullanılır.

Tek bağlantıyla farklı kaynaklardan olay gönderebilirsiniz: web sitesindeki satın alma, CRM'de "kazanıldı" olarak işaretlenen müşteri adayı ya da mağazada tamamlanan satış. Böylece reklamın getirdiği sonucu sadece tarayıcının gördüğü kadarıyla değil, işletmenizin kayıtlarıyla birlikte değerlendirirsiniz.

Conversions API ile Meta Pixel arasındaki fark nedir?

Kısa cevap: Pixel tarayıcıda çalışan bir koddur, Conversions API sunucudan çalışır. Meta, ikisini birlikte kurmayı önerir; aynı olay iki yoldan gelir ve tekilleştirme ile bir kez sayılır.

Pixel'i kaldırıp sadece Conversions API kullanmak önerilen yol değildir. Meta'nın tekilleştirme belgesinde açıkça "Conversions API'yi Meta Pixel ile birlikte uygulamanızı öneriyoruz" denir. Sitenizde henüz Pixel yoksa önce Meta Pixel kurulumu yazımızdaki adımlarla başlayın; Dönüşüm API'si için aynı Pixel ID kullanılır.

Meta dönüşüm API kurulumu neden gerekli?

Kısa cevap: Tarayıcı kaynaklı olay kaybını azaltmak, sitenin dışında gerçekleşen satışları Meta'ya bildirmek ve reklam algoritmasına daha eksiksiz sonuç verisi sağlamak için.

• Tarayıcı engelleri: Reklam engelleyiciler, çerez kısıtlamaları ve teşekkür sayfası yüklenmeden kapanan sekmeler Pixel olayının hiç gitmemesine yol açabilir.
• iOS ve uygulama içi izinler: Apple, iOS 14.5 ve sonrasında uygulamaların kullanıcıyı diğer şirketlerin uygulama ve sitelerinde izlemek için App Tracking Transparency (ATT) üzerinden izin almasını şart koşar. Bu, mobil kaynaklı ölçümü daraltır. Dönüşüm API'si bu izni aşmanın yolu değildir; ama sizin kendi kayıtlarınızdaki gerçek satışı Meta'ya iletmenizi sağlar.
• Site dışı satışlar: Telefonla kapanan satış, CRM'de onaylanan teklif veya mağazada ödenen sipariş Pixel'in göremeyeceği olaylardır.
• Optimizasyon: Reklam sistemi hangi kişinin satın aldığını ne kadar eksiksiz görürse benzer kişileri o kadar isabetli bulur. Eksik veri, bütçenin yanlış kitleye gitmesine sebep olur.

Reklam bütçesi yüksek olmayan işletmelerde de fark önemlidir: aylık birkaç düzine satışın birkaçı bile kaybolursa kampanyanın gerçekten çalışıp çalışmadığı yanlış okunur. Bütçenin nasıl oluştuğunu Instagram reklam fiyatları yazımızda anlattık.

Meta dönüşüm API kurulumu hangi yollarla yapılır?

Kısa cevap: Dört ana yol vardır: Events Manager'dan Conversions API Gateway, iş ortağı entegrasyonları (örneğin WooCommerce eklentisi), Google Tag Manager sunucu taraflı kapsayıcı ve geliştiricinin yazdığı doğrudan API entegrasyonu.

Conversions API Gateway

Meta'nın kurulum belgesine göre Gateway, Events Manager üzerinden barındırma bölgesi seçilerek kurulur ve bölge sonradan değiştirilemez; AWS yığınının oluşması yaklaşık 30–40 dakika sürer. Bulut sunucusu sizin hesabınızda çalıştığı için barındırma ücreti de o hesaba yansır. İsterseniz kendi alan adınızdan bir alt alan adı tanımlanır; bunun için DNS erişimi gerekir.

WordPress ve iş ortağı entegrasyonları

WooCommerce mağazalarında en kısa yol Meta'nın resmi eklentisidir. Elementor ile yapılmış kurumsal sitelerde ise form gönderimi, arama ve WhatsApp tıklaması gibi olaylar genellikle GTM üzerinden kurulur. Hangi yolun uygun olduğu sitenizin altyapısına bağlıdır; yeni bir mağaza kuruyorsanız e-ticaret sitesi kurulumu aşamasında bu bağlantıyı baştan planlarız.

Google Tag Manager sunucu taraflı kurulum

Meta'nın GTM rehberi, sunucu kapsayıcısında varsayılan GA4 istemcisini ve Facebook Conversions API etiketini kullanmayı, Pixel ile aynı olayları paylaşan "yedekli" bir yapı kurmayı anlatır. Bu yol, web kapsayıcısı düzgün kurulmuş bir siteyi gerektirir; altyapı yoksa önce Google Tag Manager kurulumu ve GA4 kurulumu yapılır.

Doğrudan API entegrasyonu

Kendi yazılımınız veya CRM'iniz varsa en esnek yöntemdir. Meta, olayların gerçekleşir gerçekleşmez, ideal olarak bir saat içinde gönderilmesini önerir; olay zamanı (event_time) 7 günden eskiyse istek hata verir. Mağaza içi ve çevrimdışı satışlarda ise işlemin 62 gün içinde yüklenmesi istenir.

Meta dönüşüm API kurulumu adım adım nasıl yapılır?

Kısa cevap: Önce hangi olayların ölçüleceği belirlenir, sonra Pixel kontrol edilir, kurulum yolu seçilir, erişim belirteci oluşturulur, olaylar tekilleştirme kimliğiyle gönderilir, test edilir ve eşleşme kalitesi izlenir.

1. Olay planı

   Hangi hareketin sizin için sonuç olduğunu yazarız: satın alma, form gönderimi (Lead), randevu, arama, WhatsApp'a geçiş. Her olayın adı, değeri ve para birimi baştan belirlenir.

2. Pixel ve alan adı kontrolü

   Sitede doğru Pixel'in çalıştığı, olayların çift tetiklenmediği ve iş hesabının Meta Business Suite'te düzgün yetkilendirildiği kontrol edilir.

3. Kurulum yolunun seçimi

   Altyapınıza göre Gateway, iş ortağı entegrasyonu, GTM sunucu taraflı veya doğrudan API seçilir. Seçimin gerekçesi yazılı teklifte yer alır.

4. Erişim belirteci ve müşteri bilgileri

   Belirteç Events Manager'dan oluşturulur. E-posta, telefon, ad gibi bilgiler gönderilmeden önce normalleştirilir ve karma işlenir; IP adresi, tarayıcı bilgisi, fbp ve fbc karma işlenmeden gönderilir.

5. Tekilleştirme

   Aynı olayın Pixel ve sunucu sürümüne aynı event_id ve event_name verilir; böylece satış iki kez sayılmaz.

6. Test olayları

   Events Manager'daki Test Events penceresinden alınan test kodu ile olaylar canlıdan önce denenir, sonra test kodu kaldırılır.

7. İzleme ve rapor

   Event Match Quality puanı, olay kapsamı ve veri gecikmesi ilk haftalarda takip edilir; eksikler düzeltilir ve size kısa bir kurulum raporu verilir.

Tekilleştirme (event_id) nasıl çalışır?

Kısa cevap: Meta, aynı Pixel ID'ye gelen ve event_id ile event_name değeri aynı olan iki olayı aynı olay sayar; ilk olaydan sonraki 48 saat içinde gelen eşi atılır.

Pixel tarafında event_id, fbq çağrısının dördüncü parametresi olan eventID ile verilir. Sunucu tarafında aynı değer event_id alanına yazılır. Değer her olay için benzersiz olmalıdır; örneğin sipariş numarası ya da form gönderimine özel bir kimlik.

Alternatif yöntem fbp ve/veya external_id değerlerini her iki tarafta tutarlı kullanmaktır. Ancak Meta'nın belgesine göre bu yöntem genellikle tarayıcı olayı önce, sunucu olayı sonra geldiğinde çalışır. Bu yüzden kurulumlarımızda event_id kullanıyoruz.

Sık görülen hata: Pixel'de olay adı "Purchase", sunucuda "purchase" ya da farklı bir adla gönderilir. Ad birebir aynı olmazsa tekilleştirme çalışmaz ve satışlar şişer. Kurulum sonrası raporda dönüşüm sayısı birden ikiye katlandıysa ilk bakılacak yer burasıdır.

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

Kısa cevap: Event Match Quality, sunucudan gönderdiğiniz müşteri bilgilerinin olayı bir Meta hesabıyla eşleştirmede ne kadar etkili olabileceğini gösteren 10 üzerinden bir puandır. Şu an yalnızca web olayları için gösterilir.

Puanı belirleyen; hangi müşteri bilgisi alanlarının gönderildiği, bu bilgilerin kalitesi ve eşleşen olayların oranıdır. Meta'nın Dataset Quality belgesinde ayrıca olay kapsamı (Pixel olaylarının ne kadarının sunucudan da geldiği), tekilleştirme anahtarı geri bildirimi ve veri tazeliği ölçütleri yer alır.

Puanı yükseltmek için zorla veri toplanmaz. Formda zaten istediğiniz bilgiyi doğru biçimde iletmek çoğu zaman yeterlidir. Kullanıcının izin vermediği bilgiyi göndermek ise hem politika hem KVKK açısından risklidir.

Test olayları ile kurulum nasıl doğrulanır?

Kısa cevap: Events Manager'daki Test Events penceresinden test kodu alınır, istekler test_event_code parametresiyle gönderilir ve olayların gelip gelmediği, tekilleştirilip tekilleştirilmediği canlı olarak izlenir.

Meta, test_event_code alanının sadece test için kullanılmasını ve canlı istekten kaldırılmasını ister. Test kodlu olaylar da Events Manager'a akar ve hedefleme ile ölçümde kullanılabilir; bu yüzden testi gerçek sipariş yerine deneme siparişiyle yapar, ardından kaydı not ederiz.

• Her olayın hem tarayıcıdan hem sunucudan geldiği ve "tekilleştirildi" olarak göründüğü kontrol edilir.
• Değer ve para birimi (TRY) alanlarının doğru geldiği görülür.
• action_source alanının doğru olduğu doğrulanır; web olayı için "website", mağaza olayı için "physical_store".
• Reklam yöneticisinde kampanyanın doğru olayı optimize ettiği kontrol edilir.

Click-to-WhatsApp reklamlarında ise sohbetin içinde gerçekleşen satışlar ayrı bir ürün olan Conversions API for Business Messaging ile, reklama tıklamadan gelen ctwa_clid kimliği kullanılarak bildirilir. Bu kurgu WhatsApp chatbot kurulumuyla birlikte planlanır.

KVKK ve kullanıcı izni açısından nelere dikkat edilmeli?

Kısa cevap: Sunucu taraflı gönderim izin yükümlülüğünü ortadan kaldırmaz. KVKK'nın çerez rehberine göre davranışsal reklamcılık için kullanılan çerezler açık rıza gerektirir; izin vermeyen kullanıcının verisi reklam amacıyla gönderilmemelidir.

• Çerez onayı: Sitenizdeki çerez paneli, kullanıcının reklam çerezlerini reddetmesine izin vermeli ve bu tercih hem Pixel'e hem sunucu olaylarına uygulanmalıdır.
• Aydınlatma metni: Hangi verinin hangi amaçla ve kimlere aktarıldığı gizlilik politikasında yazmalıdır.
• Veri azaltma: Olay için gerekmeyen bilgi gönderilmez. Sağlıkla ilgili sayfa adları, kimlik numarası gibi hassas bilgiler olay verisine eklenmez.
• Hukuki değerlendirme: Metinlerinizin hukuki uygunluğu için avukatınızın görüşünü alın; biz teknik uygulamayı yaparız.

Reklam hesabı, Pixel ve veri kümesi sizin iş hesabınızda açılır; veri sizindir. Ajansa erişim yetkisi verilir, sahiplik verilmez.

Meta dönüşüm API kurulumu ne zaman gerekmez?

Kısa cevap: Sitenizde ölçülecek bir sonuç yoksa, reklamlarınız sadece profil ziyareti veya mesaj hedefliyorsa ya da Pixel bile düzgün kurulmamışsa önce başka işler yapılmalıdır.

• Reklamlarınız yalnızca Instagram profiline veya Messenger'a yönlendiriyor ve sitede işlem olmuyorsa web için Dönüşüm API'si öncelik değildir.
• Sitede Pixel yok veya olaylar yanlış tetikleniyorsa önce tarayıcı tarafı düzeltilir; bozuk veriyi sunucudan göndermek sorunu büyütür.
• Ayda çok az ziyaretçi ve sonuç varsa, önce teklif ve sayfa iyileştirilir; bunun için landing page tasarımı çoğu zaman daha büyük fark yaratır.

Hangi durumda olduğunuzu bilmiyorsanız sitenize ve reklam hesabınıza bakıp dürüstçe söyleriz. Google tarafında da ölçüm eksikse Google Ads dönüşüm takibi aynı çalışmada kurulabilir.

Kurulum için kontrol listesi

Kısa cevap: Aşağıdaki maddelerin hepsi "evet" ise kurulumunuz sağlıklıdır; biri bile "hayır" ise düzeltilmesi gerekir.

• Pixel ve sunucu olayları aynı Pixel ID'ye gidiyor.
• Her olayda event_id var ve tarayıcı ile sunucuda aynı.
• Olay adları iki tarafta birebir aynı.
• Müşteri bilgileri normalleştirilip karma işleniyor; IP ve tarayıcı bilgisi karma işlenmeden gidiyor.
• Olaylar gerçekleştiği anda, en geç bir saat içinde gönderiliyor.
• test_event_code canlı isteklerden kaldırıldı.
• Çerez onayı reddedildiğinde reklam olayları gönderilmiyor.
• Event Match Quality ve olay kapsamı ilk haftalarda kontrol edildi.
• Kampanyalar doğru olayı optimize ediyor.

Ölçüm kurulmadan reklam başlatmıyoruz. Reklam tarafını da birlikte yürütmek isterseniz Meta reklam ajansı sayfamızda nasıl çalıştığımızı anlattık.

Sık sorulan sorular

Meta Pixel varken Dönüşüm API'si yine de gerekli mi?

Çoğu satış veya form toplayan sitede evet. Pixel tarayıcıya bağlıdır ve engellenebilir; Dönüşüm API'si aynı olayı sunucudan gönderir. Meta ikisini birlikte kullanmayı ve aynı event_id ile tekilleştirmeyi önerir.

Kurulum için kod bilmem gerekir mi?

Conversions API Gateway ve WooCommerce gibi iş ortağı entegrasyonları kod yazmadan arayüzden kurulur. GTM sunucu taraflı ve doğrudan API kurulumu teknik bilgi ister; bu kısmı biz üstleniriz.

Dönüşüm API'si iOS izinlerini veya çerez reddini aşar mı?

Hayır. Kullanıcının izin tercihi sunucu olaylarına da uygulanmalıdır. Dönüşüm API'si tarayıcı kaynaklı teknik kayıpları azaltır, izin yükümlülüğünü kaldırmaz.

Satışlarım iki kez sayılıyor, neden olabilir?

En sık sebep tekilleştirmenin eksik olmasıdır: event_id gönderilmiyor, tarayıcı ve sunucuda farklı değerler var ya da olay adları birebir aynı değil. Test Events penceresinde olayların tekilleştirildiği kontrol edilmelidir.

Event Match Quality puanı kaç olmalı?

Meta puanı 10 üzerinden verir ama sabit bir eşik açıklamaz. Hedef, izinli olarak zaten topladığınız e-posta, telefon gibi bilgileri doğru biçimde göndermek ve puanın zaman içinde düşmediğini izlemektir.

Kurulum ücreti ne kadar?

Ücret sitenizin altyapısına, olay sayısına ve seçilen kurulum yoluna göre yazılı teklifle belirlenir. Şu an tüm hizmetlerde %40 indirim uygulanıyor. Reklam bütçesi Meta'ya doğrudan ödenir ve ajans ücretinden ayrıdır.

Kaynaklar

• Meta for Developers: Pixel ve sunucu olaylarının tekilleştirilmesi
• Meta for Developers: Conversions API Gateway kurulumu
• Meta for Developers: Dataset Quality API ve Event Match Quality
• KVKK: Çerez Uygulamaları Hakkında Rehber

Dönüşüm API kurulumunuzu birlikte planlayalım

Sitenize ve reklam hesabınıza bakıp hangi kurulum yolunun uygun olduğunu, hangi olayların ölçülmesi gerektiğini söyleyelim; kapsam ve teslim tarihi yazılı gelir.

Tüm hizmetlerde %40 indirim

WhatsApp'tan yazın 0535 596 78 27'yi arayın

Reklam Time 360, Yalı Köşkü Sitesi, Barbaros Hayrettin Paşa Mah., 1996. Sk. No:21 D:2/A, 34515 Esenyurt/İstanbul · Her gün 09:00–21:00 · Haritada aç

Diğer sayfalar: Meta Pixel kurulumu · Google Tag Manager kurulumu · GA4 kurulumu · Meta reklam ajansı · Instagram reklam fiyatları · Tüm hizmetlerimiz · İletişim