Identifikace zdroje návštěvy

Na webech partnerů zapojených do služby Newsfeed a dalších služeb, prostřednictvím kterých přivádíme návštěvnost (např. Novinky – denní tisk, HP boxy, Trending Topics, Asistent, AI funkce nebo Lidé.cz) je třeba do obsluhujícího JavaScriptu přidat funkce pro identifikaci zdroje návštěvy.

Standardní partner nevyužívající žádnou z těchto služeb neimplementuje žádný z následujících postupů.

Pro správnou funkčnost je nezbytné zajistit dostupnost funkcí výdejového skriptu Seznam SSP vložením do HTML hlavičky stránky:

<script src="https://ssp.seznam.cz/static/js/ssp.js"></script>

UTM parametry

Pokud uživatel klikne na odkaz vedoucí na váš web umístěný v některém ze Seznam kanálů, dostane se na vaše stránky s UTM parametry v URL ve tvaru:

Pro uživatele, kteří přicházejí ze služeb identifikovaných těmito UTM parametry v URL, je nutné zobrazovat reklamu pouze od Seznam.cz.

Co se děje, když uživatel váš web opustí a vrátí se

Chování SSP skriptu a výdej reklamy závisí na UTM parametrech v URL a aktuálním stavu session. Session cookie zůstává platná dalších 30 minut od posledního načtení stránky na dané doméně.

• URL stránky obsahuje UTM parametry (příchod ze Seznam kanálu) → vždy znamená založení nové session (nebo přepsání původní, pokud již existuje) a výdej reklamy od Seznamu.
• URL stránky neobsahuje UTM parametry, vyhodnocuje se stav session:
  • Session neexistuje (session cookie neexistuje, nebo již expirovala) → vydává se vaše vlastní reklama (z vámi zvolených zdrojů).
  • Session existuje → vydává se reklama od Seznamu a s každým načtením stránky na dané doméně (nejčastěji přechodem na jinou stránku vašeho webu) se obnovuje platnost session cookie na 30 minut.

Jak implementovat výdej

V Seznam SSP je pro identifikaci zdroje návštěvy určena metoda sssp.displaySeznamAds(), která vrací true, pokud uživatel přišel z některého ze Seznam kanálů (v URL jsou UTM parametry) nebo má platnou session.

<script>
  if (sssp.displaySeznamAds()) {
    // uživatel přišel ze Seznam kanálu – vydávám Seznam reklamu
    sssp.getAds([
      // identifikace volaných reklamních zón
    ]);
  } else {
    // vydávám vlastní reklamu
  }
</script>

Callback před výdejem reklamy

Pokud potřebujete před vypsáním reklamy provést přípravné kroky (například přeskládat layout nebo umístění reklamy), použijte sssp.conf.preparePositionsCallback():

<script>
  sssp.conf.preparePositionsCallback = function() {
    // vaše příkazy k provedení
  };

  if (sssp.displaySeznamAds()) {
    sssp.getAds([
      // identifikace volaných reklamních zón
    ]);
  } else {
    // vaše vlastní reklama
  }
</script>

Volitelný zákaz automatického načítání dot-small.js

Následující postup používejte pouze v případě, že přesně víte, čeho chcete dosáhnout. V některých případech je třeba zakázat automatické načítání dot-small.js v rámci SSP. Dosáhneme toho nastavením:

<script>
  window._sspDoNotLoadDOT = true;
</script>

Funkce z dot-small.js jsou pro správné fungování výdeje nezbytné. Ruční načtení a zkonfigurování dot-small.js proto musí proběhnout před vložením ssp.js:

<script src="https://h.seznam.cz/js/dot-small.js"></script>
<script src="https://ssp.seznam.cz/js/ssp.js"></script>

Příchod uživatele z Newsfeedu, Denního tisku nebo HP boxu (platné do 31. 5. 2026)

Do 31. 5. 2026 platilo, že pokud uživatel klikl na odkaz na váš článek umístěný v Newsfeedu, Denním tisku nebo HP boxu, dostal se na vaše stránky s UTM parametry v URL ve tvaru:

• Newsfeed – ?utm_source=www.seznam.cz&utm_medium=sekce-z-internetu#dop_ab_variant=1&dop_source_zone_name=hpfeed.sznhp.box&dop_req_id=…
• HP boxy – ?utm_source=www.seznam.cz&utm_medium=z-boxiku
• Seznam Prohlížeč – ?utm_source=www.seznam.cz&utm_medium=sbrowser
• Denní tisk – ?utm_source=www.seznam.cz&utm_medium=denni-tisk