dsfr-data-beacon - Composants

Cible de télémétrie declarative. Pendant côté télémétrie de proxy-url : rend la collecte d'usage visible et retirable dans le HTML, au lieu d'un window.* opaque.

Invisible et opt-in : Ce composant ne rend rien et n'envoie aucun beacon lui-même. Par défaut la télémétrie est desactivee. Poser un <dsfr-data-beacon url="..."> avec un url non vide active la collecte et en designe la cible.

Le probleme resolu

Historiquement, la télémétrie d'usage se pilotait uniquement par des variables globales posees sur window avant le chargement des composants (window.DSFR_DATA_BEACON = true, window.DSFR_DATA_BEACON_URL). Un integrateur qui colle un embed ne voit pas qu'une télémétrie part, ni vers ou.

L'élément rend cette intention explicite dans le DOM : un opérateur (ministère, établissement public) peut diriger la collecte vers son propre collecteur sans toucher au JavaScript de la page, et un integrateur peut la retirer en connaissance de cause (argument RGPD / souverainete solide, contrairement a un window.* invisible).

Attributs

Attribut	Type	Format / Valeurs	Description
`url`	String	`url="https://collecte.ministere.fr"`	Domaine de collecte du beacon. Vide = pas de cible declarative (no-op).

Precedence et opt-in

L'URL de collecte est resolue, du plus spécifique au plus général :

<dsfr-data-beacon url>  >  window.DSFR_DATA_BEACON_URL  >  URL bakee au build

L'opt-in (off par défaut) est acquis si l'une de ces conditions est vraie :

window.DSFR_DATA_BEACON === true (opt-in global classique) ;
un <dsfr-data-beacon url="..."> avec url non vide est present.

Kill switch : window.DSFR_DATA_BEACON = false neutralise la collecte même si un élément est present (coherent avec window.DSFR_DATA_PROXY = false).

Exemples

Télémétrie vers un collecteur souverain

L'élément, visible dans la page, active et cible la collecte. Il peut être placé avant ou après les composants.

<dsfr-data-beacon url="https://collecte.ministere.fr"></dsfr-data-beacon>

<dsfr-data-source id="src" api-type="opendatasoft"
  dataset-id="..." base-url="https://data.gouv.fr">
</dsfr-data-source>
<dsfr-data-chart source="src" type="bar"
  label-field="region" value-field="total">
</dsfr-data-chart>

Retrait par l'integrateur

Pour desactiver la télémétrie, il suffit de retirer la ligne — ou de poser le kill switch :

<!-- Aucune ligne <dsfr-data-beacon> : aucune telemetrie declarative -->

<!-- ...ou neutralisation explicite, même si un élément traîne ailleurs : -->
<script>window.DSFR_DATA_BEACON = false;</script>

Comportement

Invisible : aucun rendu, aucun footprint de layout.
N'émet rien lui-même : ce sont les composants dsfr-data-* qui envoient le beacon a leur initialisation ; l'élément fournit seulement la cible/opt-in.
Ordre du DOM indifferent : l'élément est consulte en lookup paresseux au moment de l'envoi ; placé après un composant dans le HTML, il est malgre tout pris en compte.
Deduplication : un beacon par composant + variante par chargement de page.
Skip en dev : aucun envoi sur localhost / 127.0.0.1 ni sur le domaine de collecte lui-même.

Conseils d'utilisation

Transparence d'abord : preferez l'élément au window.* opaque pour les embeds destines a des sites tiers — l'integrateur voit la collecte et peut l'auditer.

Self-hosting : pointez url vers votre propre collecteur compatible (endpoint /beacon) pour garder la donnée d'usage chez vous.