Dönüşüm API'si ne yapar
Bir Dönüşüm API'si (CAPI), dönüşüm etkinliklerini Storeep'in sunucusundan doğrudan reklam platformuna gönderir ve alıcının tarayıcısını atlar. Sunucudan sunucuya çalıştığı için reklam engelleyicilerinden, tarayıcı gizlilik ayarlarından veya iOS izleme sınırlarından etkilenmez ve Akıllı Teklif ve benzer kitleler için eşleşme kalitesini artırmak amacıyla karma müşteri ayrıntılarını taşır. İstemci tarafı pikseller için Tarayıcı pikselleri eşlik eden makalesine bakın.
Aynı platform için aynı anda bir tarayıcı pikseli ve bir CAPI çalıştırabilirsiniz. Storeep, her ikisini de etkinlik türünden ve sipariş numarasından oluşturulan paylaşılan bir etkinlik kimliğiyle damgalar, böylece platform bunları iki tane saymak yerine tek bir dönüşüme tekilleştirir.
Hangi platformlar bir CAPI sunar
- Facebook / Meta Dönüşüm API'si.
- TikTok Olaylar API'si.
- Snapchat Dönüşümler API'si.
X ve Google Ads, Storeep'te sunucu tarafı bir Dönüşüm API'sine sahip değildir; bunlar yalnızca tarayıcı tarafıdır.
Ne gönderilir
Her uygun siparişte, Storeep sipariş değerini ve para birimini, ürün satırı kalemlerini ve alıcının sinyallerini gönderir: karma e-posta, karma telefon, bir karma müşteri kimliği (external_id), IP adresi, kullanıcı aracısı ve Facebook ile Snapchat için karma pazar ülkesi. Ayrıca platformun dönüşümü orijinal tıklamaya ilişkilendirebilmesi için alıcının çerezlerinde bulunan herhangi bir reklam tıklama kimliğini (Facebook _fbc ve _fbp, TikTok ttclid, Snapchat ScCid) iletir.
Dönüşüm etkinlik türleri
- Facebook: yalnızca Lead veya Purchase. Facebook CAPI sepete ekleme veya ödeme etkinlikleri göndermez.
- TikTok: Lead, Purchase, Place an order veya Complete payment.
- Snapchat: Purchase veya Reserve.
Para birimi ve sıfır değerli siparişler
Her etkinlik, platform desteklediğinde siparişin kendi para birimini kullanır; aksi takdirde değer USD'ye dönüştürülür. Facebook CAPI, toplamı 0 olan herhangi bir siparişi atlar, çünkü Meta değeri olmayan dönüşümleri reddeder, bu da onu Facebook tarayıcı pikseliyle tutarlı tutar.
Terk edilmiş sipariş geçişi
Bu, anlaşılması gereken temel davranıştır. Yepyeni bir sipariş her zaman CAPI gönderimini tetikler. Terk edilmiş bir sipariş farklıdır: yalnızca o CAPI girişi için Terk edilmiş siparişler geçişini açtığınızda ve yalnızca sipariş durumu terk edilmişten başka herhangi bir duruma değiştiği anda gönderir.
- Terk edilmiş siparişler kapalıyken, kurtarılan terk edilmiş siparişler platforma asla iletilmez.
- Açıkken, durumu elle siz değiştirseniz de Automator uygulaması otomatik olarak değiştirse de, sipariş terk edilmiş durumdan çıktığında etkinlik tetiklenir.
- Automator yüklü değilse, etkinliğin tetiklenmesi için siparişi başka bir duruma kendiniz taşımalısınız.
- Geçiş giriş başınadır, bu yüzden terk edilmiş sipariş izlemeyi bir Piksel Kimliği için etkinleştirip diğeri için kapalı bırakabilirsiniz.
Bir CAPI'yi yükleme ve alanları
- Sol menüde Uygulamalar'ı açın.
- İstediğiniz Dönüşüm API'si uygulamasını bulun ve Yükle'ye tıklayın, ardından onaylayın.
- Uygulamayı tekrar açın ve bir giriş oluşturmak için Yeni piksel ekle'ye tıklayın.
Her girişte şu alanlar bulunur:
- Etkinleştir: açıkken, dönüşüm etkinlikleri sunucudan sunucuya gönderilir. Varsayılan olarak açıktır.
- Terk edilmiş siparişler: yukarıda açıklanan geçiş anahtarı. Varsayılan olarak kapalıdır.
- Reklam hesabı adı: yalnızca kendi referansınız için bir etiket.
- Piksel Kimliği: Meta, TikTok veya Snapchat Piksel Kimliğiniz.
- Pazarlar: bu girişin kapsadığı mağaza pazarları. Bir veya daha fazlasını seçin.
- Dönüşüm etkinlik türü: yukarıda listelenen platform seçenekleri.
- Erişim belirteci: platformun olaylar yöneticisinde oluşturduğunuz Dönüşümler API'si erişim belirteci. Zorunludur.
- Test modunu etkinleştir: açıkken, etkinlikler test etkinlikleri olarak gönderilir.
- Test kodu: platformdan gelen test etkinlik kodu, örneğin TEST_1234. Test modu açıkken zorunludur.
Test modu
Test modu açıkken, etkinlikler platformun test etkinlikleri görünümünde görünür, böylece canlı verilere dokunmadan entegrasyonu onaylayabilirsiniz. Test etkinlikleri reklam teklifini veya optimizasyonunu beslemez, bu yüzden canlı kampanyalar yürütmeden önce test modunu devre dışı bırakın.
Pazarlar bir CAPI'yi nasıl kapsar
Bir CAPI girişi yalnızca onda seçtiğiniz pazarlarda verilen siparişler için tetiklenir. Seçmediğiniz bir pazardaki bir sipariş o girişi tetiklemez, bu yüzden aynı mağazadan ülke başına farklı bir Piksel Kimliği ve erişim belirteci çalıştırabilirsiniz.
Kontrol edilecek şeyler
- Platformun iki gönderimi tek bir dönüşüme tekilleştirmesi için tarayıcı pikselinizde ve CAPI'nizde aynı Piksel Kimliğini kullanın.
- Etkinlikler platformun olaylar yöneticisinde görünmeyi durdurursa, erişim belirteciniz sona ermiş olabilir. Yeniden oluşturun ve girişi güncelleyin.
- Her giriş bağımsızdır. Her biri kendi Piksel Kimliği, erişim belirteci, pazarları, etkinlik türü ve terk edilmiş sipariş ayarıyla platform başına birden fazla giriş ekleyebilirsiniz.
- Canlıya geçmeden önce test modunu devre dışı bırakmayı unutmayın, aksi takdirde gerçek dönüşümleriniz sayılmaz.