Bu makalede etkinlikleri sunucu tarafı kapsayıcısına göndermenin farklı yolları açıklanmaktadır. Daha fazla arka plan bilgisine ihtiyacınız varsa sunucu tarafı etiketlemenin nasıl çalıştığına göz atın.
Bu makalede, aşağıdaki işlemlerin nasıl yapılacağı açıklanmaktadır:
- Bir web sitesinden sunucu tarafı kapsayıcınıza veri gönderme
- Sunucu tarafı kapsayıcınızda veri alma
- Sunucu kapsayıcısına ek veri göndermek için bir Google Analytics 4 etiketi kullanma
- Web siteleri dışındaki kaynaklardan veri gönder
Başlamadan önce
Bu kılavuzda, aşağıdaki öğelere sahip olduğunuz varsayılır:
1. Bir web sitesinden sunucu tarafı kapsayıcınıza veri gönderme
Verileri, Etiket Yöneticisi veya Google etiketi (gtag.js) aracılığıyla sunucu tarafı bir uygulama üzerinden yönlendirebilirsiniz. Uygulama seçeneğinizi belirleyin.
2. Sunucu tarafı kapsayıcınızda veri alma
HTTP isteğini bir sunucu kapsayıcısına gönderdiğinizde, bir istemcinin bu hak talebinde bulunması gerekir.
Mevcut istemcilerin listesini görüntülemek için:
- Google Etiket Yöneticisi'ni açın
- Sunucu kapsayıcınızı açın.
- Soldaki gezinme çubuğunda Müşteriler'i tıklayın. GA4 istemcisi varsayılan olarak sunucu tarafı kapsayıcınızda önceden yüklüdür. Universal Analytics ile çalışmanız gerekiyorsa bir Google Analytics: Universal Analytics istemcisi oluşturun.
- Ayrıntılarını görüntülemek veya düzenlemek için istemcinin adını tıklayın.
Çoğu durumda, istemci herhangi bir değişiklik gerektirmez. Ancak, kullanım alanınız farklı olabilir ve aşağıdaki ayarlardan birini düzenlemek isteyebilirsiniz:
Öncelik: İstemcilerin çalıştırılacağı sıralamayı belirler. Daha yüksek sayılar önce çalıştırılır. Gelen istekle eşleşen ilk istemci, bu istek için etkin istemci olur.
Etkinleştirme Ölçütleri: Etkinleştirme ölçütleri, istemcinin isteklere ne zaman yanıt vereceğini tanımlar:
UA istemcileri için: Varsayılan Universal Analytics yolları: İstek yollarında
/collect,/r/collectve Google Analytics'e veri gönderen JavaScript dosyalarının kullandığı diğer benzer yollar varsa istemci etkinleştirilir. Bu ayar varsayılan olarak etkindir.Belirli kimlikler için varsayılan gtag.js yolları: Sunucu kapsayıcı URL'niz üzerinden gtag.js JavaScript sunumunu etkinleştirmek için bu ayarı kullanın. Etkinleştirildiğinde, bu istemci varsayılan gtag.js istek yollarına yapılan isteklere (ör.
/gtag/js?id=TAG_ID) yanıt olarak etkinleştirilir. Bir veya daha fazla hedef kimliği eklemek için Ölçüm Kimliği Ekle'yi tıklayın.
3. Sunucu kapsayıcısına veri göndermek için bir Google Analytics 4 etiketi kullanma (isteğe bağlı)
Ölçmek istediğiniz her ayrıntı için ayrı etiketler oluşturmak yerine, ihtiyacınız olan süper veri grubunu sunucu kapsayıcınıza göndermek için web kapsayıcınızdaki GA4 yapılandırma etiketini kullanın. Daha sonra bu veriler sunucu etiketlerinizle yeniden oluşturulabilir. Böylece, web sitenizin performansını artırırken ihtiyacınız olan tüm ölçüm sinyallerini almaya devam edersiniz.
GA4 yapılandırma etiketi GA4 etkinlik etiketlerinizden önce tetiklendiğinde, sistem kararlılığı, performansı ve yükleme kalitesi hakkındaki toplu teşhisler hariç tutularak taşıma_url etkinleştirildiğinde GA4 yapılandırma etiketi Google'a hiçbir veri göndermez.
3.1 Ek parametreler ayarlama
Parametreler tüm etkinlikler, belirli etkinlikler veya page_view etkinliklerle gönderilebilir.
3.2 Sunucu tarafı Etiket Yöneticisi'nde ek veriler alma
Sunucu kapsayıcınızdaki Google Analytics 4 istemcisi, ek parametreleri ayrıştırır ve bunlardan etkinlik verileri oluşturur. Parametreleri başka etiketlerde kullanmak için:
- Sunucu kapsayıcınızda, sol taraftaki gezinme panelinde yer alan Değişkenler'i tıklayın.
- Yeni bir Kullanıcı Tanımlı Değişken oluşturun.
- Değişken Yapılandırması'nda Etkinlik Verileri değişken türünü seçin.
- Key Path (Anahtar Yolu) alanına parametrenin adını girin.
- Değişkeninize bir ad verin ve Kaydet'i tıklayın.
Artık etkinlik parametresini sunucunuzdaki başka bir etikette kullanabilirsiniz.
4. Web sitesi dışındaki kaynaklardan veri gönder (isteğe bağlı)
Google Analytics Measurement Protocol, mobil uygulamalar ve sunucudan sunucuya uygulamalar gibi kaynaklardan sunucu tarafı etiketleme desteğini etkinleştirmek için kullanılabilir.
Mobil uygulamalar
Android veya iOS uygulamanızın sunucu kapsayıcınıza veri göndermesini sağlamak için özel bir görüntü etiketi oluşturup bunu Measurement Protocol'u kullanacak şekilde yapılandırmanız gerekir:
- Mobil kapsayıcınızda (Android veya iOS), Etiketler > Yeni'yi tıklayın.
- Etiket Yapılandırması'nda Özel Resim etiket türünü seçin.
- Resim URL'si değerini, daha önce belirttiğiniz Measurement Protocol istemcisindeki yoldaki sunucu kapsayıcısında bir piksel resmi olarak ayarlayın.
İstediğiniz Measurement Protocol parametrelerini piksel pikselinizin sonuna ekleyin:
https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home - Önbellek Bozmayı Etkinleştir'in seçimini kaldırın.
- Etiketi kaydedin ve kapsayıcıyı yayınlayın.
- Sunucu tarafı kapsayıcınızda, İstemciler > Yeni'yi tıklayın.
- İstemci Yapılandırması bölümünde, Measurement Protocol istemci türünü seçin.
- Etkinleştirme Yolu'nu uygulamanızın koleksiyon uç noktasının yolu olarak ayarlayın.
- İstemci yapılandırmasını kaydedin ve sunucu tarafı kapsayıcısını yayınlayın.
Sunucudan sunucuya uygulamalar
Measurement Protocol verilerini sunucu kapsayıcınıza göndermek için www.google-analytics.com ana makine adını sunucu kapsayıcınızın alan adıyla değiştirin. Örneğin:
POST /batch HTTP/1.1
Host: collection.example.com
v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
Measurement Protocol isabetleri almak için sunucu tarafı Etiket Yöneticisi kurulumunuzu bir Measurement Protocol istemcisiyle yapılandırın:
- Sunucu tarafı kapsayıcınızda, İstemciler > Yeni'yi tıklayın.
- İstemci Yapılandırması bölümünde, Measurement Protocol istemci türünü seçin.
- Etkinleştirme Yolu'nu sunucunuzun uç noktasının yolu olarak ayarlayın.
- İstemci yapılandırmasını kaydedip kapsayıcıyı yayınlayın.
Sonraki adımlar
Verileri gerçek bir birinci taraf bağlamında göndermek için kendi sunucularınızdan Google Analytics kitaplığı gibi Google komut dosyalarını sunmanız gerekir.