Czech Ad Id (secid)

Ve spolupráci s CPEX přinášíme identifikátor, který je maximálně bezpečný a stabilní.

Jedná se o unikátní identifikátor přihlášeného uživatele, který Seznam vytvořil ve spolupráci se společností Czech Publisher Exchange z.s.p.o. (CPEX). Má nahradit cílení založené na cookies třetích stran, aby i po ukončení podpory těchto cookies dokázaly reklamní systémy pracovat s uživatelem napříč doménami.

Jak funguje?

Funguje to jen pro pro uživatele, kteří jsou přihlášení na Vašem webu.

1. Za pomoci veřejného API od Seznam.cz se nejdříve přihlásíte přes URL adresu:

   https://secid.iva.seznam.cz/oauth/token

2. Poté pošlete zahashovaný email (viz. normalizace a hashování níže) a získáte identifikátor, který je unikátní pro každého uživatele – secid (secondary ID):

   https://secid.iva.seznam.cz/api/v1/identities/{primaryID}/destinations/073e2a20-58e4-4322-ad8a-d9a9ce5ca584

Normalizovaný a hashovaný email

1. Odstraňte bílé znaky (před a za) a převeďte adresu na malá písmena.
2. Převeďte ji na UTF-8 encoded řetězec.
3. Zahashujte SHA-256 algoritmem.
4. Zkonvertujte na hexadecimální řetězec.

Máme pro vás připravené ukázky kódů pro použití v různých jazycích.

WorkFlow

Po úspěšném ověření přihlášeného uživatele na vašem webu získejte emailovou adresu a zpracujte ji podle výše uvedeného postupu. Následně si získaný identifikátor secid uložte např. do své databáze.

Při generování HTML Vaší stránky je pak potřeba tento identifikátor předat na frontend (HTML), kde se vloží do javascriptového objektu. Tento identifikátor následně používáme ke zpracování v dalších skriptech.

<script>
if (window.sznIVA && window.sznIVA.IS) {
	window.sznIVA.IS.updateIdentities({secid: 'hodnota secid'})
} else {
	window.addEventListener('szn:identities:ready', function() {
		window.sznIVA.IS.updateIdentities({secid: 'hodnota secid'})
	})
}
</script>

Diagram

Diagram znázorňuje postup získání secid – secondary ID – na vašem backendu a jeho předání JS skriptům od Seznam.cz.