L'intégration JavaScript de CrowdHandler est le moyen le plus rapide et le plus simple d'ajouter une salle d'attente à un site web, mais elle présente certaines limites, qui sont décrites ici - veuillez les lire avant de mettre en place l'intégration JavaScript.
Vous pouvez ajouter le script API de CrowdHandler à votre site de deux manières.
Si vous avez accès à votre html et/ou à vos modèles, vous pouvez ajouter le script manuellement.
Si ce n'est pas le cas, ou si vous préférez ne pas vous salir les mains, vous pouvez ajouter le script à l'aide de Google Tag Manager.
Obtenir votre clé d'API publique
Dans les deux cas, vous aurez besoin de votre clé d'API publique.
Pour obtenir votre clé d'API publique, connectez-vous à https://admin.crowdhandler.com et accédez à votre compte.
Cliquez sur API dans le menu de navigation navigation du compte.
Vous verrez votre clé d'API publique en haut de l'écran.
Vous pouvez soit cliquer sur le presse-papiers pour copier la clé de l'API publique, soit sélectionner le code et le copier.
Ajouter le script manuellement
Insérez la balise de script suivante dans l'en-tête de toutes les pages que vous souhaitez protéger.
Replace <ch-public-key> with your Public API key.
<script src="https://wait.crowdhandler.com/js/latest/main.js?id=<ch-public-key>"></script>
Par exemple, si votre clé d'API publique est 123456abcedf123456abcedf123456abcedf123456abcedf123456abcedf123456abcedf123, votre balise de script sera la suivante
<script src="https://wait.crowdhandler.com/js/latest/main.js?id=123456abcedf123456abcedf123456abcedf123456abcedf123456abcedf123"></script>
Note : Il est important que ce script soit exécuté le plus tôt possible, c'est pourquoi nous vous recommandons de l'insérer avant toutes les autres balises de script.
Utilisation de Google Tag Manager
Google Tag Manager est un système de gestion de balises qui facilite l'ajout de snippets HTML/JavaScript sur votre site web. Nous avons créé un modèle de tag GTM dédié qui vous aidera à utiliser CrowdHandler sur votre site sans modifier le code.
Cette balise appliquera CrowdHandler à votre site, nous permettant de gérer les foules et ne doit être ajoutée qu'une seule fois.
Important: Before you start, please make sure that Google Tag Manager is set up correctly on your website, according to the Google Tag Manager installation guide. Specifically, make sure that the <script> element of your Google Tag Manager container appears early on in the <head> section of your site and the <noscript> element appears at the beginning of the <body> section.
Voici comment installer CrowdHandler sur un site web via Google Tag Manager :
1. Télécharger le modèle
Vous trouverez un modèle au bas de cet article. Téléchargez-le sur votre ordinateur, nous en aurons besoin prochainement.
2. Créer un nouveau modèle dans Google Tag Manager
Cliquez sur Modèles dans le menu de Google Tag Manager
Sélectionnez ensuite New (Nouveau) dans le panneau Tag Templates (Modèles d'étiquettes).
3. Importer le modèle d'étiquette
Cliquez sur les points en haut à droite de l'interface de Google Tag Manager pour faire apparaître le menu et sélectionnez Importer.
Naviguez ensuite vers le fichier template.tpl que vous avez téléchargé et importez-le.
Cliquez sur Enregistrer et fermez l'éditeur.
Le modèle de balise doit maintenant être disponible dans le menu des modèles de balise.
4. Ajouter le modèle de balise
Sélectionnez ensuite Tags dans le menu Google Tag Manager et cliquez sur Nouveau.
Cliquez sur le panneau de configuration des balises et sélectionnez votre nouveau modèle Javascript CrowdHandler. Il se peut que vous deviez faire défiler la page vers le bas pour le voir.
5. Se connecter à CrowdHandler
Pour connecter votre site à CrowdHandler, vous devez spécifier votre clé API publique.
Collez-la dans le champ Clé API publique du modèle de balise.
Il est important que cette balise se déclenche le plus tôt possible. Ouvrez donc les paramètres avancés et réglez la priorité de déclenchement de la balise sur un chiffre élevé.
Dans la section Déclenchement, créez un nouveau déclencheur en cliquant sur la section Déclenchement, puis sur le symbole plus (+).
Vous devrez restreindre le déclencheur pour qu'il ne se déclenche que sur votre domaine et protocole de production (sauf si vous essayez explicitement de tester sur un environnement de développement ou de staging, auquel cas vous devrez vous assurer que ces domaines sont configurés sur CrowdHandler), donc sélectionnez Page View comme type de déclencheur, choisissez This trigger fires on Some Page Views comme condition et créez une condition qui corresponde le mieux à votre cas d'utilisation.
Par exemple, créez la condition Les domaines commencent par https://my-domain.com pour restreindre le déclencheur à https://my-domain.com.
Nommez votre déclencheur et cliquez sur le bouton Enregistrer.
Choisissez maintenant un nom pour votre balise et cliquez sur le bouton Enregistrer.
Cliquez sur le bouton Soumettre et choisissez Publier dans l'écran suivant pour publier les modifications.
Voilà, c'est fait ! Le script CrowdHandler a été ajouté à votre site pour que nous puissions gérer les foules et que vous puissiez gérer les ventes !