logo

Seznam pro vývojáře

Identita

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

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.

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

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

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

  4. 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
    });
    

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