L'integrazione tramite API è l'opzione di integrazione personalizzata con Connectif che consente un controllo totale sui dati inviati, ma permette solo di sincronizzare Contatti, Prodotti, Acquisti e Coupon. Gli altri eventi dovranno essere integrati utilizzando altre opzioni, tag HTML o eventi JavaScript.
Prima di iniziare: vantaggi e limitazioni di un'integrazione tramite API
Per quanto riguarda i vantaggi:
- Non dipende dal client, poiché sarà una chiamata HTTP in cui puoi controllare la risposta ricevuta per assicurarti che l'evento sia arrivato e sia stato elaborato correttamente.
- È possibile effettuare importazioni massive. Mentre con le altre opzioni l'aggiornamento avviene sempre uno alla volta.
Le possibili limitazioni di un'integrazione tramite API sono le seguenti:
- Richiede un dipartimento IT capace di effettuare le chiamate necessarie all'API di Connectif.
- Esiste un numero massimo di chiamate API consentite al minuto, quindi per eseguire operazioni massive si consiglia di utilizzare l'API di importazione, dove una singola chiamata è in grado di sincronizzare più elementi.
- Non è possibile integrare tutti gli eventi tramite API, è necessario combinare questa opzione con altre modalità di integrazione.
Come integrare Connectif tramite API?
1. Aggiungere il JavaScript di Connectif
Configura il JavaScript di Connectif sul sito web affinché venga caricato su tutte le pagine per poter integrare tramite eventi.
2. Sincronizzare tramite API
Configura la sincronizzazione delle informazioni su:
- Contatti: per registrare i dati dei visitatori dell'eCommerce.
- Prodotti: per sincronizzare il catalogo.
- Acquisti: per descrivere gli acquisti effettuati dai clienti.
-
Coupon: per sincronizzare i codici coupon e i loro utilizzi.
3. Sincronizzare gli altri eventi con un altro metodo
3.1. Tag HTML renderizzati sul server o sul client:
- Tag "Stato attuale del carrello": per descrivere il carrello in un momento specifico.
- Tag "Etichetta di pagina": per assegnare un'etichetta a una pagina.
- Tag "Il contatto ha cercato un prodotto": per identificare una visita a un prodotto come risultato diretto di una ricerca dello stesso.
- Tag "Il contatto ha effettuato il login": per indicare che il contatto ha effettuato l'accesso.
- Tag "Il contatto si è registrato": per indicare una nuova registrazione.
-
Tag "Iscrizione alla newsletter": per indicare che un contatto si è iscritto alla newsletter.
3.2. Eventi inviati tramite JavaScript:
- Notifica di pagina visitata: per indicare che il contatto ha visitato una pagina durante la navigazione sul sito web.
- Notifica di prodotto visitato: per indicare che il contatto ha visitato un prodotto specifico durante la navigazione sul sito web.
- Notifica delle informazioni del carrello: per descrivere il carrello della spesa che il contatto ha in un momento specifico.
- Notifica di ricerca effettuata: per indicare che è stata effettuata una ricerca e identificare i termini utilizzati.
- Notifica di login: per indicare che il contatto ha effettuato l'accesso.
- Notifica di registrazione: per indicare una nuova registrazione.
-
Notifica di iscrizione alla newsletter: per indicare che un contatto si è iscritto alla newsletter.
5. Configurare le Web Push
Per completare l'integrazione, sarà necessario configurare il Service Worker per poter ricevere iscrizioni alle Web Push e inviare notifiche ai tuoi contatti.
- Inizia a gestire le notifiche Web Push.
6. Validare l'integrazione
Una volta implementato l'invio di informazioni a Connectif, il passo successivo sarà verificare che l'integrazione sia stata effettuata correttamente.
Continua a imparare!
Per sfruttare al massimo il potenziale del tuo account su Connectif, ti consigliamo di continuare con i seguenti articoli:
-
Onboarding, per acquisire familiarità con la nostra interfaccia.
-
Workflows iniziali, per implementare le tue prime strategie nell'account.
-
Integrazioni con sistemi esterni, per integrarti con Facebook, moduli e webhook del tuo sito web.
-
Eventi che consumano attività, per comprendere meglio il consumo del tuo account.