Bu makalede, sunucu tarafı kapsayıcıya etkinlik göndermenin farklı yolları açıklanmaktadır. Daha fazla arka plan bilgisi gerekirse 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önder
- Sunucu tarafı kapsayıcınızda veri alma
- Web siteleri dışındaki kaynaklardan veri gönderin
Başlamadan önce
Bu kılavuzda, aşağıdakilere sahip olduğunuz varsayılmaktadı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 aracılığıyla yönlendirebilirsiniz. Uygulama seçeneğinizi belirleyin.
İsteğe bağlı: Her etkinlikle birlikte ek parametreler gönderme
Ek olarak iki tür ek parametre gönderebilirsiniz: Yapılandırma düzeyinde parametreler ve etkinlik düzeyinde parametreler. Yapılandırma parametreleri, Google etiketinizin davranışını etkiler ve yalnızca Google etiketi düzeyinde ayarlanabilir.
Etkinlik parametreleri, bir etkinlik hakkında ek bilgiler belirtir ve tüm etkinlikler, belirli etkinlikler veya page_view etkinlikleri için ayarlanabilir.
2. Sunucu tarafı kapsayıcınızda veri alma
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ğundan Müşteriler'i tıklayın. GA4 istemcisi, sunucu tarafı kapsayıcınıza varsayılan olarak ö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 olur.
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'niz üzerinden gtag.js JavaScript sunumunu etkinleştirmek isterseniz bu ayarı kullanın. Etkinleştirildiğinde bu istemci, varsayılan gtag.js istek yollarına (ör.
/gtag/js?id=TAG_ID) yapılan isteklere yanıt olarak etkinleştirilir. 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.
Bir sunucu etiketinde 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 bu etiketi Measurement Protocol'ü 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.
- Resim URL'si değerini, daha önce belirttiğiniz Measurement Protocol istemcisindeki yolda, sunucu kapsayıcısında bir piksel resmi olarak 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
Gerçek bir birinci taraf bağlamında veri göndermek için Google komut dosyalarını (ör. Google Analytics kitaplığı) kendi sunucularınızdan sunmanız gerekir.