Installation du script DialOnce

Le script DialOnce est un morceau de code JavaScript qu'il est nécessaire d'ajouter dans les pages concernées par l'ajout du click-to-hub.

Préalablement, veuillez-vous assurer de bien disposer de la CLEF D’INTEGRATION qui vous a été fournie par votre Customer Success.

Sur les pages où le widget doit être affiché il convient d'ajouter un ID HTML sur chaque élément qui va servir de déclencheur et de transmettre les ID à votre CSM.

Usage

Le script est à intégrer sur votre gestionnaire de tag ou manuellement sur toutes les pages du site web nécessitant l'affichage du widget.

<aside> 💡 L'integrationKey est un jeton d'accès à notre API. Il vous sera fourni par votre Customer Success Manager.

</aside>

<script type="text/javascript">
var _dialonce = _dialonce || {};
_dialonce.integrationKey = "integration-key-here";
(function() {
  var dialonce = document.createElement("script");
  dialonce.id = "dialonce-sdk";
  dialonce.type = "text/javascript";
  dialonce.async = true;
  dialonce.src = "<https://cdn.dial-once.com/integrations-widget-widget/assets/auto.js>";
  var script = document.getElementsByTagName("script")[0];
  script.parentNode.insertBefore(dialonce, script);
})();
</script>

Informations de debug

Lorsque le script de DialOnce démarre sur la page, il recherche automatiquement les ID et Classes des balises de la page pour y ajouter son ancrage. S'il ne trouve pas les ID ou Classes, il affiche un log de warning dans la console du navigateur :

Page doesn't contains selectors: id: DIALONCE_Avant_Vente and/or class: null
Page doesn't contains selectors: id: DIALONCE_Suivi_commande and/or class: null

Cas spécial des SPA

Pour les Single Page Applications, il est nécessaire que le script précédent soit exécuté sur chaque changement du routeur où se trouve la balise HTML sur lequel le le widget sera appelé. En effet, c'est à l'exécution du script que se fait la liaison entre la balise HTML et le script.

Nous conseillons l'utilisation de composants custom qui permettront l'exécution du script lorsque le composant sera exécuté dans le DOM (ou le V-DOM).

Analyse du poids du Widget sur votre site

Lors de l'initialisation du script DialOnce, ce dernier va effectuer les 3 requêtes suivantes :