Spis treści
- Co robi Google Tag Gateway na Cloudflare i dla kogo jest
- Wymagania przed startem: checklista
- Konfiguracja z poziomu Google Tag Manager krok po kroku
- Alternatywa: konfiguracja z panelu Cloudflare
- Jak sprawdzić, czy tagi działają w modelu first-party
- Typowe problemy i ograniczenia
- Jak ocenić efekt wdrożenia i co dalej
- Najczęściej zadawane pytania
Google Tag Gateway Cloudflare to integracja, dzięki której Cloudflare przekazuje ruch z wybranej ścieżki w Twojej domenie, np. /metrics, do serwerów tagów Google. Tag Google lub kontener GTM ładuje się wtedy z domeny sklepu, a uprawnione żądania pomiarowe wracają do Google przez tę samą ścieżkę. Jeśli domena już działa za Cloudflare, całość skonfigurujesz z poziomu GTM lub panelu Cloudflare w kilkadziesiąt minut, bez własnego serwera i bez dodatkowych opłat. Poniżej znajdziesz wymagania, obie ścieżki konfiguracji, sposób testowania i listę ograniczeń.
Najważniejsze w skrócie
- Integracja wymaga konta Cloudflare z rolą Super Administrator, Administrator lub Zaraz Admin, a przy rolach przypisanych do domen – Domain Administrator.
- Konfigurację uruchomisz w GTM w sekcji Administracja, w pozycji Google Tag Gateway, albo bezpośrednio w panelu Cloudflare.
- Ścieżka pomiaru musi być nieużywana w serwisie; Google proponuje ją automatycznie, ale możesz ją zmienić.
- Cloudflare nie pobiera opłat za tę funkcję i nie wlicza jej żądań do rozliczeń za CDN, WAF ani ochronę przed botami.
- Ustawienie obejmuje całą strefę, czyli wszystkie subdomeny – tagi na wybranych hostach ograniczysz regułami w GTM.
Co robi Google Tag Gateway na Cloudflare i dla kogo jest
Google Tag Gateway na Cloudflare zamienia domenę, z której ładują się tagi Google, z domeny Google na Twoją. Cloudflare obsługuje wybraną ścieżkę i przekazuje ruch spod niej do Google, więc nie musisz utrzymywać żadnej infrastruktury.
Cloudflare był pierwszą platformą z taką integracją: wersja beta, jeszcze pod nazwą first-party mode, pojawiła się w marcu 2025 roku. Od tego czasu GTM nauczył się pokazywać status konfiguracji i pozwala ją wycofać jednym przyciskiem. Integracja działa tylko wtedy, gdy ruch do Twojej witryny faktycznie przechodzi przez Cloudflare, czyli rekordy DNS strony są obsługiwane w trybie proxy.
Rozwiązanie jest najlepsze dla sklepów i serwisów, które korzystają głównie z GA4 i Google Ads i chcą, żeby tagi Google działały w modelu first-party bez budowy serwera tagowania. Jeśli potrzebujesz przetwarzać dane przed wysłaniem albo obsługiwać dostawców spoza Google, przeczytaj porównanie Google Tag Gateway i server-side GTM.
Wymagania przed startem: checklista
Większość problemów z konfiguracją wynika z brakujących uprawnień albo ścieżki, która koliduje z adresami w serwisie. Sprawdź poniższe punkty przed rozpoczęciem.
| Wymaganie | Szczegóły | Jak sprawdzić |
|---|---|---|
| Kontener GTM na stronie | Co najmniej jeden tag, który się uruchamia | Tryb podglądu GTM |
| Domena za Cloudflare | Ruch witryny przechodzi przez Cloudflare | Rekordy DNS w panelu Cloudflare |
| Rola w Cloudflare | Super Administrator, Administrator lub Zaraz Admin; przy rolach domenowych Domain Administrator | Lista członków konta |
| Dostęp w GTM | Dostęp do sekcji Administracja kontenera | Ustawienia użytkowników GTM |
| Wolna ścieżka | Np. /metrics nie może być adresem istniejącej podstrony |
Wpisz adres w przeglądarce – powinien zwrócić błąd 404 |
| Zgody | Consent Mode działa przed wdrożeniem | Tag Assistant, stan zgód przy pierwszym zdarzeniu |
| Plan Cloudflare | Wariant prowadzony przez Tag Assistant i Snippets wymaga planu Pro lub wyższego | Ustawienia konta |
Google zaleca też przejrzenie konfiguracji zgód przed wdrożeniem, bo gateway zmienia sposób, w jaki tagi Google się ładują. Pełną listę kontrolną znajdziesz w checkliście Consent Mode v2.
Konfiguracja z poziomu Google Tag Manager krok po kroku
Domyślna ścieżka konfiguracji jest zautomatyzowana: GTM wykrywa Cloudflare, a Ty autoryzujesz Google do utworzenia reguł na Twoim koncie. Nazwy przycisków mogą się różnić w zależności od języka interfejsu.
- Otwórz konfigurację. W kontenerze GTM przejdź do sekcji Administracja, wybierz Google Tag Gateway i kliknij „Kontynuuj”.
- Zeskanuj witrynę. Wpisz adres strony w polu skanowania i uruchom skanowanie.
- Potwierdź platformę. Sprawdź, czy w wynikach pojawił się Cloudflare, i przejdź dalej. Inne platformy zobaczysz po rozwinięciu pełnej listy.
- Zatwierdź ścieżkę pomiaru. Na ekranie konfiguracji potwierdź proponowaną ścieżkę albo wpisz własną, nieużywaną w serwisie.
- Zaloguj się do Cloudflare. Wybierz logowanie do Cloudflare i potwierdź aktywację domen.
- Wybierz domeny. W panelu wyboru zaznacz domeny do aktywacji i kliknij „Gotowe”. Zamknięcie panelu bez tego kliknięcia odrzuca wybór.
- Zakończ konfigurację. Po powrocie do ekranu Google Tag Gateway status domeny powinien zmienić się na aktywny.
Każda domena może mieć jeden z czterech statusów: aktywna w modelu first-party, nierozpoczęta, wstrzymana albo oczekująca – ten ostatni oznacza, że funkcja jest włączona, ale nie ma jeszcze danych diagnostycznych. Status oczekujący zwykle zmienia się po pewnym czasie od pojawienia się ruchu.
Po aktywacji sprawdź w kodzie strony i w zakładce Network, skąd ładuje się kontener. W zależności od wariantu konfiguracji Cloudflare może sam wstawić kontener ładowany z nowej ścieżki albo trzeba podmienić adres skryptu we fragmencie GTM na ścieżkę pomiaru. W obu przypadkach upewnij się, że ten sam kontener nie ładuje się dwa razy, bo zdublujesz odsłony i konwersje.
Alternatywa: konfiguracja z panelu Cloudflare
Jeśli zautomatyzowana konfiguracja z GTM się nie powiedzie albo wolisz zarządzać wszystkim w Cloudflare, możesz włączyć funkcję bezpośrednio w panelu Cloudflare. Wymagane uprawnienia są takie same.
W panelu Cloudflare wybierz domenę i przejdź do strony Google Tag Gateway w obszarze zarządzania tagami. Włącz przełącznik konfiguracji, wpisz identyfikator tagu Google oraz ścieżkę pomiaru i zapisz zmiany. Cloudflare zaznacza w dokumentacji, że jeśli na stronie jest już skrypt GTM, wstawiony przez Cloudflare tag w modelu first-party go nadpisuje.
Trzecia możliwość to wariant prowadzony przez rozszerzenie Tag Assistant, oparty na mechanizmie Snippets w Cloudflare, dostępny w planie Pro lub wyższym. Tag Assistant generuje kod fragmentu i wyrażenie reguły, które wklejasz w Cloudflare, a po wdrożeniu przeprowadza testy poprawności. Na końcu trzeba zaktualizować tagi na stronie zgodnie z instrukcją wyświetloną przez Tag Assistant.
Jak sprawdzić, czy tagi działają w modelu first-party
Weryfikacja zajmuje kilka minut i polega na sprawdzeniu, czy żądania tagów idą przez Twoją ścieżkę. Najpewniejsze źródło to Tag Assistant.
- Tag Assistant. Połącz się ze stroną, przejdź przez kilka podstron i wywołaj tagi. W podsumowaniu, na liście wysłanych żądań, sprawdź, czy przechodzą przez ścieżkę pomiaru.
- Ekran Google Tag Gateway w GTM. Status powinien być aktywny. Po wybraniu zarządzania domenami zobaczysz domeny pogrupowane na otagowane, nieotagowane i inne aktywne.
- Narzędzia deweloperskie. W zakładce Network przefiltruj żądania po nazwie ścieżki i sprawdź, czy skrypt kontenera ładuje się z Twojej domeny z kodem odpowiedzi 200.
- Konsola przeglądarki. Poniższy fragment wypisze adresy zasobów zawierające ścieżkę pomiaru lub domenę Google, co pozwala szybko porównać obie drogi.
- GA4. W raporcie czasu rzeczywistego lub w DebugView upewnij się, że dane nadal spływają bez przerw.
performance.getEntriesByType('resource')
.map(function (entry) { return entry.name; })
.filter(function (url) {
return url.indexOf('/metrics/') !== -1 || url.indexOf('googletagmanager') !== -1;
});
Nie każde żądanie musi przechodzić przez Twoją ścieżkę – część może nadal trafiać bezpośrednio do Google i nie musi to oznaczać błędu. Ogólną metodykę testowania tagów opisujemy w poradniku jak sprawdzić, czy tag działa, a weryfikację zgód w żądaniach – w tekście o parametrach gcs i gcd.
Typowe problemy i ograniczenia
Integracja jest prosta, ale ma kilka cech, które mogą zaskoczyć, szczególnie w serwisach z wieloma subdomenami. Najważniejsza dotyczy zasięgu ustawienia.
Cała strefa naraz. Włączenie funkcji dla strefy, np. twojsklep.pl, obejmuje wszystkie subdomeny i niestandardowe nazwy hostów. Nie wyłączysz jej dla jednej subdomeny ani regułami konfiguracji Cloudflare. Jeśli tagi nie powinny działać np. w panelu klienta czy na blogu w osobnej subdomenie, ogranicz je regułami w GTM:
Reguła: Inicjowanie – wszystkie strony
Uruchamiaj w przypadku: Niektóre zdarzenia inicjowania
Warunek: Page Hostname | jest równe | twojsklep.pl
Kolizja ścieżki. Jeśli wybrana ścieżka jest używana przez serwis, np. przez istniejący katalog, część podstron może przestać działać. Wybierz ścieżkę nietypową i sprawdź ją przed wdrożeniem.
Własne reguły Cloudflare. Sprawdź, czy reguły przekierowań, pamięci podręcznej lub zapory nie obejmują ścieżki pomiaru, bo mogą zakłócić przekazywanie żądań.
Zgody bez zmian. Gateway nie zastępuje platformy zgód ani Consent Mode. Tagi nadal muszą respektować wybory użytkownika.
Błędy konfiguracji. Jeśli zautomatyzowana konfiguracja się nie powiedzie, spróbuj ponownie, a przy powtarzających się błędach skonfiguruj funkcję w panelu Cloudflare. Gdy konto Cloudflare nie zostanie wykryte, pozostaje konfiguracja samodzielna.
Wycofanie. Na ekranie Google Tag Gateway w GTM wybierz konfigurację i usuń ją. Operacja odłącza Cloudflare od kontenera i wyłącza funkcję we wszystkich aktywnych domenach naraz. Później możesz skonfigurować ją ponownie, również z innym kontem Cloudflare.
Jak ocenić efekt wdrożenia i co dalej
Efekt gatewaya mierz na własnych danych, bo zależy od odbiorców, przeglądarek i odsetka zgód. Porównaj co najmniej 14 dni przed wdrożeniem i po nim, uwzględniając sezonowość i zmiany w kampaniach.
W GA4 zestaw liczbę użytkowników i sesji w podziale na przeglądarki, a w Google Ads – liczbę konwersji w stosunku do kliknięć. Nie oczekuj, że gateway ominie blokery reklam – część z nich nadal rozpoznaje żądania pomiarowe. Jeśli liczby w GA4, Google Ads i panelu sklepu zaczną się różnić inaczej niż wcześniej, przyczyn szukaj według listy z artykułu o rozbieżnościach konwersji.
Gateway to dobry pierwszy krok w budowaniu strategii danych first-party. Gdy pojawi się potrzeba wysyłania konwersji do Meta z serwera albo wzbogacania zdarzeń marżą, kolejnym etapem jest własny serwer tagowania, a wybór miejsca jego uruchomienia omawiamy w tekście o hostingu server-side GTM. Pamiętaj też o październikowych zmianach w działaniu kontenerów GTM, które dotyczą instalacji hybrydowych. Opis narzędzia znajdziesz na stronie Google Tag Manager, a pozostałe poradniki – w podtemacie server-side tagging.
Najczęściej zadawane pytania
Czy Google Tag Gateway na Cloudflare jest płatny?
Nie. Cloudflare udostępnia integrację bezpłatnie i nie wlicza żądań przechodzących przez gateway do rozliczeń za CDN, WAF ani ochronę przed botami. Płacisz wyłącznie za swój dotychczasowy plan Cloudflare. Wariant konfiguracji prowadzony przez Tag Assistant i mechanizm Snippets wymaga jednak planu Pro lub wyższego.
Czy po włączeniu gatewaya trzeba zmieniać kod GTM na stronie?
To zależy od wariantu konfiguracji. Cloudflare może sam wstawić kontener ładowany z nowej ścieżki i nadpisać istniejący skrypt, a w innych wariantach trzeba podmienić adres skryptu we fragmencie GTM. Po wdrożeniu zawsze sprawdź w zakładce Network, skąd ładuje się kontener, i czy nie ładuje się on dwa razy.
Czy można włączyć Google Tag Gateway tylko dla jednej subdomeny?
Nie. W Cloudflare funkcja działa na poziomie całej strefy, więc obejmuje wszystkie subdomeny i niestandardowe nazwy hostów, a reguły konfiguracji Cloudflare nie pozwalają jej wyłączyć dla wybranych adresów. Jeśli tagi nie powinny działać w części subdomen, dodaj w GTM warunek oparty na zmiennej Page Hostname.
Jak wyłączyć Google Tag Gateway na Cloudflare?
Na ekranie Google Tag Gateway w GTM wybierz konfigurację i usuń ją. Spowoduje to odłączenie Cloudflare od kontenera i wyłączenie funkcji we wszystkich aktywnych domenach jednocześnie. Później możesz ponownie przeprowadzić konfigurację, także z innym kontem Cloudflare. Po wyłączeniu sprawdź, czy kontener nadal ładuje się poprawnie z domeny Google.
Ile naprawdę trwa konfiguracja gatewaya na Cloudflare?
Przy kompletnych uprawnieniach sama konfiguracja w GTM zajmuje zwykle kilkanaście minut, a z testami w Tag Assistant – około pół godziny. Dłużej trwa, gdy trzeba uzyskać dostęp do konta Cloudflare od innej osoby, zmienić kolidującą ścieżkę albo dostosować tagi na stronie w wariancie konfiguracji przez mechanizm Snippets.