Facebook Dönüşümler API (Conversion API - CAPI) Ne İşe Yarar? Nasıl Kurulur?

E-ticaret sitenizi ziyaret eden herkese Facebook ve Instagram üzerinden reklam gösterebilirsiniz. Sitenize üye olan ya da olmayan ziyaretçilerinize kendi sosyal medya hesaplarında reklam gösterimi yapabilir; üstelik aldıkları aksiyonlara göre (sepete ürün ekleyenler, üye olanlar, alışveriş yapanlar gibi) hedef kitleler oluşturabilirsiniz.

Facebook CAPI Nedir?

Üçüncü parti çerezlerin engellenmeye başlaması ve iOS 14 ile gelen takip kısıtlamaları, Facebook Pixel'in bazı olayları ölçememesine yol açtı. Facebook'un bu soruna çözümü olan Dönüşümler API'si (Facebook Conversion API — CAPI), verilerin daha eksiksiz toplanmasını sağlar.

Aradaki temel fark çalışma biçimidir. Facebook Pixel tarayıcı üzerinden çalışır: ziyaretçinin tarayıcısında çalışan bir kod, yapılan işlemi Facebook'a bildirir. Facebook CAPI ise sunucu üzerinden çalışır: işlem sizin sunucunuzda kayda geçtiği anda bilgi doğrudan Facebook'a iletilir, ziyaretçinin tarayıcısına çerez eklenmez.

Pixel Varken CAPI'ye Gerek Var mı?

Facebook Pixel dönüşümlerinizi ölçer; sayfa görüntüleme, sepete ekleme ve satın alma gibi olayları toplar, hedef kitlelerinizi oluşturur. Çoğu mağaza için tek başına yeterlidir ve CAPI kurmak zorunlu değildir.

Pixel tarayıcı üzerinden çalışır. Reklam engelleyiciler, iOS'taki izleme izni ve tarayıcıların çerez kısıtlamaları nedeniyle olayların bir bölümü Facebook'a ulaşmaz. Bu, Pixel'in eksiği değil, tarayıcı tarafındaki gizlilik düzenlemelerinin sonucudur.

CAPI aynı olayı sunucu üzerinden gönderir. Sipariş sunucunuzda oluştuğu anda bilgi doğrudan Facebook'a iletilir, arada tarayıcı yoktur. İki sistem birlikte çalışır; CAPI, Pixel'in yerine geçmez.

Aynı olay iki kez sayılmaz. İkisi birlikte çalıştığında bir olay için Facebook'a iki kayıt gider: biri tarayıcıdan, biri sunucudan. Facebook bu kayıtları eşleştirip tek olay olarak sayar.

CAPI'nin katkısı, ölçülen dönüşüm sayısı arttıkça belirginleşir. Facebook'un reklamınızı kime göstereceğini belirleyen sistem dönüşüm verisiyle çalışır; veri eksiksiz olduğunda bütçeniz daha verimli kullanılır ve yeniden pazarlama listeleriniz daha doğru olur. Düzenli reklam veriyorsanız kurmanız önerilir.

Pixel'in sitenizde kurulu olması şart mı? Hayır. CAPI panelde ayrı bir bağlantıdır ve Pixel'i sitenize kurmadan da çalışabilir. İhtiyaç duyduğu tek şey, Facebook tarafında oluşturulmuş bir pikselin kimliğidir (Pixel ID); veriler o kimliğe gönderilir. Yine de web siteleri için önerilen kurulum ikisinin birlikte çalışmasıdır: CAPI tek başına, tarayıcıda oluşan sinyalleri toplayamaz. Pixel kurulumu için Facebook Piksel Entegrasyonu sayfasını inceleyebilirsiniz.

Facebook CAPI Ne İşe Yarar?

Facebook CAPI ile sitenizde gezilen sayfaları, sepete eklenen ürünleri, tamamlanan siparişleri ve daha pek çok veriyi takip edebilirsiniz. Veriler daha eksiksiz toplandığı için oluşturduğunuz hedef kitleler daha doğru kişileri içerir ve reklam performansınız artar.

Facebook CAPI Nasıl Kurulur?

Kurulum iki aşamalıdır: önce Facebook tarafından iki bilgi alırsınız (Pixel ID ve CAPI Token), sonra bu bilgileri ideasoft panelinize girersiniz.

1. Facebook Tarafından Bilgileri Alın

1. Business Manager hesabınıza girin ve Olay Yöneticisi (Events Manager) bölümüne gidin.
2. Kullanacağınız pikselin üzerine tıklayın.
3. Ayarlar sekmesini açın. Hem Pixel ID'nize hem de Dönüşümler API'si bölümüne buradan ulaşırsınız.
4. Pixel ID: Ayarlar sekmesinin üst kısmında yer alan kimlik numarasıdır. Üzerine tıkladığınızda otomatik olarak kopyalanır.
5. CAPI Token: Aynı sekmedeki Dönüşümler API'si bölümünde Erişim jetonu oluştur bağlantısına tıklayın. Oluşan jetonu kopyalayın.

Jetonu saklayın. Erişim jetonu yalnızca oluşturulduğu anda tam hâliyle görünür. Kopyalamadan ekranı kapatırsanız yeni bir jeton oluşturmanız gerekir. Jeton bir şifre niteliğindedir; kimseyle paylaşmayın.

Facebook arayüzü zaman zaman değişir. Menü adları ve bölümlerin yeri güncellemelerle farklılaşabilir. Aradığınız alanı bulamazsanız Olay Yöneticisi içinde "Dönüşümler API'si" ifadesini arayın; jeton oluşturma her sürümde bu başlığın altındadır.

2. Bilgileri ideasoft Panelinize Girin

1. Yönetim panelinizde Ayarlar > Genel Ayarlar bölümüne gidin.
2. Pazarlama ve Analiz Araçları başlığını açın.
3. Listedeki Facebook Conversion API satırında Bağla butonuna tıklayın.
4. Açılan pencerede alanları doldurup Onayla deyin.

Açılan pencerede dört alan bulunur:

• Facebook CAPI Token: Olay Yöneticisi'nden kopyaladığınız erişim jetonu.
• Pixel ID: Kullandığınız pikselin kimlik numarası.
• Katalog Ürün ID Tipi: Facebook kataloğunuzda ürünlerinizi hangi kimlik tipiyle tutuyorsanız burada da aynı tipi seçmeniz gerekir (örneğin Ürün Stok Kodu). Yanlış seçim, ürünlerin katalogla eşleşmemesine yol açar.
• Test Kodu: Kurulumu kontrol etmek için kullanılır. Zorunlu değildir; nasıl kullanıldığını aşağıdaki bölümde bulabilirsiniz.

Onayla dediğinizde Facebook Dönüşümler API'si sitenize kurulmuş olur. Bağlantıyı daha sonra düzenlemek isterseniz aynı satırdaki düzenleme simgesini, kaldırmak isterseniz Bağlantıyı Kaldır butonunu kullanabilirsiniz.

Kopyalarken dikkat: Token ve Pixel ID'yi yapıştırırken başına veya sonuna boşluk gelmemesine dikkat edin. Ayrıca token ile Pixel ID'nin aynı piksele ait olması gerekir; birden fazla pikseliniz varsa karıştırmayın.

Kurulumdan Sonra Kontrol Etme

Kurulum tamamlandıktan sonra olayların Facebook'a ulaşıp ulaşmadığını Test Kodu ile kontrol edebilirsiniz.

1. Facebook Olay Yöneticisi'nde pikselinizi açın ve Olayları Test Et bölümüne gidin.
2. Burada size özel bir test kodu üretilir; kodu kopyalayın.
3. ideasoft panelinizde Facebook Conversion API penceresini açıp kodu Test Kodu alanına yapıştırın ve onaylayın.
4. Sitenizde bir ürünü görüntüleyin veya sepete ekleyin. Bu işlemler Olay Yöneticisi'ndeki test ekranında görünmelidir.
5. Kontrol bittikten sonra Test Kodu alanını boşaltmanız önerilir.

Olaylarım Olay Yöneticisi'nde Görünmüyor

Kurulumu tamamladığınız hâlde olaylarınızı göremiyorsanız sırasıyla şunları kontrol edin:

• Hemen görünmesini beklemeyin. Olay Yöneticisi'ndeki özet ekranlara veriler anlık değil, kısa bir gecikmeyle yansır. Anlık kontrol için yukarıdaki Test Kodu yöntemini kullanın.
• Token ve Pixel ID'yi yeniden kontrol edin. Kopyalama sırasında eksik karakter kalmış ya da başına boşluk gelmiş olabilir.
• Token ile Pixel ID aynı piksele mi ait? Farklı pikseller kullanıldığında veriler Facebook tarafında eşleşmez.
• Jeton geçerli mi? Facebook tarafında erişim jetonunu yenilediyseniz veya sildiyseniz panele yeni jetonu girmeniz gerekir.
• Katalog Ürün ID Tipi doğru mu? Ürünler katalogla eşleşmiyorsa bu alanı Facebook kataloğunuzdaki tiple aynı yapın.
• Doğru pikseli inceliyor musunuz? Olay Yöneticisi'nde birden fazla piksel varsa panele girdiğiniz kimliğe ait olanı açtığınızdan emin olun.

Sorun devam ediyorsa: Yukarıdaki adımları uyguladığınız hâlde olaylarınız görünmüyorsa Destek Sistemi üzerinden kayıt oluşturabilirsiniz. Kaydınıza Pixel ID'nizi ve Olay Yöneticisi'nde gördüğünüz ekranın görüntüsünü eklemeniz incelemeyi hızlandırır.