Podmiana telefonów

Przegląd

Podmiana telefonów to funkcja atrybucji połączeń, która dynamicznie zastępuje numery telefonów na Twojej stronie w zależności od źródła ruchu odwiedzającego. Gdy odwiedzający przychodzi z konkretnej kampanii — Google Ads, Facebook, polecenie od partnera lub dowolny link z tagami UTM — tracker automatycznie podmienia Twój domyślny numer telefonu na dedykowany numer śledzący. Gdy odwiedzający zadzwoni na ten numer, wiesz dokładnie, która kampania doprowadziła do połączenia.

Jak to działa

Skonfiguruj podmianę telefonu w kampanii

Otwórz kampanię i ustaw Oryginalny telefon (numer na Twojej stronie) oraz Telefon zastępczy (numer śledzący przypisany do tej kampanii). Zobacz Kampanie — Podmiana telefonów po szczegóły konfiguracji.

Odwiedzający trafia na Twoją stronę

Odwiedzający klika link kampanii (z parametrami UTM) i skrypt trackera się ładuje. Tracker pobiera aktywne reguły podmiany telefonów z serwera.

Dopasowanie UTM

Tracker sprawdza parametry UTM odwiedzającego z każdą regułą. Wszystkie niepuste pola dopasowania (utm_source, utm_medium, utm_campaign, rvl_ref) muszą pasować dokładnie. Pierwsza pasująca reguła wygrywa.

Numer jest zastępowany

Tracker znajduje wszystkie wystąpienia oryginalnego numeru na stronie — w linkach tel:, w tekście z atrybutem data-revol-phone — i zastępuje je numerem śledzącym. Podmiana zachowuje formatowanie oryginalnego numeru.

Zdarzenie jest rejestrowane

Zdarzenie phone_swap jest rejestrowane z oryginalnymi i zastępczymi numerami. To zdarzenie pojawia się w Dzienniku aktywności i tabeli Wydajność kampanii.

Odwiedzający dzwoni

Odwiedzający dzwoni na numer śledzący. Widzisz połączenie przypisane do konkretnej kampanii — bez zgadywania.

Zakładka Podmiana telefonów

Zakładka Podmiana telefonów pokazuje wszystkie aktywne reguły podmiany telefonów z Twoich kampanii w jednej tabeli:

Kolumna	Opis
Kampania	Nazwa kampanii z warunkami UTM (źródło, medium itp.) wyświetlonymi poniżej
Podmiana telefonu	Oryginalny numer → Numer zastępczy
Status	Aktywny lub nieaktywny

Ta zakładka jest podsumowaniem tylko do odczytu — aby dodać lub edytować reguły podmiany telefonów, otwórz kampanię w zakładce Kampanie i skonfiguruj sekcję Podmiana telefonów.

Dodawanie numerów telefonów na stronie

Tracker zastępuje numery telefonów na dwa sposoby:

1. Linki tel (automatyczne)

Każdy link <a href="tel:..."> na stronie jest automatycznie wykrywany. Jeśli href pasuje do oryginalnego numeru z reguły, jest podmieniany — zarówno atrybut href, jak i widoczny tekst.

<!-- Przed podmianą -->
<a href="tel:+380441234567">+380 (44) 123-45-67</a>

<!-- Po podmianie (odwiedzający z kampanii Google Ads) -->
<a href="tel:+380449876543">+380 (44) 987-65-43</a>

Nie są potrzebne żadne dodatkowe atrybuty — tracker automatycznie znajduje linki tel:.

2. Atrybut data (jawny)

Dla numerów telefonów, które nie są w linkach tel: (zwykły tekst, span, div), dodaj atrybut data-revol-phone:

<!-- Telefon w span -->
<span data-revol-phone>+380441234567</span>

<!-- Telefon w div -->
<div class="contact-phone" data-revol-phone>+380 44 123 45 67</div>

Elementy z data-revol-phone są ukryte (visibility: hidden) do momentu zakończenia podmiany, zapobiegając migotaniu oryginalnego numeru.

Użyj data-revol-phone dla wszystkich numerów telefonów, które chcesz podmieniać — nawet jeśli są wewnątrz linków tel:. Daje to trackerowi jawną kontrolę i zapobiega migotaniu.

Zachowanie formatowania

Tracker zachowuje formatowanie oryginalnego numeru przy zastępowaniu. Jeśli oryginalny i zastępczy numer mają taką samą liczbę cyfr, zastępczy jest formatowany według wzorca oryginału:

Oryginał	Zastępczy (surowy)	Wynik
`+380 (44) 123-45-67`	`+380949876543`	`+380 (94) 987-65-43`
`044 123 45 67`	`0949876543`	`094 987 65 43`
`+380441234567`	`+380949876543`	`+380949876543`

Jeśli liczba cyfr się różni, zastępczy numer jest wstawiany bez formatowania.

Obsługa SPA

Moduł podmiany telefonów używa MutationObserver do obserwacji dynamicznie dodawanych elementów. Jeśli Twoja strona jest zbudowana w React, Vue, Angular lub innym frameworku renderującym treść po załadowaniu strony — tracker wykrywa nowe elementy telefonów, gdy pojawiają się w DOM, i podmienia je automatycznie. Observer obserwuje całe body dokumentu pod kątem:

Nowych linków <a href="tel:...">
Nowych elementów z atrybutem data-revol-phone

Observer rozłącza się przy opuszczaniu strony, aby zapobiec wyciekom pamięci.

Reguły dopasowywania

Reguły podmiany telefonów wywodzą się z kampanii. Każda kampania z ustawionym zarówno Oryginalnym telefonem, jak i Telefonem zastępczym tworzy regułę.

Jak działa dopasowywanie

Tracker sprawdza parametry UTM odwiedzającego z polami dopasowania reguły. Wszystkie niepuste pola muszą pasować dokładnie (logika AND):

Reguła: { utm_source: "google", utm_medium: "cpc" }

✓ Odwiedzający z utm_source=google, utm_medium=cpc        → PASUJE
✗ Odwiedzający z utm_source=google, utm_medium=organic     → NIE PASUJE
✗ Odwiedzający z utm_source=facebook, utm_medium=cpc       → NIE PASUJE

Jeśli kampania ma ustawiony utm_source, ale utm_medium jest pusty — musi pasować tylko źródło. Puste pola są ignorowane przy dopasowywaniu.

Priorytet

Jeśli wiele kampanii pasuje do parametrów UTM odwiedzającego, używana jest pierwsza pasująca reguła. Reguły są zwracane w kolejności utworzenia.

Zdarzenia podmiany telefonów

Każda podmiana telefonu generuje zdarzenie phone_swap, śledzone raz na sesję odwiedzającego. Zdarzenie zawiera:

{
  "from": "+380441234567",
  "to": "+380949876543"
}

Zdarzenia podmiany telefonów pojawiają się w:

Dzienniku aktywności — jako typ zdarzenia phone_swap z danymi from/to
Tabeli Wydajność kampanii — w kolumnie Podmiany telefonów
Szczegółach sesji — na osi czasu zdarzeń sesji odwiedzającego

Przypadki użycia

Śledzenie połączeń z Google Ads

Utwórz kampanię z utm_source=google, utm_medium=cpc. Ustaw oryginalny telefon na główny numer firmowy, a zastępczy na dedykowany numer śledzący. Każde połączenie od odwiedzających z Google Ads jest przypisane do tej kampanii.Wynik: Widzisz dokładnie, ile połączeń generują Twoje wydatki na Google Ads — w tym samym panelu co rozmowy czatowe, wysyłki formularzy i odsłony stron.

Atrybucja wielokanałowa

Utwórz osobne kampanie dla każdego źródła ruchu — Google, Facebook, Instagram, newsletter e-mailowy — każdą z własnym numerem śledzącym. Ten sam oryginalny numer na stronie jest zastępowany innym numerem w zależności od tego, skąd przybył odwiedzający.

Kampania	Źródło	Numer śledzący
Google Brand	google / cpc	+380 44 111 1111
Facebook Ads	facebook / paid	+380 44 222 2222
Newsletter	newsletter / email	+380 44 333 3333
Organic	— (bez podmiany)	Oryginalny numer

Marketing offline (druk, billboardy)

Utwórz kampanię dla reklam drukowanych z unikalnym parametrem rvl_ref. Dodaj dedykowany numer telefonu. Gdy ktoś zadzwoni na numer z ulotki — wiesz, że pochodzi z druku, nie z internetu. Połącz z kodem QR do cyfrowego śledzenia tego samego materiału.

Śledzenie partnerów i poleceń

Daj każdemu partnerowi polecającemu własną kampanię z rvl_ref=partner_name i dedykowanym numerem śledzącym. Śledź dokładnie, ile połączeń generuje każdy partner — obok sesji, odsłon stron i rozmów z AI.

Testy A/B stron docelowych

Utwórz dwie kampanie z tym samym źródłem, ale różnymi wartościami utm_content (np. landing-v1 vs landing-v2), każda z innym numerem śledzącym. Porównaj liczbę połączeń między wariantami stron docelowych.

Integracja SIP

Podmiana telefonów staje się znacznie potężniejsza w połączeniu z integracją numerów SIP (VoIP). Gdy używasz numerów śledzących SIP jako zastępczych, cały cykl życia połączenia jest rejestrowany w Revol:

Odwiedzający widzi numer śledzący SIP

Tracker podmienia Twój oryginalny numer na numer śledzący połączony z SIP dla odwiedzających z konkretnej kampanii.

Odwiedzający dzwoni na numer SIP

Połączenie jest kierowane przez Twojego dostawcę VoIP (Binotel, Twilio itp.) i łączone z Twoim zespołem.

Połączenie jest nagrywane i analizowane

Z aktywną integracją VoIP połączenie jest nagrywane, transkrybowane i powiązane z sesją odwiedzającego. Widzisz pełną podróż: którą reklamę kliknął, jakie strony przeglądał i co powiedział podczas rozmowy.

AI analizuje rozmowę

Jeśli Twój agent AI jest skonfigurowany dla kanału integracji, może analizować transkrypcję rozmowy — zidentyfikować intencję odwiedzającego, wyekstrahować dane leada, ocenić jakość rozmowy, a nawet zasugerować działania następcze.

Co otrzymujesz

Z połączeniem Podmiany telefonów + integracji SIP masz kompletny pipeline atrybucji połączeń:

Punkt danych	Źródło
Która kampania przyciągnęła odwiedzającego	Parametry UTM → Dopasowanie kampanii
Które strony odwiedzający przeglądał przed zadzwonieniem	Przepływ stron sesji
Jak długo przebywał na stronie	Czas trwania sesji
Co powiedział podczas rozmowy	Nagranie rozmowy VoIP + transkrypcja
Jakość leada i intencja	Analiza AI rozmowy
Na który numer śledzący zadzwonił	Dane zdarzenia podmiany telefonu
Koszt za połączenie (jeśli znany wydatek na reklamy)	Atrybucja kampanii + dane platformy reklamowej

Tworzy to zamkniętą pętlę zwrotną: widzisz, że kliknięcie Google Ads doprowadziło do 3 odsłon stron, 45-sekundowego przeglądania, połączenia telefonicznego, w którym odwiedzający pytał o ceny, a AI oceniło go jako leada o wysokim zamiarze zakupowym — wszystko na jednej osi czasu sesji.

Najlepsze praktyki

Używaj dedykowanych numerów na kampanię

Nie używaj tego samego numeru śledzącego w wielu kampaniach — to niweczy cel atrybucji. Każda kampania powinna mieć unikalny numer zastępczy.

Dodaj data-revol-phone do wszystkich elementów z telefonem

Nawet jeśli używasz linków tel: (które są wykrywane automatycznie), dodanie data-revol-phone zapobiega migotaniu oryginalnego numeru przed zakończeniem podmiany.

Zachowaj spójność oryginalnego numeru

Używaj tego samego oryginalnego numeru telefonu we wszystkich kampaniach. Tracker szuka tego dokładnego numeru na stronie — jeśli Twoja strona wyświetla różne numery w różnych sekcjach, utwórz osobne reguły podmiany dla każdego.

Testuj z parametrami UTM

Po skonfigurowaniu reguły podmiany telefonu odwiedź swoją stronę z pasującymi parametrami UTM (np. ?utm_source=google&utm_medium=cpc) i sprawdź, czy numer się zmienia. Sprawdź Dziennik aktywności pod kątem zdarzenia phone_swap.

Szczegóły techniczne

Szczegół	Wartość
Moduł	`tracker/modules/phone-swap.js` — leniwie ładowany tylko gdy istnieją reguły
Dopasowywanie	Dokładne dopasowanie wszystkich niepustych pól UTM (logika AND)
Wykrywanie	Linki `<a href="tel:...">` + elementy `[data-revol-phone]`
Obsługa SPA	MutationObserver na `document.body` (childList + subtree)
Zapobieganie migotaniu	CSS `visibility: hidden` na `[data-revol-phone]` do momentu podmiany
Śledzenie zdarzeń	Jedno zdarzenie `phone_swap` na sesję (tylko pierwsza podmiana)
Odświeżanie konfiguracji	Co 5 minut poprzez odpytywanie konfiguracji w tle
Normalizacja numerów	Usuwa spacje, myślniki, nawiasy, kropki przed porównaniem

Tracker

Documentation Index

​Przegląd

​Jak to działa

​Zakładka Podmiana telefonów

​Dodawanie numerów telefonów na stronie

​1. Linki tel (automatyczne)

​2. Atrybut data (jawny)

​Zachowanie formatowania

​Obsługa SPA

​Reguły dopasowywania

​Jak działa dopasowywanie

​Priorytet

​Zdarzenia podmiany telefonów

​Przypadki użycia

​Integracja SIP

​Co otrzymujesz

​Najlepsze praktyki

​Szczegóły techniczne

Przegląd

Jak to działa

Zakładka Podmiana telefonów

Dodawanie numerów telefonów na stronie

1. Linki tel (automatyczne)

2. Atrybut data (jawny)

Zachowanie formatowania

Obsługa SPA

Reguły dopasowywania

Jak działa dopasowywanie

Priorytet

Zdarzenia podmiany telefonów

Przypadki użycia

Integracja SIP

Co otrzymujesz

Najlepsze praktyki

Szczegóły techniczne