Pruvodce - API

Parametr external_key (externí identifikátor)

External_key je parametr, ve kterém můžete předat externí identifikátor za účelem jeho propojení s individuálním vyplněním dotazníku (odpověďi).
Obvykle se v něm předává jedinečný identifikátor klienta (např. z online systému po přihlásení) nebo zdroj návštěvy (např. external_key=facebook nebo external_key=mailing).

Parametr je přidán jako klasický GET parametr do URL adresy průzkumu. Pomocí tohoto parametru lze dotazník vyplnit několikrát.
Parametr lze použít na všech úrovních zabezpečení Vašeho průzkumu.

Příkladové URL adresy

https://www.netquest.cz/dotaznik/123456/pruzkum-spokojenosti.html?external_key=facebook

http://dotaznik.mojefirma.cz?external_key=0002371231189

Popis parametrů odpovědi

NázevPopis
external_keyJedná se o libovolný řetězec alfanumerických znaků. Povolené znaky jsou a-z, A-Z, 0-9, bez diakritiky.

Prezentace a analýza výsledků

Je-li parametr external_key obsažen v URL dotazníku, zobrazí se tato informace na následujících místech:

  • Individuální vyplnění
  • Export RAW dat do formátu CSV
  • Export RAW dat do formátu XLSX
  • Export do SPSS

V případě RAW dat a souboru SPSS se jedná o sloupec v aplikaci Excel nebo další změnu V v programu SPSS. Více o prezentaci dat naleznete v článku Měření vyplnění pomocí parametru external_key.

External_key ve widgetu

External_key můžete předat také k vyplnění widgetu, ale tato vlastnost vyžaduje menší práci programátora.
V tomto případě se přenáší jedinečný identifikátor klienta (např. z online systému po přihlášení) nebo jiný parametr umožňující identifikaci vyplnění.

Parametr je přidán javaskriptovou proměnnou s názvem: widget_external_key.
Proměnná musí být definována před načtením kódu widgetu.
Proměnná musí být definována na každé podstránce, na níž je widget zobrazen.

Příkladový kód

Na níže uvedeném příkladu je abcd jedinečný identifikátor widgetu, tuto hodnotu lze nalézt v uživatelském panelu v záložce „Kód widgetu ke stažení”. Hodnota user12345 je jedinečný identifikátor uživatele (dynamická proměnná).

<script type="text/javascript">
    var widget_external_key = 'user12345';
</script>
<script type="text/javascript">(function(d,s,u,i){var e=d.createElement(s), p=d.getElementsByTagName(s)[0];e.async=1;e.src=u+'#id='+i; p.parentNode.insertBefore(e,p);})(document,'script','//cloud.netquest.cz/scripts/widget/script.min.js', 'abcd');</script>

Pomohl Vám tento článek?

Děkujeme za odpověď