Integra il tuo account Connectif con Reskyt per poter inviare notifiche push native tramite l'applicazione.
In questo articolo, imparerai come integrare il tuo account Connectif con Reskyt per raccogliere l’attività del contatto e un esempio di un workflow in cui viene inviata una notifica push a Reskyt.
Tempo di implementazione: 1 ora.
Difficoltà: Intermedio
Quando usarlo?: Per inviare notifiche push tramite l'app.
Questo è un esempio delle molte possibilità offerte da questa integrazione. Seguendo i principi base spiegati in questo articolo, potrai creare più strategie di invio push che ti aiutino a raggiungere i tuoi obiettivi.
Perché implementare l’estensione
1. Casi d’uso che potrai creare dopo questa integrazione
Ecco alcune idee che possono servirti per implementare diverse strategie nell’app di Reskyt dopo aver attivato nell tuo Negozio Connectif l’estensione con Reskyt.
- Recuperare carrelli abbandonati.
- Realizzare strategie di remarketing tramite le push di Reskyt.
- Inviare un augurio di compleanno ai contatti.
- Inviare uno sconto per l’anniversario del primo acquisto.
2. Cosa potrai fare con Connectif in Reskyt?
Con questa estensione, da Connectif potrai creare strategie automatizzate per inviare notifiche push tramite l’app Reskyt.
Inoltre, potrai raccogliere l’attività del contatto in Reskyt.
3. Quali dati di Connectif potrai usare in Reskyt?
Inoltre, in Reskyt potrai sfruttare tutte le informazioni raccolte nella scheda del contatto, così come la sua attività in tempo reale, per personalizzare le notifiche con i dati del contatto di Connectif.
Prima di iniziare: cosa devi tenere a mente
Per poter integrare il tuo account Connectif con Reskyt e automatizzare l’invio di notifiche push native, avrai bisogno di:
Richiedere a Reskyt l’attivazione dell’API e il suo valore, per poterla utilizzare.
Inoltre, devi considerare alcune proprietà delle notifiche push mobili inviate tramite Reskyt:
- Non è possibile annullare l’iscrizione di un contatto a queste notifiche, poiché non esiste un meccanismo che notifichi in caso di errore nella consegna.
- Le push mobili non hanno statistiche né analisi di invii, aperture o clic.
- Potrebbe essere possibile recuperare il numero di clic tramite opzioni UTM nel link, ma non è un valore raccolto di default.
- Il contatto potrà avere al massimo un dispositivo, poiché può essere memorizzato un solo token nel campo personalizzato.
- Due o più contatti possono avere lo stesso token Reskyt, perché potrebbero, ad esempio, avviare più sessioni sullo stesso dispositivo.
PASSO 1: Creazione del campo personalizzato che memorizzerà il token di Reskyt
(In questa sezione si creerà il campo personalizzato che raccoglierà il Token di Reskyt, cioè l’identificatore del contatto nell’App).
1. Vai su "Contatti > Campi del Contatto" e clicca su Aggiungi nuovo campo personalizzato.
2. Assegna il tipo Testo e clicca su Vai all’editor.
3. Assegna il Nome e l’ID "reskyt-token" e clicca su Salva.
Perché l’integrazione funzioni e il token venga memorizzato in Connectif, è importante che il campo personalizzato abbia questo nome e questo ID.
PASSO 2: Creazione del workflow per raccogliere il token del contatto
(In questa sezione si creerà il workflow che raccoglierà l’attività del contatto durante la navigazione nell’app di Reskyt e aggiornerà, in Connectif, il campo personalizzato creato nel PASSO 1. Questa attività sarà raccolta tramite uno script che sarà inserito in Reskyt tramite inline).
4. Vai su Workflows e clicca su Crea nuovo workflow.
5. Seleziona un nuovo workflow vuoto.
6. Nel "Nodo Inizio", seleziona Tutti i contatti della mia lista.
7. Aggiungi il nodo trigger "Alla visita della pagina" per attivare il workflow nel momento in cui un contatto visita il sito. Nella configurazione del nodo, nella scheda Limitazioni, rimuovi tutte le limitazioni.
8. Aggiungi il nodo di tipo condizione "Controlla valore" e accedi all’editor del nodo.
9. Nella configurazione del nodo "Controlla valore" seleziona l’operatore User Agent, ottenuto dal nodo "Alla visita della pagina" e trascinalo nella colonna sinistra del pannello centrale.
10. Seleziona, dalla colonna destra, il valore Letterale e trascinalo nel pannello centrale, nella colonna destra. Quindi, inserisci in quel valore il testo "rktwebview".
Il valore indicato è quello che Reskyt assegna di default. Puoi modificarlo, ma se lo fai dovrai indicare in questo campo il valore che hai assegnato al posto di "rktwebview".
11. Clicca su Aggiorna.
In questo modo, Connectif controllerà che, durante la navigazione, la pagina contenga il valore "rktwebview" nel parametro User Agent. Questa informazione è fornita direttamente da Reskyt, per indicare che un contatto sta navigando tramite la sua applicazione.
12. Aggiungi il nodo di tipo azione "Invia contenuto web" per inserire lo Script che controllerà l’attività del contatto tramite Reskyt.
13. Non modificare il collegamento di questo nodo con il nodo "Controlla valore", affinché appaia "Sì".
14. Clicca su (Modifica configurazione nodo) del nodo “Invia contenuto web” e Crea nuovo contenuto per generare un nuovo contenuto.
15. Quando crei un nuovo contenuto, seleziona come tipo Inline, assegnagli un nome, per esempio "Script Reskyt", e clicca su Crea nuovo contenuto.
16. Aggiungi un componente di tipo HTML e modificalo, copiando e incollando il seguente codice:
<script>
(function connectifReskyt(global) {
if (global.connectif &&
global.connectif.managed &&
global.connectif.managed.isInitialized()) {
getReskytToken();
} else {
global.document.addEventListener(
"connectif.managed.initialized",
function onConnectifInitialized() {
getReskytToken();
}
);
}
function getReskytToken() {
var reskytToken = getCookie("token_md5");
if (!reskytToken) {
return;
}
var previousReskytToken = global.sessionStorage.getItem("cn_reskyt_token");
if (reskytToken !== previousReskytToken) {
global.connectif.managed.sendEvents([], {
entityInfo: { "reskyt-token": reskytToken },
onResponded: function onResponded() {
global.sessionStorage.setItem("cn_reskyt_token", reskytToken);
}
});
}
}
function getCookie(name) {
var value = "; " + global.document.cookie;
var parts = value.split("; " + name + "=");
if (parts.length === 2) return parts.pop().split(";").shift();
}
})(window);
</script>Questo Script raccoglie il token di Reskyt da un cookie e lo memorizza nel campo personalizzato "reskyt-token".
17. Clicca su Salva per conservare le modifiche e su Torna al selettore per tornare e completare la configurazione del nodo.
18. Una volta selezionato il contenuto Inline che hai appena creato clicca su Avanti .
19. In Configurazione aggiungi il selettore adeguato per mostrare il contenuto. In questo caso, è consigliabile includere il contenuto nella pagina prodotto o in un’altra pagina che venga renderizzata sia sul web sia sull’App.
20. Nella scheda Limitazioni, rimuovi tutte le limitazioni del nodo. Infine, clicca su Termina per salvare la configurazione del nodo.
21. Salva e attiva il Workflow.
PASSO 3: Creazione dell’evento di invio dati per mostrare le push in Reskyt
(In questa sezione si creerà l’evento che invierà le informazioni da Connectif a Reskyt per permettere la visualizzazione delle notifiche push all’interno dell’App).
22. Accedi a Configurazione negozio nel menu laterale sinistro.
23. Nel selettore di scheda, vai su "Integrazioni > Integrazioni personalizzate (webhooks)" e clicca su Crea nuova integrazione.
24. Imposta il campo "Nome integrazione" per identificare l’integrazione e clicca su Aggiorna.
25. Nella scheda Invia dati, clicca su Crea nuovo evento di invio.
26. All’interno di quella schermata, assegna un nome all’evento.
27. Nel riquadro Webhook URL dove inviare il messaggio, incolla l’URL dell’API di Reskyt per inviare notifiche push. In questo caso, l’URL è "https://push.api.reskyt.com/push/send".
Se hai bisogno di ulteriori informazioni sull’API di Reskyt, accedi alla sua documentazione.
28. Clicca su Aggiungi una nuova intestazione e assegnale il Nome "x-api-key" e, nel Valore, inserisci il valore dell’API di Reskyt.
Dovrai richiedere questo valore a Reskyt, così come l’attivazione della sua API, per poterla utilizzare.
29. Clicca su Aggiungi un nuovo campo per creare ciascuno dei campi personalizzati e completa le sue informazioni:
- Crea un campo con nome e ID "dateEnd" di tipo Testo.
Anche se non è obbligatorio aggiungere la data di fine, è consigliabile, per esempio, in strategie dove si voglia inviare una push che informa di un’offerta, affinché cessi di essere inviata quando l’offerta termina.
- Crea un campo con nome e ID "pictureUrl" di tipo Testo.
- Crea un campo con nome e ID "title" di tipo Testo e rendilo obbligatorio.
- Crea un campo con nome e ID "tokens" di tipo Testo e rendilo obbligatorio. Attiva le opzioni JSON e assegna il parametro "/tokens/0".
- Crea un campo con nome e ID "url" di tipo Testo.
- Crea un campo con nome e ID "utmCampaign" di tipo Testo.
- Crea un campo con nome e ID "heading" di tipo Testo e rendilo obbligatorio.
30. Clicca su Salva.
PASSO 4: Creazione del workflow per inviare una notifica push in Reskyt
(In questa sezione si creerà la strategia che invierà una notifica push all’app di Reskyt).
Ti consigliamo di creare un segmento dinamico plus per filtrare i contatti che non hanno vuoto il campo personalizzato reskyt-token. In questo modo, la strategia si attiverà solo per i contatti di Reskyt, evitando che Connectif debba cercare in tutta la tua base contatti.
31. Vai su Workflows e clicca su Crea nuovo workflow e seleziona un Nuovo workflow vuoto.
32. Nel "Nodo Inizio", seleziona il Segmento Dinamico Plus che hai creato per filtrare i contatti di Reskyt.
34. Cerca il nodo di tipo azione che hai creato durante la tua integrazione con Reskyt (passo 3) e aggiungilo al tuo workflow.
35. Nella configurazione del nodo, trascina il campo "reskyt-token" dalle informazioni del contatto e abbinalo al valore "Tokens" della colonna destra. Il resto dei valori, associa a un campo Letterale per dare la forma e le informazioni che conterrà la tua push in Reskyt.
Il campo dateEnd deve essere in formato Timestamp. Puoi usare questo convertitore per ottenere il formato della data che vuoi inserire. Inoltre, Reskyt stabilisce come data limite 2 mesi dopo l’invio.
36. Clicca su Aggiorna per salvare la configurazione del nodo e attiva il tuo workflow.
Successo!
L’integrazione del tuo account Connectif con Reskyt è pronta.
Continua ad imparare!
Per sfruttare tutto il potenziale del tuo account Connectif, ti consigliamo di continuare con i seguenti articoli:
Integrazione personalizzata per ricevere dati, per imparare come utilizzare informazioni che non sono registrate di default nella piattaforma.
Webhooks predefiniti, per integrare il tuo account Connectif con WhatsApp, Doofinder e altri webhooks del tuo sito.
Casi d’Uso, per ottenere idee e modelli di strategie che puoi applicare nel tuo Negozio.
Integrazioni via API, per gestire eventi come registrazioni di acquisti o iscrizioni di contatti.