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>