Identita – Seznam pro vývojáře

Vzorová implementace – inzerent

Ukázka implementace konverzního kódu a předání identit do ekosystému Seznamu. Vhodné pro všechny inzerenty Skliku a Zboží.cz, kteří používají skript rc.js.

Postup

Vložení skriptu rc.js do stránky
Do těla stránky (<body>) vložíte značku <script> s rc.js skriptem od Seznamu:
```
<script src="https://c.seznam.cz/js/rc.js"></script>
```
V ideálním případě tento skript načítejte synchronně.
Nastavení identifikátorů do Objektu identity
Objekt identity je automaticky a synchronně importován v rámci skriptu výše. Po vložení rc.js do stránky je tedy rovnou dostupné API v objektu window.sznIVA.IS a je možné nastavit jednotlivé identifikátory:
```
<script>
window.sznIVA.IS.updateIdentities({
	eid: "email.zakaznika@email.cz", // email či zahashovaný email
    aid: {
        a1: "Česká republika", // vyplňte stát
        a2: "Praha", // vyplňte město
        a3: "Radlická", // vyplňte ulici
        a4: "3294/10", // vyplňte číslo popisné
        a5: "150 00", // vyplňte poštovní směrovací číslo
    },
    tid: "+420 234 694 111" // vyplňte telefonní číslo
});
</script>
```
Není povinné posílat vždy všechny identifikátory. Pokud máte všechny potřebné údaje, můžete poslat všechny nebo jen ty, co máte. Např. pokud máte jenom emailovou adresu nebo v rámci adresy máte jen stát, tak pošlete pouze tyto údaje nebo je necháte prázdné.

Pokud chcete smazat některé z identit, například když uživatel odvolá dříve udělený souhlas, použijte následující metodu:
```
window.sznIVA.IS.clearIdentities(['said', 'secid', 'eid', 'aid', 'tid']);
// odstraní pouze zmíněné identifikátory
```

Volání retargetingového/konverzního kódu

Když máte nastaveny všechny potřebné identifikátory v Objektu identity, můžete přejít k odeslání retargetingového hitu:

<script>
var retargetingConf = {
	rtgId: 123456, /* identifikátor retargeting */
	consent: 1
	/* souhlas od návštěvníka na odeslání retargetingového hitu, 
		povolené hodnoty: 0 (není souhlas) nebo 1 (je souhlas) */
};
// protože jsme rc.js načetli synchronně, můžeme volat 
// retargetingový hit okamžitě
window.rc.retargetingHit(retargetingConf);
</script>

nebo odeslání konverzního hitu:

<script>
// příklad volání konverzního kódu:
var conversionConf = {
	id: 10000000, /* identifikátor konverze Sklik*/
	value: 199.9, /* hodnota objednávky v Kč*/
	consent: 1
	/* souhlas od návštěvníka na odeslání konverzního hitu, 
		povolené hodnoty: 0 (není souhlas) nebo 1 (je souhlas) */
};
// protože jsme rc.js načetli synchronně, můžeme volat 
// konverzní hit okamžitě
window.rc.conversionHit(conversionConf);
</script>

Ukázka kompletní implementace

Výsledná implementace na stránce inzerenta by měla vypadat takto:

<! DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Partner</title>
</head>
<body>
<!–– Vložení rc.js ideálně synchronně ––>
<script src="https://c.seznam.cz/js/rc.js"></script>

<script>
	// protože se IS - Objekt Identity importuje v rc.js synchronně,
	// rovnou můžete volat:
	window.sznIVA.IS.updateIdentities({
		eid: "email.zakaznika@email.cz", // email či zahashovaný email
		aid: {
			a1: "Česká republika", // vyplňte stát
			a2: "Praha", // vyplňte město
			a3: "Radlická", // vyplňte ulici
			a4: "3294/10", // vyplňte číslo popisné
			a5: "150 00", // vyplňte poštovní směrovací číslo
		},
		tid: "+420 234 694 111" // vyplňte telefonní číslo
	})

	// pokud chcete smazat některé z identit, například když
	// uživatel odvolá dříve udělený souhlas, použijte následující metodu:
	window.sznIVA.IS.clearIdentities(['said', 'secid', 'eid', 'aid', 'tid']);

	// příklad volání retargetingového kódu:
	var retargetingConf = {
		rtgId: 123456, /* identifikátor retargeting */
		consent: 1
		/* souhlas od návštěvníka na odeslání retargetingového hitu, 
			povolené hodnoty: 0 (není souhlas) nebo 1 (je souhlas) */
	};
	// protože jsme rc.js načetli synchronně, můžeme volat 
	// retargetingový hit okamžitě
	window.rc.retargetingHit(retargetingConf);

	// příklad volání konverzního kódu:
	var conversionConf = {
		id: 10000000, /* identifikátor konverze Sklik*/
		value: 199.9, /* hodnota objednávky v Kč*/
		consent: 1
		/* souhlas od návštěvníka na odeslání konverzního hitu, 
			povolené hodnoty: 0 (není souhlas) nebo 1 (je souhlas) */
	};
	// protože jsme rc.js načetli synchronně, můžeme volat konverzní hit hned
	window.rc.conversionHit(conversionConf);
</script>
</body>
</html>