Bu makale, Google komut dosyalarını kendi sunucularından yayınlayan geliştiricilere yöneliktir. Gelişmiş izin modu gibi özelliklerin kilidini açmak ve etiket davranışını kullanıcılarınızın bulunduğu yere göre kontrol etmek için etiketler için bölgeye özgü davranışı etkinleştirmenizi öneririz.
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ı yayınlamayı ayarlama
1. adım: İstek üstbilgisini ayarlayın
Aşağıdaki bölümlerde açıklandığı gibi, kullanıcının bölge bilgilerini içeren belirli istek üstbilgileri göndermeniz gerekir.
Aşağıdaki durumlarda doğrudan 2. adımdan başlayabilirsiniz:
- App Engine'i kullanıyorsanız App Engine, coğrafi konum üstbilgilerini otomatik olarak gönderir.
- Aşağıda listelenenlerden farklı bir altyapı sağlayıcısı kullanıyorsanız. Özel üstbilgi oluşturmanız gerekir.
GCP Yük Dengeleyici ile Cloud Run
Coğrafi konum bilgilerini tüm HTTP istek üst bilgileriyle veya belirli istekler için gönderebilirsiniz. Özel istek üst bilgileri eklemek 1 milyon istek başına ücret alınmasına neden olacağından, yalnızca Google komut dosyalarının yayınlanmasını isteyen istekler için coğrafi bilgileri eklemenizi öneririz. Bu seçenek başlangıçta daha fazla kurulum gerektirir ancak altyapınızı mümkün olduğunca ekonomik bir şekilde çalıştırmanıza yardımcı olur.
Komut dosyası istekleri
Coğrafi başlıkları yalnızca komut dosyası isteklerine dahil etmek için yeni bir arka uç oluşturmanız ve yönlendirme kuralları oluşturmanız gerekir.
Yeni bir arka uç oluşturmak için:
- GCP yük dengeleyiciyi açın
- Yük dengeleyicinizde Arka uç yapılandırması bölümünü açın. Yeni bir arka uç hizmeti oluşturun.
- 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.
- Gelişmiş yapılandırmalar bölümünü açın. Özel istek üstbilgilerini ekleyin.
Başlık Adı Üstbilgi Değeri X-Gclb-Country {client_region} X-Gclb-Region {client_region_subdivision} - Yeni arka uç hizmetini kaydedin.
Yönlendirme kurallarını yapılandırmak için:
- Yük dengeleyicinizde Yönlendirme kuralları bölümünü açın. Gelişmiş ana makine yolu ve kuralı modunu seçin.
gtm.js,/gtag/jsve/gtag/destinationparametrelerini yeni arka uç hizmetiyle eşlemek içinpathRulesparametresini güncelleyin.
pathRules: - paths: - /gtm.js - /gtag* service: projects/project_id/global/backendServices/new backend service - paths: - /* service: projects/project_id/global/backendServices/original backend service
- Değişikliklerinizi kaydedin.
Tüm istekler
Coğrafi konum bilgilerini tüm HTTP istekleriyle 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 başlık için yeni bir ö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 üst bilgileriyle veya belirli istekler için gönderebilirsiniz. Özel istek üst bilgileri eklemek 1 milyon istek başına ücret alınmasına neden olacağından, yalnızca Google komut dosyalarının yayınlanmasını isteyen istekler için coğrafi bilgileri eklemenizi öneririz. Bu seçenek başlangıçta daha fazla kurulum gerektirir ancak altyapınızı mümkün olduğunca ekonomik bir şekilde çalıştırmanıza yardımcı olur.
Komut dosyası istekleri
Coğrafi başlıkları yalnızca komut dosyası isteklerine dahil etmek için yeni bir arka uç oluşturmanız ve yönlendirme kuralları oluşturmanız gerekir.
Yeni bir arka uç oluşturmak için:
- GCP yük dengeleyiciyi açın
- Yük dengeleyicinizde Arka uç yapılandırması bölümünü açın. Yeni bir arka uç hizmeti oluşturun.
- 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.
- Gelişmiş yapılandırmalar bölümünü açın. Özel istek üstbilgilerini ekleyin.
Başlık Adı Üstbilgi Değeri X-Gclb-Country {client_region} X-Gclb-Region {client_region_subdivision} - Yeni arka uç hizmetini kaydedin.
Yönlendirme kurallarını yapılandırmak için:
- Yük dengeleyicinizde Yönlendirme kuralları bölümünü açın. Gelişmiş ana makine yolu ve kuralı modunu seçin.
gtm.js,/gtag/jsve/gtag/destinationparametrelerini yeni arka uç hizmetiyle eşlemek içinpathRulesparametresini güncelleyin.
pathRules: - paths: - /gtm.js - /gtag* service: projects/project_id/global/backendServices/new backend service - paths: - /* service: projects/project_id/global/backendServices/original backend service
- Değişikliklerinizi kaydedin.
Tüm istekler
Coğrafi konum bilgilerini tüm HTTP istekleriyle 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 başlık için yeni bir ö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 bir kaynak istek politikası oluşturun.
Bu işlem, aşağıdaki üstbilgileri değerleriyle birlikte otomatik olarak ekler:
| Başlık 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 Motoru'nu kullanarak aşağıdaki eşlemeyle istek başlığını değiştir işlemini içeren bir kural grubu oluşturun:
| Başlık Adı | Üstbilgi Değeri |
|---|---|
| X-Azure-Country | {geo_country} |
Cloudflare
Yönetilen dönüştürme işlemleri bölümünde "Ziyaretçi konumu üstbilgileri ekle"yi etkinleştirin:
Bu işlem, aşağıdaki başlığı değeriyle birlikte otomatik olarak ekler:
| Başlık 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 konum üst bilgilerini yukarıda belirtildiği gibi ayarladıysanız Etiket Yöneticisi, HTTP istek üst bilgisini okuyarak bölgeyi veya ülkeyi otomatik olarak algılar. Alternatif olarak özel üstbilgiler de ayarlayabilirsiniz.
Otomatik algılama
- Google Etiket Yöneticisi'ni açın
- Sunucu kapsayıcınızı açın.
- Değişkenler menüsünde, yerleşik değişkenler listesini Yapılandır.
- Ziyaretçi Bölgesi'ni seçin.
Coğrafi üstbilgiler artık Ziyaretçi Bölgesi değişkeninde kullanılabilir.
Özel üstbilgiler
- Google Etiket Yöneticisi'ni açın
- Sunucu kapsayıcınızı açın.
- Değişkenler menüsünde, Ziyaretçi Bölgesi türünde Yeni bir kullanıcı tanımlı değişken oluşturun.
- Değişken Yapılandırması'nda Özelleştirilebilen Değişken'i seçin.
Değişkenler menüsünde iki yeni İstek başlığı değişkeni oluşturun: Biri ülkeniz için, diğeri alt bölüm kodu için. Değerleri, HTTP istek üst bilgilerinizdeki ülke kodlarıyla doldurun.
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.
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 istemcinize eklemeniz gerekir.
Bölge ayarını uygulamak istediğiniz müşteriyi seçin veya yeni bir müşteri oluşturun. Desteklenen istemciler şunlardır:
- Google Etiket Yöneticisi: Web kapsayıcısı
- Google Analytics: GA4
GA4 istemcileri yapılandırıyorsanız Belirli kimliklere ait varsayılan gtag.js yolları kutusunu işaretleyin ve web kapsayıcınızın ölçüm kimliğini girin.
Bölgeye özgü ayarları etkinleştir'i işaretleyin. Önceki adımda oluşturduğunuz {{Visitor Region}} değişkenini Bölge alanına ekleyin.
Müşterinizin kaydını yapın.
4. Adım: Bölge ayarlarının geçerli olduğunu doğrulayın
Ayarlarınızın çalışıp çalışmadığını test etmek için:
- Sunucu kapsayıcınız için Önizleme modunu açın.
- Birinci taraf sunma özelliğini kullanırken web sitenizi yükleyin.
- Önizleme penceresinde, Google Analytics GA4 istemcisini Talep edildi olarak tıklayın.
- Gerçek bölgeyi görmek için Değişkenleri Göster radyo düğmesini değerler olarak değiştirin.
- Bölge mülkü bir ülke kodu gösteriyorsa uygulamanız doğrudur.
- ❌ Bölge mülkü
undefinedgö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.