Uživatelská data
Odesílání uživatelských dat umožňuje přesné párování konverzí a retargetingových publik i v prostředí bez cookies – například na mobilních zařízeních nebo v prohlížečích blokujících sledování třetích stran.
Proč zasílat uživatelská data?
Klíčovým identifikátorem je e-mail uživatele (em). Pokud ho znáte (přihlášený zákazník, dokončená objednávka), propojí SEM událost s konkrétním uživatelem i bez přítomnosti cookie. To zvyšuje přesnost přiřazení konverzí a kvalitu retargetingových publik napříč zařízeními.
Ostatní parametry (telefon, jméno, adresa, pohlaví…) jsou volitelné. Lze je využít jako podmínky při tvorbě retargetingových a konverzních seznamů – například cílit jen na zákazníky z určitého města nebo filtrovat podle pohlaví.
Hashování probíhá automaticky
Při frontendové implementaci (skript, GTM šablona) předávejte hodnoty v čitelné podobě. SEM skript je před odesláním automaticky zahashuje algoritmem SHA-256. Výjimka platí pouze pro S2S měření – tam hashujete na svém serveru sami.
Kdy uživatelská data odesílat?
- Po přihlášení uživatele – zavolejte
updateUserDataihned po přihlášení - Po dokončení objednávky – v události
Purchasespolu s daty objednávky - Kdykoli jsou data k dispozici – například po načtení stránky u přihlášeného uživatele
Parametry uživatelských dat
Všechny hodnoty jsou typu string. Při frontendové implementaci je zasílejte v čitelné podobě – hashování zajistí skript.
| arametr | Popis | Formát / příklad | Priorita |
|---|---|---|---|
em | E-mail uživatele | jan.novak@email.cz | Klíčový |
ph | Telefonní číslo | +420606666666 | Doporučený |
fn | Jméno | Jan | Volitelný |
ln | Příjmení | Novák | Volitelný |
ge | Pohlaví | m, f nebo o | Doporučený |
db | Datum narození | 19870223 (formát YYYYMMDD) | Volitelný |
ct | Město | Praha | Doporučený |
zp | PSČ | 14900 | Volitelný |
sr | Ulice a číslo popisné | Ulice 12 | Volitelný |
country | Kód země (ISO 3166-1 alpha-2) | cz | Volitelný |
region | Region nebo stát uvnitř federace – pro CZ může být kraj/okres (ANSI/ISO 3166-2 nebo libovolný řetězec) | by (Bavorsko), Jihomoravský kraj | Volitelný |
subscription_id | ID předplatného | subscription123 | Volitelný |
Metoda updateUserData
Uživatelská data odesílejte metodou SEM('updateUserData', userData). Zavolejte ji kdykoli jsou data k dispozici – nejlépe ihned po přihlášení uživatele nebo při načtení stránky, kde víte, že je zákazník přihlášen.
const userData = {
em: "jan.novak@email.cz", // hashuje se automaticky
ph: "+420606666666",
fn: "Jan",
ln: "Novák",
ge: "m",
db: "19870223",
ct: "Praha",
zp: "14900",
sr: "Ulice 12",
country: "cz"
};
SEM('updateUserData', userData);
Pokud odesíláte pouze e-mail, stačí minimální varianta:
SEM('updateUserData', { em: "jan.novak@email.cz" });
Odesílání spolu s událostí
Uživatelská data lze nastavit jednou pomocí updateUserData a pak odesílat události normálně – data se přiloží automaticky. Nebo je lze předat přímo v těle události. Obě varianty jsou rovnocenné.
// Zavolejte ihned po přihlášení uživatele
if (isLoggedIn) {
SEM('updateUserData', {
em: currentUser.email
});
}
// Následné události se automaticky propojí s tímto uživatelem
SEM('track', 'ViewContent', { /* ... */ });
S2S měření – hashujte sami
Při Server-to-Server měření musíte osobní data hashovat algoritmem SHA-256 na svém serveru před odesláním do Skliku. Výsledek je hexadecimální řetězec 64 znaků.
Před hashováním normalizujte hodnoty
- E-mail: převeďte na malá písmena, odstraňte mezery na začátku a konci
- Telefonní číslo: použijte formát E.164 (např.
+420606666666) - Jméno, příjmení, město: malá písmena, diakritiku není nutné odstraňovat
Node.js
const crypto = require('crypto');
function hashValue(value) {
return crypto
.createHash('sha256')
.update(value.trim().toLowerCase())
.digest('hex');
}
const userData = {
em: hashValue('jan.novak@email.cz'),
ph: hashValue('+420606666666'),
fn: hashValue('jan'),
ln: hashValue('novák'),
};
PHP
function hashValue($value) {
return hash('sha256', strtolower(trim($value)));
}
$userData = [
'em' => hashValue('jan.novak@email.cz'),
'ph' => hashValue('+420606666666'),
'fn' => hashValue('jan'),
'ln' => hashValue('novák'),
];
Python
import hashlib
def hash_value(value):
return hashlib.sha256(value.strip().lower().encode()).hexdigest()
user_data = {
'em': hash_value('jan.novak@email.cz'),
'ph': hash_value('+420606666666'),
'fn': hash_value('jan'),
'ln': hash_value('novak'),
}
Využití v retargetingu a konverzích
Geografické a demografické parametry (ct, region, ge…) lze použít jako podmínky při tvorbě retargetingových seznamů a konverzí v sekci Správa měření. Například:
- Retargetingový seznam pouze pro zákazníky z Prahy → podmínka
ct = Praha - Konverze pouze pro ženy → podmínka
ge = f - Kombinace: zákazníci z Brna, kteří si prohlédli kategorii „Televize“
Podmínky v rámci jedné události se vyhodnocují podle objektů v poli contents – kombinace parametrů platí vždy v rámci jednoho objektu (logika AND uvnitř objektu, logika OR napříč objekty). Více v sekci Dynamický retargeting.
Návod na hashování e-mailu (EID)
Podrobný technický popis správného hashování pro S2S najdete na vyvojari.seznam.cz/identita/eid.