Bu makalede, etkinlikleri sunucu tarafı kapsayıcıya göndermenin farklı yolları açıklanmaktadır. Daha fazla bilgi edinmek için sunucu tarafı etiketlemenin işleyiş şekline göz atın.
Bu makalede aşağıdaki konular ele alınmaktadır:
- Bir web sitesinden sunucu tarafı kapsayıcınızla veri gönderme
- Sunucu kapsayıcısına 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ızla veri gönderme
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 etkinlikle ilgili ek bilgileri belirtir ve tüm etkinlikler, belirli etkinlikler veya page_view etkinlikler 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.
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ı 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 istemcide herhangi bir değişiklik yapılması gerekmez. 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. 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 bir ad verin ve 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önderme
Google Analytics Measurement Protocol, mobil uygulamalar ve sunucudan sunucuya uygulamalar gibi kaynaklardan sunucu tarafı etiketleme desteğini etkinleştirmek için kullanılabilir. Bu seçenek, etkinlikleri kapsayıcınızla Measurement Protocol biçiminde göndermenize olanak tanır. Kapsayıcı, bu etkinlikleri diğer tüm SGTM etkinlikleriyle aynı mekanizmayı kullanarak Google Analytics'e gönderir.
Bu seçenek, etiketleme etkinliklerinden coğrafi ve cihaz bilgilerini elde etme gibi Measurement Protocol uç noktasının tüm özelliklerini desteklemez.
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.
- Resim URL'si değerini, daha önce Measurement Protocol istemcisinde belirttiğiniz yoldaki sunucu kapsayıcıdaki 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 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.