Etiketler için bölgeye özgü davranışı etkinleştir

Bu makale, Google komut dosyalarını kendi sunucularından sunan geliştiriciler içindir. Gelişmiş izin modu gibi özelliklerden yararlanmak ve etiket davranışını kullanıcılarınızın bulunduğu yere göre kontrol etmek için etiketlerde bölgeye özgü davranışı etkinleştirmenizi öneririz.

Birinci taraf alanından komut dosyası sunuyorsanız event_location.country ve event_location.region parametrelerini kullanabilmek için istek başlığında kullanıcının coğrafi konum bilgilerini sağlamanız gerekir. İstek başlığında varsa coğrafi konumun belirlenmesinde IP adresi öncelikli olur. Aksi takdirde, ülke ve bölge bilgilerini göndermek için sırasıyla event_location.country ve event_location.region parametreleri kullanılır.

Not: gtm.js veya gtag.js, www.googletagmanger.com üzerinden yayınlanıyorsa kullanıcının IP adresi ve coğrafi konum bilgileri komut dosyası isteğine dahil edilir ancak yalnızca coğrafi konum bilgileri kullanılır. IP adresi sunucu kapsayıcısında düzeltilmişse düzeltilmiş olarak kalır ancak bölge ve ülke bilgileri modelleme için kullanılır. Bunları kaldırmak için dönüştürme özelliğini kullanabilirsiniz.

Başlamadan önce

Bu rehberde, aşağıdakileri yaptığınız varsayılmaktadır:

• Etiket Yöneticisi'nde sunucu kapsayıcısı oluşturma
• Etiketleme sunucusu oluşturma
• Birinci taraf komut dosyası sunma özelliğini ayarlama

1. adım: İstek başlığını ayarlayın

Aşağıdaki bölümlerde açıklandığı gibi, kullanıcının bölge bilgilerini içeren belirli istek başlıkları göndermeniz gerekir.

Aşağıdaki durumlarda doğrudan 2. adımdan başlayabilirsiniz:

• App Engine'i kullanıyorsanız App Engine, coğrafi üstbilgileri otomatik olarak gönderir.
• Aşağıda listelenenlerden farklı bir altyapı sağlayıcı kullanıyorsunuz. Özel üstbilgiler ayarlamanız gerekir.

GCP yük dengeleyici ile Cloud Run

Coğrafi konum bilgilerini tüm HTTP istek başlıklarıyla veya belirli istekler için gönderebilirsiniz. Özel istek üst bilgileri eklemek, 1 milyon istek başına ücretlendirileceğinden Google komut dosyalarına hizmet verme istekleri için yalnızca coğrafi bilgileri eklemenizi öneririz. Bu seçenek başlangıçta daha fazla kurulum gerektirse de altyapınızı mümkün olduğunca ekonomik bir şekilde çalıştırmanıza yardımcı olur.

Komut dosyası istekleri

Yalnızca komut dosyası istekleri için coğrafi üstbilgileri eklemek istiyorsanız yeni bir arka uç ayarlamanız ve yönlendirme kuralları oluşturmanız gerekir.

Yeni bir arka uç oluşturmak için:

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 yapılandırın:
   • Arka uç türü: Uygulamanızın kullandığı ağ uç noktası grubu türünü seçin. Cloud Run kullanıyorsanız Sunucusuz ağ uç noktası grubu'nu seçin.
   • Yeni arka uç bölümünde, sunucu tarafı Etiket Yöneticisi dağıtımınızın ağ uç noktası grubunu seçin.
     
4. Gelişmiş yapılandırmalar bölümünü açın. Özel istek üstbilgilerini ekleyin.
   

   Üstbilgi Adı	Üstbilgi Değeri
   X-Gclb-Country	{client_region}
   X-Gclb-Region	{client_region_subdivision}

5. Yeni arka uç hizmetini kaydedin.

Yönlendirme kurallarını yapılandırmak için:

1. Yük dengeleyicinizde Yönlendirme kuralları bölümünü açın. Gelişmiş ana makine yolu ve kuralı modunu seçin.
2. pathRules, /gtag/js ve /gtag/destination parametrelerini yeni arka uç hizmetiyle eşlemek için pathRules parametresini güncelleyin.
   gtm.js

   pathRules:
   - paths:
     - /gtm.js
     - /gtag*
     service: projects/project_id/global/backendServices/new backend service
   - paths:
     - /*
     service: projects/project_id/global/backendServices/original backend service

3. Değişikliklerinizi kaydedin.

Tüm istekler

Tüm HTTP istekleriyle coğrafi konum bilgisi göndermek için mevcut arka uç hizmetine özel istek üst bilgileri eklemeniz gerekir. Google Cloud dokümanlarına bakın. Aşağıdaki her üstbilgi için bir yeni özel istek üstbilgisi oluşturun:

Başlık adı	Üstbilgi Değeri
X-Gclb-Country	{client_region}
X-Gclb-Country	{client_region_subdivision}

GCP yük dengeleyici

Coğrafi konum bilgilerini tüm HTTP istek başlıklarıyla veya belirli istekler için gönderebilirsiniz. Özel istek üst bilgileri eklemek, 1 milyon istek başına ücretlendirileceğinden Google komut dosyalarına hizmet verme istekleri için yalnızca coğrafi bilgileri eklemenizi öneririz. Bu seçenek başlangıçta daha fazla kurulum gerektirse de altyapınızı mümkün olduğunca ekonomik bir şekilde çalıştırmanıza yardımcı olur.

Komut dosyası istekleri

Yalnızca komut dosyası istekleri için coğrafi üstbilgileri eklemek istiyorsanız yeni bir arka uç ayarlamanız ve yönlendirme kuralları oluşturmanız gerekir.

Yeni bir arka uç oluşturmak için:

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 yapılandırın:
   • Arka uç türü: Uygulamanızın kullandığı ağ uç noktası grubu türünü seçin. Cloud Run kullanıyorsanız Sunucusuz ağ uç noktası grubu'nu seçin.
   • Yeni arka uç bölümünde, sunucu tarafı Etiket Yöneticisi dağıtımınızın ağ uç noktası grubunu seçin.
     
4. Gelişmiş yapılandırmalar bölümünü açın. Özel istek üstbilgilerini ekleyin.
   

   Üstbilgi Adı	Üstbilgi Değeri
   X-Gclb-Country	{client_region}
   X-Gclb-Region	{client_region_subdivision}

5. Yeni arka uç hizmetini kaydedin.

Yönlendirme kurallarını yapılandırmak için:

1. Yük dengeleyicinizde Yönlendirme kuralları bölümünü açın. Gelişmiş ana makine yolu ve kuralı modunu seçin.
2. pathRules, /gtag/js ve /gtag/destination parametrelerini yeni arka uç hizmetiyle eşlemek için pathRules parametresini güncelleyin.
   gtm.js

   pathRules:
   - paths:
     - /gtm.js
     - /gtag*
     service: projects/project_id/global/backendServices/new backend service
   - paths:
     - /*
     service: projects/project_id/global/backendServices/original backend service

3. Değişikliklerinizi kaydedin.

Tüm istekler

Tüm HTTP istekleriyle coğrafi konum bilgisi göndermek için mevcut arka uç hizmetine özel istek üst bilgileri eklemeniz gerekir. Google Cloud dokümanlarına bakın. Aşağıdaki her üstbilgi için bir yeni özel istek üstbilgisi oluşturun:

Başlık adı	Üstbilgi Değeri
X-Gclb-Country	{client_region}
X-Gclb-Country	{client_region_subdivision}

Amazon Web Services (AWS) CloudFront

İsteğe CloudFront-Viewer-Country ve CloudFront-Viewer-Country-Region üstbilgisini eklemek için kaynak isteği politikası oluşturun.

Bu işlem, aşağıdaki üstbilgileri değerleriyle birlikte otomatik olarak ekler:

Üstbilgi Adı	Üstbilgi Değeri
CloudFront-Viewer-Country	Kullanıcının ülkesi
CloudFront-Viewer-Country-Region	Kullanıcının alt bölümü

Azure Front Door

Kural motorunu kullanarak aşağıdaki eşlemeyle istek başlığını değiştir işlemine sahip bir kural grubu oluşturun:

Üstbilgi Adı	Üstbilgi Değeri
X-Azure-Country	{geo_country}

Cloudflare

Yönetilen dönüşümler bölümünde "Ziyaretçi konumu üstbilgilerini ekle" seçeneğini etkinleştirin:

Bu işlem, aşağıdaki başlığı değeriyle birlikte otomatik olarak ekler:

Üstbilgi Adı	Üstbilgi Değeri
CF-IPCountry	Kullanıcının ülkesi

2. adım: Ziyaretçi Bölgesi değişkenini ayarlayın

Coğrafi üstbilgileri yukarıda belirtildiği gibi ayarladıysanız Etiket Yöneticisi, HTTP istek başlığını okuyarak bölgeyi veya ülkeyi otomatik olarak algılar. Alternatif olarak, özel üstbilgiler de ayarlayabilirsiniz.

Otomatik algılama

1. Google Etiket Yöneticisi'ni açın.
2. Sunucu kapsayıcınızı açın.
3. Değişkenler menüsünde, yerleşik değişkenler listesini Yapılandırın.
4. Ziyaretçi Bölgesi'ni seçin.

Coğrafi üstbilgiler artık Ziyaretçi Bölgesi değişkeninde kullanılabilecek.

Özel üstbilgiler

1. Google Etiket Yöneticisi'ni açın.
2. Sunucu kapsayıcınızı açın.
3. Değişkenler menüsünde Ziyaretçi Bölgesi türünde Yeni bir kullanıcı tanımlı değişken oluşturun.
4. Değişken Yapılandırması'nda Özel Değişken'i seçin.

5. Değişkenler menüsünde iki yeni İstek başlığı değişkeni oluşturun: Biri ülkeniz, diğeri ise alt bölüm kodu için. Değerleri HTTP isteği başlıklarınızdaki ülke kodlarıyla doldurun.

   Not: Biçim, ISO-3166-2'ye uygun olmalıdır.

6. Oluşturduğunuz değişkenleri, ekran görüntüsünde gösterildiği gibi Ziyaretçi Bölgesi değişkeninde kullanın.

   

7. Değişkeninize ad verip Kaydet'i tıklayın.

3. adım: İstemcinizde bölgeye özgü ayarları etkinleştirin

Gelen HTTP isteklerini işlemek için ziyaretçi bölgesini kullanmak istiyorsanız bunu istemcinize eklemeniz gerekir.

1. Google Etiket Yöneticisi: Web kapsayıcısı istemcisini seçin.

2. Bölgeye özgü ayarları etkinleştir'i işaretleyin. Önceki adımda oluşturduğunuz {{Ziyaretçi Bölgesi}} değişkenini Bölge alanına ekleyin.

3. Müşterinizi kaydedin.

4. adım: Bölge ayarlarının uygulandığını doğrulayın

Ayarlarınızın çalışıp çalışmadığını test etmek için:

1. Sunucu kapsayıcınız için önizleme modunu açın.
2. Birinci taraf sunma özelliğini kullanırken web sitenizi yükleyin.
3. Önizleme penceresinde, Hak talebinde bulunulan Google Analytics GA4 istemcisini tıklayın.
4. Gerçek bölgeyi görmek için Değişkenleri Göster radyo düğmesini değerler olarak değiştirin.
   • ✅ Bölge özelliği bir ülke kodu gösteriyorsa uygulamanız doğrudur.
   • ❌ Bölge özelliği undefined gösteriyorsa veya eksikse sunucunuz herhangi bir bölge verisi almıyor demektir. Sunucunun HTTP başlıklarının, Google Etiket Yöneticisi'nin aradığı önceden tanımlanmış değişkenlere göre ayarlanıp ayarlanmadığını kontrol edin. İstek başlığını ayarlama başlıklı makaleyi inceleyin.

Sonraki adımlar

• Web kapsayıcısında belirli bir bölge için izin modunu ayarlama