Adresa (aid)

Parametr není aktuálně využíván, ale je možné jej zasílat.

Objekt obsahující jednotlivé položky poštovní adresy uživatele vašeho webu (typicky zákazníka). Seznam.cz jednotlivé položky adresy standardizuje a hashuje na své straně. Doporučujeme primárně používat trvalou adresu (např. v e-shopech). Tzn. neprovádíte optimalizaci a hashování tak jako u jiných identifikátorů, ale necháte to na Seznamu.

Inzerent (nebo partner) má data plně pod svou kontrolou a je zodpovědný za data poskytnutá Seznamu. Inzerent (nebo partner) smí poslat uživatelská data pouze v případě, že k tomu má výslovný souhlas uživatele v souladu s platnou legislativou.

Struktura

Je nutné dodržet danou strukturu a obsah jednotlivých parametrů, ale pokud některý údaj chybí, nevyplňujte daný parametr a nechejte jej prázdný.

Jednotlivé identifikátory státu, města a ulice není nutné nijak standardizovat. Pošlete je ve formě, kterou máte uloženou u vás, ve scriptu pak probíhá normalizace těchto informací.

{
    "aid": {
        "ct":"Ústí nad Labem", // vyplňte město
        "sr":"Ulice 123", // vyplňte ulici a číslo popisné
        "zp":"401 00", // vyplňte poštovní směrovací číslo
        "country": "CZ", // vyplňte kód dvojznakový kód země např. CZ pro Českou republiku
        "st": "Ústecký kraj" // Územní celek uvnitř státu. V ČR kraj či jiná oblast, v Německu spolková země a v USA stát.
    }
}

WorkFlow

Po úspěšném ověření a přihlášení uživatele na vašem webu, můžete mít k dispozici např. trvalou adresu uživatele, zpracujte ji podle výše uvedeného postupu.

• pokud tento postup provádíte na svém backendu (PHP, Python, ASP, atd.) je potřeba tuto hodnotu předat na frontend, tedy do HTML dokumentu
• pokud tento postup provádíte na svém frontendu (JavaScript, apod.) toto odpadá

Na frontendu (HTML) je potřeba vytvořit značku script a do ní vepsat následující javascriptový kód, kterým předáte adresu dále ke zpracování skriptům od Seznam.cz.

<script>
if (window.sznIVA && window.sznIVA.IS) {
    window.sznIVA.IS.updateIdentities({aid: {objekt obsahující adresu}})
} else {
    window.addEventListener('szn:identities:ready', function() {
        window.sznIVA.IS.updateIdentities({aid:{objekt obsahující adresu}})
    })
}
</script>

Vlastní standardizace a hashování

Pokud chcete fázi standardizace a hashování provádět na své straně, postupujte dle návodu.

Pokud zvolíte přístup normalizace a hashování vlastní cestou, je nezbytně nutné se držet návodu výše, aby vše v rámci reklamního systému fungovalo správně.

Diagram

Diagram znázorňuje postup získání adresy na Vašem backendu a její předání JS skriptům od Seznam.cz.