Google Tag Manager Server konteynerine özel bir alan adı nasıl eklenir

Ira Holubovska

Yazar

Güncellendi

May 18, 2026

yorumlar

Sohbete katılın

Ayrıca mevcut

EN ES RU DE FR PT UA IT NL

Bu makalede, sunucu Google Etiket Yöneticisi kapsayıcı içinde özel bir alanın nasıl kurulacağını anlatacağım. sGTM için özel bir alan adı kullanmanın ana avantajı, üçüncü taraf çerezleri yerine birinci taraf çerezleri ayarlayarak çerez ömrünü artırmaya yardımcı olmasıdır.

Özel bir etki alanını sGTM içinde eşlemenin faydaları

Sunucu tarafı etiketlemenin temel faydası, varsayılan olarak etkinleştirilmemiş olsa da, birinci taraf çerezlerinin ayarlanmasında yatmaktadır. Bu özellikten yararlanmak için sunucu tarafı GTM'nizde özel bir alan adı uygulamanız gerekir.

Chrome, üçüncü taraf çerezlerini destekleyen son tarayıcı olduğundan ve 2024'ün 1. çeyreğinde birinci taraf çerezlerinin aşamalı olarak kaldırılması şimdi üçüncü taraflar yerine birinci taraf çerezleri kullanmaya başlamanın tam zamanı.

sGTM tarafından ayarlanan çerezlerin kararlılığı ve uzun ömürlülüğü, özel bir alan adının nasıl uygulandığına bağlıdır. sGTM içinde üç tür gümrük etki alanı yapılandırması vardır.

You can use a custom tagging server URL to set up first-party cookies. Custom tagging server URL or custom domain should share the same domain as your website. For example, if your website domain is example.com, then the tagging server URL should look like ss.example.com.

Özel bir alan adı oluşturmanın üç yolu vardır:

Aynı köken
Alt alan adı
Varsayılan etki alanı

Watch "How to add a custom domain in the server Google Tag Manager container" on YouTube

Sunucu Google Etiket Yöneticisi kapsayıcısının içine özel bir alan adı nasıl eklenir?

İlk olarak, Google Etiket Yöneticisi sunucu kapsayıcısı oluşturmalı ve ayarlamalısınız. Eğer bir sunucu kapsayıcınız yoksa, bu talimatları izleyin.

Sunucu Google Etiket Yöneticisi kapsayıcısı için özel bir alan adını eşlemenin iki yolunu göstereceğiz:

Alt alan adı kullanarak.
Same origin kullanarak.

Alt alan adı kullanarak

Adım 1. Özel alan adınızı ekleyin

Stape'teki kapsayıcınızı seçin, aşağı kaydırın ve Add custom domain seçeneğine tıklayın.

Stape yönetim panelinde özel alan adı nasıl eklenir

Subdomain name ekleyin: istediğiniz herhangi bir adı kullanabilirsiniz; ancak reklamcılık veya izlemeyle ilgili ifadeler kullanmaktan kaçının: ad, gtm, stgm, tracking, analytics, metrics, stape, gtag vb.

Adım 2. CDN ekleyin

Content Delivery Network (CDN), web sitenizin varlıklarını küresel bir sunucu ağına dağıtarak farklı konumlardaki kullanıcılar için gecikmeyi azaltır ve yükleme sürelerini iyileştirir. Kitleniz coğrafi olarak dağınıksa veya çerez izlemeyi ve veri doğruluğunu geliştirmek istiyorsanız bu seçenek faydalı olacaktır.

Varsayılan olarak CDN devre dışıdır; bu, JavaScript dosyalarının (gtm.js, gtag.js ve analytics.js gibi) doğrudan sGTM kapsayıcınızın barındırıldığı sunucu konumundan sunulduğu anlamına gelir. Uygulamada bu, hem Stape Global CDN'i hem de Own CDN'i devre dışı bırakır ve siteniz ile sGTM kapsayıcısı arasında doğrudan, proxy'siz bir bağlantı sağlar.

Önemli: CDN kurmadan önce lütfen ülkenizdeki gizlilik düzenlemelerini göz önünde bulundurun.

CDN'i etkinleştirmek için Add CDN düğmesine tıklayın ve aşağıdaki seçeneklerden birini seçin:

Stape Global CDN: komut dosyalarını, web sitesi ziyaretçinizin konumuna en yakın sunucudan yükler; bu da gecikmeyi azaltır ve coğrafi olarak dağınık kitlelere yönelik sayfa yükleme sürelerini iyileştirir. Kurulumumuzda Stape Global CDN kullanacağız. Bu özellik ücretsizdir ve tüm Stape sGTM kapsayıcıları için kullanılabilir.

Own CDN (Automatically (via Entri) bağlantı seçeneğiyle uyumsuzdur): sGTM özel alan adını yönlendirmeye ve sGTM trafiğini web sitenizin DNS sağlayıcısı üzerinden proxy'lemeye yardımcı olur. Bu durumda web sitenizin ve sGTM özel alan adının IP adresleri eşleşir; sunucu tarafı çerezler birinci taraf olarak kabul edilir. Sonuç olarak çerez süresini artırma imkânı sunar.

Adım 3. Bağlantı yöntemini seçin

Ardından, How to connect bölümünde özel bir alan adını kapsayıcınıza bağlamanın iki yolu bulunur:

Automatically (via Entri)

Alan adlarını bağlamanın en kolay yolu. Entri aracılığıyla DNS sağlayıcı bilgilerinizle oturum açın ve alan adınızı bağlamamız için tek seferlik izin verin. Ardından alan adınızı doğrulamak için doğrudan Adım 5'e geçebilirsiniz; manuel yapılandırma gerekmez.

Manually

Bu seçenekte, alt alan adınızı Stape'e bağlamak için DNS kayıtlarını barındırma sağlayıcınıza manuel olarak eklemeniz gerekir.

Kapsayıcınıza özel bir alt alan adı ekledikten sonra, özel alan adını doğrulamak için oluşturulması gereken DNS kayıtlarını göreceksiniz. DNS kaydı, seçtiğiniz sunucu konumuna ve CDN seçeneğine göre değişir. Bir sonraki adımda DNS kayıtlarının nasıl ekleneceği gösterilmektedir.

Adım 4. DNS kayıtlarını ekleyin (manuel bağlantı yöntemi için)

Varsayılan olarak alt alan adı doğrulaması CNAME kayıtlarıyla yapılır; ancak gerektiğinde (özellikle yinelenen kayıt eklememek gerektiğinde) A ve AAAA kayıtlarıyla da doğrulama yapabilirsiniz.

Her iki seçeneği de Cloudflare kullanarak kayıt oluşturmaya ilişkin adım adım kılavuzla aşağıda ele alacağız. Herhangi bir başka sağlayıcıyı da kullanabilirsiniz.

CNAME kaydıyla özel alan adı ekleme

CNAME kayıt(ları) kurulumu

Stape Global CDN kullanmıyorsanız bir, kullanıyorsanız iki CNAME kaydı oluşturmanız gerekir.

1. Alan adı hizmetinize giriş yapın ve kullanmak istediğiniz alt alan adı için yeni bir DNS kaydı oluşturun. Bunun için hesap ana sayfasında alan

adınızın yanındaki üç noktaya tıklayın ve Configure DNS seçeneğini belirleyin.

2. Add record seçeneğine tıklayın.

3. Stape hesabınıza geri dönün ve hesapta gördüğünüz kaydı girin. Proxy status seçeneğinin kapalı (off) olduğundan emin olun.

Stape yönetim panelindeki CNAME kayıtları

Stape Global CDN kullandığımız için iki CNAME kaydı oluşturuyoruz:

A ve AAAA kayıtlarıyla özel alt alan adı ekleme

A/AAAA kayıtlarının etkin CDN ile uyumsuz olduğunu lütfen unutmayın.

A/AAAA kayıt kurulumu

1. Özel alt alan adınızı A ve AAAA kayıtlarıyla doğrulamanız gerekiyorsa özel alt alan adını kapsayıcıya ekleyin ve CDN düğmesinin kapalı (off) olduğundan emin olun.

Advanced settings seçeneğine tıklayın ve Use A records instead of CNAME records kutucuğunu işaretleyin. Stape kapsayıcınızda eklemeniz gereken DNS kayıtlarını göreceksiniz. Yapılandırmanız gereken DNS kayıtları, sunucu konumuna göre değişir.

"Use A records instead of CNAME records" onay kutusu

2. DNS hesabınıza giriş yapın ve Stape hesabınızda gördüğünüz kayıtları ekleyin. Hesap ana sayfasında alan adınızın yanındaki üç noktaya tıklayın ve Configure DNS seçeneğini belirleyin.

3. Add record seçeneğine tıklayın.

4. Ardından Stape hesabınızda gördüğünüz kayıtları oluşturun. Proxy status seçeneğinin kapalı (off) olduğundan emin olun.

DNS kayıtlarınız için değerleri Stape hesabından alın:

Stape yönetim panelindeki A/AAAA kayıtları

Sonuç olarak iki DNS kaydı elde edersiniz:

Adım 5. Alan adınızı doğrulayın

DNS kayıtlarını DNS sağlayıcınıza girdikten sonra, özel alan adını yapılandırdığınız Stape kapsayıcısı sayfasına geri dönün ve Verify düğmesine tıklayın.

Stape'in özel alan adınızı doğrulamasını bekleyin (kapsayıcı durum çubuğu Verifying'den Ready'ye değiştiğinde işlem tamamlanmış olur). Özel alan adı doğrulaması genellikle 2-3 saat sürer. Bazı DNS sağlayıcılarında kayıtların doğrulanması 72 saate kadar sürebilir. Özel alan adı doğrulandığında veya herhangi bir hata tespit edildiğinde size e-posta göndereceğiz.

Alan adı doğrulama konusunda sorun yaşarsanız lütfen özel alan adı sorun giderme kılavuzumuzu takip edin.

Adım 6. Etiketleme sunucusu URL'sini ekleyin ve web sitesi komut dosyasını güncelleyin

Google Tag Manager Sunucu kapsayıcınıza gidin → Admin → Container Settings → Tagging server URL'yi alt alan adınızla değiştirin.

Komut dosyasını güncelleme

Özel alan adı kullanıyorsanız, web sitenizdeki Web GTM komut dosyasını güncellemeniz kesinlikle önerilir. Bu değişiklik, gtm.js dosyasını alan adınızdan yükleyecektir. Bunu yapmak için varsayılan alan adı googletagmanager.com'u bir önceki adımda kurduğunuz özel alan adıyla değiştirin.

Alternatif olarak, bu süreci Custom Loader power-up ile otomatikleştirebilirsiniz. GTM komut dosyasını manuel olarak düzenlemek yerine Custom Loader, GTM ve GA4 komut dosyalarını doğrudan özel alan adınızdan yükleyen hazır bir kod parçacığı oluşturur. Bu, zamandan tasarruf etmenizi sağlar, izleme komut dosyalarınızı reklam engelleyicilere karşı daha dirençli hale getirir ve tüm çerezlerin birinci taraf olarak ele alınmasını güvence altına alır.

Aynı menşe alanı (Same origin domain)

Ön Koşullar

Başlamadan önce aşağıdakilerin hazır olduğundan emin olun:

Bir Stape üzerinde kurulu sunucu Google Tag Manager konteyneri.
Bir CDN veya yük dengeleyici – tüm site trafiğinizin yönlendirildiği, istekleri iletebilen bir CDN veya yük dengeleyici.
App Engine kullanıyorsanız, etiketleme sunucusu 2.2.0 veya ya da daha sonraki bir sürümü çalıştırmalıdır.

Not:

Bazı etiketlerin düzgün çalışması için CDN'niz önbelleğe alma veya sorgu dizesi sıralama uygulamamalıdır. Cloudflare'nin Query String Sort veya URL normalization, örneğin, bazı sunucu tarafı etiketler tarafından kullanılan sendPixelFromBrowser API'si ile çakışacaktır.

Aynı kaynak alan adını adım adım yapılandırma

Altyapınıza bağlı olarak, aynı kaynak özel alan adını farklı platform ve hizmetler kullanarak yapılandırabilirsiniz. Her biri için kılavuzlar aşağıdadır:

Not:

Yukarıda listelenmeyen bir platform kullanıyorsanız, önerilerinizi support@stape.io.

Aşağıda, Cloudflare'i örnek olarak kullanarak kurulum adımlarını inceleyeceğiz.

Bu seçeneğin çalışması için tüm site trafiğinizin Cloudflare üzerinden proxy'lenmesi gerekir – Cloudflare Workers işlevselliği daha sonra sGTM isteklerini de proxy'lemenize olanak tanır. Ayrıca SSL/TLS'yi Full modunda kullanmalısınız; aksi takdirde, aynı kaynak proxy'leme yanlış olan bir 301 yönlendirmesi üzerinden çalışabilir.

Adım 1. Cloudflare Worker oluşturma

Sol kenar çubuğunda Compute → Workers & Pages → Create application → Start with Hello World! seçeneğini belirleyin.

Adım 2. Worker'ı adlandırma ve dağıtma

Bir worker adı ekleyin → Deploy.

Adım 3. Worker kodunu düzenleme

sGTM özel alan adınız için path'i belirleyin – örneğin, example.com/sgtm, example.com/data veya example.com/metrics.

Worker ayarlarında Edit code'ye tıklayın ve aşağıdaki örneğe benzer bir JS yapıştırın; burada:

/metrics/ sunucu konteyneriniz için seçtiğiniz path'tir.
https://sst.stapedesk.com/ etiketleme sunucunuzun URL'sidir.

Etiketleme sunucusu URL'si için iki seçeneğiniz vardır:

[Önerilmez] Stape tarafından sağlanan varsayılan etiketleme sunucusu URL'si (örn. https://wapdsrl.ca.stape.io).
[Önerilir] Stape admin. Özel bir alt alan adı kullanmanın iki avantajı vardır: gtm.js ve gtag.js'yi Custom Loader power-up aracılığıyla özel bir path üzerinden yükler, böylece izleme betikleri engellenemez hale gelir ve uzun ömürlü birinci taraf çerezleri etkinleştirir.

Aynı kaynak etiketleme sunucusu URL'si olarak özel bir alt alan adı kullanıyorsanız, Stape'deki sGTM konteynerinize özel bir alan adı eklediğinizden ve gerekli DNS şekilde oluşturduğunuzdan emin olun. Aynı kaynak alan adı ile Own CDN kullanmayın.

export default {
  async fetch(request, env, ctx) {
    let { pathname, search, host } = new URL(request.url);
    pathname = pathname.replace('/metrics/', '/');
    const domain = 'sst.stapedesk.com';
    let newRequest = new Request((`https://` + domain + pathname + search), request);
    newRequest.headers.set('Host', domain);
    return fetch(newRequest);
  },
};

Değişikliklerinizi dağıtın ve kaydedin.

Adım 4. Worker'a route ekleme

sGTM worker'ınıza gidin → Settings → Domains & Routes → yeni bir Route oluşturun. Sunucu GTM için kullandığınız URL'yi * ile bitecek şekilde ekleyin (bizim örneğimizde bu stapedesk.com/metrics*'dir) ve alan adınızı bölge seçiminde seçin.

Adım 5. Yapılandırma Kuralı oluşturma

Alan adınızın yanındaki üç noktaya tıklayın → Configure Rules.

Create rule → Configuration Rules:

Anlaşılır bir kural adı belirtin, örn., sGTM same origin.
Custom filter expression.
URI Path başlangıcı /metrics (farklı bir path kullanıyorsanız bunu güncelleyin).
SSL → Full.

Deploy.

Adım 6. İstek Başlığı Dönüştürme Kuralı oluşturma

Rules → Overview → Create Rule → Request Header Transform Rule:

Açıklayıcı bir kural adı girin, örn., sGTM header.
Custom filter expression.
URI Path başlangıcı /metrics (farklı bir path kullanıyorsanız bunu güncelleyin).
Statik bir başlık adı olarak X-From-Cdn değeriyle cf-stape .

Kuralı kaydedin.

İstek Başlığı Dönüştürme Kuralı oluşturma

Adım 6.1. X-Stape-Host başlığını ekleme (özel alt alan adı kullanmıyorsanız)

Kendi alt alan adınızı kullanmıyorsanız ve istekleri standart Stape alt alan adına proxy'liyorsanız, X-Stape-Host başlığını da eklemeniz gerekir.

Rules → Overview → Create Rule → Request Header Transform Rule:

Açıklayıcı bir kural adı girin, örn., sGTM same origin Stape host.
Custom filter expression.
URI Path başlangıcı /metrics (farklı bir path kullanıyorsanız bunu güncelleyin).
Statik bir başlık adı olarak X-Stape-Host başlığını olayların gerçekleştiği sunucunun değeriyle (bizim örneğimizde stape.work).

Kuralı kaydedin.

Adım 7. Custom Loader'ı güncelleme

Aynı kaynak kurulumu tamamlandıktan sonra, reklam engelleyici koruması için Custom Loader power-up'ını güncellemenizi ve sitenize uygulamanızı da öneririz. İçinde Same Origin path'inizi belirtmeyi unutmayın.

Daha fazla bilgi için Custom Loader kılavuzumuza şekilde oluşturduğunuzdan emin olun.

Adım 8. Sunucu konteyneri URL'sini web ve sunucu GTM'e ekleme

1. Web GTM konteynerinizde Google Tag ekleyin ve Measurement ID'nizi belirtin (test için herhangi bir ID işe yarar). server_container_url'yi yapılandırdığınız aynı kaynak path'e ayarlayın (bizim örneğimizde buhttps://stapedesk.com/metrics).

2. Testi kolaylaştırmak için Admin → Container Settings → Server container URLs.

3. Test için, aynı kaynak alan adını (aşağıdaki adımda gösterdiğimiz gibi) ayrıca bir Client (web konteynerinden sunucu konteynerine veri iletecek) ve Google Analytics: GA4 etiketi de yapılandırmanız gerekecektir – bunları sunucu GTM'inde yapılandırın.

Client olarak GA4 kullanacağız.

Sunucu GTM'e GA4 Client eklemek için clients bölümünü → Create New client → Client türünü seçin: Google Analytics: GA4 (Web) → client name ekleyin ve Save.

GA4 etiketini yapılandırmak için “Google Analytics: GA4” etiket yapılandırmasıyla yeni bir etiket ekleyin ve etikette Measurement ID'nizi belirtin.

Etiket için bir tetikleyici ekleyin. Client adı istekleri aldığında tetiklenmelidir (bizim durumumuzda Client GA4'tür):

Same Origin kurulumunuzu test etme

Preview'ye hem web hem de sunucu GTM konteynerlerinde tıklayın.

Her şey doğru kurulduysa, sunucu konteyneri oluşturduğunuz yeni path'te önizlemede açılmalıdır. Herhangi bir nedenle önizleme yeni path'te açılmıyorsa, önizleme penceresinin URL'sine manuel olarak girebilirsiniz.

URL çalışmıyorsa olası çözümler şunlardır:

Cloudflare'ın DNS Records bölümünde, ana alan adınıza gelen isteklerin Cloudflare üzerinden proxy'lendiğinden emin olun.

SSL/TLS bölümünde, şifreleme modu'nin Full olarak ayarlandığını kontrol edin. Değilse, Configure, Full seçin ve Save'ye tıklayın. Bu değişikliğin etkili olması 24 saate kadar sürebilir, bu nedenle yeterli zaman tanıyın.

Web sitenizi ziyaret edin. sunucu konteyner önizlemesinde artık web sitenizin gerçek alan adından gelen giriş page_view isteğini görmelisiniz.

Sonuç:

Google Etiket Yöneticisi (GTM) sunucu kapsayıcısına özel bir alan adı eklemek, sunucu tarafı izlemenizin etkinliğini ve esnekliğini önemli ölçüde etkileyebilir. Bu makalede, özel etki alanı uygulaması için iki yöntem sunduk.

Same origin yaklaşımı daha fazla güvenlik ve daha basit çerez yönetimi sunar ve tekil, odaklanmış etki alanları için idealdir. Alt etki alanı kurulumu, karmaşık veya çoklu etki alanı yapıları için uygun esneklik ve performans optimizasyonu sağlar. Her birinin karmaşıklık, performans ve yönetim açısından farklılıkları vardır. Sunucu tarafı izlemeniz için en uygun yapılandırmayı seçmek üzere teknik gereksinimlerinizi, güvenlik ihtiyaçlarınızı ve izleme hedeflerinizi dikkatlice değerlendirin.

Herhangi bir sorunuz varsa, yardım merkezini ziyaret edin ya da bir ticket oluşturun. Uzman ekibimiz, Stape'in barındırma ve sunucu tarafı takibi ile ilgili her türlü sorunuzda size yardımcı olmaktan mutluluk duyacaktır.

Sunucu tarafına geçmek mi istiyorsunuz?

Stape'de bunu ücretsiz yapabilirsiniz! Ücretsiz deneyin butonuna tıklayın ve avantajları keşfedin!

Ücretsiz deneyin

🍽️ İçindekiler:

Güncellemeler için abone olun:

Spam yok!