Birinci taraf modunu ayarlama

Bu belge, 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ı olarak kayıp ölçüm sinyallerinin gizlilik açısından güvenli bir şekilde kurtarılmasını sağlayabilir. Kurulumunuzla ilgili bir sorunuz veya sorununuz varsa [e-mail] adresinden bize ulaşabilirsiniz.

Birinci taraf modu, Google etiketinizi web sitenizin alanında (ör. example.com) barındırılan kendi birinci taraf altyapınızı kullanarak dağıtmanıza olanak tanır. Web siteniz ile Google'ın hizmetleri arasında yer alan bu altyapı, birinci taraf altyapınızı doğrudan web sitenizin kullanıcılarıyla doğrudan etkileşime giren tek teknoloji haline getirir. Birinci taraf modu, bir veri güvenliği katmanı ekler ve ölçümünüzden ödün vermeden tam IP kod karartma gibi ek veri gizliliği denetimleri sağlar. Bu belgedeki ayarlar, web sitenizde% X daha fazla ölçüm sinyalini kurtarmanıza yardımcı olur. Birinci taraf modunu etkinleştirmek için mevcut İçerik Yayınlama Ağınızı (CDN), yük dengeleyiciyi veya web sunucunuzu kullanarak oluşturabilirsiniz.

Standart Google etiketi kurulumlarında, web sayfanız bir Google alanından (ör. www.googletagmanager.com) Google etiketi ister. Etiket etkinleştiğinde, ölçüm isteklerini doğrudan Google ürününe gönderir. Birinci taraf modunda, web siteniz birinci taraf alanınızdan (ör. example.com) Google etiketini yükler. Etiket etkinleştiğinde ölçüm isteklerini birinci taraf alanınıza gönderir ve buradan ilgili Google ürününe yönlendirilirler.

Standart bir Google etiketi ayarından birinci taraf modu yapılandırmasına geçiş yaparken tam ölçüm sürekliliği elde edersiniz.

Bu şema, birinci taraf modunda bilgi akışını gösterir:

Başlamadan önce

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

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

1. Etiket sunma yolunu seçin

Etiketi sunmak için web sitenizin alan adında bir yol ayırmanız gerekir. Bu yolun alanınızda halihazırda kullanılmadığından emin olun.

Birinci taraf modunu ayarlamak için istediğiniz yolu seçin. Kullanmak isteyebileceğiniz yol örnekleri arasında /metrics, /securemetric, /analytics veya tercihen web sitenizde henüz kullanmadığınız rastgele bir alfanümerik dize bulunur.

Bu doküman genelinde örnekleri doldurmak için aşağıdakileri doldurun.

Your domain: example.com
Google tag ID: GTM-123456
Tag serving path: /metrics

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

2. Rota trafiği

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

Google Cloud

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

Yeni arka ucu oluşturma

1. GCP yük dengeleyiciyi açma

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'u HTTPS olarak ayarlayın ve Zaman Aşımı değerini önceden doldurulmuş 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 (Genel, Bölgesel) olarak ayarlayın.
     • Kapsam'ı Genel olarak ayarlayın.
     • Ekle seçeneğini Tam nitelikli alan adı ve bağlantı noktası olarak ayarlayın.
     • Tam nitelikli alan adı'nı GTM-123456.fps.goog olarak ayarlayın.
     • Uç noktayı 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 başlıklarını ekleyin.

     Başlık adı	Üstbilgi Değeri
     Host	GTM-123456.fps.goog
     X-Gclb-Country	{client_region}
     X-Gclb-Region	{client_region_subdivision}

   • Diğer ayarları inceleyin. Bu entegrasyon için Cloud CN veya CloudArmor gerekli değildir. Bu nedenle her ikisini de güvenli bir şekilde 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:

   Düzenleyen	Path	Arka uç
   *	/metrics/*	measurement-be-svc

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

4. Tarayıcıda şu adrese giderek kurulumu doğrulayın: https://example.com/metrics/healthy. 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.

Cloudflare

Etiketinizi birinci taraf modunda sunmak isterseniz yeni bir alt alan adı için CNAME girişi, istekleri yönlendirmek için Kaynak Kuralı ve coğrafi konum bilgilerini içerecek bir Dönüşüm Kuralı oluşturursunuz.

CNAME girişi oluştur

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 belgenin tamamında örnekleri doldurmak için aşağıdaki kısmı doldurun. Bu CNAME, Cloudflare yapılandırmanızın dışında hiçbir zaman açığa çıkmaz. Bu nedenle, isteğe bağlı bir addır.

CNAME subdomain: fps

1. DNS sekmesinde Records (Kayıtlar) bölümünü açın.
2. Aşağıdaki yapılandırmaya sahip yeni bir kayıt ekleyin:
   • Type (Tür) seçeneğini CNAME olarak ayarlayın.
   • Ad'ı fps olarak ayarlayın.
   • Hedef'i GTM-123456.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ştirip İfadeyi düzenle'yi tıklayın.
4. Şu ifadeyi oluşturucuya yapıştırın: (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics"))
5. Ana Makine Üstbilgisi'ni Yeniden yaz... olarak güncelleyin GTM-123456.fps.goog.
6. DNS Kaydı'nı Geçersiz kıl... 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. Tarayıcıda şu adrese giderek kurulumu doğrulayın: https://example.com/metrics/healthy. Sayfada ok yazmalıdır.

Coğrafi konum bilgilerini ekle

1. Kurallar sekmesinde Transform Rules (Kuralları Dönüştürme) seçeneğini açın.
2. İstek Başlığını Değiştirme kuralı oluşturun.
3. Kuralı Tüm gelen istekler'e uygulayın.
4. İstek başlığını aşağıdaki yapılandırmayla değiştirin:
   • Operatörü Dinamik olarak ayarla değerine ayarlayın.
   • Üstbilgi adı'nı X-CfIpCountryRegion olarak ayarlayın.
   • Değer'i ip.src.subdivision_1_iso_code olarak ayarlayın.
5. Dönüşüm Kuralını dağıtın.
6. Kuralın uygulanması için birkaç dakika bekleyin. Tarayıcıda şu adrese giderek kurulumu doğrulayın: https://example.com/metrics/?validate_geo=healthy. Sayfada ok okuması gerekir.

(İsteğe bağlı) Ziyaretçi IP başlıklarını kaldırın

Birinci taraf modunun düzgün çalışması için ziyaretçi IP'si gerekmez. Tüm ziyaretçi IP üstbilgilerini Ziyaretçi IP üstbilgilerini kaldır Yönetilen Dönüşümler'i kullanarak kaldırabilirsiniz.

Diğer

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

1. GTM-123456.fps.goog öğesine işaret eden bir kaynak veya arka uç ekleyin.
2. Ana makine üstbilgisini GTM-123456.fps.goog değerine eşit olacak şekilde geçersiz kılın. Tüm çerezlerin ve sorgu dizelerinin yönlendirilmesine izin verin.
3. Trafiği birinci taraf moduna yönlendirmek üzere /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. Tarayıcıda şu adrese giderek kurulumu doğrulayın: https://example.com/metrics/healthy. Sayfada ok yazmalıdır.

3. Adım: Ölçüm Yolu'nu kullanmak için web sitesindeki komut dosyalarını güncelleyin

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

gtag.js

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

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

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

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

gtm.js

<head> bölümünün üst kısmında Etiket Yöneticisi snippet'ini aşağıdaki kodla 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 -->

4. Adım: Ölçüm ayarlarını test edin

Ölçüm ayarlarını test etmek için kapsayıcınızı, etkinleşen en az bir etikete sahip olacak şekilde yapılandırın.

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

2. Özet > Çıkış > Gönderilen İsabetler sekmesinde isabetlerin /metrics adresine yönlendirildiğini doğrulayın.

   

5. Adım: Geri Bildirim

Geri bildirim formunu kullanarak birinci taraf modu hakkında geri bildirim gönderin.