{"id":8105,"date":"2026-08-11T13:22:00","date_gmt":"2026-08-11T11:22:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=8105"},"modified":"2026-10-24T03:14:10","modified_gmt":"2026-10-24T01:14:10","slug":"wzbogacanie-danych-w-server-side-gtm-wyszukiwanie-crm-w-czasie-rzeczywistym","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/pl\/digital-marketing-pl\/wzbogacanie-danych-w-server-side-gtm-wyszukiwanie-crm-w-czasie-rzeczywistym\/","title":{"rendered":"Server-Side GTM: wzbogacanie danych CRM z Firestore i BigQuery"},"content":{"rendered":"

Serwerowe wzbogacanie danych dodaje do zdarzenia pomiarowego wybrane atrybuty z backendu, na przyk\u0142ad wcze\u015bniej obliczony segment warto\u015bci klienta. Wewn\u0119trzne pola CRM mog\u0105 dzi\u0119ki temu pozosta\u0107 poza przegl\u0105dark\u0105. Przeniesienie przetwarzania na serwer nie zapewnia jednak anonimowo\u015bci ani automatycznej zgody na przekazanie danych platformom reklamowym.<\/p>\n

Mniej danych w przegl\u0105darce, wyra\u017ane granice<\/h2>\n

Numer klienta lub zahaszowany identyfikator pozostaje dan\u0105 osobow\u0105 albo pseudonimizowan\u0105, je\u017celi mo\u017cliwe jest powi\u0105zanie z osob\u0105. Haszowanie nie jest szyfrowaniem ani og\u00f3lnym dowodem anonimowo\u015bci. Tokeny sesji mog\u0105 by\u0107 szczeg\u00f3lnie wra\u017cliwe: tokeny dost\u0119pu i ciasteczka uwierzytelniaj\u0105ce nie powinny trafia\u0107 do zdarze\u0144 analitycznych.<\/p>\n

W\u0142a\u015bciwy projekt oddziela identyfikator pomiarowy od uwierzytelniania. Serwer musi zweryfikowa\u0107 dozwolone powi\u0105zanie z kontem klienta. Dowolnie zmienialne pole user_id<\/code> w publicznym \u017c\u0105daniu przegl\u0105darki nie mo\u017ce wybiera\u0107 dowolnych rekord\u00f3w CRM. Sama poprawna sk\u0142adnia identyfikatora nie stanowi uprawnienia.<\/p>\n\n\n\n\n\n\n\n\n
Etap<\/th>\nZadanie<\/th>\n<\/tr>\n<\/thead>\n
Przegl\u0105darka<\/td>\nWysy\u0142ka potrzebnych p\u00f3l zdarzenia i ewentualnie dozwolonego pseudonimowego identyfikatora pomiarowego.<\/td>\n<\/tr>\n
Zweryfikowany backend<\/td>\nUstalenie to\u017csamo\u015bci, uprawnienia do zdarzenia i dozwolonego celu wzbogacania.<\/td>\n<\/tr>\n
Baza wzbogacania<\/td>\nUdost\u0119pnienie niewielkiego zestawu zatwierdzonych atrybut\u00f3w z czasem aktualizacji.<\/td>\n<\/tr>\n
Tag docelowy<\/td>\nWysy\u0142ka dozwolonych p\u00f3l w schemacie odbiorcy zgodnie z wymaganymi regu\u0142ami zgody.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\"Sprawdzone
Sprawdzone powi\u0105zanie konta, minimalne dane Firestore, regu\u0142y odbiorcy i jawne stany b\u0142\u0119d\u00f3w.<\/figcaption><\/figure>\n

Odczyt z Firestore, obliczenia w BigQuery<\/h2>\n

Firestore nadaje si\u0119 do odczytu dokument\u00f3w wed\u0142ug klucza. Czas odpowiedzi zale\u017cy mi\u0119dzy innymi od regionu, sieci i obci\u0105\u017cenia. Ca\u0142e \u017c\u0105danie ssGTM nie ma gwarantowanej odpowiedzi poni\u017cej milisekundy ani bez op\u00f3\u017anie\u0144. Potrzebny jest pomiar typowych i wysokich op\u00f3\u017anie\u0144 pod realistycznym obci\u0105\u017ceniem.<\/p>\n

BigQuery s\u0142u\u017cy do oblicze\u0144 analitycznych, na przyk\u0142ad segmentu warto\u015bci klienta na podstawie historii zam\u00f3wie\u0144. Osobny, monitorowany proces eksportu zapisuje zatwierdzone wyniki w Firestore. Samo po\u0142\u0105czenie produkt\u00f3w nie tworzy takiego eksportu. Aktualno\u015b\u0107 oblicze\u0144, b\u0142\u0119dy eksportu i usuwanie danych wymagaj\u0105 jawnej obs\u0142ugi. \u015acie\u017cka \u017c\u0105dania odczytuje przygotowane warto\u015bci zamiast wykonywa\u0107 z\u0142o\u017cone zapytanie do hurtowni dla ka\u017cdego zdarzenia.<\/p>\n

Celowo ograniczony przyk\u0142ad odczytu<\/h2>\n

Poni\u017cszy kod jest przeznaczony do niestandardowej zmiennej serwerowej i nie stanowi kompletnego szablonu. Wymagane s\u0105 trzy pola szablonu: projectId<\/code> jako sta\u0142a konfiguracja projektu, authorizedCustomerKey<\/code> ze zweryfikowanego powi\u0105zania po stronie serwera oraz lookupAllowed<\/code> jako warto\u015b\u0107 logiczna wynikaj\u0105ca ze sprawdzonej kontroli uprawnie\u0144 i zgody. Bezpo\u015brednie kopiowanie tych warto\u015bci z p\u00f3l przegl\u0105darki nie spe\u0142nia warunku.<\/p>\n

Oddzielna kolekcja enrichment<\/code> zawiera wy\u0142\u0105cznie zatwierdzone atrybuty. Eksporter zapisuje updated_at_ms<\/code> jako czas uniksowy w milisekundach, a nie obiekt Timestamp Firestore. Warto\u015bci segment\u00f3w i limit aktualno\u015bci wynosz\u0105cy 24 godziny s\u0105 przyk\u0142adami wymagaj\u0105cymi dopasowania do rzeczywistego modelu danych.<\/p>\n

const Firestore = require('Firestore');\nconst getType = require('getType');\nconst queryPermission = require('queryPermission');\nconst getTimestampMillis = require('getTimestampMillis');\n\n\/\/ Template inputs: trusted server-side mapping, never raw browser fields.\nif (data.lookupAllowed !== true) return {status: 'not_allowed'};\nconst key = data.authorizedCustomerKey;\nif (getType(key) !== 'string' || key.length < 16 || key.length > 128) {\n  return {status: 'invalid_key'};\n}\nconst alphabet = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-';\nfor (let i = 0; i < key.length; i++) {\n  if (alphabet.indexOf(key.charAt(i)) < 0) return {status: 'invalid_key'};\n}\nif (getType(data.projectId) !== 'string' || data.projectId.length === 0) {\n  return {status: 'invalid_project'};\n}\nconst path = 'enrichment\/' + key;\nif (!queryPermission('access_firestore', 'read', {projectId: data.projectId, path: path})) {\n  return {status: 'permission_denied'};\n}\nconst maxAgeMs = 86400000; \/\/ Example freshness policy: 24 hours.\nreturn Firestore.read(path, {\n  projectId: data.projectId\n}).then((result) => {\n  const record = result.data;\n  if (getType(record) !== 'object' || record === null) {\n    return {status: 'invalid_record'};\n  }\n  const timestamp = record.updated_at_ms;\n  const now = getTimestampMillis();\n  if (getType(timestamp) !== 'number' || !(timestamp > 0) || timestamp > now) {\n    return {status: 'invalid_timestamp'};\n  }\n  if (now - timestamp > maxAgeMs) return {status: 'stale'};\n  const segment = record.ltv_segment;\n  if (segment !== 'low' && segment !== 'medium' && segment !== 'high') {\n    return {status: 'invalid_segment'};\n  }\n  return {status: 'ok', attributes: {ltv_segment: segment}};\n}, (error) => {\n  return {status: error && error.reason === 'not_found' ? 'not_found' : 'lookup_error'};\n});\n<\/code><\/pre>\n
Firestore.read<\/code> zwraca obiekt z polami id<\/code> i data<\/code>; pola dokumentu znajduj\u0105 si\u0119 pod result.data<\/code>. Brak dokumentu powoduje odrzucenie z reason: 'not_found'<\/code>. Kod rozr\u00f3\u017cnia dane brakuj\u0105ce, przestarza\u0142e, nieprawid\u0142owe i niedost\u0119pne z przyczyn technicznych. Nieznana warto\u015b\u0107 nie staje si\u0119 mar\u017c\u0105 zerow\u0105 ani standardowym klientem.<\/p>\n
Tag docelowy mo\u017ce pobra\u0107 jawnie przypisane atrybuty tylko przy status === 'ok'<\/code>. Wewn\u0119trzny obiekt statusu nie jest pakietem do wysy\u0142ki. Udany odczyt nie zast\u0119puje r\u00f3wnie\u017c zgody w\u0142a\u015bciwej dla odbiorcy. Ka\u017cde zdarzenie wymaga ustalonej regu\u0142y b\u0142\u0119du: wysy\u0142ki ju\u017c dozwolonego zdarzenia podstawowego bez dodatkowych p\u00f3l albo wstrzymania przekazania.<\/p>\n
Uprawnienia i czas wykonania<\/h2>\n
Wbudowane API Firestore w ssGTM obs\u0142uguje zgodnie z dokumentacj\u0105 tryb Native i wy\u0142\u0105cznie baz\u0119 (default)<\/code>. Izolacja mo\u017ce wykorzystywa\u0107 osobny projekt z w\u0142asn\u0105 baz\u0105 domy\u015bln\u0105. Szablon potrzebuje tylko odczytu przez access_firestore<\/code> dla konkretnego projektu i przewidzianej \u015bcie\u017cki. Ograniczenia szablonu uzupe\u0142niaj\u0105 IAM, ale nie zast\u0119puj\u0105 IAM.<\/p>\n
Us\u0142uga wykonawcza potrzebuje osobnej to\u017csamo\u015bci z minimalnymi uprawnieniami odczytu. Eksport u\u017cywa oddzielnej to\u017csamo\u015bci zapisuj\u0105cej. Dost\u0119p serwerowy jest kontrolowany przez IAM; przegl\u0105darkowe Security Rules nie chroni\u0105 tej \u015bcie\u017cki. Kolekcja z niewielk\u0105 liczb\u0105 p\u00f3l i granica osobnego projektu ograniczaj\u0105 zakres danych dost\u0119pnych po przej\u0119ciu us\u0142ugi.<\/p>\n
Odczyt wyd\u0142u\u017ca przetwarzanie zale\u017cnych tag\u00f3w. Oczekiwanie odpowiedzi przegl\u0105darki zale\u017cy od klienta i sposobu zwracania odpowiedzi. Udokumentowane opcje Firestore.read<\/code> nie obejmuj\u0105 w\u0142asnego parametru timeout<\/code>; nieznane opcje s\u0105 ignorowane. Obietnice w izolowanym JavaScript maj\u0105 udokumentowany limit pi\u0119ciu sekund. Limit nie zast\u0119puje \u015bwiadomie ustalonego kr\u00f3tkiego bud\u017cetu odpowiedzi. \u015aci\u015blejsze terminy mog\u0105 wymaga\u0107 osobnej us\u0142ugi odczytu albo procesu asynchronicznego.<\/p>\n
Kontrola odbiorc\u00f3w i dzia\u0142ania<\/h2>\n
GA4 i Meta CAPI maj\u0105 r\u00f3\u017cne modele danych oraz wymagania. Hash nie zezwala na dowolne dane osobowe w parametrach zdarze\u0144. Google udost\u0119pnia specjalnie konfigurowane funkcje user-provided data; funkcje te r\u00f3\u017cni\u0105 si\u0119 od zwyk\u0142ego User-ID i parametr\u00f3w niestandardowych. Mar\u017ce i segmenty powinny trafia\u0107 wy\u0142\u0105cznie do odbiorc\u00f3w rzeczywi\u015bcie wymagaj\u0105cych takich informacji.<\/p>\n
Kontrola dzia\u0142ania obejmuje udzia\u0142 trafie\u0144, brakuj\u0105ce dokumenty, nieaktualne eksporty, b\u0142\u0119dy techniczne i rozk\u0142ad op\u00f3\u017anie\u0144. Zagregowane liczniki ograniczaj\u0105 zb\u0119dne dane CRM w logach. Koszty obejmuj\u0105 odczyty, zapisy eksportu, przechowywanie i ewentualny ruch sieciowy. Pami\u0119\u0107 podr\u0119czna API obejmuje bie\u017c\u0105ce \u017c\u0105danie lub wykonanie kontenera, a nie globalny cache klient\u00f3w.<\/p>\n
Pytania i odpowiedzi<\/h2>\n
Dlaczego nie zast\u0119powa\u0107 braku danych zerem?<\/h3>\n
Warto\u015b\u0107 nieznana i rzeczywiste zero maj\u0105 r\u00f3\u017cne znaczenie. Warto\u015b\u0107 zast\u0119pcza mo\u017ce zniekszta\u0142ci\u0107 analiz\u0119. Status b\u0142\u0119du i pomini\u0119cie dodatkowego pola zachowuj\u0105 t\u0119 r\u00f3\u017cnic\u0119.<\/p>\n
Czy serwer gwarantuje brak wyciek\u00f3w?<\/h3>\n
Nie. Odpowiedzi do przegl\u0105darki, diagnostyka, logi, eksporty i \u017c\u0105dania wyj\u015bciowe pozostaj\u0105 mo\u017cliwymi \u015bcie\u017ckami danych. Konfiguracja oraz rzeczywi\u015bcie wysy\u0142ane pola wymagaj\u0105 kontroli.<\/p>\n
Co zosta\u0142o sprawdzone w przyk\u0142adzie?<\/h3>\n
29 izolowanych test\u00f3w z symulowanymi API obejmuje granice danych wej\u015bciowych, blokady odczytu, brakuj\u0105ce i nieaktualne rekordy oraz dozwolony zestaw p\u00f3l. Testy nie potwierdzaj\u0105 zgodno\u015bci z piaskownic\u0105 GTM, rzeczywistych uprawnie\u0144 IAM, zachowania pod obci\u0105\u017ceniem ani poprawno\u015bci pakiet\u00f3w dla dostawc\u00f3w.<\/p>\n
\u0179r\u00f3d\u0142a<\/h2>\n