1. Assistenza clienti di ActiveCampaign
  2. Integrazioni
  3. Integrazioni di messaggistica

Connetti OneSignal ad ActiveCampaign

Avatar
Sarah N
Ultimo aggiornamento
Piani ActiveCampaign
Starter
Plus
Pro
Enterprise

Utilizza l'integrazione di OneSignal con ActiveCampaign per inviare notifiche push al web, ai dispositivi mobili e alle app e per ricevere eventi OneSignal in ActiveCampaign ogni volta che si verifica un evento. Ciò consente di inviare comunicazioni dirette e immediate ai clienti attuali e potenziali, di aumentare i tassi di coinvolgimento, di riattivare gli utenti inattivi, di personalizzare l'esperienza dei clienti e di aggiungere costi alla vostra strategia di marketing. 

Questo articolo spiega come collegare OneSignal ad ActiveCampaign per inviare notifiche push e sincronizzare gli eventi di OneSignal con ActiveCampaign.

Prendi nota

  • Per impostare l'integrazione è necessario quanto segue:
    • Account ActiveCampaign con permessi di automazione
    • Account OneSignal impostato e configurato per l'invio di notifiche push
    • Impostazione e configurazione della web app in OneSignal
    • Modelli di notifica push (se in uso) in OneSignal. Le piattaforme supportate includono:
      • Apple iOS (APN)
      • Google Android (FCM)
      • Web
    • Chiave di autenticazione utente OneSignal
    • Chiave API OneSignal Rest per ogni web app
    • Campo ID esterno di OneSignal per ogni record di sottoscrizione popolato con l'identificatore univoco di ActiveCampaign (indirizzo email)
      • Prossimamente: I contatti acquisiti tramite un modulo ActiveCampaign popoleranno automaticamente il campo ID esterno di OneSignal
      • Nota: contattare lo sviluppatore dell'applicazione web o mobile per configurare un percorso che consenta di inviare l'indirizzo email di un contatto ActiveCampaign all'ID esterno di OneSignal
      • Nota: OneSignal non invia l'indirizzo email acquisito dalla richiesta di email o di telefono all'interno della configurazione del prompt delle autorizzazioni
  • Per le notifiche web push - OneSignal ha smesso di supportare le nuove app che utilizzano Blogger, Bubble, Squarespace, Webflow, Weebly, Wix, siti HTTP e costruttori di siti web che non supportano il caricamento dei Service Worker su un server (necessari per il web push). Scopri di più qui.
    • Clienti di Wix Studio - Leggere questo articolo sul caricamento del file service worker di OneSignal nella directory principale

Guarda video

Come funziona l'integrazione Square

Questa integrazione offre due opzioni di sincronizzazione separate. Uno sincronizza i dati con il vostro account ActiveCampaign e l'altro invia notifiche push tramite l'automazione. È possibile scegliere di utilizzare una o entrambe le opzioni con questa integrazione. Tuttavia, funzionano separatamente.

Sincronizzazione dei flussi di eventi di OneSignal con ActiveCampaign

Una volta configurati, i flussi di eventi si sincronizzeranno con ActiveCampaign ogni volta che si verifica un evento. Questo viene inviato tramite un webhook. 

Notifiche push

Per inviare le notifiche push, è possibile configurare l'integrazione attraverso una delle due azioni di automazione: È possibile utilizzare una delle due azioni di automazione, o entrambe, per inviare le notifiche push:

  • azione "OneSignal - Assegnazione di un tag" - questa azione consente di inviare notifiche push mobili in-app
  • azione "OneSignal - Invia notifica push" - questa azione consente di inviare notifiche push sul web e sul web mobile

Reporting

I rapporti relativi a questa integrazione sono disponibili nel vostro account OneSignal. È inoltre possibile utilizzare ActiveCampaign per creare una ricerca avanzata di tutti i contatti che sono entrati e hanno completato la vostra automazione OneSignal.

Sincronizzare i flussi di eventi di OneSignal con ActiveCampaign

Questa sincronizzazione invia gli eventi da OneSignal ad ActiveCampaign ogni volta che si verifica un evento. 

Che cosa aspettarsi

La configurazione dell'integrazione avviene nei tuoi account ActiveCampaign e OneSignal. Vi forniremo il codice JSON da implementare nel vostro account OneSignal. Una volta completata, questa integrazione creerà nuovi record di contatti e aggiornerà quelli esistenti in ActiveCampaign e sincronizzerà i dati degli eventi appropriati.

  Si prega di notare che il nostro team Customer Experience non può assistervi nella risoluzione dei problemi o nell'implementazione del codice per vostro conto. 

Eventi supportati

Sono supportati i seguenti eventi:

  • Impressione In-App
  • Cliccato In-App
  • Pagina In-App visualizzata
  • Spinta inviata
  • Spinta ricevuta
  • Spinta cliccata
  • Spinta fallita
  • Cancellato

Dati OneSignal sui record dei contatti

Per ogni contatto viene creato un record di oggetto personalizzato. Questo oggetto personalizzato contiene i seguenti dati:

  • Esterno
  • Timestamp
  • ID evento
  • Tipo di evento
  • ID messaggio
  • Nome del messaggio
  • Titolo del messaggio
  • Contenuti del messaggio
  • Tipo di dispositivo in abbonamento

Istruzioni passo-passo

Fai clic su ActiveCampaign > Configurazione ID di connessione

  1. Dal tuo account ActiveCampaign, fai clic su App nel menu a sinistra.

Vista espansa
:Applicazioni nel menu di sinistra espanso.jpeg

Vista chiusa:
Applicazioni nel menu di sinistra chiuso.jpeg

  1. Utilizza la barra di ricerca per individuare e selezionare l'integrazione di OneSignal.
  2. Fai clic sul pulsante "Aggiungi un account". 

  3. Verrà visualizzata una finestra modale. Inserite la User Auth Key dal vostro account OneSignal e fate clic sul pulsante "Connect".

      Se l'integrazione di OneSignal è già stata configurata tramite un'azione di automazione, in questa schermata è possibile selezionare la connessione esistente.

  4. Mappare i campi di OneSignal in entrata con i campi desiderati in ActiveCampaign, quindi fare clic su "Fine"
    • Richiesto: È necessario mappare il campo "ID esterno" di OneSignal con il campo "email del contatto" di ActiveCampaign affinché l'integrazione funzioni correttamente. In caso contrario, la sincronizzazione non andrà a buon fine
  5. Fare clic sulla freccia accanto al pulsante "Modifica" della risorsa creata, quindi fare clic su "Copia URL Webhook" Conservare questo valore negli appunti o incollarlo da qualche parte per riferimento futuro, poiché è necessario per la configurazione di OneSignal.

Configurazione di OneSignal:

  1. Accedere al proprio account OneSignal, selezionare "Tutte le app", e scegliere l'app che si desidera collegare.
  2. Fare clic su "Flussi di eventi" dal menu "Dati".
  3. Fare clic su "Nuovo flusso di eventi"
  4. Nominare il flusso di eventi come desiderato e fare clic su "Seleziona eventi" Nella finestra a comparsa, selezionate tutti gli eventi nelle sezioni "In-App Message" e "Push Notification" e fate clic su "Done"
  5. Incollare nel campo URL l'URL del Webhook copiato nell'ultimo passo della configurazione di ActiveCampaign.
  6. Nella sezione Headers, aggiungere una voce con una chiave "Content-Type" e un valore "application/json"

  7. Nella sezione Corpo, selezionare "Corpo personalizzato" dal menu a discesa. Sostituire il contenuto della sezione con il seguente JSON:

    {
    "event.kind": "{{ event.kind }}",
    "event.id": "{{ event.id }}",
    "event.timestamp": "{{ event.timestamp }}",
    "event.datetime": "{{ event.datetime }}",
    "event.app_id": "{{ event.app_id }}",
    "event.subscription_device_type": "{{ event.subscription_device_type }}",
    "event.subscription_id": "{{ event.subscription_id }}",
    "event.onesignal_id": "{{ event.onesignal_id }}",
    "event.external_id": "{{ event.external_id }}",
    "message.id": "{{ message.id }}",
    "message.name": "{{ message.name }}",
    "message.title": "{{ message.title.en }}",
    "message.contents": "{{ message.contents.en }}",
    "template_id": "{{ message.template_id }}",
    "message.template_id": "{{ message.template_id }}",
    "message.url": "{{ message.url }}",
    "message.app_url": "{{ message.app_url }}",
    "message.web_url": "{{ message.web_url }}"
    }

      Il codice JSON sopra riportato deve essere copiato esattamente così com'è, altrimenti l'integrazione non funzionerà correttamente.

  8. Fare clic su "Attiva" per salvare e abilitare il flusso di eventi.

Collegate OneSignal ad ActiveCampaign con l'azione di automazione "OneSignal - Assegna un tag".

Per utilizzare questa azione di automazione è necessario creare segmenti in OneSignal. Una volta definito il segmento, è possibile inviare notifiche mobile in-app direttamente da OneSignal. ActiveCampaign non può inviare direttamente notifiche push in-app dalle automazioni.  

Che cosa aspettarsi

Questa configurazione prevede tre fasi principali:

  1. Creare un segmento in OneSignal utilizzando il filtro "UserTags" per la coppia chiave/valore che si utilizzerà quando si configura l'azione di automazione.
  2. Configurare la notifica push in OneSignal per le app mobili.
  3. Trascinare l'azione "OneSignal - Aggiungi tag" all'automazione. In questa fase, si inserisce la chiave API di OneSignal e si crea una coppia chiave/valore durante la configurazione. Questa coppia chiave/valore deve corrispondere al segmento creato in OneSignal. Al termine, imposta l'automazione su "attiva". 

Quando un contatto passa attraverso l'automazione, il tag della coppia chiave/valore viene inviato a OneSignal. Qualsiasi tag inviato a OneSignal da questa azione verrà creato in OneSignal se non esiste ancora per i contatti e aggiornato se esiste. 

Per trovare il tag della coppia chiave/valore, accedere al proprio account OneSignal, quindi navigare su Audience > Users.

Istruzioni passo-passo

  1. Creare un segmento in OneSignal:
    • Accedi al tuo account OneSignal
    • Spostarsi su Audience > Segment > New Segment
    • Creare il nuovo segmento aggiungendo il filtro "Tag utente" per la coppia chiave/valore creata al punto 3 precedente. Per saperne di più, leggete la guida di OneSignal sulla segmentazione
  2. Create il messaggio che volete inviare al vostro segmento. Per saperne di più, leggete la guida di OneSignal sulla messaggistica in-app.
  3. Raccogliere la chiave API di OneSignal a livello di applicazione e salvarla in un file per il passaggio 5 (sotto). Questa chiave API si trova nell'App ActiveCampaign > Chiavi e ID.
  4. Da ActiveCampaign, creare o modificare un'automazione.
  5. Trascina l'azione "Invia un'email" nell'automazione. Si trova nella sezione "CX Apps" del menu delle azioni di automazione. Inserite le seguenti informazioni negli appositi campi:
    • Chiave API di OneSignal
    • Chiave dell'etichetta dati
    • Valore del tag dati
    • Per le migliori pratiche sulla creazione della coppia chiave/valore, leggere l'articolo della guida di OneSignal Aggiungere i tag dei dati utente
  6. Terminare la costruzione dell'automazione, quindi impostarla su "Attivo"

Collegate OneSignal ad ActiveCampaign con l'azione di automazione "OneSignal - Assegna un tag".

Questa azione di automazione consente di inviare notifiche push ai dispositivi web e mobili.

Che cosa aspettarsi

Una volta aggiunta l'azione "OneSignal - Invia notifica push" all'automazione, si procederà con l'autenticazione e la configurazione di OneSignal. È possibile utilizzare un modello OneSignal per la notifica push o creare manualmente il messaggio nella configurazione. 

Dopo aver collegato l'integrazione e impostato l'automazione su "Attiva", i contatti di che entrano nell'automazione e arrivano all'azione OneSignal riceveranno una notifica push. Inoltre, il flusso di attività sui record dei contatti mostrerà che sono entrati nella vostra automazione.

I rapporti relativi a questa integrazione sono disponibili nel vostro account OneSignal. È inoltre possibile utilizzare ActiveCampaign per creare una ricerca avanzata di tutti i contatti che sono entrati e hanno completato la vostra automazione OneSignal. 

Questa integrazione non aggiunge tag ai contatti.  Se si desidera aggiungere dei tag ai contatti a cui è stata inviata una notifica push, è necessario aggiungere l'azione "Aggiungi un tag" alla propria automazione, dopo l'azione OneSignal. 

Istruzioni passo-passo

  1. Assicurarsi di avere le seguenti impostazioni sul lato OneSignal: Account OneSignal configurato per l'invio di notifiche push, App ActiveCampaign e Modelli (consigliati).
  2. Raccogliere le seguenti informazioni da OneSignal e salvarle in un file per la fase 5 (sotto):
    • Chiave di autenticazione dell'utente - Questa è la chiave a livello di account e si trova in Account & API Keys
    • ID app OneSignal - Si tratta della chiave API a livello di app e si trova in App ActiveCampaign > Chiavi e ID dell'app ActiveCampaign
  3. Da ActiveCampaign, creare o modificare un'automazione.
  4. Trascina l'azione "Aspetta" nella tua automazione: Si trova nella sezione "CX Apps" del menu delle azioni di automazione.
  5. Completare i seguenti passaggi nell'azione di automazione OneSignal per collegare l'integrazione:
    • Incollare la chiave d'accesso OneSignal nel campo apposito, quindi fare clic su "Connect"
    • Selezionare la web app che si desidera utilizzare dal menu a tendina
    • Incollare la chiave API della web app
    • Selezionare il modello di notifica push che si desidera utilizzare (consigliato). Se non si desidera utilizzare un modello, è possibile creare manualmente la notifica push.
      • Per creare manualmente una notifica push nell'azione di automazione: inserire l'URL, l'intestazione (l'oggetto) e il contenuto
      • È inoltre possibile utilizzare i tag di personalizzazione per i seguenti oggetti nel messaggio: Contatti, Account, Offerte, Ecommerce e Oggetti personalizzati
      • I tag di personalizzazione di ActiveCampaign non funzionano con i modelli di OneSignal
    • Fare clic sul pulsante "Fine".

Acquisizione dell'indirizzo email per OneSignal con i moduli di ActiveCampaign

Questa opzione è per gli utenti avanzati. Dovrai essere a tuo agio con l'uso dell'HTML Il team Customer Experience di ActiveCampaign non può aiutarti a implementare o risolvere i problemi di codice personalizzato.

Con l'SDK Web di OneSignal, potete aggiungere codice personalizzato ai vostri moduli ActiveCampaign per catturare l'indirizzo email del contatto al momento dell'invio e aggiungerlo come abbonato in OneSignal.

Innanzitutto, installate l'SDK Web di OneSignal sul vostro sito web seguendo la guida all'avvio della documentazione di OneSignal.

Una volta verificata l'installazione del Web SDK, il passo successivo consiste nell'aggiungere il modulo ActiveCampaign al vostro sito.

ActiveCampaign

  1. Fai clic su "Sito Web" > "Moduli" nel menu a sinistra.
  2. Create un nuovo modulo e scegliete l'opzione "Modulo in linea".
  3. Dopo aver progettato il modulo, fare clic sul pulsante "Integra" nell'angolo in alto a destra.
  4. Trovare il codice "full embed", selezionarlo e copiarlo.

Nel sito web (dove verrà visualizzato il modulo ActiveCampaign):

  1. Incollare il codice del modulo copiato.
  2. Cercate una funzione nel javascript incluso chiamata form_submit. La prima riga di questa funzione dovrebbe essere e.preventDefault() Questo è importante.
  3. Il codice di OneSignal deve essere inserito dopo la riga e.preventDefault() in questa funzione.

  4. In una nuova riga sotto la riga e.preventDefault(), aggiungere il seguente codice:

    var userEmail = document.getElementById("email").value;
    OneSignalDeferred.push(async function(OneSignal) {
     await OneSignal.User.addEmail(userEmail);
     await OneSignal.login(userEmail);
     });

Quando il vostro modulo ActiveCampaign viene inviato, l'indirizzo email del mittente viene passato nel campo ID esterno di OneSignal.

Risoluzione dei problemi

Rivedere le impostazioni del modello per consentire la pressione su vari dispositivi.

Questo articolo ti è stato utile?
Utenti che ritengono sia utile: 16 su 16

Hai altre domande? Contattaci

Start free trial