Zonos eski iframe Checkout ile Facebook Pixel'i nasıl ayarlarım?

Checkout iframe'ini barındıran sayfanıza standart Meta Pixel temel kodunu ekleyin, Checkout customHTML'de window.Zonos.facebookPixelId öğesini ayarlayın, Zonos panosunda Facebook Pixel'i etkinleştirin ve Zonos analyticsRelayOnInit.js komut dosyasını ekleyin. Geçiş komut dosyası otomatik olarak iframe arası iletişimi yönetir ve checkout etkinliklerini Meta'ya iletir.

Zonos Checkout hangi Facebook Pixel etkinliklerini izler?

Checkout hunisinin her adımı için Zonos hem özel bir etkinliği (zonos-checkout-start, zonos-checkout-customer-info, zonos-checkout-shipping-info, zonos-checkout-payment-info, zonos-checkout-payment-fail, zonos-checkout-success, zonos-checkout-close) hem de eşleşen Meta standart etkinliğini harekete geçirir (varsa): checkout başlangıcı için InitiateCheckout, ödeme bilgisi için AddPaymentInfo ve sipariş tamamlanması için Purchase.

Google Analytics ve Facebook Pixel'i aynı anda çalıştırabilir miyim?

Evet. Aynı analyticsRelayOnInit.js komut dosyası her iki sağlayıcıyı da tek bir el sıkışmada yönetir. Her iki temel etiketi sayfanıza ekleyin, customHTML'de window.Zonos.googleAnalyticId ve window.Zonos.facebookPixelId öğelerini ayarlayın ve Zonos panosunda her iki sağlayıcıyı da etkinleştirin.

Checkout•

Ana sayfaAPI referansı Checkout REST API Facebook Pixel

iframe Checkout için Facebook Pixel

Q: Zonos Checkout'tan Facebook Pixel etkinliklerinde hata ayıklamayı nasıl yaparım?

Sayfa URL'nize zonosDebug=1 sorgu parametresini ekleyin ve geçiş el sıkışması ve iletilen etkinliklerin ayrıntılı günlüklerini görmek için tarayıcınızın geliştirici konsolunu açın. Meta Pixel Helper Chrome uzantısı gerçek zamanlı olarak Pixel çağrılarını incelemek için de faydalıdır.

Meta (Facebook) Pixel ile iframe tabanlı eski Checkout entegrasyonu kullanırken tüm checkout hunisini izleyin.

Eski Checkout entegrasyonunu (iframe iglobalstores.com'da barındırılıyor) kullanan satıcılar, tüm checkout hunisinde Meta Pixel etkinliklerini izleyebilir. Zonos Checkout, Google Analytics 4 için kullanılan aynı hafif geçiş komut dosyasını kullanarak iframe'den analitik etkinliklerini üst sayfaya aktarır, böylece etkinlikler Meta Events Manager'da kendi sitenizden kaynaklanmış gibi görünür.

Checkout hunisinin her adımı için iki etkinlik yayınlanır:

zonos-checkout-... adında özel bir etkinlik (fbq('trackCustom', ...) aracılığıyla) huninin tamamını kapsayan özel kitleler için.
Eşleşen Meta standart etkinliği (fbq('track', ...) aracılığıyla) yerleşik optimizasyon için, örn. InitiateCheckout, AddPaymentInfo ve Purchase.

Yerel entegrasyonlar bu rehbere ihtiyaç duymaz. <zonos-checkout> doğrudan sitenizde işlenerek (iframe yok) Zonos sayfanızın window.fbq öğesini çağırırsa, Zonos panosundaki Checkout ayarları → İzleme altında Facebook Pixel'i etkinleştirin ve olağan Meta Pixel temel kodunun sayfaya yüklü olduğundan emin olun. Aşağıdaki geçiş kurulumu yalnızca Checkout farklı bir kaynakta iframe'de barındırıldığında gereklidir.

Nasıl çalışır

Zonos Checkout, farklı bir kaynakta iframe içinde çalıştığı için, sayfanızın fbq işlevine doğrudan erişemez. Geçiş sistemi bunu iki aşamalı bir el sıkışma (adımlar 1-2) ile ve ardından etkinlik yönlendirmesi (adım 3) ile çözer:

Checkout üst sayfaya ping gönderir -- Checkout iframe içinde yüklendiğinde, etkinlikleri aktarmaya hazır olduğunu ve Pixel ID'sini içeren bir mesajı üst pencereye gönderir.
Üst sayfa onaylar -- Sayfanızda geçiş komut dosyası ping'i alır, Meta Pixel temel kodunuzu algılar (veya enjekte eder) ve etkinlik almaya hazır olduğunu işaret eder.
Etkinlikler iletilir -- Alışveriş yapanlar checkout'ta ilerledikçe, her analitik etkinlik postMessage aracılığıyla sayfanıza gönderilir; burada geçiş komut dosyası bunu uygun track / trackCustom modu ile fbq'ye iletir.

Tüm mesajlar, HTTPS üzerinden güvenilir Zonos kaynakları (zonos.com ve iglobalstores.com) için doğrulanır.

Ön koşullar

Meta Pixel ve bir Pixel ID'si (sayısal bir dize, genellikle 15-16 hane). Bunları Meta Events Manager'da oluşturabilirsiniz.
Sayfanıza iframe'de Zonos Checkout'u yükleyen bir eski Checkout entegrasyonu.
Zonos Checkout ayarlarında (Zonos panosunda, Checkout ayarları -> İzleme) etkinleştirilmiş Facebook Pixel.

Kurulum

Adım 1: Meta Pixel temel kodunu sayfanıza ekleyin

Meta Pixel'i sitenize yüklemediyseniz, standart Pixel temel kodunu Checkout iframe'ini barındıran sayfanın <head> bölümüne ekleyin. YOUR_PIXEL_ID yerine kendi sayısal Pixel ID'nizi yazın.

1

3<script>

4 !(function (f, b, e, v, n, t, s) {

5 if (f.fbq) return;

6 n = f.fbq = function () {

7 n.callMethod ? n.callMethod.apply(n, arguments) : n.queue.push(arguments);

8 };

9 if (!f._fbq) f._fbq = n;

10 n.push = n;

11 n.loaded = !0;

12 n.version = '2.0';

13 n.queue = [];

14 t = b.createElement(e);

15 t.async = !0;

16 t.src = v;

17 s = b.getElementsByTagName(e)[0];

18 s.parentNode.insertBefore(t, s);

19 })(

20 window,

21 document,

22 'script',

23 'https://connect.facebook.net/en_US/fbevents.js',

24 );

25 fbq('init', 'YOUR_PIXEL_ID');

26 fbq('track', 'PageView');

27</script>

Not: Sitenizde zaten Meta Pixel kuruluysa (örn., Google Tag Manager, Shopify'ın yerel entegrasyonu veya doğrudan bir kod parçacığı aracılığıyla), bu adımı atlayabilirsiniz. Geçiş komut dosyası mevcut fbq işlevinizi kullanacaktır.

Bu kod parçacığını Meta Events Manager'da Pixel Ayarları -> Pixel Kurulumuna Devam Et -> Kodu Manuel Olarak Yükleyin altında bulabilirsiniz.

Adım 2: Pixel ID'nizi Zonos Checkout'a aktarın

Zonos Checkout'a window.Zonos.facebookPixelId'yi Checkout'unuzun customHTML içinde ayarlayarak hangi Pixel ID'sini kullanacağını söyleyin. Zonos panosu, Checkout ayarları altında bir customHTML editörünü ortaya çıkarır -- böyle bir <script> etiketi ekleyin:

1<script>

2 window.Zonos.facebookPixelId = 'YOUR_PIXEL_ID';

3</script>

Bu değer, geçiş el sıkışması sırasında üst sayfaya gönderilir. Üst sayfanızda zaten fbq yüklü değilse, geçiş komut dosyası, sağladığınız ID'yi kullanarak Meta Pixel temel kodunu sizin için enjekte edecektir.

Adım 3: Zonos analitik geçiş komut dosyasını ekleyin

Aşağıdaki komut dosyası etiketini, Checkout iframe'ini yükleyen sayfaya Meta Pixel temel kodundan sonra ekleyin. Bu, Google Analytics 4 için kullanılan aynı komut dosyasıdır -- tek bir geçiş her iki sağlayıcıyı da yönetir, bu nedenle GA4 için zaten eklediyseniz, bu adımı atlayın.

1<script

2 async

3 src="https://cdn.jsdelivr.net/npm/@zonos/elements/dist/scripts/analyticsRelayOnInit.js"

4></script>

Tam örnek

Sayfanızın <head> bölümündeki tam kurulum şöyle görünür:

1<head>

2 

4 

6 <script>

7 !(function (f, b, e, v, n, t, s) {

8 if (f.fbq) return;

9 n = f.fbq = function () {

10 n.callMethod

11 ? n.callMethod.apply(n, arguments)

12 : n.queue.push(arguments);

13 };

14 if (!f._fbq) f._fbq = n;

15 n.push = n;

16 n.loaded = !0;

17 n.version = '2.0';

18 n.queue = [];

19 t = b.createElement(e);

20 t.async = !0;

21 t.src = v;

22 s = b.getElementsByTagName(e)[0];

23 s.parentNode.insertBefore(t, s);

24 })(

25 window,

26 document,

27 'script',

28 'https://connect.facebook.net/en_US/fbevents.js',

29 );

30 fbq('init', 'YOUR_PIXEL_ID');

31 fbq('track', 'PageView');

32 </script>

34 

36 <script

37 async

38 src="https://cdn.jsdelivr.net/npm/@zonos/elements/dist/scripts/analyticsRelayOnInit.js"

39 ></script>

40</head>

Hepsi bu kadar. Her iki komut dosyası sayfanızda olduktan, Facebook Pixel Zonos panosunda etkinleştirildikten ve customHTML Pixel ID'sini ayarladıktan sonra, geçiş otomatik olarak checkout hunisindeki tüm etkinlikleri Meta'ya iletir.

Meta Pixel etkinlikleri referansı

Huninin her adımında Zonos Checkout hem özel bir etkinliği (böylece hassas kitleler oluşturabilirsiniz) hem de eşleşen Meta standart etkinliğini (böylece Meta'nın optimizasyonu ve dönüşüm raporlamasında görünür) harekete geçirir. Tüm etkinlikler bir isTestMode bayrağı ve checkoutSessionId içerir.

Tetikleyici↕	Özel etkinlik (`fbq('trackCustom', ...)`)↕	Standart etkinlik (`fbq('track', ...)`)↕	Ek meta veriler↕
Checkout açılır	`zonos-checkout-start`	`InitiateCheckout`	--
Alışveriş yapan müşteri bilgisini girer	`zonos-checkout-customer-info`	yok	--
Alışveriş yapan bir kargo yöntemi seçer	`zonos-checkout-shipping-info`	yok	`serviceLevelId`
Alışveriş yapan ödeme ayrıntılarını girer	`zonos-checkout-payment-info`	`AddPaymentInfo`	`paymentMethod`
Ödeme denemesi başarısız olur	`zonos-checkout-payment-fail`	yok	--
Sipariş başarıyla tamamlanır	`zonos-checkout-success`	yok	`order_id`, `currency`, `value`, `contents`, `content_ids`
Sipariş tamamlanır (e-ticaret etkinliği)	`purchase`	`Purchase`	`order_id`, `currency`, `value`, `contents`, `content_ids`
Alışveriş yapan checkout'u kapatır	`zonos-checkout-close`	yok	--

Meta standart eşdeğeri olmayan adımlar (örn. müşteri bilgisi, kargo bilgisi) yalnızca özel zonos-checkout-... etkinliğini harekete geçirir. Bunları Meta Ads Manager'da "Etkinlik = zonos-checkout-customer-info" kullanarak özel kitleler aracılığıyla hedefleyebilirsiniz.

Satın alma etkinliği meta verileri

Purchase standart etkinliği, Meta Pixel Purchase etkinliği şemasını izler. Sepet ürünleri GA tarzı items dizisinden Meta'nın contents dizisine eşlenir:

Alan↕	Açıklama↕
`value`	Toplam sipariş değeri
`currency`	Üç harfli para birimi kodu (örn. `USD`)
`order_id`	Zonos sipariş ID'si veya checkout oturum ID'si
`contents`	Sepet ürünleri dizisi, her biri `id`, `quantity` ve `item_price` ile
`content_ids`	Ürün ID'leri dizisi (SKU, ürün ID'si veya ürün adı geri dönüşü)
`content_type`	Her zaman `"product"`
`num_items`	Tüm ürünler arasında toplam miktar

Hata ayıklama

Geçiş komut dosyası için hata ayıklama günlüğünü etkinleştirmek için, sayfa URL'nize zonosDebug=1 sorgu parametresini ekleyin:

1https://www.yourstore.com/checkout?zonosDebug=1

Geçiş el sıkışması ve iletilen etkinliklerin ayrıntılı günlüklerini görmek için tarayıcınızın geliştirici konsolunu açın. Bu, aşağıdakiları doğrulamak için kullanışlıdır:

Geçiş komut dosyası, checkout iframe'den ping alır.
Meta Pixel doğru Pixel ID'si ile yapılandırılmıştır.
Etkinlikler, beklenen track / trackCustom modu ile fbq'ye iletilir.

Meta Pixel Helper Chrome uzantısı da gerçek zamanlı olarak Pixel çağrılarını incelemek için yardımcıdır.

Sık sorulan sorular

Aynı adım için neden iki etkinlik harekete geçirilir (örn. `zonos-checkout-start` ve `InitiateCheckout`)?

Meta'nın standart etkinlikleri dönüşüm optimizasyonu, reklam raporlaması ve benzer kitleler kutusundan çıkılmış olarak güçlendirir. Özel zonos-checkout-... etkinlikleri daha granüler özel kitleler oluşturmanıza izin verir - Meta standart eşdeğeri olmayan huni adımlarında da (örn. müşteri bilgisi, kargo bilgisi). Her ikisini de harekete geçirmek, hiçbir sinyal kaybetmeden her iki dünyanın da en iyisini verir.

Hem Google Analytics hem de Facebook Pixel çalıştırıyorsam ne olur?

İki geçiş komut dosyasına ihtiyacınız yok -- aynı analyticsRelayOnInit.js her iki sağlayıcıyı da tek bir el sıkışmada yönetir. GA4 temel etiketini ve Meta Pixel temel kodunu <head>'e ekleyin, customHTML'de window.Zonos.googleAnalyticId ve window.Zonos.facebookPixelId'yi ayarlayın ve Zonos panosunda her iki sağlayıcıyı da etkinleştirin. Her etkinlik, etkinleştirilen sağlayıcılara yayılır.

Üst sayfamda Meta Pixel yüklü değilse ne olur?

customHTML window.Zonos.facebookPixelId'yi ayarlarsa ve geçiş komut dosyası sayfada fbq olmadığını algılarsa, el sıkışması sırasında sağladığınız Pixel ID'sini kullanarak Meta Pixel temel kodunu sizin için enjekte edecektir. Checkout hunisinin dışında PageView ve diğer etkinlikleri harekete geçirmek istiyorsanız, Meta Pixel temel kodunu kendiniz önceden yükleyebilirsiniz.

Test siparişleri izlenir mi?

Tüm etkinlikler bir isTestMode alanı içerir. Checkout test modundayken, etkinlikler yine de Meta'ya aktarılır ancak isTestMode: true ile işaretlenir. Bunları Meta Ads Manager'da filtreleyebilir veya özel dönüşüm kuralları ile hariç tutabilirsiniz.

Conversions API (CAPI) bunu yerine alır mı?

Hayır -- bu, alışveriş yapanların tarayıcılarında çalışan tarayıcı tarafı Pixel entegrasyonudur. Meta Conversions API, bazı satıcıların yedeklilik amacıyla Pixel'in yanında kullandıkları ayrı bir sunucu-sunucu kanalıdır. İkisi tamamlayıcıdır ve Zonos'un geçişi yalnızca tarayıcı tarafı Pixel'i yönetir.

Demo rezervasyonu yap