logo

Seznam pro vývojáře

Identita

Seznam pro vývojářeIdentitaCzech Ad Id (secid)

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.

WEB.CZ Backend (PHP, Python, ASP, ...) Váš přihlašovací proces, získáte email uživatele uzivatel@mail.cz Z tohoto emailu získejte secondary ID – secid a pošlete do svého frontendu b23fcff7-eacb-4ce8-98a5-a415eaf3bde2 Frontend (HTML, React, Angular, ...) Zde máte načten jeden ze skriptů: ssp.js, rc.js a zde voláte fci z našeho API: if (window?.sznIVA?.IS) { window.sznIVA.IS.updateIdentities({secid: 'hodnota secid'}) } else { window.addEventListener('szn:identities:ready', function() { window.sznIVA.IS.updateIdentities({secid: 'hodnota secid'}) }) } Následně odchází request do Seznamu, at už rtg/conv, ssp, ... a ten již automaticky obsahuje předaný secid SEZNAM.CZ endpoint Czech Ad ID endpoint