Bu makalede, sunucu tarafı kapsayıcıya etkinlik göndermenin farklı yolları açıklanmaktadır. Daha fazla arka plan bilgiye ihtiyacınız varsa sunucu tarafı etiketlemenin nasıl çalıştığına göz atın.
Bu makalede aşağıdakilerin nasıl yapılacağı açıklanmaktadır:
- Bir web sitesinden sunucu tarafı kapsayıcınıza veri gönderme
- Sunucu kapsayıcısına ek veri gönderme
- Sunucu tarafı kapsayıcınıza veri alma
- Web siteleri dışındaki kaynaklardan veri gönderin
Başlamadan önce
Bu kılavuzda, aşağıdakilere 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 bir sunucu tarafı uygulama aracılığıyla yönlendirebilirsiniz. Uygulama seçeneğinizi belirleyin.
İsteğe bağlı: Her etkinlikle birlikte ek parametreler gönder
İki tür ek parametre daha gönderebilirsiniz: Yapılandırma düzeyindeki parametreler ve etkinlik düzeyindeki parametreler. Yapılandırma parametreleri, Google etiketinizin davranış şeklini etkiler ve yalnızca Google etiketi düzeyinde ayarlanabilir.
Etkinlik parametreleri, bir etkinlikle ilgili ek bilgileri belirtir ve tüm etkinlikler, belirli etkinlikler veya page_view etkinlikleri için ayarlanabilir.
2. Sunucu tarafı kapsayıcınıza veri alma
Bir sunucu kapsayıcısına HTTP isteği gönderdiğinizde, istemcinin bu isteği talep etmesi gerekir.
Mevcut istemcilerin listesini görüntülemek için:
Sunucu kapsayıcınızı açın.
Soldaki gezinme çubuğunda Müşteriler'i tıklayın. GA4 istemcisi, varsayılan olarak sunucu tarafı container'ınıza önceden yüklenmiştir. Universal Analytics ile çalışmanız gerekiyorsa bir Google Analytics: Universal Analytics istemcisi oluşturun.
Ayrıntıları görüntülemek veya düzenlemek için istemcinin adını tıklayın.
İsteğe bağlı istemci ayarları
Çoğu durumda, istemci hiç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ırayı belirler. Yüksek sayılar önce çalıştırılır. Gelen istekle eşleşen ilk istemci, bu isteğin etkin istemcisi haline gelir.
Etkinleştirme Kriterleri: 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ı
/collect,/r/collectve Google Analytics'e veri gönderen JavaScript dosyaları tarafından kullanılan diğer benzer yolları içerdiğinde istemci etkinleştirilir. Bu ayar varsayılan olarak etkindir.Belirli kimlikler için varsayılan gtag.js yolları: Sunucu kapsayıcı URL'si ü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 yanıt olarak etkinleştirilir (ör.
/gtag/js?id=TAG_ID). Bir veya daha fazla hedef kimliği eklemek için Ölçüm Kimliği Ekle'yi tıklayın.
İsteğe bağlı: Sunucu tarafı Etiket Yöneticisi'nde ek veriler alma
Ek parametreler gönderiyorsanız ek parametreleri ayrıştırmak ve bunlardan etkinlik verileri oluşturmak için sunucu kapsayıcınızda Google Analytics 4 istemcisini kurmanız gerekir.
Bazı sunucu etiketleri, herhangi bir kurulum gerekmeden giden isteklerinde ek parametreler içerir. Bu parametreleri hariç tutmak için değeri kaldırmak üzere bir Dönüşüm oluşturun.
Diğer etiketlerde ek parametreler kullanmak için:
- Sunucu kapsayıcınızda, sol gezinme bölmesindeki 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.
- Anahtar Yolu alanına parametrenin adını girin.
- Değişkeninize bir ad verin ve Kaydet'i tıklayın.
Artık etkinlik parametresini sunucu kapsayıcınızdaki başka bir etikette kullanabilirsiniz.
3. İsteğe bağlı: Web siteleri dışındaki kaynaklardan veri gönderin
Google Analytics Measurement Protocol, mobil uygulamalar ve sunucudan sunucuya uygulamalar gibi kaynaklardan sunucu tarafı etiketleme desteği sağlamak 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şturur ve Measurement Protocol'u kullanacak şekilde yapılandırırsınız:
- 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.
- Image URL (Resim URL'si) değerini, daha önce belirttiğiniz Measurement Protocol istemcisindeki yoldaki sunucu kapsayıcısında bir piksel görüntüsüne ayarlayın.
İstediğiniz Measurement Protocol parametrelerini piksel URL'nizin 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ı'nda Measurement Protocol istemci türünü seçin.
- Etkinleştirme Yolu'nu uygulamanızın toplama uç noktasının yolu olarak ayarlayın.
- İstemci yapılandırmasını kaydedin ve sunucu tarafı kapsayıcıyı 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 yüklemenizi bir Measurement Protocol istemcisiyle yapılandırın:
- Sunucu tarafı kapsayıcınızda İstemciler > Yeni'yi tıklayın.
- İstemci Yapılandırması'nda 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ı kaydedin ve 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 komut dosyaları (Google Analytics kitaplığı gibi) sunmanız gerekir.