Sunucu tarafı etiketlemeye giriş

Sunucu tarafı etiketleme, pek çok cihaz bulunur. Sunucu kapsayıcıları aynı etiketi, tetikleyiciyi ve bir arada kullanabileceğiniz yeni araçlar sunarken, kullanıcı etkinliğini nerede olursa olsun ölçmenizi sağlar.

Sunucu tarafı etiketleme içermeyen tipik bir etiketleme yapılandırması kapsayıcıya bir veri kümesi yükleyin. Şekil 1'de, bir Etiket Yöneticisi web kapsayıcısının web tarayıcısı birden çok sunucuya veri gönderir.

Google Etiket Yöneticisi web kapsayıcısı kullanmak için kullanılan bir sitenin şeması

Şekil 1: Google Etiket Yöneticisi web kapsayıcısının kullanıldığı bir site diyagramı.

Buna karşılık, bir sunucu kapsayıcısı, kullanıcının tarayıcısında veya telefon. Bunun yerine, sizin kontrol ettiğiniz bir sunucuda çalışır.

Sunucu tarafı etiketleme kapsayıcısının kullanıldığı bir sitenin şeması.

Şekil 2: Sunucu kapsayıcısı kullanan etiketleme yapılandırması örneği.

Sunucu, kendi Google Cloud Platform projenizde veya seçtiğiniz farklı bir ortamda çalışır ve başka bir yere göndermeyi seçene kadar sunucudaki verilere yalnızca siz erişebilirsiniz. Bakiyeniz verilerin şekillenme şekli ve nereden yönlendirileceği konusunda tam kontrol sahibi olmak sunucu. Etiketler, korumalı JavaScript teknolojisidir. İzinler, etiketin neler yapabileceğini görmenizi sağlar. Politikalar ise kapsayıcı etrafında sınırlar belirlemenize olanak tanır.

Sunucu, kullanıcının cihazından web isteklerini alır ve bunları dönüştürür etkinliklere dönüştürmeniz gerekir. Her etkinlik, kapsayıcının Etiketler, tetikleyiciler ve değişkenler. Sunucudaki etiketler, tetikleyiciler ve değişkenler container'ın işleyiş şekli, diğer kapsayıcı türlerinde olduğu gibidir: Tetikleyiciler belirli koşullara bakmak ve uygun olduğunda, etiketleri ile birlikte işlenecek etkinlik verilerini gönderen etiketlerdir.

Bu modelde sunucu container'ları için iki önemli soru ortaya çıkar:

  • Ölçüm verileri kullanıcının cihazından sunucu kapsayıcısına nasıl aktarılır?
  • Sunucu kapsayıcısına gönderilen ölçüm verileri nasıl etkinliğe dönüştürülür?

Her iki sorunun yanıtı da, sunucuda kullanılacak yeni bir varlık türüdür. container'lar: bir istemci.

Müşterilerin çalışma şekli

İstemciler, kullanıcının cihazında çalışan yazılım ile sunucu kapsayıcısı olur. İstemci bir cihazdan ölçüm verilerini alır, dönüşüm gerçekleştirir verileri bir veya daha fazla etkinliğe gönderir, ve sonuçları paketleyerek istek sahibine geri gönderir.

O kadar çok şey var ki! Şimdi her bir bölüme ayrı ayrı daha yakından bakalım. Şekil 3'te kullanıcının web sitesinden sunucu kapsayıcısına akan veriler gösterilmektedir web sunucunuzdan sunucu kapsayıcısına aktarmaktır.

Sunucu tarafı etiketleme kapsayıcısının kullanıldığı bir sitenin şeması.

Şekil 3: Her bir veri akışını farklı bir istemci işliyor.

Müşteriler, ölçüm verilerini bir cihazdan alır. Diyelim ki bir hafta içinde kullanıcı etkinliğini üç yerde ölçebilir: web sitesi, telefon uygulaması ve akıllı cihaz ekmek kızartma makinesi var. Web siteniz Google Analytics'i, telefon uygulamanız Firebase'i kullanıyor ve ekmek kızartma makineniz "ToastMeasure" adlı özel bir protokol kullanır.

Bu üç cihazı Google Etiket Yöneticisi ile kullanmak için normalde her platform için farklı bir kapsayıcı oluşturabilirsiniz. Sunucu kapsayıcısı çalışmadığından, aynı kapsayıcı, tüm cihazlar için analiz enstrümantasyonunu üç cihaz platformu var. Ama bir sorun var. Bu cihazların hepsi şekilde iletişim kurabileceğinizi unutmayın. Google Analytics protokolü protokolüyle uyumlu hale getirecek. İşte müşteriler burada devreye girer.

Bu üç kapsayıcının yerine sunucu kapsayıcınızda üç istemci bulunur. Kapsayıcıya gelen her istek, öncelik sırasına göre, en yüksek önceliğe sahip müşteri olur. Her müşterinin ilk olarak bu tür taleplerin nasıl işleme alınacağını bilip bilmediğine karar vermektir. Yapabiliyorsa müşterinin "hak talebinde bulunduğu" ve Sauce & Spoon tablet projesinin bir sonraki aşamasına işleniyor. İsteği talep etme eylemi, sonraki müşterilerin çalışıyor. İstemci isteği işleyemezse hiçbir şey yapmaz ve istek üzerine diğer müşterilere isteği işleme alıp almamaya karar verebilir.

İstemciler istek verilerini bir veya daha fazla etkinliğe dönüştürür. ToastMeasure istemcisi bir istek aldıktan sonra kapsayıcının anlayacağı bir şeye dönüştürmenizi sağlar. Bir şeyin bir dizi etkinlik içerir.

Etkinlikler, ölçmek istediğiniz şeylerdir. Bunlar herhangi bir şey olabilir: start_toasting, finish_toasting veya buy_bread. RACI matrisinde yapıyla ilgili önerileri etkinlikleri hakkında bilgi edindiniz. Ancak tek şart, anlayabilirsiniz.

Kapsayıcıyı istemciler çalıştırır. Müşteri isteği kabul etti ve isteği teslim etti nasıl dönüştürüleceğini göstereceğim. Şimdi sıra etiketlere, tetikleyicilere ve değişkenlere geldi. Müşteri her bir etkinliği daha fazla işlenmek üzere container'ın geri kalanına aktarır.

İstemciler, sonuçları cihaza geri göndermek üzere paketler. Bir container çalıştığında, ekmek kızartma makinesine yanıt verme zamanı gelmiş demektir. Yanıt biraz zaman alabilir pek çok farklı biçime sahip. Müşteri yalnızca "Tamam, bitti" diyor olabilir. Belki etiketlerden biri komutunu çalıştırın. Ya da etiketlerden biri ekmek kızartma makinesinin üzerindeki ışıklara renkleri değiştirmesini söyler. Sizin amacınız neyse sonuçları paketlemek ve geri göndermek müşterinin işidir sunar.

Etiket Yöneticisi, bu işlemlerin büyük kısmını sizin yerinize halleder. Sunucu container'ları dahil olmak üzere, Google Analytics 4 ve Google Analytics: Universal Analytics ve Measurement Protocol. İhtiyaç duyduğunuz araçları bu müşteriler sağlar uygulamanızı oluşturduktan sonra enstrümanlar kullanmaya başlamak için anlamına gelir.

Kısa bir örnek

Tüm parçaların nasıl bir araya geldiğini görmek için kısa bir örnek üzerinden gidelim. İçinde bu örnekte aşağıdakini oluşturacaksınız:

  1. Şuraya click etkinliği göndermek için gtag.js'yi kullanan basit bir web sitesi: sunucu kapsayıcısı olur.
  2. Etkinliği alan Google Analytics 4 istemcisi.
  3. click etkinliğinde tetiklenen bir tetikleyici.
  4. Aşağıdakiler için etkinlik verilerini Google Analytics'e gönderen bir Google Analytics 4 etiketi: işleniyor.

Bu örnekte, daha önce oluşturduğunuz ve dağıtıldı .

gtag.js'yi yapılandırma

Öncelikle, verileri sunucu kapsayıcınıza göndermek için gtag.js'yi yapılandırın. Entegre gtag.js, sunucu kapsayıcınıza veri göndermekle aynı şekilde çalışır. tek bir değişiklikle Google Analytics. Aşağıdaki örnek sayfada olduğu gibi, Sunucu kapsayıcısını işaret edecek server_container_url yapılandırma seçeneği.

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'TAG_ID', {
    server_container_url: 'https://analytics.example.com',
  });
</script>

TAG_ID değerini etiket kimliğinizle değiştirin. https://analytics.example.com değerini sunucu kapsayıcısı URL'nizle değiştirin.

Ardından, click etkinliklerini işlemek için bir sendEvent() işlevi ekleyin:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'TAG_ID', {
    server_container_url: 'https://analytics.example.com',
  });

  function sendEvent() {
    gtag('event', 'click');
  }
</script>

<button onclick="javascript:sendEvent()">Send Event</button>

TAG_ID değerini etiket kimliğinizle değiştirin. https://analytics.example.com değerini sunucu kapsayıcısı URL'nizle değiştirin.

Bu yapılandırmayla, sendEvent() işlevi gibi etkinlik işleyiciler bir click etkinliği sunucu kapsayıcınıza gönderilir.

Google Analytics 4 istemcisi

Kapsayıcınız, sunucuya ulaştığında etkinliği almak için bir istemciye ihtiyaç duyar. Neyse ki sunucu kapsayıcılarında, Google Analytics 4 istemcisi de yüklü olduğundan bu adımı zaten tamamlamışsınızdır.

Tıklama tetikleyicisi

Ardından, click etkinliğinde tetiklenen bir tetikleyici oluşturun. Bir Özel Etkinlik Adı yerleşik değişkeni şuna eşit olduğunda tetiklenen tetikleyici: tıklayın.

tetikleyici yapılandırması

Google Analytics 4 etiketi

Son olarak, tetikleyiciye bir GA4 etiketi ekleyin. İstemcilerde olduğu gibi, sunucu kapsayıcısı GA4 etiketi bulunur. Etiketi oluşturmanız, ayarlarınızı yapılandırmanız, Böylece konteynerinizi kabloyla bağlamış oldunuz. GA4 istemcileri ve GA4 etiketleri, pek çok yolu vardır. Bu, tek yapmanız gereken bir GA4 etiketi oluşturmak olduğu ve bu yapılandırma şablonundan gelen etkinliklerden otomatik olarak gerekir.

Kapsayıcıyı önizleme

Kapsayıcı yapılandırıldığına göre Önizle'yi tıklayın. Web sitenizi farklı bir tarayıcı penceresi açın. İstekler ve etkinlikler sunucunuza gönderilirken her bir kapsayıcının sağ tarafında listelenen istekleri ve etkinlikleri önizleme sayfası.

Değişikliklerinizi tamamladığınızda sunucu kapsayıcısını yayınlayın.

Sunucunuzu, birinci taraf sunumu olan üretim modu için yapılandırma

Sunucu kapsayıcınıza herhangi bir üretim trafiği göndermeden önce, sunucuyu bilgisayarınıza birinci taraf alan ve sunucuyu üretim modunu kullanın.