4.13. Slevové kódy přes API

Owned by Matěj Hron (Unlicensed)
Last updated: Jan 08, 2024
2 min read

  • Modul poskytuje možnost načítání individuálních slevových kódů do kampaní přes API v reálném čase odeslání kampaně.

  • Výhodou modulu je možnost jednoduché kontroly slevových kódů, které jsou díky historii odeslaných e-mailů lehce dohledatelné.

  • Nastavení:

    • V nastavení tohoto modulu je možné vyplnit API endpoint, což znamená URL adresu e-shopu na straně klienta.

    • Pokud se na tuto URL adresu následně pošle požadavek, vrátí se konkrétní slevový kód.

Nastavení modulu “Slevové kódy přes API”

Pozor!

  • Využití tohoto modulu v kampani má omezení na 1 000 příjemců, protože se požadavky posílají přes e-shop klienta (kdyby se totiž kampaň poslala např. na milion zákazníků, mohl by e-shop spadnout).

  • Z tohoto důvodu je doporučeno tento modul používat pouze v automatizacích.

  • V případě získání jednoho slevového kódu přes API (např. pro “welcome” proces) Targito dle konfigurace při odeslání newsletteru v reálném čase kontaktuje API klienta (s limitem 5 sekund pro odpověď) a propíše získaný kód do e-mailu. Pokud v tomto případě dojde k jakémukoli problému v souvislosti s API, ovlivní to vždy pouze jeden konkrétní kontakt, kdy je rovněž možné propsat do šablony chybu s žádostí o kontaktování zákaznické podpory.

  • Lze rovněž získat přes API více kódů po jednom, nicméně tato možnost je doporučena pouze pro automatizace, u kterých je velmi málo kontaktů v daný okamžik. Zároveň je zde doporučené omezení 200 kontaktů v daný čas, poněvadž podle počtu e-mailů se tolikrát zavolá generování voucherů.

Informace:

  • Omezení na 200 kontaktů v daný čas je pouze doporučení (prakticky nedochází k žádnému bokování, pokud je počet kontaktů vyšší).

  • Toto doporučení plyne z obavy, že by značné množství API dotazů pro získání slevových kódů v jeden okamžik mohlo mít za následek zpomalení či jiné omezní funkčnosti celého procesu.

  • Nelze obecně zamezit odeslání newsletterů v případě, kdy dojde k selhání procesu získání slevových kódů vzhledem k tomu, že je obvykle vyžadováno odeslání i v případě, kdy se kód nepropíše (bude místo něho zobrazena chybová hláška).

  • Rovněž je třeba vzít v úvahu situaci, že se by se několika stovkách až tisícům kontaktů zobrazila chybová hláška s informací o kontaktování zákaznické podpory, což není žádoucí.

  • Teoreticky je možné získat přes API více kódů najednou, ovšem tato možnost není v platformě Targito zatím implementována. Zároveň je nezbytné, aby toto podporoval rovněž systém na straně klienta. Nicméně jednodušší a spolehlivější alternativou je import slevových kódů přímo do databáze Targita z dodaného souboru přes SFTP.

  • Pro zaručení spolehlivosti a rychlosti systému je vhodné nepracovat s externími zdroji dat, protože v rámci procesu může dojít k nějakému problému či dokonce výpadku, který Targito nebude mít možnost vyřešit.