Integrazione JavaScript: installazione
L'integrazione JavaScript di CrowdHandler è il modo più rapido e semplice per aggiungere una sala d'attesa a un sito web, ma presenta alcune limitazioni, illustrate qui di seguito : ti invitiamo a leggerle prima di configurare l'integrazione JavaScript.
Esistono due modi per aggiungere lo script dell'API CrowdHandler al tuo sito.
Se hai accesso al codice HTML e/o ai modelli, puoi aggiungere lo script manualmente.
Se non lo fai, o se preferisci non sporcarti le mani, puoi aggiungere lo script utilizzando Google Tag Manager.
Come ottenere tua API pubblica#
In entrambi i casi ti servirà la tua chiave API pubblica.
Per ottenere la tua chiave API pubblica, accedi a https://admin.crowdhandler.com e vai al tuo account.
Fai clic su " API " nella navigazione dell'account.
La tua chiave API pubblica è visibile nella parte superiore dello schermo.
Puoi cliccare sull'area degli appunti per copiare la chiave API pubblica oppure selezionare il codice e copiarlo.
Aggiunta dello script#
Inserisci il seguente tag script nella sezione head di tutte le pagine che desideri proteggere.
Replace <ch-public-key> with your Public API key.
<script src="https://wait.crowdhandler.com/js/latest/lite-validator/main.js?id=<ch-public-key>"></script>
Ad esempio, se la tua chiave API pubblica è 123456abcedf123456abcedf123456abcedf123456abcedf123456abcedf123, il tuo tag script sarà
<script src="https://wait.crowdhandler.com/js/latest/lite-validator/main.js?id=<strong>123456abcedf123456abcedf123456abcedf123456abcedf123456abcedf123</strong>"></script>
Nota: è importante che questo script venga eseguito il prima possibile, pertanto ti consigliamo di inserirlo prima di tutti gli altri tag script
Utilizzo di Google Tag
Google Tag Manager è un sistema di gestione dei tag che semplifica l'aggiunta di snippet HTML/JavaScript al tuo sito web. Abbiamo creato un modello di tag GTM dedicato che ti aiuterà a iniziare a utilizzare CrowdHandler sul tuo sito senza dover modificare il codice.
Questo tag applicherà CrowdHandler al tuo sito, consentendoci di gestire i flussi di visitatori, e deve essere aggiunto una sola volta.
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.
Ecco come installare CrowdHandler su un sito web tramite Google Tag Manager:
1. Scarica il
In fondo a questo articolo troverai un modello. Scaricalo sul tuo computer: ci servirà tra poco.
2. Creare un nuovo modello in Google Tag
Fai clic su " Modelli " nel menu di Google Tag Manager
Quindi seleziona "Nuovo " dal pannello "Modelli di tag".
3. Importa il di tag#
Fai clic sui puntini in alto a destra nell'interfaccia di Google Tag Manager per visualizzare il menu, quindi seleziona "Importa".
A questo punto, individua il file template.tpl che hai scaricato e importalo.
Fai clic su "Salva " e chiudi l'editor.
Il modello di tag dovrebbe ora essere disponibile nel menu dei modelli di tag.
4. Aggiungi il di tag#
Ora seleziona "Tag" dal menu di Google Tag Manager e fai clic su "Nuovo".
Fai clic sul pannello di configurazione dei tag e seleziona il tuo nuovo modello JavaScript CrowdHandler. Potrebbe essere necessario scorrere verso il basso per visualizzarlo.
5. Connettiti a
Per collegare il tuo sito a CrowdHandler, devi specificare la tua chiave API pubblica.
Incollalo nel campo “Chiave API pubblica ” nel modello di tag.
È importante che questo tag venga attivato il prima possibile, quindi apri le impostazioni avanzate e imposta la priorità di attivazione del tag su un valore elevato.
Nella sezione " Triggering ", crea un nuovo trigger cliccando sulla sezione "Triggering" e poi sul simbolo più (+).
Dovrai limitare l'attivazione del trigger in modo che scatti solo sul tuo dominio e protocollo di produzione (a meno che tu non stia esplicitamente effettuando un test su un ambiente di staging o di sviluppo, nel qual caso dovrai assicurarti che tali domini siano configurati su CrowdHandler); seleziona quindi “Visualizzazione pagina” come tipo di trigger, scegli “Questo trigger si attiva su alcune visualizzazioni di pagina ” come condizione e crea una condizione che si adatti al meglio al tuo caso d'uso.
Ad esempio, creare la condizione I domini iniziano con https://my-domain.com per limitare l'attivazione del trigger esclusivamente a https://my-domain.com.
Assegna un nome al tuo trigger e fai clic sul pulsante “Salva ”.
Ora scegli un nome per il tuo tag e clicca sul pulsante "Salva ".
Fai clic sul pulsante "Invia" e, nella schermata successiva, seleziona " Pubblica " per pubblicare le modifiche.
Ecco fatto! Lo script CrowdHandler è stato aggiunto al tuo sito: così noi ci occuperemo della gestione della folla e tu potrai concentrarti sulle vendite!