Nápověda menu

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 updateUserData ihned po přihlášení
  • Po dokončení objednávky – v události Purchase spolu 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.

arametrPopisFormát / příkladPriorita
emE-mail uživatelejan.novak@email.czKlíčový
phTelefonní číslo+420606666666Doporučený
fnJménoJanVolitelný
lnPříjmeníNovákVolitelný
gePohlavímf nebo oDoporučený
dbDatum narození19870223 (formát YYYYMMDD)Volitelný
ctMěstoPrahaDoporučený
zpPSČ14900Volitelný
srUlice a číslo popisnéUlice 12Volitelný
countryKód země (ISO 3166-1 alpha-2)czVolitelný
regionRegion nebo stát uvnitř federace – pro CZ může být kraj/okres (ANSI/ISO 3166-2 nebo libovolný řetězec)by (Bavorsko), Jihomoravský krajVolitelný
subscription_idID předplatnéhosubscription123Volitelný

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 (ctregionge…) 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.

Potřebujete další pomoc?

Pokud si stále nevíte rady, obraťte se na naše specialisty. 95 % vašich dotazů umíme vyřešit do 2 hodin.