Vzorová implementace – partner
Jednoduchá ukázka implementace výdeje reklamy a předání identit do ekosystému Seznamu. Vhodné pro všechny partnery, kteří používají náš skript ssp.js.
-
Vložení skriptu ssp.js do stránky
Do těla stránky (
<body>
) vložíte značku<script>
s ssp.js skriptem od Seznamu:<script src="https://ssp.seznam.cz/static/js/ssp.js"></script>
V ideálním případě tento skript načítejte synchronně.
-
Vložení kontejneru pro reklamu
Do stránky vložíte kontejner s id atributem, ve kterém se bude reklama vykreslovat:
<div id="cnt-1234"></div>
Pozn.: cnt-xxxx – hodnota zoneId je v uživatelským rozhraní nahrazena skutečným ID zóny (v příkladu 1234)
-
Nastavení identifikátorů do Objektu identity
Protože se Objekt Identity načítá v SSP asynchroně a není tedy dostupný hned po načtení ssp.js, je potřeba počkat na událost szn:identities:ready:
<script> window.addEventListener('szn:identities:ready', function() { // nastavení všech získaných identit do // skriptů Seznamu, poté proveďte následovně: window.sznIVA.IS.updateIdentities({ eid: "email.zakaznika@email.cz", // email či zahashovaný email secid: "hodnota secondary id secid", said: "hodnota advert_user_id ziskaného z přihlášení přes Seznam", 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 }) // Zobrazení Seznam CMP dialogu // Vydávání reklamy });
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
-
Zobrazení Seznam CMP dialogu
Pokud nevydáváte reklamu, ale chcete jen zobrazit Seznam CMP dialog, proveďte následující:
<script> window.addEventListener('szn:identities:ready', function() { // Nastavení identit ssp.config({ "webId": "123456" }); // Vydávání reklamy });
-
Výdej reklamy
Pro výdej reklamy proveďte následující:
<script> window.addEventListener('szn:identities:ready', function() { // Nastavení identit // Zobrazení Seznam CMP dialogu // vydání reklamy if (sssp.displaySeznamAds()) { sssp.getAds({ zoneId: 1234, id: 'cnt-1234', width: 970, height: 210, }); } });
Ukázka kompletní implementace
Výsledná implementace na stránce partnera by měla vypadat takto:
<! DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Partner</title>
</head>
<body>
<!–– Vložení ssp.js ideálně synchronně ––>
<script src="https://ssp.seznam.cz/static/js/ssp.js"></script>
<!–– Kontejner pro reklamu ––>
<div id="cnt-1234"></div>
<script>
// protože se IS - Objekt Identity načítá v ssp asynchroně a
// není tedy dostupný hned po načtení ssp.js, je potřeba
// počkat na událost "szn:identities:ready"
window.addEventListener('szn:identities:ready', function() {
// nastavení všech získaných identit do
// skriptů Seznamu, poté proveďte následovně:
window.sznIVA.IS.updateIdentities({
eid: "email.zakaznika@email.cz", // email či zahashovaný email
secid: "hodnota secondary id secid",
said: "hodnota advert_user_id ziskaného z přihlášení přes Seznam",
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']);
// pokud nevydáváte reklamu, ale chcete jen
// zobrazit Seznam CMP dialog, proveďte následující:
ssp.config({
"webId": "123456"
});
// vydání reklamy
if (sssp.displaySeznamAds()) {
sssp.getAds({
zoneId: 1234,
id: 'cnt-1234',
width: 970,
height: 210,
});
}
})
</script>
</body>
</html>