Bu belgede, sunucu tarafı kapsayıcıya etkinlik göndermenin farklı yolları açıklanmaktadır. Daha fazla bilgiye ihtiyacınız varsa sunucu tarafı etiketlemenin işleyiş şekline göz atın.
Bu belgede aşağıdaki konular ele alınmaktadır:
- 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ı bir uygulama üzerinden yönlendirebilirsiniz. Uygulama seçeneğinizi belirleyin.
İsteğe bağlı: Her etkinlikle birlikte ek parametreler gönderme
İki tür ek parametre gönderebilirsiniz: yapılandırma düzeyinde parametreler ve etkinlik düzeyinde parametreler. Yapılandırma parametreleri, Google etiketinizin veya Google Analytics hedef etiketinizin davranışını etkiler ve yalnızca Google etiketi ya da Google Analytics hedef 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 Google Analytics 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] | Service worker uygulaması |
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 inceleyin.
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. Google Analytics istemcisi, sunucu tarafı kapsayıcınıza varsayılan olarak ö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ı 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 hangi sırayla çalıştırılacağını belirler. Daha yüksek sayılar öncelikli olarak çalışır ve gelen istekle eşleşen ilk istemci, bu istek için etkin istemci 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 istemcisini ayarlamanız gerekir.
Bazı sunucu etiketleri, giden isteklerine ek parametreleri herhangi bir kurulum olmadan dahil eder. Bu parametreleri hariç tutmak için değeri kaldıracak bir Dönüşüm oluşturun.
Diğer etiketlerde ek parametreler 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, etiketleme etkinliklerinden coğrafi ve cihaz bilgilerini türetme gibi Measurement Protocol uç noktasının tüm özelliklerini desteklemez.
Mobil uygulamalar
Android veya iOS uygulamanızın sunucu kapsayıcınıza veri göndermesini sağlamak için özel resim etiketi oluşturup bunu Measurement Protocol'u 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 Ölçüm Protokolü istemcisindeki yolda bulunan sunucu kapsayıcısında 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 tarafı 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.