1. ActiveCampaign-Kundensupport
  2. Verknüpfungen
  3. Messaging-Integrationen

OneSignal mit ActiveCampaign verbinden

Avatar
Sarah N
Letzte Aktualisierung:
ActiveCampaign Tarife
Starter
Plus
Pro
Enterprise

Nutzen Sie die OneSignal-Verknüpfung in ActiveCampaign, um Push-Benachrichtigungen an das Internet, Mobilgeräte und Apps zu senden und OneSignal-Events an ActiveCampaign zu empfangen, sobald ein Event eintritt. Auf diese Weise können Sie eine direkte und unmittelbare Kommunikation an aktuelle und potenzielle Kunden senden, die Engagement-Rate erhöhen, inaktive Nutzer wieder einbinden, das Customer Experience personalisieren und eine kosteneffiziente Ergänzung zu Ihrer Marketingstrategie darstellen. 

Dieser Artikel erklärt, wie man OneSignal mit ActiveCampaign verbindet, um Push-Benachrichtigungen zu senden und OneSignal-Events mit ActiveCampaign zu synchronisieren.

Hinweis

  • Zum Einrichten der Verknüpfung sind folgende Schritte erforderlich:
    • ActiveCampaign-Konto mit Automationsberechtigungen
    • OneSignal-Konto eingerichtet und zum Senden von Push-Benachrichtigungen konfiguriert
    • Einrichtung und Konfiguration der Web-App in OneSignal
    • Vorlagen für Push-Benachrichtigungen (falls verwendet) in OneSignal. Zu den unterstützten Plattformen gehören:
      • Apple iOS (APNs)
      • Google Android (FCM)
      • Internet
    • OneSignal Benutzer-Authentifizierungsschlüssel
    • OneSignal Rest API-Schlüssel für jede Web-App
    • Externes ID-Feld von OneSignal für jeden Abonnementdatensatz, das mit dem eindeutigen Bezeichner für ActiveCampaign (E-Mail-Adresse) gefüllt ist
      • E-Mail-Adressen, die über ein ActiveCampaign-Formular erfasst werden, füllen automatisch das OneSignal-Feld Externe ID aus
      • Hinweis: Wenden Sie sich bitte an Ihren Web- oder Mobile-App-Entwickler, um einen Pfad zu konfigurieren, der die E-Mail-Adresse eines ActiveCampaign-Kontakts an die externe OneSignal-ID weiterleitet
      • Hinweis: OneSignal überträgt die E-Mail-Adresse, die von der E-Mail- oder Telefoneingabeaufforderung erfasst wurde, nicht in die Einrichtung der Erlaubniseingabeaufforderung
  • Für Web-Push-Benachrichtigungen - OneSignal unterstützt keine neuen Anwendungen mehr, die Blogger, Bubble, Squarespace, Webflow, Weebly, Wix, HTTP-Sites und Website-Builder verwenden, die das Hochladen von Service Workern auf einen Server nicht unterstützen (die für Web-Push erforderlich sind). Hier erfahren Sie mehr.
    • Wix Studio Kunden - Bitte lesen Sie diesen Artikel über das Hochladen der OneSignal Service Worker Datei in Ihr Stammverzeichnis

Ein Video ansehen

So funktioniert die Verknüpfung von Square

Diese Verknüpfung bietet zwei separate Synchronisationoptionen. Die eine synchronisiert Daten mit Ihrem ActiveCampaign-Konto, die andere sendet Push-Benachrichtigungen über die Automation. Sie können bei dieser Verknüpfung entweder eine oder beide Optionen verwenden. Sie funktionieren jedoch getrennt voneinander.

Synchronisieren von OneSignal-Eventströmen mit ActiveCampaign

Einmal konfiguriert, wird Event Streams mit ActiveCampaign synchronisiert, sobald ein Event eintritt. Dies wird über einen Webhook gesendet. 

Web-Push-Benachrichtigungen

Um Push-Benachrichtigungen zu senden, können Sie die Verknüpfung über eine von zwei Automationsaktionen konfigurieren: Sie können eine der beiden Automationsaktionen oder beide verwenden, um Push-Benachrichtigungen zu senden:

  • aktion "OneSignal - Tag zuweisen" - mit dieser Aktion können Sie mobile In-App-Push-Benachrichtigungen versenden
  • aktion "OneSignal - Push-Benachrichtigung senden" - mit dieser Aktion können Sie Push-Benachrichtigungen über das Web und das mobile Web senden

Reporting

Die Berichte für diese Verknüpfung finden Sie in Ihrem OneSignal-Konto. Sie können ActiveCampaign auch verwenden, um eine erweiterte Suche aller Kontakte zu erstellen, die Ihre OneSignal-Automation eingegeben und abgeschlossen haben.

Synchronisierung von OneSignal-Eventströmen mit ActiveCampaign

Diese Synchronisierung sendet Events von OneSignal an ActiveCampaign, sobald ein Event eintritt. 

Was Sie erwarten können

Die Einrichtung der Verknüpfung findet sowohl in Ihrem ActiveCampaign- als auch OneSignal-Konto statt. Wir stellen Ihnen einen JSON-Code zur Verfügung, den Sie in Ihr OneSignal-Konto implementieren können. Sobald diese Verknüpfung abgeschlossen ist, werden neue Kontaktdatensätze in ActiveCampaign erstellt und bestehende aktualisiert sowie die entsprechenden Veranstaltungsdaten synchronisiert.

Bitte beachten Sie, dass unser Customer Experience Team Sie nicht bei der Fehlerbehebung oder der Implementierung von Code in Ihrem Namen unterstützen kann. 

Unterstützte Events

Wir unterstützen die folgenden Veranstaltungen:

  • In-App-Eindruck
  • In-App geklickt
  • In-App Seite wird angezeigt
  • Gesendet drücken
  • Empfangener Push
  • Drücken Geklickt
  • Push fehlgeschlagen
  • abgemeldet

OneSignal-Daten zu Kontaktdatensätzen

Für jeden Kontakt wird ein benutzerdefinierter Objektdatensatz erstellt. Dieses benutzerdefinierte Objekt enthält die folgenden Daten: 

  • Extern
  • Zeitstempel
  • Event-ID
  • Art der Veranstaltung
  • Nachrichten-ID
  • Nachrichtenname
  • Nachrichtentitel
  • Inhalt der Nachricht
  • Abonnement Gerätetyp

Schritt-für-Schritt-Anleitung

Klicken Sie auf "ActiveCampaign > Konfiguration der Verbindungs-ID".

  1. Klicken Sie in Ihrem ActiveCampaign-Konto im linken Menü auf "Apps".

Erweiterte Ansicht:
Apps im linken Menü erweitert.jpeg

Geklappte Ansicht:
Apps im linken Menü eingeklappt.jpeg

  1. Verwenden Sie die Suchleiste, um die OneSignal-Verknüpfung zu suchen und auszuwählen.
  2. Klicken Sie auf die Schaltfläche "Ein Konto hinzufügen". 

  3. Ein modales Fenster wird angezeigt. Geben Sie den Benutzerautorisierungsschlüssel aus Ihrem OneSignal-Konto ein und klicken Sie auf die Schaltfläche "Verbinden".

    Wenn Sie die OneSignal-Verknüpfung bereits über eine Automationsaktion konfiguriert haben, können Sie auf diesem Bildschirm Ihre bestehende Verbindung auswählen.

  4. Ordnen Sie die eingehenden OneSignal-Felder den gewünschten Feldern in ActiveCampaign zu und klicken Sie dann auf auf "Fertig stellen"
    • Erforderlich: Sie müssen das OneSignal-Feld "Externe ID" dem ActiveCampaign-Feld "Kontakt-E-Mail" zuordnen, damit die Verknüpfung korrekt funktioniert. Wenn Sie dies nicht tun, schlägt die Synchronisierung fehl
  5. Klicken Sie auf den Pfeil neben der Schaltfläche "Bearbeiten" für Ihre erstellte Ressource und dann auf "Webhook-URL kopieren" Bewahren Sie diesen Wert in der Zwischenablage auf oder fügen Sie ihn an einem anderen Ort ein, da er für die OneSignal-Konfiguration erforderlich ist.

OneSignal-Konfiguration:

  1. Melden Sie sich bei Ihrem OneSignal-Konto an, wählen Sie "Alle Apps", und wählen Sie die App, die Sie verbinden möchten.
  2. Klicken Sie im Menü "Daten" auf "Eventströme".
  3. Klicken Sie auf "Neuer Veranstaltungs-Flow"
  4. Benennen Sie den Veranstaltungs-Flow wie gewünscht und klicken Sie auf "Events auswählen" Wählen Sie im Popup-Fenster alle Events in den Abschnitten "In-App-Nachricht" und "Push-Benachrichtigung" aus und klicken Sie auf "Fertig"
  5. Fügen Sie die Webhook-URL, die Sie im letzten Schritt der ActiveCampaign-Konfiguration kopiert haben, in das URL-Feld ein.
  6. Fügen Sie im Abschnitt Kopfzeilen einen Eintrag mit dem Schlüssel "Content-Type" und dem Wert "application/json" hinzu

  7. Wählen Sie im Abschnitt "Body" aus dem Drop-down-Menü "Custom Body" aus. Ersetzen Sie den Inhalt des Abschnitts durch das folgende 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.de }}",
    "message.contents": "{{ message.contents.de }}",
    "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 }}"
    }

    Der obige JSON-Code muss genau so kopiert werden, da die Verknüpfung sonst nicht richtig funktionieren wird.

  8. Klicken Sie auf "Aktivieren" , um den Veranstaltungs-Flow zu speichern und zu aktivieren.

Verbinden Sie OneSignal mit ActiveCampaign mit der Automationsaktion "OneSignal - Tag zuweisen".

Sie müssen Segmente in OneSignal erstellen, um diese Automationsaktion zu verwenden. Sobald das Segment definiert ist, können Sie mobile In-App-Benachrichtigungen direkt von OneSignal aus versenden. ActiveCampaign kann keine In-App-Push-Benachrichtigungen direkt von Automationen aus versenden.  

Was Sie erwarten können

Diese Einrichtung umfasst drei Hauptschritte:

  1. Erstellen Sie in OneSignal ein Segment mit dem Filter "BenutzerTags" für das Schlüssel/Wert-Paar, das Sie bei der Konfiguration der Automationsaktion verwenden werden.
  2. Konfigurieren Sie die Push-Benachrichtigung in OneSignal für mobile Anwendungen.
  3. Ziehen Sie die Aktion "OneSignal – Tag hinzufügen" auf Ihre Automation. In diesem Schritt geben Sie den API-Schlüssel von OneSignal ein und erstellen ein Schlüssel/Wert-Paar während der Konfigurationseinrichtung. Dieses Schlüssel/Wert-Paar muss mit dem in OneSignal erstellten Segment übereinstimmen. Setzen Sie Ihre Automation auf "Aktiv"

Wenn ein Kontakt Ihre Automation durchläuft, wird das Schlüssel/Wertpaar-Tag an OneSignal übertragen. Jedes Tag, das Sie mit dieser Aktion an OneSignal senden, wird in OneSignal erstellt, wenn es noch nicht für Kontakte existiert, und aktualisiert, wenn es existiert. 

Um das Schlüssel/Wertpaar-Tag zu finden, melden Sie sich bei Ihrem OneSignal-Konto an und navigieren Sie dann zu Zielgruppe > Benutzer.

Schritt-für-Schritt-Anleitung

  1. Erstellen Sie ein Segment in OneSignal:
    • In Ihr OneSignal-Konto einloggen
    • Navigieren Sie zu Zielgruppe > Segment > Neues Segment
    • Erstellen Sie Ihr neues Segment, indem Sie den Filter "Benutzer-Tags" für das in Schritt 3 oben erstellte Schlüssel/Wert-Paar hinzufügen. Um mehr zu erfahren, lesen Sie den Leitfaden von OneSignal zur Segmentierung
  2. Erstellen Sie die Nachricht, die Sie an Ihr Segment senden möchten. Um mehr zu erfahren, lesen Sie den Leitfaden von OneSignal zum Thema In-App-Messaging.
  3. Erfassen Sie den OneSignal-API-Schlüssel auf App-Ebene und und speichern Sie ihn in einer Datei für Schritt 5 (unten). Dieser API-Schlüssel befindet sich unter der ActiveCampaign-App > Schlüssel & IDs.
  4. Erstellen Sie in ActiveCampaign oder bearbeiten Sie eine Automation.
  5. Ziehen Sie die Aktion "OneSignal – Eine Push-Benachrichtigung senden" auf Ihre Automation. Sie befindet sich unter dem Abschnitt "CX Apps" des Automationsaktionsmenüs. Geben Sie die folgenden Informationen in die vorgesehenen Felder ein:
  6. Beenden Sie die Erstellung Ihrer Automation und setzen Sie sie dann auf "Aktiv"

Verbinden Sie OneSignal mit ActiveCampaign mit der Automationsaktion "OneSignal - Tag zuweisen".

Mit dieser Automationsaktion können Sie Push-Benachrichtigungen an Web- und Mobilgeräte senden.

Was Sie erwarten können

Sobald Sie die Aktion "OneSignal – Push-Benachrichtigung senden" zu Ihrer Automation hinzufügen, führt Sie eine Eingabeaufforderung durch die folgenden Verbindungs- und Konfigurationsschritte: Sie können eine OneSignal-Vorlage für Ihre Push-Benachrichtigung verwenden oder Ihre Nachricht manuell in der Konfiguration erstellen. 

Nachdem Sie die Verknüpfung verbunden und die Automation auf "Aktiv" gesetzt haben, wird Kontakten, die Ihre Automation betreten und zu Ihrer OneSignal-Aktion gelangen, eine Push-Benachrichtigung gesendet. Außerdem wird im Aktivitätsstrom der Kontaktdatensätze angezeigt, dass der Kontakt in Ihre Automation eingetreten ist.

Die Berichte für diese Verknüpfung finden Sie in Ihrem OneSignal-Konto. Sie können ActiveCampaign auch verwenden, um eine erweiterte Suche aller Kontakte zu erstellen, die Ihre OneSignal-Automation eingegeben und abgeschlossen haben. 

Diese Verknüpfung fügt keine Kontakte zu einer Liste hinzu.  Wenn Sie den Kontakten, die eine Push-Benachrichtigung erhalten haben, Tags hinzufügen möchten, müssen Sie die Aktion "Tag hinzufügen" zu Ihrer Automation hinzufügen, die der OneSignal-Aktion folgt. 

Schritt-für-Schritt-Anleitung

  1. Vergewissern Sie sich, dass Sie auf der OneSignal-Seite die folgenden Einstellungen vorgenommen haben: OneSignal-Konto, das für das Senden von Push-Benachrichtigungen konfiguriert ist, ActiveCampaign App und Vorlagen (empfohlen).
  2. Sammeln Sie die folgenden Informationen von OneSignal und speichern Sie sie in einer Datei für Schritt 5 (unten):
    • Benutzerautorisierungsschlüssel - Dies ist der Schlüssel auf Kontoebene und befindet sich unter Konto & API-Schlüssel
    • OneSignal App ID - Dies ist der API-Schlüssel auf App-Ebene und befindet sich unter ActiveCampaign App > Keys & IDs für die ActiveCampaign App
  3. Erstellen Sie in ActiveCampaign oder bearbeiten Sie eine Automation.
  4. Ziehen Sie die OneSignal-Aktion auf Ihre Automation. Sie befindet sich unter dem Abschnitt "CX Apps" des Automationsaktionsmenüs.
  5. Führen Sie die folgenden Schritte in der OneSignal-Automationsaktion aus, um die Verknüpfung zu verbinden:
    • Fügen Sie Ihren OneSignal-Benutzerauthentifizierungsschlüssel in das vorgesehene Feld ein und klicken Sie dann auf auf "Verbinden"
    • Wählen Sie aus dem Drop-down-Menü die Web-App aus, die Sie verwenden möchten
    • Fügen Sie den API-Schlüssel der Web-App ein
    • Wählen Sie die Push-Benachrichtigungsvorlage, die Sie verwenden möchten (empfohlen). Sie können Ihre Push-Benachrichtigung hier manuell erstellen, wenn Sie keine Vorlage verwenden möchten.
      • So erstellen Sie manuell eine Push-Benachrichtigung in der Automationsaktion: geben Sie Ihre URL, die Überschrift (Betreffzeile) und den Inhalt ein
      • Sie können auch Personalisierungs-Tags für die folgenden Objekte in Ihrer Nachricht verwenden: Kontakt, Konto, Deal, E-Commerce und benutzerdefinierte Objekte
      • Die Personalisierungs-Tags von ActiveCampaign funktionieren nicht mit den Vorlagen von OneSignal
    • Klicken Sie auf die Schaltfläche "Fertigstellen".

Erfassen von E-Mail-Adressen für OneSignal mit ActiveCampaign Forms

Diese Option ist für fortgeschrittene Benutzer. Sie müssen mit der Verwendung von HTML vertraut sein Das ActiveCampaign Customer Experience Team kann Ihnen nicht bei der Implementierung oder Fehlerbehebung von benutzerdefiniertem Code helfen.

Mit dem OneSignal Web SDK können Sie benutzerdefinierten Code zu Ihren ActiveCampaign-Formularen hinzufügen, um die E-Mail-Adresse des Kontakts bei der Übermittlung zu erfassen und sie als Abonnenten in OneSignal hinzuzufügen.

Installieren Sie zunächst das OneSignal Web SDK auf Ihrer Website, indem Sie der Startanleitung in der Dokumentation von OneSignal folgen.

Nachdem Sie überprüft haben, dass das Web SDK installiert wurde, fügen Sie im nächsten Schritt das ActiveCampaign-Formular zu Ihrer Website hinzu.

ActiveCampaign

  1. Klicken Sie im linken Menü auf "Website" > "Formulare".
  2. Erstellen Sie ein neues Formular und wählen Sie die Option "Inline-Formular".
  3. Nachdem Sie das Formular entworfen haben, klicken Sie auf auf die Schaltfläche "Integrieren" in der oberen rechten Ecke.
  4. Suchen Sie den Code für die "vollständige Einbettung", wählen Sie ihn aus, und kopieren Sie ihn.

In der HTML-Seite Ihrer Website (wo das ActiveCampaign-Formular angezeigt wird):

  1. Fügen Sie den kopierten Formularcode ein.
  2. Suchen Sie nach einer Funktion in dem enthaltenen Javascript namens form_submit. Die erste Zeile in dieser Funktion sollte e.preventDefault() sein. Dies ist wichtig.
  3. Der OneSignal-Code sollte nach der Zeile e.preventDefault() in diese Funktion eingefügt werden.

  4. Fügen Sie in einer neuen Zeile unterhalb der Zeile e.preventDefault() den folgenden Code ein:

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

Wenn Ihr ActiveCampaign-Formular abgeschickt wird, wird die E-Mail-Adresse des Absenders in das Feld OneSignal External ID übertragen.

Fehlerbehebung

Überprüfen Sie Ihre Vorlageneinstellungen, um Push-Nachrichten auf verschiedenen Geräten zuzulassen.

War dieser Beitrag hilfreich?
16 von 16 fanden dies hilfreich

Haben Sie weitere Fragen? Kontaktieren Sie uns

Start free trial