Shopify Conversions API kurulumu nasıl yapılır

Shopify Conversions API kurulumu, mağazanızda gerçekleşen sepete ekleme ve satın alma gibi olayların yalnızca ziyaretçinin tarayıcısından değil, Shopify'ın sunucularından da Meta'ya iletilmesini sağlayan ayardır. Shopify tarafında bunun için sunucu kodu yazmanız, ayrı bir aracı servis kiralamanız ya da geliştirici tutmanız gerekmez. Facebook ve Instagram satış kanalı bu bağlantıyı zaten taşır; sizin işiniz doğru veri paylaşım seviyesini seçmek, hangi olayların gerçekten sunucudan çıktığını bilmek ve bunu Events Manager üzerinden doğrulamaktır.

Shopify Conversions API kurulumu neyi değiştirir

Kurulumdan önce olay tek bir yerden çıkar: ziyaretçinin tarayıcısında çalışan piksel kodu. Kurulumdan sonra aynı olayın bir kopyası Shopify'ın sunucusundan doğrudan Meta'ya gider. Yani gönderici değişir, olayın kendisi değişmez. Tarayıcı tarafı kapanmaz, kapatmanız da gerekmez; iki kanal birlikte çalışacak şekilde tasarlanmıştır. Aynı satın almanın iki kez sayılması meselesi ayrı bir konudur ve Meta bunu olay kimliği üzerinden kendi tarafında ele alır. Bu yazının kapsamı dar ve nettir: Shopify'ın kendi entegrasyonuyla sunucu tarafını açmak ve doğru çalıştığını görmek.

Başlamadan önce elinizde olması gerekenler

Kurulumun takıldığı yerlerin çoğu ayarın kendisi değil, eksik bağlantılardır. Aşağıdakileri önceden hazırlarsanız akış tek oturumda biter.

• Shopify mağazasında uygulama ve satış kanalı ekleyebilecek yönetici yetkisi.
• Meta Business portföyü, ona bağlı bir Facebook sayfası ve reklam hesabı.
• Halihazırda kullandığınız veri kümesi, yani piksel. Yeni bir tane oluşturursanız geçmiş veriniz ve mevcut kitleleriniz eski kümede kalır. Piksel kavramına yabancıysanız önce Meta Pixel nedir ve nasıl kurulur yazısına göz atın.
• Meta tarafında doğrulanmış bir mağaza alan adı.
• Gizlilik politikanızda ve çerez onay akışınızda, müşteri verisinin reklam ölçümü için işlendiğine dair güncel bir karşılık.

Veri paylaşım seviyeleri ve sunucu tarafını hangisi açar

Shopify'ın Facebook ve Instagram kanalında paylaşım tek bir açma kapama düğmesi değil, kademeli bir seçimdir. Kanalın güncel sürümünde üç kademe bulunur ve aralarındaki fark hem göndericiyle hem de gönderilen bilgiyle ilgilidir.

• Standart: Olaylar yalnızca tarayıcıdaki pikselden gider, müşteriye ait ek bilgi eklenmez.
• Gelişmiş: Olaylar yine tarayıcıdan gider, ancak müşterinin e-posta ve telefon gibi bilgileri karma hâlinde olaya eklenir.
• Maksimum: Tarayıcı gönderimi devam ederken Shopify sunucusundan da gönderim başlar. Conversions API bu kademede devreye girer.

Pratikte kurulum dediğimiz şey büyük ölçüde bu seçimden ibarettir. Kademeyi geri düşürdüğünüzde sunucu gönderimi de durur; yani bu, bir kez yapılıp unutulan bir kurulum değil, sürdürülmesi gereken bir tercihtir. Kademelerin isimleri ve arayüzdeki yerleri zaman zaman değişiyor. Ayarı açmadan önce Shopify Yardım Merkezi'ndeki ve Meta'nın resmî dokümanındaki güncel adlandırmayı doğrulayın; ekran görüntüsü paylaşan blog yazılarına değil, üreticinin kendi sayfasına bakın.

Shopify'da hangi olaylar sunucudan gider

Satış kanalı, mağazanın standart akışında oluşan olayları üretir: sayfa görüntüleme, ürün görüntüleme, arama, sepete ekleme, ödemeye başlama, ödeme bilgisi ekleme ve satın alma. Maksimum kademede bunların sunucu kopyası da Meta'ya iletilir. Olay listesinin kanal sürümüne göre değişebildiğini unutmayın; kendi mağazanızda hangi olayların geldiğini Events Manager'daki olay tablosundan doğrulayın. Dönüşüm olaylarının ne anlama geldiğini tazelemek isterseniz reklamlarda dönüşüm nedir yazısı temel çerçeveyi veriyor.

Burada gözden kaçan asıl nüans şu: sunucudan giden olaylar yalnızca satış kanalının kendi ürettiği olaylardır. Temanıza elle eklediğiniz piksel kodu, üçüncü taraf uygulamaların bastığı olaylar ve Customer Events altında yazdığınız özel pikseller bu akışın dışında kalır, tarayıcıda kalmaya devam eder. Checkout Extensibility'ye geçmiş mağazalarda teşekkür sayfasına elle kod eklenemediği için bu ayrım daha da belirleyici hâle gelir: satın alma olayınızın bir sunucu kopyası varsa, o kopya satış kanalından geliyordur.

İkinci nüans iptal ve iadelerle ilgilidir. Sunucu gönderimi siparişin oluştuğu anı bildirir; sonradan iptal edilen ya da iade edilen sipariş için geriye dönük bir düzeltme gitmez. Kapıda ödemenin yaygın olduğu mağazalarda bu fark özellikle hissedilir ve raporu okurken akılda tutulması gerekir.

Kurulum adımları

• Shopify yöneticisinde Ayarlar bölümünden Uygulamalar ve satış kanalları sayfasını açın; Facebook ve Instagram kanalı kurulu değilse Shopify App Store üzerinden ekleyin.
• Kanal ayarlarında Meta hesabınızı bağlayın. Business portföyü, Facebook sayfası, reklam hesabı ve ticaret hesabı sırasıyla eşleşmelidir.
• Veri paylaşımı bölümünde paylaşımı etkinleştirin ve açılan listeden mevcut veri kümenizi seçin. Kanal yeni bir küme önerse bile eskisini seçin.
• Kademeyi maksimuma alın ve kaydedin.
• Events Manager'a geçip veri kümesinin Shopify ile ilişkilendirildiğini ve bağlantı yönteminin sunucu gönderimini içerdiğini görün.
• Alan adı doğrulaması eksikse tamamlayın; doğrulanmamış alan adı ölçüm önceliklerinizi sınırlayabilir.

Kurulumu doğrulama

Doğrulama atlanınca kurulum yapıldı sayılır ama çalışmaz. Sırayla şunlara bakın.

• Events Manager içinde veri kümenizi açın ve olay tablosundaki bağlantı yöntemi sütununu inceleyin. Satın alma satırında tarayıcının yanında sunucu da görünmelidir.
• Gerçek bir sipariş akışı çalıştırın. Shopify'ın test ödeme yöntemiyle ya da düşük tutarlı gerçek bir siparişle deneyin; olay birkaç dakika içinde tabloya düşer.
• Tarayıcı eklentisi Meta Pixel Helper yalnızca tarayıcı tarafını gösterir. Sunucu olayı orada görünmez ve bu bir hata değildir. Sunucu doğrulaması yalnızca Events Manager üzerinden yapılır.
• Teşhis sekmesindeki uyarıları okuyun, eksik parametre bildirimlerini tek tek kapatın.
• Aynı testi farklı bir cihaz ve ağdan tekrarlayın. Reklam engelleyici açık bir tarayıcıda sunucu olayının hâlâ geldiğini görmek en net kanıttır.

Tarayıcı tarafında ayrıca bir bozukluk varsa doğrulama karışır ve neyin nereden geldiğini ayıramazsınız. O durumda önce Meta Pixel hataları ve çözümleri yazısındaki kontrolleri geçin, sonra sunucu tarafına dönün.

Kurulumun sessizce bozulduğu durumlar

• Kanalı kaldırıp yeniden bağlamak paylaşım kademesini standarda düşürebilir. Her yeniden bağlantıdan sonra kademeyi kontrol edin.
• Bağlantıyı kuran Meta kullanıcısının yetkisi kalkarsa ya da hesabı kapanırsa gönderim durur. Bağlantıyı kişisel bir hesap yerine kurumsal bir kullanıcı üzerinden kurun.
• Birden fazla veri kümesi devredeyse olaylar bölünür ve hiçbiri tam görünmez.
• Headless kurulumlarda veya özel checkout kullanan mağazalarda satış kanalının kapsamı sınırlıdır; bu senaryoda kurulum farklı bir yoldan ilerler.
• Tema veya uygulama değişikliğinden sonra doğrulama adımlarını baştan çalıştırın. Değişikliği yapan kişi ölçümü düşündüğünü nadiren söyler.

Kurulumdan sonraki ilk hafta

İlk günlerde bakılacak şey reklam sonuçları değil, veri akışının kararlılığıdır. Sunucu kaynaklı satın alma sayısının günden güne oturmasını, teşhis uyarılarının temizlenmesini ve olay eşleşme kalitesi göstergesinin bir zemine yerleşmesini izleyin. Eşleşme kalitesini yükseltmek ayrı bir çalışmadır ve gönderdiğiniz müşteri parametreleriyle ilgilidir, kurulumun kendisiyle değil. Toplanan bu verinin hedefleme tarafındaki karşılığını merak ediyorsanız AI hedefleme sayfası konuyu ürün tarafından anlatıyor. Kurulumu bir kez yapıp unutmak yerine, her tema ve uygulama değişikliğinde doğrulama listesini tekrar çalıştırmayı alışkanlık hâline getirin; bu liste kısa ve tekrar edilebilir olduğu için ayda bir çalıştırmak da makul bir rutindir.