İçeriğe geç
Ücretsiz yapay zekâ görünürlük analizi: markanız ChatGPT ve Gemini cevaplarında geçiyor mu?Başvurun →
Analitik ve Veri10 dk okuma

Server-side tracking kurulumu: sunucu taraflı GTM adım adım

Sunucu container'ından birinci taraf alan adına, GA4, Google Ads ve Meta Conversions API bağlantısından onay moduna kadar sunucu taraflı Google Tag Manager kurulumunun sırası.

YazarMahmud FiloğluİnceleyenSon güncelleme: Markdown olarak görüntüle
Server-side tracking kurulumu yazısının kapağı: mavi dalga deseni üzerinde 'sGTM kurulumu' yazısı

Server-side tracking kurulumu, ölçüm etiketlerinin bir kısmını ziyaretçinin tarayıcısından sizin kontrol ettiğiniz bir sunucuya taşımak demektir. Pratikte bu iş çoğunlukla sunucu taraflı Google Tag Manager (sGTM) ile yapılır: tarayıcı veriyi tek bir akış olarak sizin sunucunuza gönderir, sunucudaki container da bu veriyi kurallara göre GA4'e, Google Ads'e ve Meta'ya dağıtır. Kavramın tanımı için server-side tracking sözlük maddesine, tarayıcı taraflı ölçümle farkı için server-side ve client-side tracking karşılaştırmasına bakabilirsiniz. Bu yazı kurulumun kendisini anlatıyor: hangi sırayla, hangi ayarlarla ve nerede dikkat ederek.

Adımlar Google'ın sGTM geliştirici dokümanlarına ve Meta'nın Conversions API dokümanlarına dayanıyor. Ekran adları ve varsayılan değerler zamanla değişebilir; kuruluma başlamadan önce ilgili sayfayı açıp güncel hâline bakın.

Sunucu taraflı GTM nasıl çalışır?

Google'ın "An introduction to server-side tagging" sayfasına göre sunucu container'ı kullanıcının tarayıcısında ya da telefonunda çalışmaz; sizin kontrol ettiğiniz bir sunucuda çalışır. Sunucu kendi Google Cloud projenizde ya da seçtiğiniz başka bir ortamda durur ve siz başka bir yere göndermeyi seçene kadar veriye yalnız siz erişirsiniz.

Web container'dan alışık olduğunuz etiket, tetikleyici ve değişken modeli burada da geçerlidir. Farkı yaratan yeni parça client'tır: client, cihazdan gelen isteği karşılar, onu bir ya da daha fazla etkinliğe (event) çevirir, container'ın geri kalanına işletir ve cevabı paketleyip geri yollar. Her istek, öncelik sırasıyla client'lara sunulur; isteği ilk "sahiplenen" client işler, diğerleri devreye girmez. Sunucu container'ları iki hazır client ile gelir: Google Analytics ve Measurement Protocol.

Google'ın öğrenme merkezindeki "Why and when to use server-side tagging?" bölümü üç gerekçe sayar: gizlilik kontrolü, site performansı ve veri kalitesi. Tarayıcı taraflı kurulumda kullanıcının IP adresi tedarikçi sunucularına her istekte gider; sunucu tarafında ise isteği tedarikçiye göndermeden önce doğrulayabilir, anonimleştirebilir ya da engelleyebilirsiniz. Aynı bölüm, birinci taraf bağlamda çerezlerin HttpOnly bayrağıyla yazılabileceğini ve sunucuda veriyi tarayıcıya hiç göstermeden (ör. kâr marjı) zenginleştirebileceğinizi de belirtir.

Başlamadan önce gerekenler

Google'ın Cloud Run kurulum rehberi ve öğrenme merkezi şu ön koşulları listeler:

  • Bir Google Cloud (GCP) hesabı ve faturalandırma hesabı; proje oluşturma (Project Creator) ve faturalandırma hesabı kullanıcısı (Billing Account User) rolleri.
  • Sunucu container'ı oluşturma yetkisi olan bir Google Tag Manager hesabı.
  • Veri kaynağı olarak bir GTM web container'ı ya da sitede çalışan bir Google etiketi.
  • Örnek veri akışı için bir GA4 mülkü.
  • İsteğe bağlı ama önerilen: birinci taraf bağlam için sitenizin bir alt alan adı (ör. olcum.siteniz.com).

Bunlara bir de içeriden bir karar ekleyin: sunucuyu kim işletecek? Google'ın "Planning infrastructure requirements and costs" bölümü, Cloud Run'ın Google Cloud bilgisi gerektirdiğini ve şirketin mevcut Google Cloud politikaları varsa yükseltmenin BT ya da DevOps ekibiyle birlikte yapılmasını öneriyor.

Adım 1: Sunucu container'ını oluşturun ve sunucuyu hazırlayın

Tag Manager'da hesabınızın menüsünden yeni bir container oluşturun ve türünü Server seçin. Kurulum ekranında iki yol vardır: Tag Manager içinden otomatik hazırlama (automatic provisioning) ya da sunucuyu kendiniz kurmak.

YolNe yaparNe zaman
Otomatik (Cloud Run)Bir Google Cloud projesi açar; bir önizleme sunucusu ve tek bir etiketleme sunucusu kurar. Bölge sabit olarak us-central1'dir.Yalnız test için; Google canlı trafik yükünü desteklemediğini söylüyor. Sonradan yükseltilir.
Cloud Run arayüzü veya Cloud Shell komut satırıBölgeyi ve otomatik ölçekleme sınırlarını siz belirlersiniz.Canlı kurulumda bölge ve ölçekleme üzerinde kontrol isteniyorsa.
Manuel (Docker)Etiketleme sunucusu bir Docker imajı içindeki Node.js sunucusudur; herkese açık HTTP erişimi veren herhangi bir ortamda çalışır.Google Cloud dışında barındırma gerekiyorsa. Kurulumu en zor seçenektir.

Otomatik kurulumdan sonra sunucunun ayakta olduğunu basit bir istekle doğrulayın: sunucu adresinin sonuna /healthy ekleyip açın; sayfada "ok" görmelisiniz.

Manuel kurulumda Google'ın "Manual setup guide" sayfasındaki üç kural önemlidir: tam olarak bir önizleme sunucusu çalıştırın (otomatik ölçeklemeyi 1'in üstüne açmayın); yük dengeleyici ya da CDN'in zaman aşımı 20 saniyeden uzun olsun, yoksa önizleme düzgün çalışmaz; etiketleme sunucularına en fazla 1 vCPU verin, fazlası kullanılmaz ve ölçeklemeyi bozar. Aynı sayfa bir uyarı daha yapar: sunucuyu barındıran tarafın (bulut sağlayıcı ya da kendi veri merkeziniz) verinize erişimi olabilir; sağlayıcının hizmet şartlarını okuyun.

Adım 2: Canlı trafik için kapasite ve maliyet

Test sunucusu canlı trafiği taşımaz; yayına almadan önce Cloud Run ayarlarını yükseltirsiniz. Google'ın "Set up server-side tagging with Cloud Run" rehberinde verilen değerler şöyle:

  • Her sunucu yaklaşık aylık 45 USD'dir (1 vCPU, 0,5 GB bellek, CPU'nun sürekli ayrıldığı fiyatlama modeli).
  • Sunucu kesintisinde veri kaybı riskini azaltmak için en az 2 örnek (instance) önerilir.
  • 2–10 sunucu arasında otomatik ölçeklemenin saniyede 35–350 isteği karşılaması beklenir; gerçek performans etiket sayısına ve etiketlerin ne yaptığına göre değişir.
  • Maksimum örnek sayısı en kötü durum maliyetidir; Cloud Run gerekmedikçe o kadar örnek açmaz.

Google'ın öğrenme merkezi farklı rakamlar veriyor: "Upgrade your servers for live traffic" bölümü en az 3 örnek ve 3–6 örnekle saniyede 50–200 istek öneriyor; "Planning infrastructure requirements and costs" bölümü örnek başına aylık yaklaşık 50 USD diyor. Kapasiteyi planlarken iki kaynaktaki farkı bilin ve maliyeti Google Cloud fiyat hesaplayıcısıyla kendi trafiğinize göre çıkarın.

Gözden kaçan kalem kayıt (log) maliyetidir. Cloud Run rehberine göre varsayılan ayarda her isteğin bilgisi kaydedilir; ayda 1 milyonun üzerinde istek alan bir sunucuda bu kayıtlar ciddi ücret doğurabilir ve Google istek kaydını kapatmayı öneriyor. Beklenmedik faturaya karşı bir bütçe uyarısı (billing alert) da kurun.

Adım 3: Sunucuyu birinci taraf alan adına bağlayın

Sunucu ilk kurulduğunda bulut sağlayıcının verdiği bir adreste (ör. …run.app) çalışır ve üçüncü taraf bağlamdadır. Google'ın "Custom domain configuration" sayfası, daha dayanıklı çerezler gibi birinci taraf faydaları için etiketleme sunucusunun ve sitenin aynı alan adında çalışması gerektiğini söyler. Üç seçenek:

SeçenekÖrnekSunucunun yazdığı çerezKurulum
Aynı köken (Google'ın önerdiği)www.siteniz.com/metricsTam erişimİstekleri yönlendiren bir CDN ya da yük dengeleyici; gerekirse DNS
Alt alan adımetrics.siteniz.comTam erişimDNS kayıtlarını güncellemek
Varsayılan alan adımetrics.run.appYok; yalnız JavaScript çereziHazır gelir

Google'ın giriş sayfası, sunucu container'ına canlı trafik göndermeden önce sunucuyu birinci taraf alan adınıza kurmayı ve üretim moduna yükseltmeyi "güçlü şekilde" öneriyor. Alan adını bağladıktan sonra Tag Manager'da Admin > Container Settings altında sunucu container adresini yeni adresle güncelleyin.

Adım 4: Web tarafından veriyi sunucuya gönderin

Google'ın önerdiği veri kaynağı, tarayıcıda çalışan Google etiketidir. Web container'ınızda bir Google etiketi oluşturun, etiket kimliğinizi girin ve yapılandırma ayarlarına server_container_url parametresini ekleyip değerine sunucu adresinizi yazın. gtag.js kullanıyorsanız aynı parametre gtag('config', …) satırına eklenir.

Mevcut ölçümünüzü bir anda kesmeyin. Google'ın öğrenme merkezi, var olan GA4 kurulumunu olduğu gibi bırakıp sunucu tarafı için yeni bir GA4 mülkü açmayı ve etiketleri tek tek kopyalayarak bir süre çift ölçüm (dual tagging) yapmayı öneriyor. Sunucu tarafındaki ölçüm tarayıcı tarafıyla aynı seviyeye gelince etiketleri sunucuya yönlendirip çift kurulumu kaldırırsınız. Bazı tedarikçileri tarayıcıdan, bazılarını sunucudan beslemek de yaygın bir karma yöntemdir.

Sitenizde bir içerik güvenlik politikası (CSP) varsa, Google'ın "Send data to server-side Tag Manager" sayfasına göre sunucu adresinizi img-src ve connect-src yönergelerine, servis çalışanı yöntemi için frame-src yönergesine ekleyin; X-Frame-Options başlığı da sunucu adresinden iframe yüklenmesini engellememelidir.

Adım 5: Sunucu container'ında GA4 client, etiket ve tetikleyici

Sunucu container'ında GA4 client'ı varsayılan olarak yüklüdür. Google'ın öğrenme merkezindeki yapılandırma özetle şöyle:

  1. Client: GA4 client'ında varsayılan GA4 yollarını açık bırakın (/g/collect gibi istekleri sahiplenir). Çerez ve istemci kimliği ayarını, alan adını bağlayana kadar "JavaScript Managed" yapın; birinci taraf alan adı hazır olunca sunucunun yönettiği çereze geçebilirsiniz.
  2. Etiket: Yeni bir Google Analytics: GA4 etiketi oluşturun ve alanları varsayılan bırakın. Etiket, ölçüm kimliğini ve etkinlik parametrelerini client'ın ürettiği veriden devralır.
  3. Tetikleyici: Özel (Custom) bir tetikleyici açın ve yalnız GA4 client'ının ürettiği etkinliklerde çalışacak şekilde Client Name değişkenine koşul koyun. Google, sunucu container'ı işlem ve ağ maliyeti biriktirebildiği için sınırları testte bile erkenden çizmeyi öneriyor.

Ek parametre gönderiyorsanız bunları sunucuda kullanmak için Event Data türünde bir kullanıcı tanımlı değişken oluşturup anahtar yoluna parametrenin adını yazın.

Adım 6: Google Ads dönüşümlerini sunucuya taşıyın

Google'ın "Google Ads conversions" sayfasına göre Ads dönüşüm etiketlerini sunucuya taşımak sayfada çalışan kodu azaltır ve sayfa yüklenme hızına yardım eder. Sıra şöyle:

  1. Sunucu container'ında bir Conversion Linker etiketi kurun; çoğu durumda tüm sayfalarda tetiklenir.
  2. Dönüşüm olacak etkinliği GA4'te önemli etkinlik (key event) olarak tanımlayın ve web container'daki GA4 etkinlik etiketiyle gönderin.
  3. Sunucu container'ında bir Google Ads Conversion Tracking etiketi oluşturun, Google Ads hesabınızdaki dönüşüm kimliğini ve etiketini girin, etkinlik adına göre tetikleyin.

Geliştirilmiş dönüşümler (enhanced conversions) kullanacaksanız, kullanıcı tarafından sağlanan veriyi taşıyan değişkenin etkinlik parametresi adı user_data olmalıdır; Google, karma kullanıcı verisinin ve geliştirilmiş dönüşümlerin doğru çalışması için bunu şart koşuyor. Satışın CRM'de kapandığı işlerde dönüşümü sonradan yüklemek ayrı bir akıştır; o konu Google Ads offline dönüşüm takibi yazısında.

Adım 7: Meta Conversions API'yi aynı akıştan besleyin

Meta Conversions API (CAPI) için Meta'nın "Conversions API for Server-Side Google Tag Manager (GTM)" sayfası kurulumu GA4 akışı üzerine kurar:

  1. Web container: GA4 yapılandırmasında sunucu adresini girin ve first_party_collection değerini true yapın; Meta, user_data parametrelerini geçirebilmek için bunun zorunlu olduğunu yazıyor. GA4 etkinlik etiketinde Meta standart etkinlik adını (ör. Lead) ya da eşlenen GA4 adını kullanın.
  2. Sunucu container: Şablon galerisinden Meta'nın yazıp bakımını yaptığı Conversions API etiketini ekleyin. Etiket için Pixel kimliği ve erişim belirteci (access token) gerekir; işlem kaynağını (action source) "website" seçin ve etiketi GA4 client'ından gelen etkinliklerle tetikleyin.
  3. Tekilleştirme: Tarayıcıdaki Meta Pixel etiketi ile GA4 etkinlik etiketine aynı tetikleyiciyi, aynı etkinlik adını ve aynı event_id'yi verin.

Meta, sunucu taraflı GTM'nin etkinlik gönderebilmesi için tarayıcı tarafında bir etiket gerektiğini; test için eklenen test_event_code değerinin yayından önce kaldırılması gerektiğini de belirtiyor. "Handling Duplicate Pixel and Conversions API Events" sayfasına göre etkinlikler ancak aynı event_id ile ilk etkinliğin alınmasından sonraki 48 saat içinde gelirse tekilleştirilir; Meta en iyi reklam performansı için Conversions API'nin Pixel'in yanında kullanılmasını öneriyor.

Müşteri bilgisi gönderirken Meta'nın "Customer Information Parameters" sayfasındaki karma kuralına uyun: e-posta, telefon, ad, soyad gibi iletişim alanları normalleştirilip SHA-256 ile karma hâle getirilir; client_ip_address, client_user_agent, fbc ve fbp ise karma yapılmaz. Pixel ile Conversions API'nin farkı ve eşleşme kalitesi için Meta Conversions API nedir? yazısına bakın.

Adım 8: Onay modunu sunucu kurulumuna bağlayın

Google'ın "Implement consent mode with server-side Tag Manager" sayfası akışı şöyle anlatıyor: sitenizdeki çerez bandı kullanıcının tercihini Google etiketine iletir; Google etiketi bu tercihi HTTP isteğine onay parametreleri olarak ekleyip sunucu container'ına gönderir; sunucudaki Google ürün etiketleri bu sinyale göre ne kadar ve ne tür veri göndereceklerini ayarlar. Bu yüzden onay modunu yalnız web container'da kurmanız yeterlidir. Örnekler:

  • Temel (basic) uygulamada kullanıcı analitik çerezlerine onay vermediyse Google etiketleri hiç yüklenmez; ne tarayıcıda ne sunucuda Analytics çerezi yazılır ya da okunur.
  • Google Ads dönüşüm etiketi, ad_storage reddedildiğinde Ads çerezlerini yazmaz ve okumaz; bunun yerine tarayıcı, üçüncü taraf çerezi olmayan bir alan adına dönüşüm pikseli gönderir. Geliştirilmiş dönüşümler yalnız onay verildiğinde çalışır.
  • Google Ads yeniden pazarlama etiketi, ad_storage reddedildiğinde HTTP isteğini ve çerez kullanımını engeller.

Google'ın sayfası bu otomatik davranışı Google ürün etiketleri için anlatıyor. Meta Conversions API etiketi gibi başka tedarikçilerin etiketlerini onay durumuna bağlamayı ayrıca planlayın ve önizlemede onay reddedilmiş bir oturumla test edin. Onay modunun kendisi ve v2 parametreleri için Consent Mode v2 nedir? yazısına bakabilirsiniz.

Teknik kurulum hukuki uyumu tek başına sağlamaz. Bu yazı hukuki danışmanlık değildir; hangi verinin hangi hukuki dayanakla hangi tedarikçiye gideceğini kendi hukuk danışmanınızla değerlendirin.

Adım 9: Önizleme, doğrulama ve geçiş

Sunucu container'ında Preview düğmesine basıp sitenizi ayrı bir sekmede açın. Google'ın "Preview and debug server containers" sayfasına göre sol panelde gelen HTTP istekleri (collect?v=2… gibi) ve bunlardan üretilen etkinlikler listelenir. Her istek için üç şeye bakın:

  • Client: İsteği doğru client mı sahiplendi?
  • Gelen istek: Tarayıcının ağ sekmesinde gördüğünüz istekle birebir aynı mı, beklediğiniz parametreler geliyor mu?
  • Giden istekler: Hangi etiket hangi tedarikçiye ne gönderdi ve tedarikçi hangi durum koduyla cevap verdi?

Önizleme düzgün görünüyorsa bir süre tarayıcı tarafı ile sunucu tarafını paralel çalıştırıp GA4, Google Ads ve Meta Etkinlik Yöneticisi'ndeki sayıları karşılaştırın; tutarlı olduğunda tarayıcıdaki mükerrer etiketleri kaldırın. Manuel kurduysanız etiketleme sunucusunu güncel tutmayı da takvime alın: Google, Docker imajının güvenlik düzeltmeleri ve yeni özelliklerle düzenli güncellendiğini ve en azından her ana sürümde (ör. 1.x.x'ten 2.x.x'e) güncellemeyi öneriyor.

Kurulumdan sonra: araç seçimi ve bakım

Kendi Google Cloud projenizde sGTM işletmek yerine yönetilen barındırma hizmetleri ya da hazır server-side tracking araçları da kullanılabilir; seçenekleri en iyi server-side tracking araçları listesinde karşılaştırdık. Hangi yolu seçerseniz seçin, sunucu tarafı bir kez kurulup bırakılan bir iş değildir: yeni bir dönüşüm, yeni bir tedarikçi ya da onay bandında bir değişiklik her seferinde önizleme ve karşılaştırma turu ister.

Roicool sunucu taraflı Google Tag Manager kurulumu yapar; kapsam ve süreç server-side tracking hizmet sayfasında anlatılıyor.

Sık sorulan sorular

Sunucu taraflı GTM'nin maliyeti hangi kalemlerden oluşur?

Google'ın öğrenme merkezi Cloud Run maliyetini üç kaleme ayırır: sabit ağırlıklı işlem maliyeti (açık tuttuğunuz örnek sayısı), trafiğe göre dalgalanan ağ çıkışı (sunucudan tedarikçilere ve tarayıcıya giden veri) ve ücretsiz katmanı aşınca büyüyebilen kayıt depolama. Sunucu JavaScript kütüphaneleri gibi büyük dosyalar da dağıtıyorsa ağ çıkışı belirgin bir kalem olabilir.

Sunucu taraflı kurulumdan sonra tarayıcıdaki etiketler kaldırılabilir mi?

Tarayıcı tarafını tamamen kaldıramazsınız. Sunucu container'ı veriyi kendisi toplamaz; Google'ın önerdiği kurulumda isteği tarayıcıdaki Google etiketi gönderir. Bu etiket GTM web container'ında ya da doğrudan gtag.js ile çalışabilir. Meta da sunucu taraflı GTM ile etkinlik göndermek için tarayıcıda bir etiket gerektiğini yazıyor. Kaldırılan, sunucuya taşıdığınız tedarikçi etiketlerinin tarayıcıdaki kopyalarıdır.

Mobil uygulama ya da arka uç verisi sunucu container'ına gönderilebilir mi?

Evet. Google'ın dokümanına göre sunucu container'ında bir Measurement Protocol client'ı tanımlayıp ona bir etkinleştirme yolu verirsiniz. Android ve iOS uygulamaları mobil container'daki özel bir görsel etiketiyle bu yola istek gönderebilir; sunucudan sunucuya çalışan sistemler de istekteki Google Analytics alan adı yerine sunucu container'ınızın alan adını kullanır. Google'a göre bu yol, Measurement Protocol uç noktasının bütün özelliklerini desteklemez; örneğin coğrafi ve cihaz bilgisi etkinlikten türetilmez.

Birden fazla site tek bir sunucu container'ını kullanabilir mi?

Evet. Google'ın öğrenme merkezi, aynı sunucu container'ı birden fazla siteden istek alıyorsa servise birden fazla özel alan adı eklenebileceğini söylüyor. Önizlemeyi her alan adında kullanmak için Container Settings'e ek sunucu adresleri girersiniz; Google'ın manuel kurulum rehberine göre bu adreslerin alan adından sonraki yolları aynı olmalıdır.

Cloud Run bölgesi sonradan değiştirilebilir mi?

Otomatik kurulum servisi us-central1 bölgesinde açar. Google'ın öğrenme merkezine göre bölgeyi değiştirmek için Cloud Run arayüzünde yeni bölgede yeni bir servis oluşturup eskisini silmeniz gerekir. Farklı coğrafyalara hizmet vermek isterseniz birden fazla servisi bir yük dengeleyicinin arkasına koyabilirsiniz.

Kaynaklar

  1. 1Google for Developers, An introduction to server-side tagging, 2026
  2. 2Google for Developers, Why and when to use server-side tagging?, 2026
  3. 3Google for Developers, Setting up a new server container, 2026
  4. 4Google for Developers, Set up server-side tagging with Cloud Run, 2026
  5. 5Google for Developers, Manual setup guide, 2026
  6. 6Google for Developers, Planning infrastructure requirements and costs, 2026
  7. 7Google for Developers, Upgrade your servers for live traffic, 2026
  8. 8Google for Developers, Custom domain configuration, 2026
  9. 9Google for Developers, Configuring the Google Analytics data stream, 2026
  10. 10Google for Developers, Send data to server-side Tag Manager, 2026
  11. 11Google for Developers, Google Ads conversions, 2026
  12. 12Meta for Developers, Conversions API for Server-Side Google Tag Manager (GTM), 2026
  13. 13Meta for Developers, Handling Duplicate Pixel and Conversions API Events, 2026
  14. 14Meta for Developers, Customer Information Parameters, 2026
  15. 15Google for Developers, Implement consent mode with server-side Tag Manager, 2026
  16. 16Google for Developers, Preview and debug server containers, 2026

Yazar hakkında

Senior Software Engineer & Tech Lead

Semih Bayındır , ileri seviye teknik uzmanlığa sahip, yazılım mimarisi ve modern geliştirme teknolojilerinde güçlü deneyimi olan bir Senior Software Engineer & Tech Lead ’dir.

Tüm yazıları

Bu yazı hangi hizmetle ilgiliServer-side trackingSunucu taraflı Google Tag Manager, birinci taraf veri, Meta Conversions API ve geliştirilmiş dönüşümler: reklam sinyalini kontrollü ve eksiksiz gönderin.

Diğer yazılar

Tüm Analitik ve Veri yazıları

Okuduğunuzu sizin için uygulayalım.

30 dakikalık tanışmada hesabınıza bakar, hangi adımın önce gelmesi gerektiğini söyleriz.

Ezgi'ye sor