Connecter OneSignal à ActiveCampaign

Plans ActiveCampaign
Starter
Plus
Pro
Enterprise

Utilisez l'intégration de OneSignal avec ActiveCampaign pour envoyer des notifications push sur le web, les appareils mobiles et les applications. Cela vous permet d'envoyer des communications directes et immédiates à vos clients actuels et potentiels, d'augmenter les taux d'engagement, de réengager les utilisateurs inactifs, de personnaliser l'expérience des clients et de compléter votre stratégie de marketing de manière rentable. 

Cet article explique comment connecter OneSignal à ActiveCampaign pour envoyer des notifications push et synchroniser les événements OneSignal avec ActiveCampaign.

Remarque

  • Les éléments suivants sont nécessaires à la mise en place de l'intégration :
    • Compte ActiveCampaign avec autorisations d'automatisation
    • Compte OneSignal configuré pour l'envoi de notifications push
    • Installation et configuration de l'application web dans OneSignal
    • Modèles de notification push (si utilisés) dans OneSignal. Les plates-formes prises en charge sont les suivantes
      • Apple iOS (APN)
      • Google Android (FCM)
      • Web
    • Clé d'authentification de l'utilisateur OneSignal
    • Clé API OneSignal Rest pour chaque application web
    • Champ OneSignal External ID pour chaque enregistrement d'abonnement rempli avec l'identifiant unique pour ActiveCampaign (adresse e-mail)
      • Les adresses e-mail capturées via un formulaire ActiveCampaign rempliront automatiquement le champ ID externe de OneSignal
      • Note : Veuillez contacter votre développeur web ou d'application mobile pour configurer un chemin pour pousser l'adresse e-mail d'un contact ActiveCampaign vers l'ID Externe OneSignal
      • Note : OneSignal ne transmet pas l'adresse e-mail capturée à partir de l'e-mail ou de l'invite téléphonique dans la configuration de l'invite de permission
  • Pour les notifications push web - OneSignal a cessé de prendre en charge les nouvelles applications utilisant Blogger, Bubble, Squarespace, Webflow, Weebly, Wix, les sites HTTP et les constructeurs de sites web qui ne prennent pas en charge le téléchargement de Service Workers sur un serveur (ce qui est nécessaire pour le push web). Découvrez-en plus ici.
    • Clients de Wix Studio - Veuillez consulter l'article à propos du téléchargement du fichier service worker de OneSignal dans votre répertoire racine

Regarder une vidéo

Comment fonctionne l'intégration de Square

Cette intégration offre deux options de synchronisation distinctes. L'un synchronise les données avec votre compte ActiveCampaign et l'autre envoie des notifications push via l'automatisation. Vous pouvez choisir d'utiliser l'une ou l'autre ou les deux options avec cette intégration. Cependant, ils fonctionnent séparément.

Synchroniser les flux d'événements OneSignal avec ActiveCampaign

Une fois configurés, les flux d'événements se synchroniseront avec ActiveCampaign chaque fois qu'un événement se produira. Elle est envoyée via un webhook. 

Notifications Push

Pour envoyer des notifications push, vous pouvez configurer l'intégration via l'une des deux actions d'automatisation : Vous pouvez utiliser l'une ou l'autre des actions d'automatisation, ou les deux, pour envoyer des notifications push :

  • action "OneSignal - Assign a tag" - Cette action vous permet d'envoyer des notifications push mobiles in-app
  • action "OneSignal - Send push notification" - cette action vous permet d'envoyer des notifications push sur le web et le web mobile

Reporting

Vous trouverez les rapports relatifs à cette intégration dans votre compte OneSignal. Vous pouvez également utiliser ActiveCampaign pour créer une recherche avancée de tous les contacts qui sont entrés et ont terminé votre automatisation OneSignal.

Synchroniser les flux d'événements OneSignal avec ActiveCampaign

Cette synchronisation envoie des événements de OneSignal à ActiveCampaign chaque fois qu'un événement se produit. 

À quoi s’attendre

La configuration de l’intégration se fait dans votre compte ActiveCampaign. Nous vous fournirons un code JSON à implémenter dans votre compte OneSignal. Une fois terminée, cette intégration créera de nouvelles fiches de contact et mettra à jour les fiches existantes dans ActiveCampaign et synchronisera les données d'événement appropriées.

Veuillez noter que notre équipe d'expérience client ne peut pas vous aider à résoudre les problèmes ou à mettre en œuvre un code en votre nom. 

Événements soutenus

Les événements suivants sont pris en charge :

  • Impression In-App
  • Cliquer dans l'application
  • Page In-App affichée
  • Poussée envoyée
  • Poussée reçue
  • Poussée cliquée
  • Échec de la poussée
  • Désabonné

Données OneSignal sur les enregistrements de contact

Un enregistrement d'objet personnalisé est créé pour chaque contact. Cet objet personnalisé comprend les données suivantes :

  • Externe
  • Horodatage
  • ID de l'événement
  • Type d'événement
  • ID du message
  • Nom du message
  • Titre du message
  • Contenu des messages
  • Type d'appareil d'abonnement

Instructions étape par étape

Cliquez sur ActiveCampaign > Configuration de l'ID de connexion

  1. Dans votre compte ActiveCampaign, cliquez sur Applications dans le menu de gauche.

Vue étendue :
Apps sur le menu de gauche étendue.jpeg

Vue réduite :
Apps sur le menu de gauche réduite.jpeg

  1. Utilisez la barre de recherche pour localiser et sélectionner l’intégration Publicité à formulaire.
  2. Cliquez sur le bouton "Ajouter un compte"
  3. Une fenêtre modal apparaît. Saisissez la clé d'authentification de l'utilisateur de votre compte OneSignal et cliquez sur le bouton "Connect".

    Si vous avez déjà configuré l'intégration OneSignal via une action d'automatisation, vous pouvez sélectionner votre connexion existante sur cet écran.

  4. Faites correspondre les champs OneSignal entrants aux champs souhaités dans ActiveCampaign, puis cliquez sur "Terminer"
    • Obligatoire : Vous devez faire correspondre le champ OneSignal "External ID" au champ ActiveCampaign "Contact email" pour que l'intégration fonctionne correctement. Si vous ne le faites pas, la synchronisation échouera
  5. Cliquez sur la flèche à côté du bouton "Edit" de votre ressource créée, puis cliquez sur "Copy Webhook URL" Conservez cette valeur dans votre presse-papiers ou collez-la quelque part pour vous y référer ultérieurement, car elle est nécessaire pour la configuration de OneSignal.

Configuration de OneSignal :

  1. Connectez-vous à votre compte OneSignal, sélectionnez "All Apps", et choisissez l'application que vous souhaitez connecter.
  2. Cliquez sur "Event Streams" dans le menu "Data".
  3. Cliquez sur "Nouveau flux d'événements"
  4. Nommez le flux d'événements comme vous le souhaitez et cliquez sur "Select Events" Dans la fenêtre contextuelle, sélectionnez tous les événements dans les sections "In-App Message" et "Push Notification" et cliquez sur "Done"
  5. Collez l'URL du Webhook que vous avez copié dans la dernière étape de la configuration d'ActiveCampaign dans le champ URL.
  6. Dans la section Headers, ajoutez une entrée avec une clé "Content-Type" et une valeur "application/json"
  7. Dans la section Corps, sélectionnez "Corps personnalisé" dans le menu déroulant. Remplacer le contenu de la section par le JSON suivant :

    {
    "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 }}"
    }

    Le code JSON ci-dessus doit être copié tel quel, sinon l'intégration ne fonctionnera pas correctement.

  8. Cliquez sur "Activate" pour enregistrer et activer le flux d'événements.

Connectez OneSignal à ActiveCampaign avec l'action d'automatisation "OneSignal - Assign a tag".

Vous devez créer des segments dans OneSignal pour utiliser cette action d'automatisation. Une fois le segment défini, vous pouvez envoyer des notifications mobiles in-app directement depuis OneSignal. ActiveCampaign ne peut pas envoyer directement des notifications push in-app à partir d'automatisations.  

À quoi s’attendre

Cette configuration comporte trois étapes principales :

  1. Créez un segment dans OneSignal en utilisant le filtre "UserTags" pour la paire clé/valeur que vous utiliserez lors de la configuration de l'action d'automatisation.
  2. Configurez la notification push dans OneSignal pour les applications mobiles.
  3. Faites glisser l'action "OneSignal - Ajouter un tag" vers votre automatisation. Dans cette étape, vous allez entrer votre clé API OneSignal et créer une paire clé/valeur lors de la configuration. Cette paire clé/valeur doit correspondre au segment que vous avez créé dans OneSignal. Réglez votre automatisation sur "Active"

Lorsqu'un contact passe par votre automatisation, la paire de tags clé/valeur est envoyée à OneSignal. Tout tag envoyé à OneSignal à partir de cette action sera créé dans OneSignal s'il n'existe pas encore pour les contacts et mis à jour s'il existe. 

Pour trouver la paire de tags clé/valeur, connectez-vous à votre compte OneSignal, puis naviguez vers Audience > Utilisateurs.

Instructions étape par étape

  1. Créez un segment dans OneSignal :
    • Connectez-vous à votre compte OneSignal
    • Naviguez vers Audience > Segment > Nouveau segment
    • Créez votre nouveau segment en ajoutant le filtre "User Tags" pour la paire clé/valeur créée à l'étape 3 ci-dessus. Pour en savoir plus, lisez le guide de OneSignal sur la segmentation
  2. Créez le message que vous souhaitez envoyer à votre segment. Pour en savoir plus, lisez le guide de OneSignal sur la messagerie in-app.
  3. Rassemblez la clé API de l'application OneSignal et enregistrez-la dans un fichier pour l'étape 5 (ci-dessous). Cette clé API se trouve sous Application ActiveCampaign > Clés & IDs.
  4. Depuis ActiveCampaign, créez ou modifiez une automatisation.
  5. Faites glisser l'action “OneSignal - Envoyer une notification push” vers votre automatisation. Il se trouve dans la partie "CX Apps" du menu d'action de l'automatisation. Saisissez les informations suivantes dans les champs prévus à cet effet :
    • Clé API OneSignal
    • Clé du tag des données
    • Valeur du tag des données
    • Pour connaître les meilleures pratiques en matière de création de la paire clé/valeur, veuillez consulter l'article d'aide de OneSignal Add user data tags
  6. Terminez la construction de votre automatisation, puis activez-la

Connectez OneSignal à ActiveCampaign avec l'action d'automatisation "OneSignal - Assign a tag".

Cette action d'automatisation vous permet d'envoyer des notifications push à des appareils web et mobiles.

À quoi s’attendre

Une fois que vous avez ajouté l'action “OneSignal - Envoyer une notification push” à votre automatisation, une invite vous guidera à travers les étapes de connexion et de configuration OneSignal suivantes : Vous pouvez utiliser un modèle OneSignal pour votre notification push ou créer manuellement votre message dans la configuration. 

Après avoir connecté l'intégration et configuré l'automatisation sur "Active", les contacts qui entrent dans votre automatisation et parviennent à votre action OneSignal recevront une notification push. En outre, le flux d'activité sur les enregistrements de contact montrera qu'ils sont entrés dans votre système d'automatisation.

Vous trouverez les rapports relatifs à cette intégration dans votre compte OneSignal. Vous pouvez également utiliser ActiveCampaign pour créer une recherche avancée de tous les contacts qui sont entrés et ont terminé votre automatisation OneSignal. 

Cette intégration ne permet pas d'ajouter des contacts à une liste.  Si vous souhaitez ajouter des tags aux contacts qui ont reçu une notification push, vous devez ajouter l'action "Ajouter un tag" à votre automatisation, à la suite de l'action OneSignal. 

Instructions étape par étape

  1. Assurez-vous d'avoir la configuration suivante du côté de OneSignal : Compte OneSignal configuré pour envoyer des notifications push, application ActiveCampaign, et Modèles (recommandé).
  2. Recueillez les informations suivantes auprès de OneSignal et enregistrez-les dans un fichier pour l'étape 5 (ci-dessous) :
    • Clé d'authentification de l'utilisateur - Il s'agit de la clé au niveau du compte, qui se trouve sous Compte et clés API
    • OneSignal App ID - Il s'agit de la clé API au niveau de l'application, située sous ActiveCampaign App > Keys & IDs pour l'application ActiveCampaign
  3. Depuis ActiveCampaign, créez ou modifiez une automatisation.
  4. Faites glisser l'action vers votre automatisation. Il se trouve dans la partie "CX Apps" du menu d'action de l'automatisation.
  5. Effectuez les étapes suivantes dans l'action d'automatisation OneSignal pour connecter l'intégration :
    • Collez votre clé d'authentification de l'utilisateur OneSignal dans le champ prévu à cet effet, puis cliquez sur "Connect"
    • Sélectionnez l'application web que vous souhaitez utiliser dans le menu déroulant
    • Collez la clé API de l'application web
    • Sélectionnez le modèle de notification push que vous souhaitez utiliser (recommandé). Vous pouvez créer manuellement votre notification push ici si vous ne souhaitez pas utiliser un modèle.
      • Pour créer manuellement une notification push dans l'action d'automatisation : entrez votre URL, votre titre (ligne d'objet) et votre contenu
      • Vous pouvez également utiliser des tags de personnalisation pour les objets suivants dans votre message : Contact, Compte, Offre, E-commerce et Objets personnalisés
      • Les balises de personnalisation d'ActiveCampaign ne fonctionnent pas avec les modèles de OneSignal
    • Cliquez sur le bouton "Terminer".

Capturer l'adresse e-mail pour OneSignal avec ActiveCampaign Forms

Cette option est destinée aux utilisateurs avancés. Vous devrez être à l'aise avec l'utilisation de l'éditeur HTML L'équipe d'expérience client d'ActiveCampaign ne peut pas vous aider à implémenter ou à résoudre un code personnalisé.

Avec le OneSignal Web SDK, vous pouvez ajouter un code personnalisé à vos formulaires ActiveCampaign pour capturer l'adresse e-mail du contact lors de la soumission et l'ajouter en tant qu'abonné dans OneSignal.

Tout d'abord, installez le OneSignal Web SDK sur votre site web en suivant le guide de démarrage de la documentation de OneSignal.

Une fois que vous avez vérifié que le SDK Web a été installé, l'étape suivante consiste à ajouter le formulaire ActiveCampaign à votre site.

Dans ActiveCampaign :

  1. Cliquez  sur "Site web" > "Formulaires" dans le menu de gauche.
  2. Créez un nouveau formulaire et choisissez l'option "Inline form".
  3. Après avoir conçu le formulaire, cliquez sur le bouton "Intégrer" dans le coin supérieur droit.
  4. Trouvez le code "full embed", sélectionnez-le et copiez-le.

Dans le code HTML de votre site (où le formulaire ActiveCampaign sera affiché) :

  1. Collez le code du formulaire copié.
  2. Recherchez une fonction dans le javascript inclus appelée form_submit. La première ligne de cette fonction doit être e.preventDefault() Ceci est important.
  3. Le code OneSignal doit être inséré après la ligne e.preventDefault() dans cette fonction.
  4. Sur une nouvelle ligne située sous la ligne e.preventDefault(), ajoutez le code suivant :

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

Lorsque votre formulaire ActiveCampaign est soumis, l'adresse e-mail de l'expéditeur est transmise dans le champ OneSignal External ID.

Dépannage

Révisez les paramètres de votre modèle pour autoriser les poussées sur différents appareils.

Vous avez d'autres questions ? Contactez-nous

Start free trial