Bu makalede, sunucu tarafı kapsayıcıya etkinlik göndermenin farklı yolları açıklanmaktadır. Daha fazla bilgi için sunucu tarafı etiketlemenin işleyiş şekline göz atın.
Bu makalede aşağıdakiler ele alınmaktadır:
- Bir web sitesinden sunucu tarafı kapsayıcınızla veri gönderme
- Sunucu kapsayıcıya ek veri gönderme
- Sunucu tarafı kapsayıcınızda veri alma
- Web siteleri dışındaki kaynaklardan veri gönderme
Başlamadan önce
Bu rehberde, aşağıdakileri zaten sahip olduğunuz varsayılmaktadır:
1. Bir web sitesinden sunucu tarafı kapsayıcınıza () veri gönderin
Verileri Etiket Yöneticisi veya gtag.js aracılığıyla sunucu tarafı bir uygulama üzerinden yönlendirebilirsiniz. Uygulama seçeneğinizi belirleyin.
İsteğe bağlı: Her etkinlikle birlikte ek parametreler gönderin
İki tür ek parametre daha 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ındaki ek bilgileri belirtir ve tüm etkinlikler, belirli etkinlikler veya page_view etkinlikleri için ayarlanabilir.
2. Sunucu tarafı kapsayıcınızda veri alma
Bir sunucu kapsayıcısına HTTP isteği gönderdiğinizde istemcinin bu isteği talep etmesi gerekir.
Kullanılabilir 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ı kapsayıcınıza önceden yüklenmiştir.
Ayrıntıları görüntülemek veya düzenlemek için müşterinin adını tıklayın.
İsteğe bağlı istemci ayarları
Çoğu durumda, müşteri herhangi bir değişiklik gerektirmez. Bununla birlikte, 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. Yüksek sayılar önce çalıştırılır. Gelen istekle eşleşen ilk istemci, o isteğin etkin istemcisi olur.
Etkinleştirme ölçütleri: Etkinleştirme ölçütleri, istemcinin isteklere ne zaman yanıt vereceğini tanımlar:
- Belirli kimliklere ait varsayılan gtag.js yolları: Sunucu kapsayıcı URL'si üzerinden gtag.js JavaScript sunumunu etkinleştirmek isterseniz bu ayarı kullanın. Bu ayar etkinleştirildiğinde, bu istemci varsayılan gtag.js istek yollarına yapılan isteklere yanıt olarak etkinleştirilir. Bu istek yollarına örnek olarak
/gtag/js?id=TAG_IDverilebilir. Bir veya daha fazla hedef kimliği eklemek için Ölçüm kimliği ekle'yi tıklayın.
- Belirli kimliklere ait varsayılan gtag.js yolları: Sunucu kapsayıcı URL'si üzerinden gtag.js JavaScript sunumunu etkinleştirmek isterseniz bu ayarı kullanın. Bu ayar etkinleştirildiğinde, bu istemci varsayılan gtag.js istek yollarına yapılan isteklere yanıt olarak etkinleştirilir. Bu istek yollarına örnek olarak
İsteğe bağlı: Sunucu tarafı Etiket Yöneticisi'nde ek veri 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 ayarlamanız gerekir.
Bazı sunucu etiketleri, ek parametreleri herhangi bir kurulum yapmadan giden isteklerine ekler. 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 menüsünden 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 ad verip Kaydet'i tıklayın.
Artık etkinlik parametresini sunucu kapsayıcınızdaki diğer tüm etiketlerde 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ğini etkinleştirmek için kullanılabilir.
Mobil uygulamalar
Android veya iOS uygulamanızın sunucu kapsayıcınızla veri göndermesini sağlamak için özel bir resim etiketi oluşturup bunu Ölçüm Protokolü'nü 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ı bölümünde Özel Resim etiket türünü seçin.
- Görüntü URL'si değerini, daha önce belirttiğiniz Measurement Protocol istemcisindeki yolda, sunucu kapsayıcısında bulunan bir piksel görüntü 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 Müşteriler > 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 yoluna ayarlayın.
- İstemci yapılandırmasını kaydedin ve sunucu tarafı kapsayıcıyı yayınlayın.
Sunucudan sunucuya uygulamalar
Ölçüm protokolü verilerini sunucu kapsayıcınızla paylaşmak 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 isabetlerini almak için sunucu tarafı Etiket Yöneticisi kurulumunuzu bir Measurement Protocol istemcisiyle yapılandırın:
- Sunucu tarafı kapsayıcınızda Müşteriler > 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 yoluna 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 Google Analytics kitaplığı gibi Google komut dosyalarını kendi sunucularınızdan yayınlamanız gerekir.