Özel alan yapılandırması

Bu makale, sunucu tarafı etiketlemeyi web siteleriyle aynı birinci taraf bağlamında barındırmak isteyen geliştiriciler için hazırlanmıştır. Aynı kaynaktan sunma, sunucu tarafından ayarlanan çerezlerin güvenlik ve dayanıklılık avantajlarından yararlanmanızı sağlayan en iyi uygulamadır. Aşağıdaki talimatlar, sitenizde dağıtılan Google etiketinden (gtag.js veya gtm.js) bağımsız olarak aynı kaynaktan yayın oluşturma işlemi için geçerlidir.

İlk kez oluşturduğunuz etiketleme sunucusu, bulut sağlayıcı tarafından sağlanan bir alanda barındırılır. Varsayılan uç noktayı kullandığınızda, sunucu kapsayıcısına veri gönderir ancak üçüncü taraf bağlamında çalışır. Birinci taraf bağlamının avantajlarından (ör. daha uzun ömürlü çerezler) yararlanmak için etiketleme sunucunuzun ve web sitenizin aynı alanda çalışması gerekir.

Aşağıdaki tabloda, üst web sitesi www.example.com'te barındırıldığında etiketleme sunucusunu nasıl barındırabileceğiniz gösterilmektedir:

Aynı kaynak (en iyi uygulama) Alt alan adı Varsayılan alan
Örnek URL https://www.example.com/metrics https://metrics.example.com https://metrics.run.app
Sunucu tarafından ayarlanan çerez erişimi Güvenlik ve dayanıklılık avantajlarına tam erişim. Güvenlik ve dayanıklılık avantajlarına tam erişim. Yok. Yalnızca JavaScript çerezleri ayarlanabilir.
Kurulum karmaşıklığı İstekleri yönlendirmek için bir CDN veya yük dengeleyici yapılandırın. DNS girişlerini güncellemeniz gerekebilir. DNS girişlerini güncelleyin. Önceden yapılandırılmış olarak gelir.

Başlamak için uygulama seçeneğinizi belirleyin.

Ön koşullar

Bu rehberde, aşağıdaki şartları karşıladığınız varsayılır:

  • Etiket Yöneticisi'nde sunucu kapsayıcısı oluşturma
  • Etiketleme sunucusu oluşturma
  • İstekleri yönlendirebilen bir CDN veya yük dengeleyici.
  • App Engine kullanıyorsanız: Etiketleme sunucusu 2.2.0 veya sonraki bir sürümü çalıştırmalıdır. Etiketleme sunucunuzu geleceğe hazır hale getirmek için Cloud Run'a geçin.

Özel alanı yapılandırma

Sunucu kapsayıcınızı, web sitenizle aynı alan adından bir yolda çalışacak şekilde ayarlayabilirsiniz. Örneğin, web siteniz web trafiği www.example.com adresinde sunuyorsa sunucu kapsayıcınız için www.example.com/metrics gibi bir yol ayırın.

Aynı kaynakta ayarlanan sunucu tarafı etiketlemeyi gösteren diyagram.

1. Etiketleme sunucunuz için kullanacağınız alan yolunu seçin

Bu yol, bu birinci taraf yayınlama uygulaması için ayrılır. Daha önce kullanmadığınız bir yol seçtiğinizden emin olun.

Kullanabileceğiniz yollara örnek olarak şunlar verilebilir: /collect, /metrics, /data

Bu yol dizesini not edin. Bunu sonraki adımlarda /metrics yerine /metrics gördüğünüz her yerde kullanacaksınız: /metrics

2. Trafiği etiketleme sunucunuza yönlendirin

Web siteniz halihazırda trafiği yollara göre yönlendirmeyi destekleyen bir CDN veya yük dengeleyici ile ayarlanmışsa 4. adıma atlayın.

  1. Web sitenize yönlendiren bir kaynak veya arka uç ekleyin.
  2. Ana makine üstbilgisini, web sitesinin ana makine adı (ör. example.com) olacak şekilde geçersiz kılın.
  3. Tüm çerezlerin ve sorgu dizelerinin yönlendirilmesine izin verin. Platformda bu seçenek yoksa platform muhtemelen bunu varsayılan olarak yapar.
  4. Etiketleme sunucunuzu işaret eden başka bir kaynak veya arka uç ekleyin. Bu, metrics.run.app gibi bulut sağlayıcı tarafından sağlanan alan adı olabilir.
  5. Ana makine üstbilgisini yukarıda belirtilen alan adına eşit olacak şekilde geçersiz kılın. Tüm çerezlerin ve sorgu dizelerinin yönlendirilmesine izin verin.
  6. Trafiği etiketleme sunucusuna yönlendirmek için /metrics/* gibi bir yol kuralı ekleyin.
  7. Ayrılmış sunucu tarafı etiketleme yolunu varsayılan kuraldan daha yüksek önceliğe sahip olacak şekilde yapılandırın.
  8. Henüz yapmadıysanız DNS'nizi CDN'ye veya yük dengeleyiciye işaret edecek şekilde güncelleyin. DNS güncellemelerinin yayılması biraz zaman alabilir.
  9. Yeni oluşturduğunuz alan adında (ör. https://example.com/metrics/healthy) /healthy uç noktasını ziyaret edin. ok simgesini görürsünüz.

3. Google Etiket Yöneticisi'nde sunucu URL'sini güncelleme

Sunucu kapsayıcı yapılandırmanızı, yol ön ekini tanımlayabilmesi ve istekleri doğru şekilde işleyebilmesi için güncellemeniz gerekir.

Yeni uç noktaya güncellemek için:

  1. Google Etiket Yöneticisi'ni açın.
  2. Web sitesiyle aynı kaynakta ayarlanan sunucu kapsayıcısını açın.
  3. Yönetici sekmesi > Kapsayıcı Ayarları bölümünde önceki tüm URL'leri kaldırın. Tüm sunucu kapsayıcı URL'lerinin aynı yolu paylaşması gerektiğinden bu işlem gereklidir.
  4. URL ekle'yi tıklayın ve yol ön eki dahil URL'nizi girin.
  5. Kaydet'i tıklayın ve çalışma alanınıza geri dönün.
  6. Yeni bir hata ayıklama oturumu başlatmak ve ayrı bir sekmede istek göndermek için Önizleme düğmesini tıklayın.
  7. Gönderilen isteği tıklayın. İstemcinizin gelen isteği talep ettiğinden emin olun.

Sık karşılaşılan sorunları giderme

  1. Önizleme, gelen istekleri göstermiyor
    1. Cloud projenizin günlük gezginine gidin. Sunucu tarafı etiketleme dağıtımının trafik aldığını doğrulayın. Gösterilmiyorsa 1. adımdaki talimatları uygulayın.
    2. CDN'nin veya yük dengeleyicinin çerezleri yönlendirdiğini onaylayın.
    3. Tek bir önizleme sunucunuz olduğunu ve etiketleme sunucularında PREVIEW_SERVER_URL ayarının bulunduğunu doğrulayın.
    4. PREVIEW_SERVER_URL + /healthy simgesine giderek önizleme sunucusunun çalıştığını doğrulayın. ok simgesini görürsünüz.
  2. İstemciler istekleri işleme almıyor: Ayrılmış yolu kullanmak için Container Ayarları'ndaki URL'yi güncelleyin. URL, yolu içermiyorsa veya farklıysa istemciler düzgün çalışmaz.