Birinci taraf modunu ayarlama

Bu doküman, Google etiketini birinci taraf modunda dağıtmak isteyen kullanıcılar içindir. En uzun ömürlü etiket yapılandırması için birinci taraf modunu öneririz.

Genel Bakış

Not: Birinci taraf modu beta sürümündedir. Birinci taraf modunu ayarlamak, etiket kurulumunuzun daha iyi performans göstermesine yardımcı olabilir. Bu da daha kaliteli ölçüm sinyalleri elde etmenizi sağlar. Kurulumunuzla ilgili sorunuz veya sorunuz varsa [e-mail] adresinden bize ulaşın.

Birinci taraf modu, web sitenizin alanında barındırılan kendi birinci taraf altyapınızı kullanarak bir Google etiketi dağıtmanıza olanak tanır. Bu altyapı, web siteniz ile Google'ın hizmetleri arasında yer alır. Bu dokümanda açıklanan kurulum, web sitenizi daha iyi ölçmenize yardımcı olur. Mevcut içerik yayınlama ağınızı (CDN), yük dengeleyicinizi veya web sunucunuzu kullanarak ayarlayabilirsiniz.

Standart Google etiketi kurulumlarında web sayfanız bir Google alanından Google etiketi ister. Etiket etkinleştirildiğinde doğrudan Google ürününe ölçüm istekleri gönderir. Birinci taraf modunda, web siteniz Google etiketini birinci taraf alanınızdan yükler. Etiket tetiklendiğinde birinci taraf alanınıza ölçüm istekleri gönderir. Bu istekler, ilgili Google ürününe yönlendirilir.

Bu şema, birinci taraf modundaki bilgi akışını temsil etmektedir:

Başlamadan önce

Bu kılavuzda, web sitenizin aşağıdakilerle yapılandırılmış olduğu varsayılmaktadır:

• Google etiketi veya Etiket Yöneticisi kapsayıcısı
• İstekleri harici uç noktalara yönlendirebilen bir içerik yayınlama ağı (CDN) veya yük dengeleyici

Başlamak için kurulum türünüzü seçin.

Manuel kurulum Cloudflare ile otomatik kurulum

1. Etiket yayınlama yolunu seçme

Etiketi yayınlamak için web sitenizin alanında bir yol ayırmanız gerekir. Bu yolun alanınızda zaten kullanılmadığından emin olun.

Birinci taraf modunu ayarlamak için sitenizde kullanılmayan bir yol seçin. Sitede zaten mevcut bir yola çakışma olasılığını azaltmak için herhangi bir harf ve sayı kombinasyonunu seçebilir veya daha okunaklı bir yol istiyorsanız /metrics, /securemetric, /analytics gibi bir kelimeyi ya da istediğiniz başka bir kelimeyi kullanabilirsiniz.

Yol, kök yol / olmamalı veya 100 karakteri aşmamalıdır.

Bu dokümandaki örnekleri doldurmak için aşağıdakileri girin.

Your domain: example.com
Google tag ID: G-12345
Tag serving path: /metrics

Dikkat: Bu kurulum, tüm trafiği seçilen yola yönlendirir. Web sitenizi etkilememek için halihazırda kullanılmayan bir yol seçin.

2. Trafiği yönlendirme

Bu bölümde, web sitenizin trafiği yollara göre yönlendirmeyi destekleyen bir CDN veya yük dengeleyici kullandığı varsayılmaktadır.

Google CloudCloudflareDiğer

Site ziyaretçisinin yaklaşık coğrafi konumunu arayan yeni bir arka uç oluşturmanız ve mevcut Harici Uygulama Yük Dengeleyicinizde yönlendirme kuralları oluşturmanız gerekir.

Yeni arka uç oluşturma

1. GCP yük dengeleyicisini açın

2. Yük dengeleyicinizde Arka uç yapılandırması bölümünü açın. Yeni bir arka uç hizmeti oluşturun.

3. Yeni arka uç hizmetinizi coğrafi konum bilgileriyle yapılandırın:

   • measurement-be-svc gibi bir ad belirtin.
   • Arka uç türü'nü İnternet ağ uç noktası grubu olarak ayarlayın.
   • Protokol'ü HTTPS olarak ayarlayın ve Tümelenme Süresi'ni önceden doldurulmuş değer olarak bırakın.
   • Arka uçlar bölümünde İnternet ağ uç noktası grubu açılır menüsünü tıklayın ve yeni bir internet ağ uç noktası grubu oluşturun:
     • Ağ uç noktası grubu türü'nü İnternet NEG (Küresel, Bölgesel) olarak ayarlayın.
     • Kapsam'ı Küresel olarak ayarlayın.
     • Ekle'yi Tam nitelikli alan adı ve bağlantı noktası olarak ayarlayın.
     • Tam nitelikli alan adı'nı G-12345.fps.goog olarak ayarlayın.
     • Bitiş noktasını oluşturmak için OLUŞTUR'u tıklayın.
     • Yeni arka uç hizmeti sekmesine dönmek için Ağ uç noktası grubu sekmesini kapatın.
   • Yeni ağ uç noktası grubunun adını arayın ve seçin.
   • Gelişmiş yapılandırmalar bölümünü açın. Aşağıdaki özel istek üstbilgilerini ekleyin.

     Başlık adı	Üstbilgi değeri
     Host	G-12345.fps.goog
     X-Gclb-Country	{client_region}
     X-Gclb-Region	{client_region_subdivision}

   • Diğer ayarları inceleyin. Bu entegrasyon için Cloud CDN veya Cloud Armor gerekli değildir. Bu nedenle, ikisini de güvenle devre dışı bırakabilirsiniz.
   • Yeni arka uç hizmetini kaydedin.

Yönlendirme kurallarını yapılandırma

1. Yük dengeleyicinizde Yönlendirme kuralları bölümünü açın.

2. Aşağıdaki ana makine ve yol kurallarını ekleyin:

   Ana makine	Path	Arka uç
   *	/metrics/*	measurement-be-svc

3. Yük dengeleyici yapılandırmasını güncelleyin.

4. Bir tarayıcıda https://example.com/metrics/healthy adresine giderek kurulumu doğrulayın. Sayfada ok metni olmalıdır. https://example.com/metrics/?validate_geo=healthy adresine giderek coğrafi bilgilerin dahil edildiğini doğrulayın. Sayfada ok metni bulunmalıdır.

Etiketinizi birinci taraf modunda yayınlamak için yeni bir alt alan adı için CNAME girişi, istekleri yönlendirmek üzere bir Kaynak Kuralı ve coğrafi konum bilgilerini dahil etmek için bir Dönüşüm Kuralı oluşturursunuz. Bu kurulumu tamamlamak için bir Cloudflare Enterprise planınız olmalıdır. Enterprise planınız yoksa bunun yerine Cloudflare otomatik kurulumunu kullanabilirsiniz.

CNAME girişi oluşturma

Not: Etiketler bu CNAME girişini kullanmaz. Cloudflare, istekleri dahili olarak yönlendirmek için bu girişi kullanır.

CNAME girişi için ayrılacak bir alt alan adı seçin. Bu belgedeki örnekleri doldurmak için aşağıdaki bilgileri girin. Bu CNAME hiçbir zaman Cloudflare yapılandırmanızın dışında gösterilmez. Bu nedenle, ad rastgele olabilir.

CNAME subdomain: fps

1. DNS sekmesinde Kayıtlar bölümünü açın.
2. Aşağıdaki yapılandırmaya sahip yeni bir kayıt ekleyin:
   • Tür'ü CNAME olarak ayarlayın.
   • Ad'ı fps olarak ayarlayın.
   • Hedef'i G-12345.fps.goog olarak ayarlayın.
3. CNAME kaydını kaydedin.

Kaynak kuralını oluşturma

1. Kurallar sekmesinde Kaynak Kuralları'nı açın ve kural oluşturun.
2. Route measurement gibi bir kural adı girin.
3. Gelen istekleri Özel filtre ifadesine göre eşleştirin ve İfadeyi düzenle'yi tıklayın.
4. Aşağıdaki ifadeyi derleyiciye yapıştırın: (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
5. Ana Makine Başlığı'nı Şuna yeniden yaz: olarak güncelleyin. G-12345.fps.goog.
6. DNS Kaydı'nı İptal et ve şunu kullan: olarak güncelleyin. fps.example.com.
7. Kaynak kuralını kaydedin.
8. Başka Kaynak Kuralları varsa yeni oluşturulan kuralın konumunu, diğer joker karakter yollarından sonra çalışacak şekilde artırın.
9. Bir tarayıcıda https://example.com/metrics/healthy adresine giderek kurulumu doğrulayın. Sayfada ok yazıyor olmalıdır.

Coğrafi konum bilgilerini ekleme

1. Kurallar sekmesinde Dönüşüm Kuralları'nı açın.
2. İstek Başlığını Değiştir kuralı oluşturun.
3. Kuralı Tüm gelen istekler'e uygulayın.
4. İstek üstbilgisini aşağıdaki yapılandırmayla değiştirin:
   • Operatörü Dinamik olarak ayarla olarak ayarlayın.
   • Başlık adı'nı X-CfIpCountryRegion olarak ayarlayın.
   • Değer'i ip.src.subdivision_1_iso_code olarak ayarlayın.
5. Dönüştürme kuralını dağıtın.
6. Kuralın dağıtılması için birkaç dakika bekleyin. Bir tarayıcıda https://example.com/metrics/?validate_geo=healthy adresine giderek kurulumu doğrulayın. Sayfada ok yazmalıdır.

(İsteğe bağlı) Ziyaretçi IP üstbilgilerini kaldırma

Birinci taraf modunun doğru şekilde çalışması için ziyaretçi IP'sinin kullanılması gerekmez. Ziyaretçi IP üstbilgilerini kaldırın yönetilen dönüştürmelerini kullanarak tüm ziyaretçi IP üstbilgilerini kaldırabilirsiniz.

Etiketinizi birinci taraf modunda yayınlamak için CDN'nizi veya yük dengeleyicinizi, istekleri birinci taraf modu uç noktasına yönlendirecek şekilde yapılandırmanız gerekir.

1. G-12345.fps.goog adresine yönlendiren bir kaynak veya arka uç ekleyin.
2. Ana makine üstbilgisini G-12345.fps.goog olarak değiştirin. Tüm çerezlerin ve sorgu dizelerinin yönlendirilmesine izin verin.
3. Trafiği birinci taraf moduna yönlendirmek için /metrics/* için bir yol kuralı ekleyin.
4. Ayrılmış yolu varsayılan kuraldan daha yüksek önceliğe sahip olacak şekilde yapılandırın.
5. Bir tarayıcıda https://example.com/metrics/healthy adresine giderek kurulumu doğrulayın. Sayfada ok yazıyor olmalıdır.

3. Adım: Ölçüm yolunu kullanacak şekilde web sitesindeki komut dosyalarını güncelleyin

Web sitesinin her sayfasındaki komut dosyalarını aşağıdakilerden biriyle değiştirin:

gtag.jsgtm.js

<head> bölümünün üst kısmında, Google etiketi kimliğinizi içeren iki komut satırı bulun:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-12345"></script>

ve bunları ölçüm yoluyla değiştirin:

<!-- Google tag (gtag.js) -->
<script async src="/metrics/"></script>

<head> bölümünün en üstünde, Etiket Yöneticisi snippet'ini aşağıdakiyle değiştirin:

<!-- Google Tag Manager -->
<script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'/metrics/?id='+i+dl;f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','');</script>
<!-- End Google Tag Manager -->

Ölçüm ayarlarını test etme

Ölçüm ayarını test etmek için kapsayıcınızı, etkinleşen en az bir etiket içerecek şekilde yapılandırın.

1. Tag Assistant'a gidin ve kapsayıcınızı önizleyin. Etkinlikleri tetiklemek için sitenizde gezinin.

2. Özet > Çıkış > Gönderilen İsabetler sekmesinde, isabetlerin /metrics adresine yönlendirildiğinden emin olun.