Meta Conversions API nasıl kurulur?

Meta Conversions API, web sitesindeki dönüşüm olaylarını sunucunuzdan Meta'ya göndererek Pixel ölçümünü destekleyecek şekilde kurulur. Kurulum için Meta Events Manager'da bir veri kümesi oluşturmanız, erişim belirteci almanız, sunucu tarafında olay gönderimi yapmanız ve tarayıcıdan gelen olaylarla aynı event_id değerini kullanmanız gerekir.

Bu yapı, tarayıcı kısıtlamaları nedeniyle eksik kalan bazı olayların yeniden ölçülmesine yardımcı olur. Ancak CAPI, eksik veriyi sınırsız biçimde geri getirmez. Kullanıcı izni, doğru olay tasarımı, veri kalitesi ve uygulama hataları sonucu doğrudan etkiler.

Meta Pixel kurulumu hakkında temel bilgiye ihtiyacınız varsa Meta Pixel kurulumu ve kullanımı rehberini inceleyebilirsiniz. CAPI, Pixel'in alternatifi değil, çoğu web sitesi için tamamlayıcısıdır.

Meta Conversions API hangi sorunu çözer?

Meta Conversions API, tarayıcıda oluşan ölçüm kayıplarını azaltmak için dönüşüm verisini web sunucusundan Meta'ya iletir.

Tarayıcı tabanlı ölçüm; reklam engelleyiciler, çerez kısıtlamaları, mobil işletim sistemi izinleri ve sayfa kapanmaları nedeniyle her olayı yakalayamayabilir. Örneğin kullanıcı ödeme tamamlandıktan sonra teşekkür sayfasını yüklemeden sekmeyi kapatırsa Pixel olayı gönderilemeyebilir.

CAPI ise ödeme sistemi, CRM veya sunucu uygulamasında oluşan doğrulanmış olayı kullanabilir. Bu yaklaşım özellikle satın alma, potansiyel müşteri ve kayıt olaylarında daha kontrollü veri akışı sağlar. Meta'ya yalnızca gerçekten gerçekleşen olayları göndermek önemlidir.

Bu nedenle CAPI, reklam raporlarını otomatik olarak kusursuz hale getirmez. Tarayıcı ve sunucu olayları aynı dönüşümü temsil etmiyorsa Meta aynı satın almayı iki kez algılayabilir.

Meta Conversions API kurulumu için neler gerekir?

Kurulumdan önce Meta Business hesabına, bir reklam hesabına ve ölçüm yapmak istediğiniz veri kümesine erişiminiz olmalıdır.

Gereken temel bileşenler şunlardır: Meta Business Manager erişimi, reklam hesabı, Meta Pixel veya veri kümesi, sunucuya erişim, dönüşüm olaylarının listesi ve kullanıcı verisi işleme izinleri. E-ticaret sitelerinde ayrıca sipariş numarası, tutar, para birimi ve ürün bilgileri gerekir.

Önce hangi olayları göndereceğinizi belirleyin. Yaygın olaylar PageView, ViewContent, AddToCart, InitiateCheckout, Purchase, Lead ve CompleteRegistration'dır. Her olayın ne zaman tetikleneceği yazılı olarak tanımlanmalıdır.

Olay planı nasıl hazırlanır?

Bir olay planında olay adı, tetiklenme koşulu, kaynak sistem, gönderilecek parametreler ve beklenen sonuç bulunmalıdır. Purchase olayı yalnızca ödeme başarılı olduğunda gönderilmelidir. Sepete ekleme, buton tıklamasıyla değil ürün gerçekten sepete eklendiğinde tetiklenmelidir.

1. Satış, form veya kayıt hedefini belirleyin.
2. Her hedef için Meta standart olayını seçin.
3. Olayın hangi sistemde kesinleştiğini yazın.
4. Gönderilecek değerleri ve izin koşullarını tanımlayın.
5. Pixel ve CAPI olaylarının aynı dönüşümü nasıl eşleştireceğini belirleyin.

Örneğin bir e-ticaret sitesinde Purchase olayı ödeme sağlayıcısından başarılı yanıt alındığında oluşabilir. Kullanıcı yalnızca ödeme sayfasını açtıysa Purchase gönderilmemelidir. Bu ayrım raporlama doğruluğunu doğrudan etkiler.

Events Manager üzerinden CAPI nasıl başlatılır?

Meta Events Manager üzerinden veri kaynağınızı seçip Conversions API kurulum akışını açarak sunucu bağlantısı için gerekli ayarları oluşturabilirsiniz.

İlk adımda Events Manager'a girin ve ilgili veri kümesini seçin. Kullanılan arayüze göre veri kaynağı Pixel veya dataset olarak görünebilir. “Ayarlar” bölümünde Conversions API seçeneğini bulun ve kurulum yöntemini belirleyin.

Meta genellikle iş ortağı entegrasyonu, manuel kurulum veya sunucu tarafı bağlantı seçenekleri sunar. Shopify, WooCommerce veya benzeri platformlarda iş ortağı uygulaması kullanılabilir. Özel yazılımda ise geliştirici, Meta'nın sunucu uç noktasına HTTP isteği gönderir.

Manuel kurulumda Meta, bir access token oluşturur. Bu token sunucunun Meta'ya olay göndermesine izin verir. Token'ı tarayıcıdaki JavaScript koduna, herkese açık depo dosyasına veya URL parametresine koymayın.

Kurulum ekranındaki test olay kodunu da not edin. Test kodu, gerçek reklam raporlarını değerlendirmek için değil, gönderilen isteğin Meta tarafından alınıp alınmadığını kontrol etmek için kullanılır.

Bir iş ortağı bağlantısı kullanıyorsanız yalnızca uygulamayı etkinleştirmek yeterli olmayabilir. Uygulamanın hangi olayları gönderdiğini, event_id üretip üretmediğini ve Purchase değerini doğru aktarıp aktarmadığını kontrol edin.

Kurulum sırasında erişim rolünüz yetersizse token oluşturma veya veri kaynağı seçme adımları görünmeyebilir. Bu durumda Business Manager yöneticisinden veri kümesi ve reklam hesabı izinlerini kontrol etmesini isteyin.

Sunucu tarafında Meta'ya olay nasıl gönderilir?

Sunucu tarafında olay göndermek için Meta'nın Graph API uç noktasına access token içeren bir POST isteği hazırlamanız gerekir.

İstek gövdesinde genellikle data dizisi bulunur. Her olayda event_name, event_time, action_source ve user_data alanları yer alır. Web sitesi olaylarında action_source değeri website olarak gönderilir. event_time Unix zaman damgası biçiminde olmalıdır.

Satın alma olayında event_source_url, value ve currency gibi alanlar da kullanılabilir. Ürün bazlı e-ticaret verisinde content_ids, content_type ve num_items değerleri eklenebilir. Parametreleri yalnızca gerçekten sisteminizde bulunan verilerden üretin.

{
  "data": [
    {
      "event_name": "Purchase",
      "event_time": 1710000000,
      "event_id": "order-87421",
      "action_source": "website",
      "event_source_url": "https://www.ornek-site.com/siparis-tamamlandi",
      "user_data": {
        "em": ["hashlenmis_eposta"],
        "ph": ["hashlenmis_telefon"]
      },
      "custom_data": {
        "currency": "TRY",
        "value": 1299.90,
        "order_id": "87421"
      }
    }
  ]
}

Bu örnek, doğrudan üretim ortamına kopyalanacak tamamlanmış bir entegrasyon değildir. Alanların sunucu dilinizde doğru biçimde oluşturulması, kullanıcı verilerinin Meta kurallarına uygun işlenmesi ve kimlik değerlerinin doğru hash yöntemiyle hazırlanması gerekir.

event_time değeri olayın gerçekten gerçekleştiği zamanı göstermelidir. Sunucu saati ileri veya geri ise olaylar gecikmiş ya da hatalı görünebilir. Sunucuların saat senkronizasyonunu da kontrol edin.

Meta API yanıtında hata dönmese bile olayın doğru rapora yazıldığı varsayılmamalıdır. Events Manager'daki Test Events ve Event Match Quality bölümlerinden sonuçları ayrıca doğrulayın.

Pixel ve CAPI olayları nasıl eşleştirilir?

Pixel ve CAPI aynı dönüşümü gönderiyorsa çift sayımı önlemek için iki kaynakta aynı event_name ve event_id değerleri kullanılmalıdır.

Örneğin kullanıcı siparişi 87421 numarasıyla tamamladıysa tarayıcıdaki Pixel olayı ve sunucudaki CAPI olayı aynı mantıksal kimliği taşımalıdır. Bu kimlik, yalnızca sipariş numarası veya rastgele üretilen ortak bir olay kimliği olabilir.

event_id değerinin tarayıcıda bir formatta, sunucuda başka formatta üretilmesi eşleştirmeyi bozar. Büyük-küçük harf farkı, başına eklenen farklı metinler veya yeniden oluşturulan rastgele değerler aynı olayın iki kez sayılmasına neden olabilir.

Yanlış: Pixel her sayfa yüklemesinde rastgele event_id üretir, sunucu da yeni bir event_id oluşturur. Doğru: Aynı sipariş veya form işlemi için ortak event_id üretilir ve iki kanala aktarılır.

Purchase olayında sipariş numarası genellikle uygun bir eşleştirme anahtarıdır. Ancak sipariş numarası müşteri kimliği olarak kullanılmamalı, gereksiz kişisel veri içermemeli ve sisteminizde aynı sipariş için iki farklı değer üretilmemelidir.

Lead olayında ortak kimlik, form gönderiminin sunucuda oluşturduğu kayıt numarası olabilir. Form gönderimi başarısızsa CAPI Lead gönderilmemelidir. Kullanıcı butona bastı fakat sunucu kaydı oluşmadıysa dönüşüm gerçekleşmiş sayılmaz.

Deduplication testini gerçek reklam kampanyasıyla başlamadan önce yapın. Aynı test olayının Pixel ve CAPI kaynaklarında görünüp görünmediğini, Meta'nın olayı birleştirip birleştirmediğini kontrol edin.

Hangi CAPI kurulum yöntemi seçilmelidir?

Kurulum yöntemi, kullandığınız e-ticaret altyapısına, sunucu erişiminize ve olayların nerede kesinleştiğine göre seçilmelidir.

Hazır altyapılarda resmi veya güvenilir iş ortağı entegrasyonu daha kısa sürede kurulabilir. Ancak eklentinin gönderdiği olayları incelemeden etkinleştirmek doğru değildir. Aynı anda başka bir Pixel eklentisi çalışıyorsa PageView, AddToCart veya Purchase tekrarları oluşabilir.

Özel yazılımlarda doğrudan sunucu entegrasyonu daha fazla kontrol sağlar. Geliştirici, ödeme onayını, sipariş değerini ve kullanıcı iznini kendi iş akışına göre yönetebilir. Bunun karşılığında hata günlüğü, yeniden deneme mekanizması ve token güvenliği kurulmalıdır.

Sunucu tarafı etiketleme çözümü de kullanılabilir. Bu modelde web sitesinden gelen veriler önce sizin kontrol ettiğiniz bir sunucuya, ardından Meta'ya iletilir. Yapı, farklı reklam platformlarını tek noktadan yönetmek için yararlı olabilir. Fakat ek sunucu maliyeti ve bakım gerektirir.

Google dönüşüm takibi de kuruyorsanız Google Dönüşüm Takibi kurulum rehberindeki olay planlama yaklaşımını karşılaştırabilirsiniz. Meta ve Google'a aynı olay adlarını göndermek zorunda değilsiniz; ancak iş hedefleri ve dönüşüm tanımları tutarlı olmalıdır.

Kurulum yöntemi ne olursa olsun, önce test ortamında bir veya birkaç olay gönderin. Tüm siteye yayılan otomasyonu, test sonucunu görmeden etkinleştirmeyin. Özellikle ödeme akışında küçük bir kod değişikliği, Purchase sayısını etkileyebilir.

Meta Conversions API nasıl test edilir?

Meta Conversions API, Events Manager içindeki Test Events ekranında test_event_code kullanılarak ve gerçek olay kaydıyla birlikte doğrulanır.

Önce Events Manager'da ilgili veri kaynağını açın ve Test Events bölümüne girin. Meta'nın oluşturduğu test kodunu sunucu isteğine geçici olarak ekleyin. Test isteği gönderildiğinde olay kısa süre içinde test ekranında görünmelidir.

Testte event_name, event_time, action_source, event_id, value, currency ve user_data alanlarını ayrı ayrı inceleyin. Purchase için değer 0, eksik veya yanlış para birimindeyse reklam optimizasyonu hatalı sinyal alabilir.

• Olay adı Meta'nın beklediği standart adla eşleşiyor mu?
• event_time gerçek olay zamanını gösteriyor mu?
• action_source değeri web sitesi için website olarak gidiyor mu?
• Pixel ve CAPI aynı event_id değerini kullanıyor mu?
• Test isteği gerçek raporlamaya karışmayacak şekilde temizlendi mi?
• Purchase olayında value ve currency doğru mu?
• Sunucu yanıtı hata kodu döndürüyor mu?
• Olaylar Events Manager'da alınan ve işlenen olarak görünüyor mu?

Test ekranında olayın görünmesi, reklam kampanyasının hemen daha iyi performans göstereceği anlamına gelmez. Önce olayın doğru koşulda oluştuğunu, sonra eşleştirme kalitesini değerlendirin.

Events Manager'daki Diagnostics bölümü, eksik veya hatalı parametreler hakkında uyarılar gösterebilir. Uyarıların tamamı engelleyici hata değildir. Önceliği, Purchase gibi optimizasyon için kullandığınız olaylara verin.

Son kontrolde küçük bir gerçek işlem yapabilirsiniz. İşlemin sipariş sisteminde oluştuğunu, Meta'da tek dönüşüm olarak göründüğünü ve tutarın doğru aktarıldığını karşılaştırın. Test verisini daha sonra üretim raporlarından ayırın.

CAPI kurulduktan sonra reklam raporları neden farklılaşır?

CAPI kurulduktan sonra Meta raporlarının diğer sistemlerden farklı olması, veri kaynaklarının farklı kurallar ve zaman aralıkları kullanmasından kaynaklanabilir.

Meta Ads Manager, kendi ilişkilendirme penceresi içinde reklam etkileşimiyle ilişkilendirilen olayları raporlar. Google Analytics ise oturum, trafik kaynağı, modelleme ve kanal gruplaması gibi farklı kurallar kullanır. Sipariş sistemi ise yalnızca gerçekleşen ve onaylanan siparişleri temel alır.

Bu nedenle Meta'da 100 satın alma görünürken ödeme sisteminde 88 sipariş bulunması tek başına CAPI'nin yanlış olduğunu kanıtlamaz. Önce aynı tarih aralığını, saat dilimini, olay adını, iptal siparişleri ve test kayıtlarını karşılaştırın.

Asıl sorun, CAPI'nin aynı Purchase olayını iki defa göndermesi de olabilir. Özellikle teşekkür sayfası Pixel'i ile ödeme webhook'u CAPI'si birlikte çalışıyorsa event_id kontrol edilmelidir. Tek sipariş için iki farklı event_id üretilirse Meta bunları ayrı olay sayabilir.

Rapor karşılaştırması için basit bir kontrol tablosu hazırlayın. Tarih, sipariş numarası, olay zamanı, Pixel durumu, CAPI durumu, Meta sonucu ve ödeme sistemi sonucu aynı satırda yer almalıdır.

Meta'nın Event Match Quality göstergesi, gönderilen kullanıcı bilgilerinin eşleştirme açısından ne kadar kullanılabilir olduğunu anlamaya yardımcı olur. Bu göstergede yüksek sonuç almak için gereksiz veri toplamayın. İzin verilen, gerekli ve doğru veriyi gönderin.

CAPI, raporların tüm platformlarda aynı sayıya gelmesini hedeflemez. Hedef, gerçekleşen olayların doğru koşulda, doğru parametrelerle ve mümkün olduğunca tutarlı şekilde aktarılmasıdır.

Meta reklam maliyetlerini değerlendirirken yalnızca platformdaki dönüşüm sayısına bakmayın. CPM, CPC ve CPL ölçümlerini gerçek sipariş veya nitelikli lead verisiyle birlikte inceleyin.

Meta Conversions API kurulumunda hangi hatalar yapılır?

En sık hatalar yanlış olay tetikleme, eksik event_id, açıkta bırakılan access token, izinsiz veri gönderimi ve test kodunun üretimde unutulmasıdır.

İlk hata, buton tıklamasını dönüşüm kabul etmektir. Ödeme butonuna basılması ödeme başarısı değildir. Sunucu, ödeme sağlayıcısından başarılı yanıt almadan Purchase göndermemelidir.

İkinci hata, kullanıcı verilerini hashlemenin bütün uyum sorunlarını çözdüğünü sanmaktır. Hash işlemi, verinin aktarım biçimini değiştirir; kullanıcı izni veya hukuki gerekliliklerin yerine geçmez. E-posta ve telefon gibi alanları yalnızca gerekli koşullarda işleyin.

Üçüncü hata, access token'ı istemci tarafına koymaktır. Tarayıcıya gönderilen token ziyaretçiler tarafından görülebilir. Token sunucu ortam değişkenlerinde veya güvenli gizli bilgi yönetiminde saklanmalıdır.

Dördüncü hata, aynı olay için farklı para birimleri veya metin biçimli tutarlar göndermektir. value sayısal olmalı, currency ISO para birimi koduyla tutarlı kullanılmalıdır. Sipariş sistemindeki toplam ile Meta'ya giden toplam karşılaştırılmalıdır.

Beşinci hata, test_event_code değerini canlı isteklerde bırakmaktır. Bu değer yalnızca test sürecinde kullanılmalı ve üretim koduna sabit olarak yazılmamalıdır.

Altıncı hata, CAPI kurulduktan sonra izleme yapmamaktır. Haftalık olarak olay hacmini, hata oranını, eşleştirme kalitesini ve sipariş sistemiyle farkı kontrol edin. Büyük fark varsa önce son kod veya eklenti değişikliğini inceleyin.

Meta reklam politikaları ve kullanıcı verisi işleme konusunda ayrıca Meta Reklam Politikaları rehberini inceleyin. Teknik olarak gönderilebilen her veri, reklam amacıyla gönderilmesi gereken veri değildir.

Kurulumdan sonra beklenen olay sayısı, gerçek sipariş veya lead hacmiyle düzenli olarak karşılaştırılmalıdır. Böylece teknik sorun ile platformlar arası normal fark birbirinden ayrılır.