← Všechny návody

Pokročilé

API a webhooky pro vývojáře

Napojte tracking na vlastní systémy, Zapier nebo Make.

Od plánu Pro můžete data napojit na vlastní nástroje přes REST API a webhooky (Nastavení → API klíče / Webhooky).

REST API

Vytvořte si API klíč a posílejte ho v hlavičce Authorization: Bearer <klíč>. Dostupné jsou přehled kódů, detail konkrétního kódu s historií cílů a stránkovaný seznam skenů včetně skutečně použitého pravidla a verze cíle.

Endpoint GET /api/v1/assets/<id>/scans podporuje limit, offset a filtry target, sourceType a sourceId. Historie je vždy omezena podle aktuálního plánu workspace.

Připsání skutečného výsledku kampaně

Konverzní API není navázané na WordPress, e-shop ani konkrétní rezervační službu. Funguje s jakýmkoli webem, aplikací, CRM, pokladním systémem nebo automatizací, která po dokončení akce umí bezpečně zavolat URL z backendu nebo serverového webhooku.

U konkrétního QR nebo NFC kódu nejprve v úpravě zapněte „Měřit výsledky kampaně přes API“. Při započítaném scanu QRsken přidá do cílové adresy parametr qrsken_ref. Cílový systém si ho uloží k návštěvě, objednávce, rezervaci či kontaktu a po dokončení odešle výsledek do POST /api/v1/conversions.

💡Pro běžný formulář lze na cílový web vložit veřejný pomocný skript https://www.qrsken.cz/qrsken-conversion-v1.js a formulář označit data-qrsken-conversion-form. Bez API klíče bezpečně přenese qrsken_ref do formuláře, po zachycení jej odstraní z adresního řádku; skutečnou konverzi stále zapisuje až váš backend nebo automatizace. Funguje i pro formulář, který se zobrazí až později v modalu.
  • Parametr qrsken_ref čtěte při první návštěvě a přeneste jej až k odeslanému formuláři nebo objednávce.
  • Pro každý výsledek odešlete vlastní stabilní event_id (např. ID objednávky) a typ purchase, reservation, lead nebo custom.
  • Hodnotu posílejte jen tehdy, když ji skutečně znáte; částka je v haléřích/centech společně s měnou, například 1 299 Kč = 129900 a CZK.
  • Do API nikdy neposílejte jméno, e-mail, telefon, adresu ani API klíč do JavaScriptu. Volání patří výhradně na backend vašeho webu.

Kde to použijete

  • E-shop: po zaplacení objednávky připište purchase včetně skutečné hodnoty objednávky.
  • Rezervace a objednávkové systémy: po vytvoření rezervace připište reservation. Pokud ji zákazník následně zruší nebo vrátí objednávku, odešlete bezpečné storno výsledku — do metrik se přestane započítávat, ale auditní stopa zůstane zachována.
  • Poptávkový formulář nebo CRM: po uložení kontaktu připište lead.
  • Pokladní/POS systém: při uplatnění QR nabídky lze připsat purchase s částkou z účtenky.
  • Make, Zapier nebo vlastní automatizace: trigger po nové objednávce či leadu zavolá API bez zásahu do hlavního webu.
  • Vlastní mobilní nebo webová aplikace: server po dokončení akce pošle custom událost.
💡WordPress formulář, WooCommerce, Shoptet doplněk nebo GetMyReservation jsou jen různé podoby téhož toku. Pokud návštěvník přišel jinak než přes měřený kód, systém normálně funguje — jen se výsledek nepřipíše konkrétnímu materiálu.
⚠️Výsledek znamená prokazatelnou akci po měřeném scanu, nikoli všechny objednávky firmy. Člověk, který uviděl billboard a přišel na web přímo, do QR atribuce nepatří.

Webhooky

Zadejte URL a při každém započítaném skenu na ni odešleme JSON s identifikací kódu, typem scan/tap, státem, městem, zařízením, OS, prohlížečem a objektem routing. Ten obsahuje typ a ID použitého pravidla, neměnnou verzi cíle, skutečnou cílovou URL a případnou A/B variantu. Každý požadavek je podepsaný hlavičkou X-QR-Signature (HMAC-SHA256), abyste si ověřili pravost.

💡Webhooky snadno propojíte se Zapierem nebo Make a odtud dál do CRM, tabulek nebo Slacku.

Související návody

🧪 A/B testy a chytré přesměrování📅 Naplánované přesměrování podle času🔀 Dynamické přesměrování podle podmínek