API JavaScript (nouvelle version)

Vue d’ensemble

L’API JavaScript de Pandectes vous permet d’interagir par programmation avec la bannière de consentement depuis le thème de votre boutique ou vos scripts personnalisés. Sans écrire de code complexe, comprendre ce que propose l’API vous aide à savoir ce qui est possible et quand demander à un développeur de la mettre en œuvre pour vous.
Cette fonctionnalité est disponible sur New Banner et accessible depuis All settings > JavaScript API.

Que peut-on faire avec l’API JavaScript ?

Lire l’état de consentement actuel du visiteur

L’API permet à votre boutique de savoir en temps réel ce à quoi un visiteur a consenti. Vous pouvez vérifier :

• Si un visiteur a autorisé le suivi analytique (par exemple Google Analytics, Microsoft Clarity)
• Si un visiteur a autorisé les cookies marketing (par exemple Facebook Pixel, TikTok)
• Si un visiteur a autorisé les cookies de préférences/fonctionnalités
• La décision complète de consentement du visiteur, sous la forme d’un objet unique

C’est utile lorsque vous souhaitez que d’autres parties de votre boutique se comportent différemment selon ce à quoi le visiteur a consenti.

Contrôler la fenêtre de consentement

L’API vous permet d’ouvrir ou fermer la fenêtre de la bannière de consentement à partir de n’importe quelle action sur votre boutique. Par exemple, un bouton dans le pied de page, un lien dans une page de politique de confidentialité ou une option « Paramètres des cookies » dans votre menu. Cela fonctionne en complément de la fonctionnalité de lien de menu intégrée, mais donne aux développeurs plus de souplesse pour la déclencher depuis n’importe quel élément de la page.

Définir ou mettre à jour le consentement par programmation

Dans les scénarios avancés, votre boutique peut définir directement la décision de consentement d’un visiteur. Par exemple, lorsqu’un visiteur fait un choix de consentement via une interface personnalisée que vous avez créée, ou lorsque le consentement est recueilli par un autre mécanisme et doit être transmis à Pandectes pour être appliqué.

Modifier la langue de la bannière

L’API permet de changer dynamiquement la langue de la fenêtre de consentement. Si votre boutique s’adresse à des visiteurs de plusieurs langues et détecte leur préférence, la bannière peut s’afficher dans la bonne langue sans dépendre uniquement de la langue par défaut du navigateur.

Réagir aux événements de consentement

L’API peut avertir votre boutique dès qu’un événement lié au consentement se produit, par exemple :

• Lorsque la bannière est entièrement chargée et prête
• Lorsque le visiteur ouvre la fenêtre de consentement
• Lorsque la fenêtre de consentement est fermée
• Lorsque le visiteur modifie ou soumet ses préférences de consentement

Vous pouvez ainsi créer des parcours qui réagissent instantanément au choix d’un visiteur. Par exemple, charger un script de suivi dès que le consentement est donné, sans avoir à recharger la page.

À qui est-elle destinée ?

L’API JavaScript s’adresse aux marchands disposant d’un développeur ou à ceux qui utilisent une vitrine personnalisée. Vous n’avez pas besoin d’utiliser ou de comprendre l’API pour que la bannière fonctionne. Elle fonctionne entièrement par elle-même dès l’installation. Cependant, si vous souhaitez une intégration plus poussée entre la bannière de consentement et le reste du comportement de votre boutique, l’API est l’outil adapté.

Premiers pas

Pour explorer l’API et consulter la référence complète, accédez à All settings > JavaScript API dans l’application Pandectes. La page contient la liste complète des propriétés, fonctions et événements disponibles, avec leurs descriptions. Si vous avez besoin d’aide pour mettre en œuvre un cas d’usage précis, n’hésitez pas à contacter notre équipe support.

Mis à jour le : 27/10/2026