Načítání widgetu

Skript, který zkopírujete z Konfigurace → Skript, obsahuje atribut data-kanbu-load. Určuje, kdy se po vložení skriptu stáhne a spustí samotný chatbot. Neovlivňuje, jestli se chat hned rozbalí — to nastavujete zvlášť jako Otevřít chat automaticky, viz Bubliny a výzvy.

Výchozí hodnota je idle. Tu má i skript vygenerovaný v aplikaci. Pro většinu webů ji nechte — chatbot se načte až po dokončení stránky, v době, kdy je prohlížeč volný.

1. Jak změnit strategii

  1. Zkopírujte skript z Konfigurace → Skript.
  2. Upravte hodnotu atributu data-kanbu-load (viz možnosti níže).
  3. Vložte upravený skript do Google Tag Manageru nebo do kódu webu — stejný postup jako v Nasazení na web.

Příklad s okamžitým načtením:

<script
  async
  src="https://loader.kanbu.ai/v0/embed.js"
  data-kanbu-agent-id="VASE-ID-AGENTA"
  data-kanbu-load="immediate"
></script>

Hodnotu pište malými písmeny. Neznámá nebo chybějící hodnota se chová jako idle.

2. Dostupné hodnoty

  • idle (výchozí, doporučené)

    Počká, až se stránka načte (window.load), a teprve potom stáhne widget v době, kdy je prohlížeč nečinný. Má nejmenší vliv na rychlost webu. Ikona chatu se může objevit o chvíli později než zbytek stránky.

  • load

    Stáhne widget hned po window.load, bez čekání na nečinnost prohlížeče. Chatbot se objeví dřív než u idle, ale pořád až po dokončení načtení stránky.

  • immediate

    Stáhne a spustí widget ihned, jakmile se spustí embed.js — nesoupeří o pořadí až po načtení stránky. Widget je k dispozici nejdřív. Zároveň nejvíc soutěží s ostatními zdroji stránky (obrázky, vlastní skripty), takže může zpomalit první vykreslení webu. Hodí se tam, kde má být chat hned připravený — landing page, QR odkaz, kiosk, nebo když máte zapnuté Otevřít chat automaticky.

  • interaction

    Widget se stáhne až po první akci návštěvníka (klik, stisk klávesy, dotyk nebo scroll). Do té doby chatbot nic nestahuje a web nezatěžuje. První otevření může chvíli trvat, protože se teprve v tu chvíli stahuje kód. Vhodné, když je priorita výkon webu a chatbot je jen doplněk.

3. Dopad na web a na chat

HodnotaKdy se widget stáhneDopad na rychlost webuKdy je chat k dispozici
idlepo načtení stránky, v nečinnostinejnižšío chvíli později
loadhned po načtení stránkynízkýpo načtení stránky
immediatehned se spuštěním skriptunejvyššínejdřív
interactionpo první akci návštěvníkaprakticky žádný do té dobyaž po interakci, s krátkým zpožděním

Strategie ovlivňuje jen stažení a spuštění widgetu. Až běží, platí stejná nastavení vzhledu, domén pro vložení i umístění.

Pokud je zapnuté Otevřít chat automaticky, chat se rozbalí až ve chvíli, kdy je widget načtený. S idle nebo interaction to tedy není okamžitě po otevření stránky — pro landing page nebo QR použijte immediate nebo load.

4. Volitelný timeout u idle

U idle můžete doplnit data-kanbu-idle-timeout — maximální čekání v milisekundách, než se widget stáhne, i když prohlížeč ještě není nečinný. Výchozí je 5000 (5 sekund).

<script
  async
  src="https://loader.kanbu.ai/v0/embed.js"
  data-kanbu-agent-id="VASE-ID-AGENTA"
  data-kanbu-load="idle"
  data-kanbu-idle-timeout="5000"
></script>

Na prohlížečích bez requestIdleCallback se widget po načtení stránky spustí prakticky hned.

Časté otázky

  • Musím atribut vůbec uvádět?

    Ne. Bez data-kanbu-load platí idle. Skript z aplikace ho ale obsahuje, aby bylo chování zřejmé.

  • Změní to, na kterých stránkách se chatbot zobrazí?

    Ne. Které stránky skript smí spustit, řeší Domény pro vložení a trigger v Google Tag Manageru.

  • Chat se po načtení stránky hned nerozbalí. Je to tahle volba?

    Ne. Rozbalení chatu nastavujete přepínačem Otevřít chat automaticky v Bublinách a výzvách. data-kanbu-load jen říká, kdy se kód chatbota vůbec stáhne.

  • Proč na pomalém webu chatbot vyskočí až později?

    Skript z aplikace používá idle. Widget čeká na dokončení stránky a volný prohlížeč. Pokud má být ikona (nebo otevřený chat) hned, změňte hodnotu na load nebo immediate.

Související

Zpět na Domény pro vloženíPokračovat na Správa provozu