Comment démarrer avec le SDK browserless ?

Le SDK browserless vous permet d'utiliser les mêmes méthodes JavaScript que le SDK JS standard. C'est pourquoi il n'existe pas de documentation dédiée pour ce SDK ; il s'agit d'une liste des différences principales, tout le reste étant identique (vous pouvez trouver des informations complémentaires sur ces différences dans notre documentation pour développeurs : Javascript (browserless)

Le SDK browserless est conçu pour fonctionner en dehors d'un environnement navigateur (par exemple, dans des environnements purement serveur). Si vous pouvez accéder aux APIs du navigateur, vous devriez utiliser le SDK standard et non le browserless, même si vous êtes techniquement dans un environnement serveur.

Différences principales avec le SDK JS standard

Le SDK browserless n'offre pas de stockage permanent des données et informations nativement stockées dans les cookies (car il est destiné aux applications qui ne s'affichent pas dans un navigateur). Il ne fournit pas non plus les propriétés qui dépendent d'une API navigateur pour être définies.

Cela dit, le SDK browserless stocke tout de même les données pour la durée de la session active (tant que l'application est en cours d'exécution) dans une variable appelée localVariable. Il stocke l'équivalent de ce qui est stocké dans nos cookies, notamment : le mode de confidentialité, l'ID du visiteur et l'ID utilisateur.

Toutes les données stockées ne sont pas directement accessibles, mais notre SDK fournit des méthodes pour gérer ces données.

Gestion des données stockées en mode browserless

Mode de confidentialité : utilisez pa.privacy.getMode() et pa.privacy.setMode() Privacy | Piano Analytics Developers Documentation (atinternet-solutions.com)

Identification du visiteur (idclient) : utilisez pa.getVisitorId() et pa.setVisitorId() Visitor identification | Piano Analytics Developers Documentation (atinternet-solutions.com)

Utilisateurs : utilisez pa.getUser() et pa.setUser() Users | Piano Analytics Developers Documentation (atinternet-solutions.com)

Persistance entre les redémarrages (approche recommandée)

Les données stockées ne persistent pas lorsque l'application est arrêtée. Si vous souhaitez conserver ces informations plus longtemps, l'application doit les stocker de manière persistante elle-même et les restaurer au prochain lancement. Par exemple : stocker l'ID du visiteur de manière externe (base de données, stockage de session côté serveur, etc.), au prochain lancement forcer le même ID de visiteur en utilisant pa.setVisitorId(), et appliquer la même approche pour le mode de confidentialité et les informations utilisateur si nécessaire.

Considération importante relative au consentement

Comme le SDK browserless ne peut pas s'appuyer sur les cookies pour mémoriser l'état de confidentialité/consentement, vous devez vous assurer de disposer d'un système en place pour stocker et réutiliser le mode de confidentialité du visiteur entre les exécutions. Cela permet d'éviter de re-demander inutilement le consentement en raison de la perte de l'état de session.

Compatibilité en mode hybride

Le SDK JavaScript browserless peut être utilisé pour s'intégrer avec Piano en mode hybride. Les mêmes limitations s'appliquent : il n'y a pas de stockage de cookies, donc toute information habituellement persistée dans les cookies (y compris le mode de confidentialité) doit être gérée de manière externe si vous avez besoin de continuité entre les redémarrages de l'application.