Sunucu tarafı Etiket Yöneticisi'ne veri gönderme

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:

• Etiket Yöneticisi'nde sunucu kapsayıcısı oluşturma
• Etiketleme sunucusu oluşturma

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.

Etiket Yöneticisi gtag.js

Google etiketi: GA 4

Sunucu tarafı işleme için bir Google etiketi ayarlamak isterseniz sunucu kapsayıcı URL'nizi eklemeniz gerekir.

Sunucu kapsayıcısı URL'si için yapılandırma değişkeni oluşturma

1. Google Etiket Yöneticisini açın.

2. Yapılandırmak istediğiniz web kapsayıcısını seçin.

3. Değişkenler menüsünü açın.

4. Google etiketi: Yapılandırma ayarları türünde yeni bir kullanıcı tanımlı değişken oluşturun.

5. Aşağıdaki parametreleri ekleyin:

   • Ad: server_container_url
   • Değer: Etiket Yöneticisi sunucu kapsayıcınızın sunucu kapsayıcısı URL'sine ayarlanır.

6. Değişkeninize "Sunucu URL'si" gibi bir ad verin ve Kaydet'i tıklayın.

Sunucu kapsayıcısı URL'sini bir Google etiketine atama

1. Etiketler menüsünü açın.
2. Yeni bir Google etiketi ekleyin veya mevcut bir etiketi düzenleyin.
3. Yapılandırma ayarları'nda, az önce oluşturduğunuz sunucu kapsayıcısı değişkenini seçin.
   İpucu: Ayarlar değişkeninden hangi parametrelerin devralındığını görmek için Devralınan ayarları göster'i tıklayın.
4. Google etiketinin diğer tetikleyicilerden önce etkinleştiğinden emin olmak için Tetikleyici'yi tıklayın ve Başlatma - Tüm sayfalar tetikleyicisini kullanın. Sayfa tetikleyicileri hakkında daha fazla bilgi edinin.
5. Etiketi kaydedin ve kapsayıcıyı yayınlayın.

İ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.

Yapılandırma parametreleriTüm etkinliklerEtkinlikleri seçinpage_view etkinlik

Google Etiket Yöneticisi'nde yapılandırma ayarlarını yeniden kullanmayı öğrenin.

Tüm etkinliklerde ek parametreler göndermek için Google Etiket Yöneticisi'nde etkinlik ayarlarını yeniden kullanın.

Google Analytics 4 etkinliği ile ek parametreler göndermek için:

1. Bir web kapsayıcısına Google Analytics 4 Etkinliği etiketi ekleyin veya mevcut bir etiketi düzenleyin.
2. Etkinlik Parametreleri > Satır Ekle'yi tıklayın.
3. Etkinlikle birlikte gönderilecek parametreyi ekleyin. Önceden tanımlanmış etkinlik parametreleri için Önerilen etkinlikler referansına bakın.
   • Alan Adı alanına parametrenizin adını ekleyin (ör. language).
   • Değer alanına parametrenizin değerini ekleyin.

İpucu: Değeriniz Etiket Yöneticisi'nin yüklendiği sırada belirlenecekse sabit kodlanmış bir değer yerine bir değişken kullanın.

1. Başlatma - Tüm Sayfalar'da etkinleşecek bir tetikleyici yapılandırın.
2. Etiketi kaydedin ve kapsayıcıyı yayınlayın.

page_view etkinliğinde parametre göndermek için:

1. Bir web kapsayıcısında, mevcut bir Google etiketini düzenleyin.

2. Yeni bir parametre ekleyerek yapılandırma ayarlarında varsayılan page_view değerini devre dışı bırakın:

   • Ad: send_page_view
   • Değer: false

3. Yeni bir Google Analytics: GA4 Etkinliği etiketi oluşturun.

   • 1. adımda değiştirdiğiniz yapılandırma etiketini seçin.
   • Etkinlik Adı'nı page_view olarak ayarlayın.

4. Etkinlikle birlikte gönderilecek parametreyi ekleyin. Önceden tanımlanmış etkinlik parametreleri için Önerilen etkinlikler referansı başlıklı makaleyi inceleyin. - Alan Adı alanına parametrenizin adını ekleyin (ör. language).

   • Değer alanına parametrenizin değerini ekleyin.

İpucu: Değeriniz Etiket Yöneticisi'nin yüklendiği sırada belirlenecekse sabit kodlanmış bir değer yerine bir değişken kullanın.

1. Başlatma - Tüm Sayfalar'da etkinleşecek bir tetikleyici yapılandırın.
2. Etiketi kaydedin ve kapsayıcıyı yayınlayın.

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.

Önemli Terim: "İstemciler", bir kullanıcının cihazında çalışan yazılım ile sunucu tarafı Etiket Yöneticisi kapsayıcınız arasındaki bağdaştırıcılardır. Bir cihazdan ölçüm verileri alır, bu verileri bir veya daha fazla etkinliğe dönüştürür, verileri kapsayıcıda işler ve sonuçları cihaza geri gönderilecek şekilde paketler.

Kullanılabilir istemcilerin listesini görüntülemek için:

1. Google Etiket Yöneticisini açın.

2. Sunucu kapsayıcınızı açın.

3. 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.

4. 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_ID verilebilir. 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 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:

1. Sunucu kapsayıcınızda, sol gezinme menüsünden Değişkenler'i tıklayın.
2. Yeni bir kullanıcı tanımlı değişken oluşturun.
3. Değişken Yapılandırması'nda Etkinlik Verileri değişken türünü seçin.
4. Anahtar Yolu alanına parametrenin adını girin.
5. 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:

1. Mobil kapsayıcınızda (Android veya iOS) Etiketler > Yeni'yi tıklayın.
2. Etiket Yapılandırması bölümünde Özel Resim etiket türünü seçin.
3. 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
4. Önbellek bozmayı etkinleştir'in seçimini kaldırın.
5. Etiketi kaydedin ve kapsayıcıyı yayınlayın.
6. Sunucu tarafı kapsayıcınızda Müşteriler > Yeni'yi tıklayın.
7. İstemci Yapılandırması'nda Measurement Protocol istemci türünü seçin.
8. Etkinleştirme Yolu'nu, uygulamanızın toplama uç noktasının yoluna ayarlayın.
9. İ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:

1. Sunucu tarafı kapsayıcınızda Müşteriler > Yeni'yi tıklayın.
2. İstemci Yapılandırması'nda Measurement Protocol istemci türünü seçin.
3. Etkinleştirme Yolu'nu sunucunuzun uç noktasının yoluna ayarlayın.
4. İ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.

Google komut dosyalarını sunucum üzerinden yükleme