Zonos eski iframe Checkout ile Google Analytics 4'ü nasıl kurarım?

Checkout iframe'ini barındıran sayfanıza standart GA4 gtag.js parçacığını ekleyin, ardından Zonos analyticsRelayOnInit.js komut dosyasını ekleyin. Geçiş komut dosyası çapraz iframe iletişimini otomatik olarak işler ve ödeme etkinliklerini GA4 özelliğinize iletir.

Zonos Checkout hangi GA4 etkinliklerini izler?

Zonos Checkout, 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 ve işlem ayrıntılarına sahip standart GA4 satın alma etkinliği dahil olmak üzere tam ödeme hattını izler.

GA4 izlemesi için createTempCart API çağrımı değiştirmem gerekir mi?

Hayır. Geçiş sistemi createTempCart API'den bağımsız olarak çalışır. Sayfanıza GA4 etiketini ve Zonos geçiş komut dosyasını eklemeniz yeterlidir.

Checkout•

Ana sayfaAPI referansı Checkout REST API Google Analytics 4

iframe Checkout için Google Analytics 4

Q: Zonos Checkout'dan GA4 etkinliklerinin hata ayıklaması nasıl yapılır?

Sayfa URL'inize zonosDebug=true 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. Etkinlikleri gerçek zamanlı olarak doğrulamak için Google Analytics'te GA4 DebugView'ı da kullanabilirsiniz.

iframe tabanlı eski Checkout entegrasyonunu kullanırken GA4 ile tam ödeme hattını izleyin.

Eski Checkout entegrasyonunu kullanan (iframe iglobalstores.com üzerinde barındırılan) tüccarlar artık tam ödeme hattı boyunca GA4 analitik etkinliklerini izleyebilir. Zonos Checkout, hafif bir geçiş komut dosyası kullanarak iframe'den analitik etkinliklerini üst sayfaya otomatik olarak aktarır, böylece etkinlikler GA4 özelliğinizde kendi sitenizden kaynaklanmış gibi görünür.

Yerel entegrasyonlar bu kılavuza ihtiyaç duymaz. Eğer <zonos-checkout> doğrudan sitenizde (iframe olmadan) görüntülenirse, Zonos sayfanızın window.gtag işlevini doğrudan çağırır — Zonos panosunda Checkout ayarları → İzleme altında Google Analytics'i etkinleştirmeniz ve sayfanızda normal GA4 temel etiketinizin yüklendiğinden emin olmanız yeterlidir. Aşağıdaki geçiş kurulumu, Checkout'un farklı bir kaynakta iframe'de barındırıldığında gereklidir.

Meta Ads dönüşümlerini izlemek için mi arıyorsunuz? Facebook Pixel kılavuzuna bakın — aynı geçiş komut dosyasını kullanır ve GA4 ile birlikte çalışabilir.

Nasıl çalışır

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

Checkout üst öğeyi pingler -- Checkout iframe içinde yüklendiğinde, etkinlikleri geçirmeye hazır olduğunu belirten bir mesajı üst pencereye gönderir.
Üst öğe onaylar -- Sayfanızdaki geçiş komut dosyası, pingi alır, mevcut GA4 yapılandırmanızı algılar ve etkinlik almaya hazır olduğunu belirten sinyal gönderir.
Etkinlikler iletilir -- Alışveriş yapanlar ödeme hattında ilerledikçe, her analitik etkinlik postMessage aracılığıyla sayfanıza gönderilir; burada geçiş komut dosyası bunu gtag'a iletir.

Tüm mesajlar, yalnızca HTTPS üzerinde güvenilir Zonos kaynaklarına (zonos.com ve iglobalstores.com) karşı doğrulanır.

Ön koşullar

Ölçüm kimliği (format: G-XXXXXXXXXX) olan bir GA4 özelliği. Google Analytics'de bir tane oluşturabilirsiniz.
Sayfanızda iframe'de Zonos Checkout yükleyen eski Checkout entegrasyonu.

Kurulum

Adım 1: GA4 etiketini sayfanıza ekleyin

Sitenizde GA4 yüklü değilse, Checkout iframe'ini barındıran sayfanın <head> bölümüne standart Google Analytics 4 etiketini ekleyin. G-XXXXXXXXXX yerine kendi ölçüm kimliğinizi yazın.

1

3<script

4 async

5 src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"

6></script>

8<script>

9 window.dataLayer = window.dataLayer || [];

10 function gtag() {

11 dataLayer.push(arguments);

12 }

13 gtag('js', new Date());

14 gtag('config', 'G-XXXXXXXXXX');

15</script>

Not: Sitenizde GA4 etiketi zaten yüklüyse (ör. Google Tag Manager aracılığıyla veya doğrudan bir parçacık), bu adımı atlayabilirsiniz. Geçiş komut dosyası mevcut gtag işlevinizi kullanacaktır.

Bu parçacığı GA4 özelliğinizde Admin -> Veri Akışları -> akışınızı seçin -> Etiket talimatlarını görüntüleyin -> Manuel olarak yükleyin altında bulabilirsiniz.

Adım 2: Ölçüm kimliğinizi Zonos Checkout'a iletin

Zonos Checkout'a hangi GA4 ölçüm kimliğini kullanacağını söyleyin ve window.Zonos.googleAnalyticId öğesini Checkout'unuzun customHTML içinde ayarlayın. Zonos panosu, Checkout ayarları altında bir customHTML editörü gösterir -- bunun gibi bir <script> etiketi ekleyin:

1<script>

2 window.Zonos.googleAnalyticId = 'G-XXXXXXXXXX';

3</script>

Bu değer, geçiş el sıkışması sırasında üst öğeye gönderilir. Üst sayfanızda gtag zaten yüklü değilse, geçiş komut dosyası bu kimliği kullanarak GA4 temel etiketini sizin için enjekte edecektir.

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

GA4 etiketinden sonra aynı sayfaya aşağıdaki komut dosyası etiketini ekleyin. Bu komut dosyası, Zonos Checkout iframe'den analitik etkinliklerini dinler ve bunları gtag'a iletir.

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 şu şekilde görünür:

1<head>

2 

4 

6 <script

7 async

8 src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"

9 ></script>

11 <script>

12 window.dataLayer = window.dataLayer || [];

13 function gtag() {

14 dataLayer.push(arguments);

15 }

16 gtag('js', new Date());

17 gtag('config', 'G-XXXXXXXXXX');

18 </script>

20 

22 <script

23 async

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

25 ></script>

26</head>

Hepsi bu. Her iki komut dosyası sayfanızda olduğunda, geçiş komut dosyası iframe ödeme hattı ile el sıkışmayı otomatik olarak tamamlar ve tüm ödeme hattı etkinliklerini GA4 özelliğinize iletir.

GA4 etkinlikleri referans

Zonos Checkout geçiş aracılığıyla aşağıdaki etkinlikleri yayar. Tüm etkinlikler bir isTestMode bayrağı ve checkoutSessionId içerir.

Etkinlik↕	Tetikleyici↕	Ek meta veri↕
`zonos-checkout-start`	Checkout açılır	--
`zonos-checkout-customer-info`	Alışveriş yapan müşteri bilgilerini girer	--
`zonos-checkout-shipping-info`	Alışveriş yapan kargo yöntemini seçer	`serviceLevelId`
`zonos-checkout-payment-info`	Alışveriş yapan ödeme detaylarını girer	`paymentMethod`
`zonos-checkout-payment-fail`	Ödeme denemesi başarısız olur	--
`zonos-checkout-success`	Sipariş başarıyla tamamlanır	`transaction_id`, `currency`, `value`, `items`
`zonos-checkout-close`	Alışveriş yapan ödeme hattını kapatır	--
`purchase`	Sipariş tamamlandı (GA4 standart e-ticaret etkinliği)	`transaction_id`, `currency`, `value`, `items`

Satın alma etkinliği meta verileri

purchase etkinliği, GA4 e-ticaret purchase etkinliği şemasını izler:

Alan↕	Açıklama↕
`transaction_id`	Zonos sipariş kimliği veya ödeme oturumu kimliği
`currency`	Üç harfli para birimi kodu (ör. `USD`)
`value`	Toplam sipariş değeri
`items`	Sepet öğeleri dizisi; her biri `item_id`, `item_name`, `price` ve `quantity` ile

Hata ayıklama

Geçiş komut dosyası için hata ayıklama günlüğünü etkinleştirmek üzere, sayfa URL'inize 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ğıdakileri doğrulamak için kullanışlıdır:

Geçiş komut dosyası, ödeme iframe'den ping alır.
GA4, doğru ölçüm kimliği ile yapılandırılır.
Etkinlikler gtag'a iletilir.

Sık sorulan sorular

`createTempCart` API çağrımı değiştirmem gerekir mi?

Hayır. Geçiş sistemi createTempCart API'den bağımsız olarak çalışır. Sayfanıza GA4 etiketini ve geçiş komut dosyasını eklemeniz yeterlidir.

Zaten Google Analytics için `footerHTML` kullanıyorsam ne olur?

createTempCart API'deki footerHTML parametresi, komut dosyalarını ödeme iframe'ne enjekte eder; bu, iframe kaynağı içinde sayfa düzeyinde etkinlikleri izlemekle sınırlıdır. Geçiş yaklaşımı önerilir çünkü etkinlikleri kendi alan adınızda kendi GA4 özelliğinize gönderir ve size tek bir özellikte tam huni görünürlüğü verir.

footerHTML'dan GA4 komut dosyalarını geçişi ayarladıktan sonra güvenli bir şekilde kaldırabilirsiniz.

Bu, Google Analytics'te GA4 hata ayıklama modu ile çalışır mı?

Evet. Tarayıcınızın geliştirici konsolunda geçiş komut dosyası günlüklerini etkinleştirmek için zonosDebug=1 kullanabilir ve etkinlikleri gerçek zamanlı olarak doğrulamak için Google Analytics'te GA4 DebugView kullanabilirsiniz.

Test siparişleri izlenir mi?

Tüm etkinlikler bir isTestMode alanı içerir. Checkout test modundayken, etkinlikler yine de GA4'e gönderilir ancak isTestMode: true ile işaretlenir. Gerekirse özel boyutlar kullanarak GA4'te bunları filtreleyebilirsiniz.

Demo rezervasyonu yap