Vyzkoušejte přednastavené kampaně a získejte první konverze do 15 minut.

Mailocator Engage / Pluginy 2026-01-29 11:47:34

Geolokační plugin v Mailocatoru

K čemu geolokační plugin slouží

Geolokační plugin umožňuje vyžádat od uživatele souhlas se sdílením polohy a následně s těmito polohovými daty pracovat v Mailocatoru. Pokud uživatel polohu poskytne, můžete na jejím základě spouštět nebo filtrovat kampaně, typicky pomocí radiusu v kilometrech ve filtrech kampaní.

Poskytnutí polohy nelze vynutit ani obejít. Uživatel musí udělit výslovný souhlas v rámci svého prohlížeče nebo zařízení.

Jak funguje geolokace v praxi

Po aktivaci pluginu Mailocator:

zobrazí výzvu k poskytnutí polohy,

uloží data o poloze (pokud jsou k dispozici a dostatečně přesná),

zpřístupní je pro použití ve filtrech kampaní (např. vzdálenost od bodu).

Pokud uživatel polohu neposkytne nebo zařízení polohu neumí určit, Mailocator s tímto stavem dále pracuje a podle něj se chovají filtry kampaní.

Výchozí chování pluginu

Pokud je geolokační plugin aktivní a není nijak upraven, platí tato výchozí pravidla:

výzva k poskytnutí polohy se zobrazí automaticky na druhé stránce návštěvy,

získaná poloha je uložena maximálně 150 dní (poté je nutné výzvu znovu zobrazit),

poloha je považována za platnou, pokud má přesnost do 10 km (10 000 m).

Tato pravidla jsou navržena, aby výzva nebyla rušivá a zároveň poskytovala použitelná data pro cílení kampaní.

Úprava chování pomocí vlastního JavaScriptu

Chování geolokačního pluginu lze upravit vložením konfiguračního objektu do Nastavení → Vlastní kód (JavaScript).

const mlGeolocationCfg = {
  run: "auto",
  ttl: 150,
  pageNum: 2,
  minAccuracy: 10000
} 

Význam jednotlivých parametrů

run – způsob spuštění výzvy (auto = automaticky)
ttl – doba platnosti uložené polohy ve dnech
pageNum – číslo stránky návštěvy, na které se výzva zobrazí
minAccuracy – maximální povolená nepřesnost v metrech

Možné stavy polohy

Geolokační plugin rozlišuje tyto stavy, se kterými lze dále pracovat:

unknown-location – Uživatel zatím polohu ani nepovolil, ani neodmítl. Výzva se zobrazí.

inaccurate-location – Zařízení vrátilo nepřesnou polohu (např. desktop bez GPS). Poloha se nepovažuje za platnou.

device-unavailable – Zařízení nemá přístup k údajům o poloze nebo je geolokace nedostupná.

located – Uživatel poskytl skutečnou polohu s požadovanou přesností.