B Blengi docs

De widget insluiten

Bekijk een voorbeeld van de agent op je site

Een sitevoorbeeld is een link die een van je pagina’s toont met de widget er al op, aangeboden door Blengi. Er hoeft niets op de site geïnstalleerd te worden om het te laten werken: de pagina wordt opgehaald, je stylesheets en afbeeldingen worden nog steeds vanaf je eigen host geladen, en de widget wordt aan het einde toegevoegd. Open de link en de agent is er.

Het is bedoeld voor het moment voordat de echte installatie klaar is — een demo voor morgen terwijl een tagmanager-aanpassing nog bij een bureau in behandeling is, een belanghebbende die de agent op de echte pagina wil zien in plaats van in een testomgeving, of een controle om te zien hoe de widget in een thema past. Het is geen manier om de agent voor bezoekers te laten draaien: de juiste installatie is het snippet, en een preview-link vervalt.

Maak een link aan

php artisan pitchbar:site-preview-link <agent-id> https://www.example.com/pricing/ --days=3

Het commando geeft een ondertekende URL weer. Links blijven standaard drie dagen geldig en maximaal veertien. Links binnen dezelfde site op de pagina worden opnieuw ondertekend met dezelfde vervaldatum, dus wie de preview opent, kan door de site klikken terwijl de agent de hele tijd aanwezig is; links naar andere sites blijven ongewijzigd.

Wat wel en niet getoond kan worden

  • De host van de pagina moet een van de toegestane bronnen van de agent zijn. Een preview kan alleen een site tonen waar de agent al toegang toe heeft, nooit die van iemand anders.
  • Gesprekken die via een voorbeeld worden geopend, zijn playground-gesprekken: ze verschijnen nergens in analytics, content gaps, leads of gebruiksstatistieken. De agent reageert precies zoals hij dat op de live-site zou doen, en paginavragen, segmenten en beperkte paden volgen de echte pagina-URL, niet die van het voorbeeld.
  • De pagina wordt opgehaald zoals een bezoeker die zou zien, zonder dat hij ingelogd is, en vijf minuten in de cache bewaard. Het eigen JavaScript van de pagina wordt niet uitgevoerd in een voorbeeld — noch de tag manager, noch de analytics, noch de embeds — omdat het voorbeeld wordt geserveerd vanaf het domein van deze app en er mag daar niets van een andere site worden uitgevoerd. Menu’s, schuifbalken en formulieren die hiervan afhankelijk zijn, worden weergegeven zoals het stylesheet ze opmaakt, wat voor een inhoudspagina vrijwel identiek is; formulieren worden niet verzonden.
  • Privé-, interne en onoplosbare adressen worden geweigerd, en de kopie bevat noindex, dus het komt nooit terecht bij zoekmachines.

Hoe de widget opstart zonder toegestane bronnen te raken

Het voorbeeld wordt aangeboden vanaf het domein van deze app, dat niet op je lijst met toegestane bronnen staat, en dat hoort ook niet zo. In plaats daarvan krijgt de widget een kortstondig voorbeeldtoken voor die ene agent, hetzelfde mechanisme dat de eigen Voorbeeldfunctie van het dashboard gebruikt. Het schakelt de herkomstcontrole voor een paar minuten uit vanaf elke keer dat je het opent, en verder niets, en daardoor wordt het gesprek gemarkeerd als ‘speelruimte’.