Meta Pixel (CAPI) ve TikTok Events API 2.0 — RUTHH COD Form & Upsells

Settings → Pixels (/app/settings/pixels) ekranında Meta Pixel + Conversions API (CAPI) ve TikTok Pixel + Events API 2.0 ayarlarını yapılandırarak kapıda ödeme huni adımlarının ve tamamlanan siparişlerin hem tarayıcı hem sunucu üzerinden deterministik event_id tekilleştirmesiyle izlenmesini sağlamak.

• Meta Pixel ID (ve isteğe bağlı olarak Meta Olay Yöneticisi’nden alınan Conversions API Erişim Anahtarı) veya TikTok Pixel ID (ve isteğe bağlı TikTok Events API 2.0 Erişim Anahtarı) bilgilerine sahip olmanız.

1. Shopify Yönetim Paneli’nde Settings → Pixels (/app/settings/pixels) sayfasına gidin.
2. Add Pixel butonuna tıklayın ve Meta (Facebook & Instagram) seçeneğini seçin.
3. Sayısal Meta Pixel ID değerinizi girin.
4. Tarayıcı takibine ek olarak sunucu taraflı Conversions API (CAPI) gönderimini açmak için:
   • Conversions API Access Token (Erişim Anahtarı) bilginizi yapıştırın (sunucuda şifrelenmiş olarak saklanır; mağaza ön yüzü JavaScript koduna hiçbir zaman açılmaz).
   • Meta Olay Yöneticisi’ndeki Olayları Test Et (Test Events) sekmesinde doğrulama yaparken isteğe bağlı Test Event Code (örneğin TEST12345) alanını doldurun.
5. Gönderilecek huni olaylarını (InitiateCheckout form açılışında, AddPaymentInfo form gönderiminde ve Purchase doğrulanmış COD siparişi oluşturulduğunda) seçip Save butonuna tıklayın.

1. Settings → Pixels (/app/settings/pixels) ekranında Add Pixel butonuna tıklayın ve TikTok seçeneğini seçin.
2. TikTok Pixel ID değerinizi girin.
3. Sunucu taraflı olay iletimi için isteğe bağlı TikTok Events API 2.0 Access Token ve Test Event Code alanlarını doldurun.
4. SaveBar üzerinden Save butonuna tıklayın.

1. Alıcı COD formunu açtığında, bilgilerini gönderdiğinde veya siparişi tamamladığında uygulama ilgili işlem için deterministik bir event_id üretir.
2. Tarayıcı Yolu: Mağaza ön yüzü, yerel Shopify Web Pixel uzantısı tarafından dinlenen özel analitik olaylarını (cod:form_open, cod:form_submit, cod:order_created) yayınlar ve pazarlama izni verildiğinde bu olaylar event_id ile birlikte Meta/TikTok’a iletilir.
3. Sunucu Yolu: Sunucuda orderCreate veya draftOrderCreate başarıyla tamamlandığında, sunucu CAPI dağıtıcısı alıcı bilgilerini (telefon, e-posta, ülke, izin dahilinde IP/kullanıcı aracısı) normalize edip SHA-256 ile özetleyerek (hash) birebir aynı event_id ile Meta Graph API ve TikTok Events API 2.0 servislerine Purchase olayını gönderir.
4. Meta ve TikTok aynı event_id değerine sahip tarayıcı ve sunucu olaylarını otomatik olarak tekilleştirir (çift sayımı önler).

• Müşteri Gizliliği ve Çerez İzinleri: Hem Shopify Web Pixel uzantısı hem sunucu taraflı göndericiler Shopify Customer Privacy izin sinyallerine uyar. Alıcı pazarlama/analitik takibini reddettiğinde piksel gönderimi durdurulur.

• Purchase olayı Sunucu CAPI’de görünüyor ancak Tarayıcı Pikselinde görünmüyor: Müşteri reklam engelleyici (ad blocker) kullanıyor olabilir veya sipariş onaylanır onaylanmaz sekmeyi kapatmış olabilir. Sunucu taraflı CAPI tam olarak bu kayıpları telafi etmek için çalışır.
• Meta Olay Yöneticisi’nde çift Purchase görünüyor: Özel teşekkür sayfasında farklı bir event_id ile ikinci bir Purchase olayı tetikleyen başka bir üçüncü taraf piksel uygulaması veya manuel tema kodu olmadığından emin olun.

• GA4, Google Ads ve Pinterest Tag
• Veri Gizliliği ve GDPR
• Sipariş Oluşturma Modları ve Google E-Tablolar Aktarımı