GTM Köprüsü & GA4 Olay Köprüsü

Çift yönlü dataLayer eşitlemesi ve GA4 uyumlu API'lerle nicel Google Analytics 4 telemetrisini nitel MousePlayer oturum oynatmalarıyla birleştirir.

1. Mimariye Genel Bakış & Yetenekler

Modern web analizi genellikle temel bir veri yalıtımı sorunuyla karşılaşır: Google Analytics 4 gibi nicel platformlar web sitesinde ne olduğunu bildirirken nitel oturum oynatma araçları bunun neden olduğunu açıklar. MousePlayer GTM & GA4 Köprüsü tarayıcının JavaScript çalışma ortamında çift yönlü eşitleme kanalı kurarak bu boşluğu kaldırır.

Etkinleştirildiğinde takip betiği iki özel çekirdek modülü başlatır:

  • Oturum Oynatma Aktarıcısı (initGa4SessionBridge): Oturum kurulur kurulmaz etkin kayıt oturumunun kimliğini (mp_session_id) ve doğrudan oynatma URL'sini (mp_session_url) web sitesinin veri katmanına otomatik gönderir.
  • GA4 Olay Alıcısı (initDataLayerBridge): Veri katmanı dizisine mevcut yapıyı bozmayan dinleyici ekler. GA4 için gönderilen her özel e-ticaret veya davranış olayı, tüm sayısal ve metin parametreleriyle MousePlayer analiz veritabanına özel olay olarak (ce) anında yansıtılır.

Özel dataLayer Nesnesi Desteği: Web uygulaması standart dataLayer yerine özelleştirilmiş JavaScript dizi adı (örneğin xyzDataLayer) kullanıyorsa motor, yapılandırılmış gtm_datalayer_name parametresine elle kod değişikliği gerektirmeden dinamik uyum sağlar.

2. Stratejik İş Değeri

Oturum oynatma bağlantılarını doğrudan kurumsal analiz hatlarına bağlamak önemli operasyonel avantajlar sağlar:

İş Yeteneği Operasyonel Etki
Dönüşüm Oranı Optimizasyonu (CRO) Dijital analistlerin GA4 dönüşüm hunilerindeki sürtünme noktalarını bulup belirli ödeme adımlarında sepeti terk eden kullanıcıların kayıtlarını hemen açmasını sağlar.
Gelir İlişkilendirme & Denetimi Yüksek değerli e-ticaret işlemleri, satın almaya götüren tam işaretçi yolları, tıklamalar ve görünüm alanı durumları incelenerek denetlenebilir.
Hızlandırılmış Teknik Hata Ayıklama Kalite mühendisliği ekipleri GA4 JavaScript istisnalarını veya API hata günlüklerini görsel ekran kayıtlarıyla doğrudan ilişkilendirerek hatayı elle yeniden üretme ihtiyacını kaldırabilir.
Müşteri Desteğinde Çözüm Kullanıcı oturum kimliği içeren destek kayıtları, temsilcilerin müşterinin tam oturum oynatmasını incelemesini ve çözüm süresini büyük ölçüde azaltmasını sağlar.

3. Google Tag Manager Yapılandırma Kılavuzu

Oynatma URL'sini Google Tag Manager içinde yakalayıp Google Analytics 4'e yönlendirmek için üç ayrı GTM öğesi yapılandırılmalıdır:

Adım 1: Veri Katmanı Değişkenleri Oluşturun

GTM çalışma alanında Değişkenler → Kullanıcı Tanımlı Değişkenler bölümüne gidip şu türde iki değişken oluşturun: Veri Katmanı Değişkeni:

  • Değişken Adı: dlv - mp_session_id • Veri Katmanı Değişkeni Adı: mp_session_id
  • Değişken Adı: dlv - mp_session_url • Veri Katmanı Değişkeni Adı: mp_session_url

Adım 2: Etkinleştirme Tetikleyicisi Oluşturun

Şu bölüme gidin: Tetikleyiciler → Yeni ve tetikleyici türü olarak Özel Olay seçin. Şu parametreleri yapılandırın:

  • Olay Adı: mp_session_ready
  • Bu tetikleyici şu durumlarda çalışır: Tüm Özel Olaylar

Adım 3: GA4 Olay Etiketini Yapılandırın

Türü Google Analytics: GA4 Olayı olan yeni etiket oluşturun ve oturum bağlantısını GA4 mülküne iletin:

# GA4 Event Tag Configuration Tag Type: Google Analytics: GA4 Event Configuration Tag: [Select standard GA4 Configuration Tag] Event Name: mp_recording_ready # Event Parameters: | Parameter Name | Value | |-----------------|---------------------------| | mp_session_id | {{dlv - mp_session_id}} | | mp_session_url | {{dlv - mp_session_url}} | Triggering: Fire on Custom Event -> mp_session_ready

4. GA4'te Keşifleri (Özel Raporları) Yapılandırma

GTM etiketi yayımlandığında GA4, oynatma URL'sini olay parametresi olarak almaya başlar. Bu veriyi özel keşif raporlarında analiz etmek için önce parametreyi Özel Boyut olarak kaydetmelisiniz.

GA4 Yönetici Alanında Özel Boyut Kaydı

Google Analytics 4 arayüzünde Yönetici → Veri gösterimi → Özel tanımlar bölümüne gidip Özel boyut oluştur seçeneğine tıklayın:

  • Boyut adı: MousePlayer Session URL
  • Kapsam: Olay (veya oturum kapsamlı parametrelere ekleniyorsa Oturum )
  • Olay parametresi: mp_session_url

Oturum İnceleme Keşfi Oluşturma

GA4'ün Keşfet bölümünde, tekil kullanıcı yolculuklarını incelemek için yeni bir Serbest biçimli keşif oluşturun:

  • Satırlar: Şu alanları ekleyin: Event name, Transaction ID (e-ticaret için) veya Landing page.
  • Sütunlar / Boyutlar: Yeni oluşturulan şu özel boyutu ekleyin: MousePlayer Session URL.
  • Değerler: Şunu ekleyin: Event count veya Total users.

Oluşan rapor tablosu, GA4 metriklerinin yanında doğrudan tıklanabilir URL'ler gösterir; istatistiksel aykırılıklardan görsel oynatmalara anında geçebilirsiniz.

5. Oynatma URL'lerini GA4 Varsayılan Raporlarına Ekleme

Keşiflerin yanı sıra özel boyutlar, GA4 Rapor Kitaplığı kullanılarak şu standart varsayılan raporlara da eklenebilir: Trafik edinme, Sayfalar ve ekranlar veya E-ticaret satın alımları.

Standart Rapor Tablolarını Değiştirme

  1. GA4'te herhangi bir varsayılan ayrıntılı raporu açın (örneğin Raporlar → Etkileşim → Sayfalar ve ekranlar).
  2. Sağ üst köşedeki Raporu özelleştir kalem simgesine tıklayın (yönetici erişimi gerekir).
  3. Sağ panelde Rapor Verileri altında Boyutlar seçeneğine tıklayın.
  4. Şu boyutu MousePlayer Session URL birincil veya ikincil boyut listesine ekleyip görünür yapın.
  5. Şuna tıklayın: Kaydet → Geçerli rapordaki değişiklikleri kaydet.

Kaydedildikten sonra standart edinme veya dönüşüm tablolarını inceleyen analistler, MousePlayer Session URL boyutunu ikincil boyut olarak ekleyip standart trafik segmentlerinde ziyaretçi davranışını anında görsel inceleyebilir.

6. JavaScript API & GA4 / GTM Uyumluluk Başvurusu

MousePlayer, standart gtag() tarzı komutlar kullanan sezgisel GA4 uyumlu JavaScript API'si ve herkese açık genel nesne (window.MousePlayer) sunar. Geliştiriciler konsolda oturum URL'lerini sorgulayabilir, B2B müşteri kimliği ekleyebilir ve oynatma bağlantılarını üçüncü taraf yardım masalarına veya hata takip araçlarına yerleştirebilir.

1. Doğrudan Oynatma URL'si Ekleme (Intercom / Zendesk / Özel Köprüler)

Etkin ziyaretçi oturumunun tam oynatma URL'sini tarayıcı konsolundan veya özel betikten şu yöntemle doğrudan alabilirsiniz: window.MousePlayer.getSessionUrl().

// Example: Retrieve the active session URL and attach it to Intercom chat metadata if (window.MousePlayer && window.MousePlayer.getSessionUrl) { var replayUrl = window.MousePlayer.getSessionUrl(); console.log('Active Replay:', replayUrl); // Attach to Intercom Messenger metadata if (window.Intercom) { Intercom('update', { 'mouseplayer_replay_url': replayUrl }); } }

2. Özel B2B Müşteri Kimliği Ayarlama (user_id)

Giriş yapan SaaS veya B2B müşterilerini tanımak için özel user_id değerini (veritabanı kimliği, e-posta veya UUID gibi) başlangıç betik yapılandırmasında veya çalışma anında GA4 sözdizimiyle iletebilirsiniz:

// Method A: Set user_id dynamically at login (GA4 / gtag style) mp('set', 'user_id', 'USR-987654'); // Method B: Set via config object mp('config', 'YOUR_CHANNEL_ID', { user_id: 'USR-987654' }); // Method C: Direct SDK invocation window.MousePlayer.setUserId('USR-987654');

3. Eşzamansız Veri Alma Yöntemleri

Özel etiket yönetimi betiklerinde oturum üstverisini eşzamansız almak için standart GA4 geri çağırım sözdizimini kullanabilirsiniz:

// Retrieve active session URL mp('get', 'session_url', function(url) { console.log('Session URL:', url); }); // Retrieve visitor ID (Client ID equivalent) mp('get', 'client_id', function(clientId) { console.log('Visitor ID:', clientId); });

Burada adı geçen tüm ticari markalar ilgili sahiplerine aittir. MousePlayer'ın bu sağlayıcılarla ticari ilişkisi yoktur.