Section 14 sur 14
Encart
Un encart, ce sont les prochains départs d’un arrêt, intégrés à votre propre
page web : le « comment venir » d’un restaurant, les informations pratiques
d’une salle, la page d’accueil d’une mairie, l’entrée d’un espace de
coworking. Vous le configurez sur myQuavern et vous collez une <iframe> dans
votre site. Il consomme vos unités Quavsit, avec le même forfait, le même
dépassement et le même plafond de dépense que l’API, et rien d’autre.
Ce que vous obtenez#
Un arrêt, de deux à huit départs, et la ligne de pied qui crédite l’exploitant. Chaque ligne porte le repère de ligne, la destination, le temps restant en minutes entières et l’heure de passage. Le carré ambre signale un départ réellement en temps réel ; une ligne d’horaire prévu reste à l’encre, et la différence figure aussi dans le texte annoncé par un lecteur d’écran.
Vous pouvez ajouter une ligne d’alerte de service, et une ligne de marche — la distance et le temps de marche depuis votre adresse jusqu’à l’arrêt, estimés à vol d’oiseau à 4,5 km/h. Aucun service de calcul d’itinéraire n’est appelé et il n’y a pas de carte.
Comment le configurer#
L’éditeur se trouve sur myQuavern, sous Encarts Quavsit. Vous choisissez l’arrêt, les lignes, le nombre de départs affichés, l’intervalle de rafraîchissement, le plafond d’unités quotidien, la présence des alertes, l’adresse de marche, le thème, la langue, le titre, et les sites autorisés à l’intégrer.
Cette dernière liste compte : un encart est servi aux origines que vous nommez
et à personne d’autre. Chacune est un protocole et un hôte, sans chemin,
https://example.com ou https://*.example.com ; http://localhost est
accepté aussi, pour construire un site avant sa mise en ligne. De une à cinq
origines.
Le code à coller#
L’éditeur écrit ce code pour vous, avec la hauteur déjà calculée pour le nombre de départs demandé.
<iframe src="https://quavsit.quavern.com/embed/qvw_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
title="Prochains départs — Quinconces"
width="100%" height="232" loading="lazy" referrerpolicy="origin"
style="border:0"></iframe>referrerpolicy="origin" est délibéré. L’encart doit savoir quel site
l’intègre, afin de vérifier votre liste d’origines, et il n’a besoin de rien de
plus que l’origine : l’adresse de la page n’est jamais transmise.
Si votre mise en page change la largeur, la hauteur peut changer avec elle. Ajoutez une fois l’assistant de redimensionnement, n’importe où dans la page, et chaque iframe Quavsit reçoit sa propre hauteur rendue :
<script src="https://quavsit.quavern.com/embed.js" defer></script>L’assistant pèse moins d’un kilo-octet. Il écoute un message venant de
quavsit.quavern.com et règle la hauteur de l’iframe qui l’a envoyé. Il
n’ajoute aucune variable globale, n’enregistre rien et n’envoie rien nulle
part.
Les états#
La personne qui lit votre page n’est pas cliente de Quavsit et ne s’est inscrite à rien, donc l’encart n’affiche jamais un code d’erreur, un forfait ou une connexion. Chaque état tient en une phrase sobre, dans la langue de l’encart.
| État | Ce que voit le lecteur |
|---|---|
| Des départs | la liste, et l’heure de son tracé |
| Rien à venir | « Aucun départ dans les 90 prochaines minutes. » |
| Flux temps réel muet | la liste, puis « Horaires de 14:02 ; le flux temps réel ne répond pas. » |
| Panne en amont | « Les départs sont indisponibles pour le moment. » |
| En pause | « Ce tableau des départs est en pause. » |
| Unités épuisées, plafond atteint, compte inactif | « Ce tableau des départs n’est pas disponible. » |
| Jeton inconnu, ou site absent de la liste | « Ce tableau des départs n’est pas disponible. » |
Vous voyez la vraie raison dans l’éditeur, et pour un quota épuisé ou un plafond quotidien atteint vous recevez un courriel par jour.
Ce que cela coûte#
Un rafraîchissement lit les départs d’un arrêt et coûte 1 unité, le poids de lecture de l’API. Un encart est rafraîchi au plus une fois par intervalle, quel que soit le nombre de visiteurs ayant votre page ouverte : le deuxième visiteur dans la fenêtre reçoit la réponse du premier, gratuitement. Avec les alertes activées, les alertes de l’arrêt sont lues au plus une fois toutes les 300 secondes, pour 1 unité.
Personne ne regarde, rien n’est dépensé. La page ne lit que pendant que l’iframe est à l’écran, donc un onglet en arrière-plan, un accordéon replié et un téléphone dans une poche ne coûtent rien, et une session de lecture s’arrête au bout de vingt minutes avec une commande « Afficher de nouveau les horaires en direct ». Une page laissée ouverte en permanence s’arrête donc d’elle-même ; un lieu équipé d’un écran veut plutôt un tableau des départs, qui est fait pour cela.
Le coût suit les visites plutôt que les pics de trafic : environ une unité par visite, moins quand les visites se chevauchent, et jamais plus que le plafond quotidien que vous fixez. Sur le forfait gratuit ce plafond est de 150 unités par jour, soit environ 150 visites par jour à l’intervalle gratuit de 120 secondes, et cela reste dans les 5 000 unités mensuelles du forfait.
| Forfait | Encarts | Intervalle le plus court | Plafond quotidien, défaut et maximum |
|---|---|---|---|
| Gratuit | 1 | 120 s | 150 / 150 |
| À la demande | 3 | 60 s | 600 / 2 000 |
| Starter | 5 | 60 s | 600 / 2 000 |
| Pro | 20 | 30 s | 2 000 / 10 000 |
| Max | 50 | 30 s | 5 000 / 43 200 |
Un changement de forfait ne modifie jamais un encart : une baisse de forfait le conserve et applique le nouveau plancher, et l’éditeur indique quel nombre est appliqué et pourquoi.
Confidentialité#
La personne qui lit votre page n’a rien demandé à Quavern, donc l’encart ne
coûte à votre page rien que vous ayez à expliquer. Il ne dépose aucun cookie,
n’écrit ni dans localStorage ni dans sessionStorage, et n’émet aucune
requête vers un tiers : les polices, les styles et les données viennent toutes
de quavsit.quavern.com. Il n’y a rien ici qu’une bannière de consentement
aurait à couvrir.
La page est servie en noindex, nofollow et absente du plan du site Quavsit :
son contenu appartient à votre page, pas à l’index de qui que ce soit.
Deux choses parviennent tout de même au serveur de Quavern, comme pour toute image ou tout cadre chargé par une page : l’origine de votre site, transmise par le navigateur parce que le code collé le demande et utilisée uniquement pour vérifier votre liste, et l’adresse du lecteur, dont le serveur a besoin pour répondre. Le lecteur n’est ni identifié, ni profilé, ni mesuré, et l’encart ne porte aucune analyse d’audience.