Bu makalede, sunucu tarafı kapsayıcıya etkinlik göndermenin farklı yolları açıklanmaktadır. Daha fazla arka plan bilgisine ihtiyacınız varsa sunucu tarafı etiketlemenin işleyiş şekli başlıklı makaleye göz atın.
Bu makalede aşağıdaki konular ele alınmaktadır:
- Bir web sitesinden sunucu tarafı kapsayıcınıza veri gönderme
- Sunucu kapsayıcısına ek veriler 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ğıdakilere sahip olduğunuz varsayılmaktadır:
1. Web sitesinden sunucu tarafı kapsayıcınıza veri gönderme
Verileri, Etiket Yöneticisi veya gtag.js aracılığıyla sunucu tarafı uygulaması üzerinden yönlendirebilirsiniz. Uygulama seçeneğinizi belirleyin.
İsteğe bağlı: Her etkinlikle ek parametreler gönderin
İki tür ek parametre gönderebilirsiniz: yapılandırma düzeyinde parametreler ve etkinlik düzeyinde parametreler. Yapılandırma parametreleri, Google etiketinizin davranış şeklini 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.
Kurulum önerileri
Sunucu kapsayıcısına veri göndermek için bir web sayfasında GA4 etiketini kullanmanızı öneririz. Bu etiket, etkinliklerin en iyi yayınlanma oranını sağlamak için farklı aktarım yöntemleri kullanabilir. Bu yöntemler aşağıdakileri kapsar ancak bunlarla sınırlı değildir:
- Resim pikseli
- Fetch API
- XHR
- Sunucu kapsayıcınızın alanından yüklenen bir iframe'de çalışan hizmet çalışanı.
Tüm yöntemlerin desteklendiğinden emin olmak için aşağıdakileri kontrol edin:
İçerik güvenliği politikası (İGP)
| Yönerge | İçerik | Purpose |
| img-src | [SERVER_CONTAINER_URL] | Ölçüm istekleri |
| connect-src | [SERVER_CONTAINER_URL] | Ölçüm istekleri |
| frame-src | [SERVER_CONTAINER_URL] | Hizmet çalışanı uygulama |
Ayrıca, X-Frame-Options, iframe'lerin sunucu kapsayıcısı URL'sinden yüklenmesini kısıtlamamalıdır.
Ürüne özel politikalar için https://developers.google.com/tag-platform/security/guides/csp adresini ziyaret edin.
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üklenir.
Ayrıntıları görüntülemek veya düzenlemek için müşterinin adını tıklayın.
İsteğe bağlı müşteri 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 Kriterleri: Etkinleştirme kriterleri, 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 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 ayarlamanız gerekir.
Bazı sunucu etiketleri, giden isteklerine ek parametreleri kurulum gerektirmeden dahil eder. Bu parametreleri hariç tutmak için değeri kaldıracak bir dönüşüm oluşturun.
Diğer etiketlerde ek parametreleri kullanmak için:
- Sunucu kapsayıcınızda, soldaki 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 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 Measurement Protocol biçiminde kapsayıcınıza 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, Measurement Protocol uç noktasının tüm özelliklerini (ör. etkinlikleri etiketleyerek coğrafi ve cihaz bilgilerini türetme) desteklemez.
Mobil uygulamalar
Android veya iOS uygulamanızın sunucu kapsayıcınıza 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 belirttiğiniz Measurement Protocol istemcisindeki yolda bulunan sunucu kapsayıcısındaki bir piksel resim 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 yolu olarak ayarlayın.
- İstemci yapılandırmasını kaydedin ve sunucu taraflı kapsayıcıyı yayınlayın.
Sunucudan sunucuya uygulamalar
Ölçüm protokolü 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 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 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 Google Analytics kitaplığı gibi Google komut dosyalarını kendi sunucularınızdan sunmanız gerekir.