Identita – Seznam pro vývojáře

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>