logo

Seznam pro vývojáře

Identita

Seznam pro vývojářeIdentitaVzorová implementace – inzerent

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

  1. 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ě.

  2. 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
    

  3. 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>