1. 📥 Źródła danych UTM
Parametry UTM są pozyskiwane z następujących źródeł, według hierarchii priorytetów:
- Parametry z adresu URL (query string) – jeśli zawarte są w linku:
- utm_source, utm_medium, utm_campaign, utm_content, utm_term
- Google AdWords / DoubleClick – obecność gclid lub gclsrc w URL.
- Referrer (document.referrer) – analiza domeny odsyłającej.
- Ciasteczko ylutm – jeśli wcześniej zapisano dane UTM.
- Brak danych – przypisanie wartości (direct).
2. 📋 Reguły przypisywania UTM w kolejności ich zastosowania
🔹 Przypadek 1: Wejście z parametrami UTM w URL
Jeśli URL zawiera przynajmniej utm_source, to system:
- Używa dostępnych parametrów UTM z URL.
- Brakujące uzupełnia wartością (not set).
🔹 Przypadek 2: Kampania Google Ads (AdWords)
Jeśli obecny jest gclid, przypisywane są:
- utm_source: z URL lub „google”
- utm_medium: z URL lub „cpc”
- utm_campaign, utm_content, utm_term: z URL lub „adwords”
🔹 Przypadek 3: Kampania DoubleClick
Jeśli obecny jest gclsrc, przypisywane są:
- utm_source: „google”
- utm_medium: „cpc”
- utm_campaign, utm_content, utm_term: „DoubleClick”
🔹 Przypadek 4: Brak UTM, ale referrer obecny
Analiza domeny referrera:
- Jeśli to wyszukiwarka (np. Google, Bing):
- utm_source: nazwa wyszukiwarki
- utm_medium: „organic”
- utm_term: zapytanie z referrera lub (not provided)
- Jeśli to sieć społecznościowa (np. Facebook):
- utm_source: nazwa sieci
- utm_medium: „social”
- Jeśli to inna strona:
- utm_source: domena referrera
- utm_medium: „referral”
- utm_content: ścieżka URL referrera
🔹 Przypadek 5: Brak referrera lub referrer zgodny z aktualną domeną (direct)
Jeśli document.referrer jest pusty lub wskazuje na tę samą domenę co window.location.host:
- Jeżeli brak ciasteczka ylutm:
- utm_source: (direct)
- utm_medium: (none)
- utm_campaign: (direct)
- Pozostałe: (not set)
- Jeżeli ciasteczko ylutm istnieje:
- Wartości z ciasteczka nie są nadpisywane, pozostają stare wartości
3. ⏱️ Znaczenie czasu / sesji
- Parametry UTM są aktualizowane najczęściej na początku nowej sesji.
- Nowa sesja powstaje gdy brak ciasteczka sesji (ylssid)
- Parametry UTM mogą się zmienić w trakcie sesji, jeśli użytkownik w ramach sesji kliknął link z podanymi w nim parametrami UTM. Nie wpływa to jednak na UTM powiązane z sesją (tam są brane pod uwagę początkowe wartości), sprawi jednak, że np. formularze wypełnione w tej sesji będą zapisywane już z nowymi parametrami UTM. Dodatkowo UTM zostaną zapamiętane na poczet następnych sesji.
4. 🍪 Trwałość danych UTM
- Ciasteczko ylutm przechowuje dane przez 6 miesięcy..