Reklamverenler için Google etiketi ağ geçidini ayarlama

Bu belge, reklamverenler için Google etiketi ağ geçidini dağıtmak isteyen kullanıcılar içindir. En dayanıklı etiket yapılandırması için reklamverenlere yönelik Google etiketi ağ geçidini kullanmanızı öneririz.

Genel Bakış

Reklamverenler için Google etiketi ağ geçidi, Google etiketini web sitenizin alanında barındırılan kendi birinci taraf altyapınızı kullanarak dağıtmanıza olanak tanır. Bu altyapı, web siteniz ile Google'ın hizmetleri arasında yer alır. Bu dokümanda yer alan 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 tetiklendiğinde ölçüm isteklerini doğrudan Google ürününe gönderir. Reklamverenler için Google etiketi ağ geçidi kullanıldığında web siteniz, Google etiketini birinci taraf alanınızdan yükler. Etiket tetiklendiğinde, bazı ölçüm istekleri birinci taraf alanınız kullanılarak Google'a gönderilir.

Bu şema, reklamverenler için Google etiketi ağ geçidindeki bilgi akışını gösterir:

Başlamadan önce

Bu kılavuzda, web sitenizin aşağıdakilerle yapılandırıldığı 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. Ölçüm yollarını seçme

Her etiketin veya Google Etiket Yöneticisi kapsayıcısının yayınlanması için web sitenizin alanında benzersiz bir ölçüm yolu ayırmanız gerekir.

Ölçüm Yolu Şartları:

• Yollar, alanınızda zaten kullanılmıyor olmalıdır.
• Her yol, kök yol / olmamalıdır.
• Her yol 100 karakteri aşmamalıdır.

Google Etiket Yöneticisi:

Google Etiket Yöneticisi'ni kullanıyorsanız yalnızca kapsayıcı kimliğinizi (ör. GTM-XXXXXX) sağlamanız gerekir. Bu tek kurulum, söz konusu kapsayıcıya önceden eklenmiş tüm etiketler (Google Analytics, Google Ads vb.) için yeterlidir.

Her benzersiz kapsayıcı veya bağımsız etiket için benzersiz bir yayın yolu ve buna karşılık gelen kimlik gerekir.

Reklamverenler için Google etiketi ağ geçidini ayarlamak üzere sitenizde kullanılmayan bir yol seçin. Sitede zaten bulunan bir yolla çakışma olasılığını azaltmak için harf ve rakamların herhangi bir kombinasyonunu seçebilir veya daha okunabilir bir yol istiyorsanız /gtm, /metrics, /analytics gibi bir kelime ya da istediğiniz başka bir kelimeyi kullanabilirsiniz.

Örneğin:

Kullanım Örneği	Kimlik	Etiket sunma yolu	Kaynak uç nokta
Bağımsız Etiket 1	G-12345	/abjfo/	g-12345.fps.goog/abjfo/
Bağımsız Etiket 2	G-67890	/fjdso/	g-67890.fps.goog/fjdso/
GTM Kapsayıcısı	GTM-ABCDEF	/cvfjk/	gtm-abcdef.fps.goog/cvfjk/

Bu belgedeki örnekleri doldurmak için aşağıdakileri girin.

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

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

Birden fazla etiket veya kapsayıcıyı işleme:

Etiketleriniz aynı GTM kapsayıcısında bulunuyorsa bu kurulumu tekrarlamanız gerekmez. Tek bir Google Etiket Yöneticisi kapsayıcısı eklemeniz yeterlidir. İçindeki tüm etiketler işlenir.

Etiketleriniz ayrı GTM kapsayıcılarında bulunuyorsa VEYA bağlantıları kaldırılmışsa... Bu kurulumu her örnek için tekrarlamanız gerekir. Bu, aşağıdakileri yayınlıyorsanız geçerlidir:

• Birden fazla, ayrı Google Etiket Yöneticisi kapsayıcısı.
• Ayrı etiketler (ör. G-XXXXXX) olanlar.

Bunu yaptığınızda her kapsayıcıya veya etikete benzersiz bir etiket yayınlama yolu atamanız gerekir.

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 Cloud

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 ucu 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 Zaman aşımı'nı önceden doldurulmuş değer olarak bırakın.
   • Arka uçlar bölümünde İnternet ağ uç noktası grubu açılır listesini tıklayın ve yeni bir internet ağ uç noktası grubu oluşturun:
     • Ağ uç noktası grubu türü'nü İnternet NEG'si (Global, Bölgesel) olarak ayarlayın.
     • Kapsam'ı Global olarak ayarlayın.
     • Ekleme şekli'ni Tam nitelikli alan adı ve bağlantı noktası olarak ayarlayın.
     • Tam nitelikli alan adı'nı G-12345.fps.goog olarak ayarlayın.
     • Uç nokta oluşturmak için CREATE'i (Oluştur) 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-Forwarded-Country	{client_region}
     X-Forwarded-Region	{client_region_subdivision}

   • Diğer ayarları inceleyin. Bu entegrasyon için Cloud CDN veya Cloud Armor gerekli değildir. Bu nedenle, her 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	Yol	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 bulunmalı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 Google etiket ağ geçidinde yayınlamak için yeni bir alt alan adı için CNAME girişi oluşturacak, istekleri yönlendirmek üzere bir Origin Rule oluşturacak ve coğrafi konum bilgilerini eklemek için bir Transform Rule oluşturacaksınız. Bu kurulumu tamamlamak için Cloudflare Enterprise planınızın olması gerekir. Enterprise planınız yoksa bunun yerine Cloudflare otomatik kurulumu'nu kullanmayı düşünebilirsiniz.

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ğıdakileri girin. Bu CNAME, Cloudflare yapılandırmanızın dışında hiçbir zaman gösterilmez. Bu nedenle, ad rastgeledir.

CNAME subdomain: fps

1. DNS sekmesinde Kayıtlar bölümünü açın.
2. Aşağıdaki yapılandırmayla yeni bir kayıt ekleyin:
   • Type (Tür) alanını 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. Kural adı girin (ör. Route measurement).
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ı Şununla yeniden yaz: olarak güncelleyin. G-12345.fps.goog.
6. DNS kaydını Geçersiz kılma... 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 tüm joker karakterli yollardan 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 ifadesi yer almalıdır.

Coğrafi konum bilgilerini ekleyin

1. Kurallar sekmesinde Ayarlar'ı açın.
2. Ziyaretçi konumu üstbilgilerini ekle seçeneğini etkinleştirin.
3. Kuralın yayı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.

Akamai

Etiketinizi reklamverenler için Google etiketi ağ geçidinde yayınlamak üzere, istekleri yönlendirmek ve coğrafi konum bilgisi eklemek için mülkünüze yeni bir kural eklemeniz gerekir.

Yönlendirme kuralını oluşturma

1. Mülk Yöneticisi'nde yayın yapılandırmanızın yeni bir sürümünü oluşturma
2. Mülk Yapılandırma Ayarları bölümünde yeni bir Rule ekleyin.
   • Route measurement gibi bir ad girin.
3. Yeni bir Maç ekleme
   • Eşleşme açılır listelerini Yol ve şunlardan biri olarak ayarlayın.
   • Eşleşme değerini /metrics/* olarak ayarlayın.
4. Yeni bir Davranış ekleme
   • Standart Mülk Davranışı'nı seçin ve Kaynak Sunucu davranışını belirleyin.
   • Origin Server Hostname'i (Kaynak Sunucu Ana Makine Adı) G-12345.fps.goog olarak ayarlayın.
   • Forward Host Header (Ana Makine Başlığını Yönlendir) seçeneğini Origin Hostname (Kaynak Ana Makine Adı) olarak ayarlayın.
5. Yeni kuralı kaydedin ve değişikliklerinizi dağıtın
   • Üretimde kullanıma sunmadan önce yeni yönlendirme kuralını hazırlık ortamınızda test ettiğinizden emin olun.
   • İpucu: Giden yanıt başlıklarını değiştiren veya kaldıran bir kuralınız olmadığından emin olun. Content-Type yanıt başlığı eksikse bu durum, Google komut dosyalarının başarısız olmasına neden olabilir.

Coğrafi konum bilgilerini ekleyin

1. Mülk Yapılandırma Ayarları bölümünde Yönlendirme kuralınızı (yukarıda oluşturulan) seçin.

2. Yeni bir davranış ekleme

   • Standart Mülk Davranışı'nı seçin ve İçerik Hedefleme (EdgeScape) davranışını belirleyin.
   • Etkinleştir'i true olarak ayarlayın.

3. Yeni davranışı kaydedin ve değişikliklerinizi dağıtın.

   • Üretimde kullanıma sunmadan önce yeni yönlendirme kuralını hazırlık ortamınızda test ettiğinizden emin olun.

4. Bir tarayıcıda https://example.com/metrics/healthy adresine giderek kurulumu doğrulayın. Sayfada ok metni bulunmalı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.

Amazon CloudFront

Not: Amazon CloudFront ile reklamverenler için Google etiketi ağ geçidi beta sürümündedir. Kurulumunuzla ilgili bir sorunuz veya sorununuz varsa [e-mail] adresinden bize ulaşın.

Etiketinizi reklamverenler için Google etiketi ağ geçidi ile yayınlamak üzere, istekleri yönlendirmek ve coğrafi konum bilgileri eklemek için dağıtımınızın davranışını yapılandırmanız gerekir.

Yeni bir kaynak ekleme

1. Amazon Web Services'deki (AWS) CloudFront sayfasına gidin.
2. CloudFront Dağıtımınızı seçin.
3. Kaynaklar sekmesinde aşağıdaki ayarlarla bir kaynak oluşturun:
   • Kaynak alanını G-12345.fps.goog olarak ayarlayın.
   • Protokol'ü Yalnızca HTTPS olarak ayarlayın.

Yönlendirme davranışını oluşturma

1. AWS'de CloudFront sayfasına gidin.
2. CloudFront Dağıtımınızı seçin.
3. Davranışlar sekmesinde aşağıdaki ayarlarla yeni bir Davranış oluşturun:
   • Yol deseni'ni /metrics/* olarak ayarlayın.
   • Kaynak ve kaynak grupları'nı G-12345.fps.goog olarak ayarlayın.
   • Nesneleri otomatik olarak sıkıştır'ı Hayır olarak ayarlayın.
   • Görüntüleyici protokolü politikasını Yalnızca HTTPS olarak ayarlayın.
   • İzin Verilen HTTP Yöntemleri'ni GET, HEAD, OPTIONS, PUT, POST, PATCH, DELETE olarak ayarlayın.
   • Önbellek anahtarı ve kaynak istekleri bölümünde Önbellek politikası ve kaynak isteği politikası'nı seçin.
     • Önbellek politikası'nı CachingDisabled olarak ayarlayın.
     • Kaynak isteği politikasını AllViewerExceptHostHeader olarak ayarlayın.
4. Davranış listesinde, yeni davranışın Precedence değerinin diğer tüm davranışlardan yüksek olduğunu doğrulayın.
   • Precedence seçeneğini değiştirmek için davranışınızı seçin ve Yukarı taşı düğmesini diğer tüm davranışlardan daha yukarıda olana kadar tıklayın.
5. Bir tarayıcıda https://example.com/metrics/healthy adresine giderek kurulumu doğrulayın. Sayfada ok ifadesi yer almalıdır.

Coğrafi konum bilgilerini ekleyin

1. Gerekli coğrafi konum bilgilerini yönlendirmek için yönlendirme davranışınızda Üstbilgiler'i AllViewerExceptHostHeader olarak ayarlayın.
   • CloudFront izleyici konum başlıklarının tam listesi bu makalede ayrıntılı olarak açıklanmıştır.
2. Dağıtımınızın yayınlanması için birkaç dakika bekleyin. Bir tarayıcıda, kurulumu doğrulamak için şu adrese gidin: https://example.com/metrics/?validate_geo=healthy. Sayfada ok yazmalıdır.

Diğer

Etiketinizi reklamverenler için Google etiketi ağ geçidinde yayınlamak üzere CDN'nizi veya yük dengeleyicinizi istekleri reklamverenler için Google etiketi ağ geçidi 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 değerine eşit olacak şekilde geçersiz kılın. Tüm çerezlerin ve sorgu dizelerinin yönlendirilmesine izin verin.
3. Aşağıdaki üstbilgilerden birini ekleyerek ziyaretçinin coğrafi konum bilgilerini iletin:
   • X-Forwarded-CountryRegion - Kullanıcının ülkesi ve bölgesi tek bir ISO 3166-2 koduyla (örneğin: US-CA) belirtilir.
   • X-Forwarded-Country ve X-Forwarded-Region:
     • X-Forwarded-Country - Kullanıcının ülkesi, ISO 3166-1 alfa-2 kodu olarak (örneğin: US).
     • (İsteğe bağlı) X-Forwarded-Region: Kullanıcının bölge alt bölümü kodu (örneğin: CA).
   • Her iki başlık grubu da eklenirse X-Forwarded-CountryRegion kullanılır.
4. Trafiği reklamverenler için Google etiketi ağ geçidine yönlendirmek üzere /metrics/* için bir yol kuralı ekleyin.
5. Ayrılmış yolu varsayılan kuraldan daha yüksek önceliğe sahip olacak şekilde yapılandırın.
6. Bir tarayıcıda https://example.com/metrics/healthy adresine giderek kurulumu doğrulayın. Sayfada ok ifadesi yer almalıdır. https://example.com/metrics/?validate_geo=healthy adresine giderek coğrafi bilgilerin dahil edildiğini doğrulayın. Sayfada ok yazmalıdır.

3. adım: Web sitesindeki komut dosyalarını, ölçüm yolunu kullanacak şekilde 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ğinizin bulunduğu iki satırlık komut dosyasını 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>

gtm.js

<head> bölümünün en üstünde, Etiket Yöneticisi snippet'ini aşağıdakilerle 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 ayarları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ın önizlemesini yapın.
2. Etkinlikleri tetiklemek için web sitenizde gezinin.

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