Filtrování podle výsledků API

Filtr podle API umožňuje spouštět kampaně na základě dat získaných z externího endpointu – například informace o počasí, geolokaci, typu zařízení, provozu v okolí apod. Mailocator si před vyhodnocením kampaně načte JSON odpověď z vámi zadaného API a podle hodnot v ní rozhodne, zda se má kampaň zobrazit.

To vám dává možnost využít libovolná externí data, která nejsou dostupná v běžných filtrech, a přesně tak přizpůsobit zobrazení kampaně aktuální situaci.

Nastavení endpointu v Mailocatoru

Nejprve je potřeba napojit API endpoint v Nastavení Mailocatoru.

Otevřete Nastavení Mailocatoru a přejděte do Napojení externí API

adejte URL vašeho endpointu (např. služba pro počasí, geolokaci apod.)

Autentifikace

Aktuálně není podporována žádná autorizace na úrovni HTTP hlaviček (Basic Auth, Bearer token apod.).
Je ale možné poslat API klíč jako GET parametr v URL, například:
https://api.example.com/weather?city=Prague&api_key=XYZ123

Formát odpovědi – pouze JSON

Endpoint musí vracet data ve formátu JSON.
Jiné formáty (HTML, XML, text) nejsou podporovány. Typické je například:

{
  "city": "Prague",
  "temp": 5,
  "weather": "snow",
  "country": "CZ"
} 

Nastavení filtru v kampani

Jakmile máte endpoint nastavený, můžete s daty pracovat ve filtrech:

• V kampani zvolte filtr podle API.
• Přidejte libovolný počet podmínek podle názvů hodnot, které API vrací (např. weather, temp, country, segment).
• Můžete filtrovat podle rovnosti, rozsahu nebo konkrétních hodnot (např. weather = snow, temp = 0, country = CZ).

Mailocator při načtení stránky zavolá zadaný API endpoint, načte JSON data a vyhodnotí, zda podmínky filtru platí. Pokud ano, kampaň se může zobrazit.

Osvědčená praxe

Filtrovaní podle API se vyplatí zejména tam, kde potřebujete silný kontext zvenčí:

Počasí – nabídka zimního oblečení, horkých nápojů nebo topení při nízkých teplotách, naopak letní kampaně při horku.

Geolokace / region – lokální akce, dostupnost služeb jen v určitém městě nebo zóně.

Speciální stavy – např. API vrací stav vašeho systému, dostupnost produktu, “happy hours” nebo speciální promo okno.