Der Knoten Double Opt-In ist für Interactions-Programme sowie Automation Center Programme verfügbar. Mit diesem Knoten können Sie Ihren Prozess zum Erhalt eines "Confirmed Opt-in" (COI) oder "Double Opt-In" (DOI) ganz einfach automatisieren. Der Knoten Double Opt-In ist vollständig DSGVO-konform und deckt folgende Aktionen ab:
- Er sendet eine E-Mail mit einem personalisierten Bestätigungslink an jeden Kontakt.
- Er erfasst den (Bestätigungs-)Klick des Kontakts, sobald dieser erfolgt.
- Er setzt den bestätigten Opt-in-Status.
- Er speichert alle gesetzlich erforderlichen Bestätigungsdaten für das Double Opt-In, einschließlich der zugehörigen Timestamps und IP-Adressen, in Ihrer Kontaktdatenbank.
Der vom Knoten Double Opt-In generierte DOI Link funktioniert so lange, wie der die E-Mail empfangende Kontakt einen Eintrag in Ihrer Datenbank hat.
Voraussetzungen
Unabhängig von Ihrer tatsächlichen Double Opt-In Journey müssen Sie für Folgendes sorgen:
- Klar definierte Opt-in-Strategien; das schließt die Identifizierung optionaler Opt-in-Felder und die von ihnen abgedeckten Use Cases ein.
- Ein gutes Verständnis für Ihre Methode des Kontaktimports.
- Die von Ihrer Website gehosteten Erfolgs- und Fehlerseiten.
Bitte beachten Sie, dass der Knoten Double Opt-In bei intensiver Nutzung die Performance Ihrer Systems vermindern kann. Behalten Sie Ihre Strategien für das Consent Management im Auge und decken Sie diese mit einer oder zwei Automation Journeys ab.
Allgemeine Struktur der Double Opt-In Journey
Für das Erstellen einer DOI Journey sind im Allgemeinen folgende Schritte erforderlich:
1. Erstellen Sie eine DOI Journey, die auf die Registrierung neuer Kontakte reagiert. Abhängig von der Methode, mit der Sie Kontakte importieren, kann das ein Interactions-Programm oder ein Automation Center Programm sein.
2. Konfigurieren Sie den Knoten "Double Opt-In". Beim Konfigurieren des Knotens werden auch folgende Elemente erstellt:
- DOI-Felder in der Kontaktdatenbank
- das Event Send DOI-Mail
3. Erstellen Sie ein Kontakt-Personalisierungstoken für die in der Nachricht verwendete DOI_Url.
4. Erstellen Sie eine neue Triggered E-Mail für den Versand der DOI Mail. Diese E-Mail wird vom Event Send DOI-Mail getriggert, das wiederum von diesem Knoten getriggert wird; um den personalisierten DOI Link anzuzeigen, verwendet der Content das Token DOI_Url.
Abhängig von Ihren Use Cases und dem Daten-Setup wollen Sie das Double Opt-In Programm und den Trigger möglicherweise auch für andere Szenarien verwenden, etwa für das Triggern einer Welcome Journey. Vielleicht wollen Sie auch mehrere Sprachen managen oder einen anderen Kanal als E-Mail verwenden. Die entsprechenden Möglichkeiten besprechen Sie bitte mit Ihrem Client Success Manager.
DOI Journey erstellen
Zuerst müssen Sie entscheiden, ob Sie für das Erstellen Ihrer Journey Interactions oder das Automation Center verwenden wollen. Die transaktionale Verarbeitung in Interactions garantiert, dass die Nachrichten innerhalb von 10 Sekunden gesendet werden (weitere Informationen zur Fair Usage Policy in Interactions erhalten Sie hier). Beim Automation Center ist mit einer längeren Verzögerung zu rechnen.
Wofür Sie sich entscheiden, hängt von der Lösung für den Kontaktimport ab, die für Ihren Account eingerichtet ist:
- Integrationen mit SAP Commerce Cloud, Shopify und Adobe Commerce sowie Implementierungen, die das Emarsys API verwenden, können externe Events mit Interactions nutzen, um eine transaktionale Journey in Echtzeit zu erstellen.
- API Events, die aus einem anderen System kommen (externe API Events) sollten ebenfalls Interactions triggern; das gewährleistet die schnelle Ausführung und sorgt für eine solide Kundenerfahrung.
- Accounts, die für das Managen der Kontaktdatenbank die Formular-, HTTPS Feed- oder Auto-Import-Funktionen verwenden, können für das Erstellen der DOI Journey das Automation Center verwenden.
Interactions-Programm verwenden
Wir empfehlen die Verwendung von Interactions, da damit der Versand von DOI-Nachrichten innerhalb von 10 Sekunden garantiert ist. Weitere Informationen zur Fair Usage Policy von Interactions erhalten Sie hier.
1. Auf der Seite Management > Externe Events erstellen Sie ein externes Event für neue Kontaktregistrierungen (z.B. Neue Kontaktregistrierung) und richten dieses ein. Dieses externe Event wird für das Triggern der DOI Automation verwendet.
Implementierungen, die eine Integration mit SAP Commerce Cloud, Shopify oder Adobe Commerce verwenden, weisen standardmäßig einige Webshop Events zu externen Events zu. Wenn Sie diese verwenden, können Sie Schritt 1 und Schritt 2 überspringen.
Die External Event ID finden Sie auf der Seite Externe Events.
2. Konfigurieren Sie mithilfe der External Event ID den External Event Trigger API Call (z.B. POST /v2/event/100002621/trigger).
1. Navigieren Sie zu Automation > Automation Programme, klicken Sie Programm erstellen und wählen Sie Verhaltensfokussierte Journeys (Interactions) aus.
4. Wählen Sie die Quelle Externes Event aus.
5. Geben Sie Ihrem Interactions-Programm einen Namen.
6. Doppelklicken Sie den Triggerknoten und konfigurieren Sie ihn wie folgt:
a. Wählen Sie Ihr externes Event aus (z.B. Neue Kontaktregistrierung).
b. Unter Trigger-Event Timeout wählen Sie Timeout deaktivieren aus, um sicherzugehen, dass auf diese Nachrichten kein Timeout angewendet wird und sie auch nach einer Verzögerung durch einen Systemausfall zugestellt werden.
7. Unter Aktionen klicken Sie den Knoten Double Opt-In, um ihn zu Ihrem Programm hinzuzufügen, und folgen Sie der Anleitung unter Knoten "Double Opt-In" konfigurieren.
Automation Center Programm verwenden
1. Navigieren Sie zu Automation > Automation Programme, klicken Sie Programm erstellen und wählen Sie Audience-fokussierte Journeys (Automation Center) aus.
2. Fügen Sie einen Eintrittsknoten hinzu, der Ihrer Strategie für den Kontaktimport entspricht:
a. Formular - Verwenden Sie diesen Eintrittsknoten, wenn die Kontaktregistrierung über ein Emarsys Formular erfolgt.
b. Neuer Kontakt - Verwenden Sie diesen Eintrittsknoten, wenn die Kontaktregistrierung über einen HTTPS Feed oder einen manuellen Datei-Import erfolgt.
c. Bei Auto-Import - Verwenden Sie diesen Eintrittsknoten, wenn die Kontaktregistrierung über automatische Datei-Importe erfolgt
3. Doppelklicken Sie den Eintrittsknoten und wählen Sie Ihre Quelle für den Kontaktimport aus.
4. Unter Aktionen klicken Sie den Knoten Double Opt-In, um ihn zu Ihrem Programm hinzuzufügen, und folgen Sie der Anleitung unter Knoten "Double Opt-In" konfigurieren.
Knoten "Double Opt-In" konfigurieren
Der Knoten Double Opt-In hat für Interactions-Programme und Automation Center Programme dieselben Konfigurationsoptionen.
Während Sie den Knoten Double Opt-In konfigurieren, erstellt er automatisch die erforderlichen Ressourcen. Das umfasst die Felder des Typs DOI_* in Ihrer Kontaktdatenbank und das Event Send DOI-Mail.
Wenn Sie mit der Konfiguration des Knotens Double Opt-In fertig sind, müssen Sie unbedingt Done klicken, andernfalls werden die Felder und externen Events nicht erstellt.
Hier erhalten Sie detaillierte Informationen zu den Konfigurationsoptionen:
Aktionen beim Durchlaufen des Knotens
Wenn ein Kontakt den Knoten Double Opt-In durchläuft, geschieht Folgendes:
1. Es wird ein kontaktspezifischer DOI Link generiert. Zum Beispiel: node-doi.ems-ci.com/acnode/confirm.html?rid=27&cid=212411983&uid=FXb2JKI3Mc&pid=616837db13bc5b480a993fd2&
Bitte beachten Sie, dass das Protokoll-Präfix nicht in der URL enthalten ist. Wenn Sie in Ihrer E-Mail den vollständigen Link anzeigen, denken Sie daran, das Präfix https:// voranzustellen.
2. Der Link wird im Feld DOI_Url gespeichert. Sie können ein benutzerdefiniertes Feld einrichten, es muss aber den Typ URL haben.
3. Die Timestamp für die Versandzeit der DOI-Kampagne wird im Feld DOI_Sent gespeichert. Sie können ein benutzerdefiniertes Feld einrichten, es muss aber den Typ Datum haben.
4. Der Knoten setzt den Wert des Systemfelds Opt-in auf [empty], um sicherzustellen, dass alle früheren Opt-in-Daten gelöscht werden, bis die Einwilligung erteilt wurde.
5. Optional können Sie auch andere Felder einrichten. Sie können ein or mehrere Felder (Einzelauswahl) wählen, die bei Triggern des Knotens Double Opt-In aktualisiert werden. Damit können Sie beispielsweise das Feld opt-in zurücksetzen oder ein beliebiges benutzerdefiniertes Feld aktualisieren, das Sie in dieser Journey verwenden wollen (das ist dann nützlich, wenn Sie mehrere Newsletter-Kategorien haben, für die eine wöchentliche, vierzehntägige oder monatliche Anmeldung möglich ist oder die bestimmte Themen wie technisches Zubehör, Kleidung oder Küchengeräte abdecken). Weitere Informationen erhalten Sie unter Benutzerdefinierte Felder erstellen. Sie können aus folgenden Feldtypen wählen:
- Einzelauswahl
- Kurztext
- Langtext
- Großer Text
- numerisch
Hinweise:
- Sie können nur das Feld
opt-inoder benutzerdefinierte Felder auswählen. Auf andere Systemfelder ist von hier aus kein Zugriff möglich. - Wenn Sie den Feldtyp "Kurztext", "Langtext", "Großer Text" oder "numerisch" auswählen, können Sie nur eine bestimmte Gruppe an vordefinierten Werten verwenden:
0,1,2oderempty.
6. Das externe Event Send DOI-Mail wird für den Kontakt getriggert (Sie können ein benutzerdefiniertes externes Event auswählen; in diesem Fall müssen Sie das Event auf der Seite Management > Externe Events erstellen). Diese Aktion triggert den Versand der E-Mail, die wir in Schritt 4 des Abschnitts Allgemeine Struktur der Double Opt-In Journey erstellt haben. Die E-Mail enthält die vom Knoten generierte DOI_Url. Wenn der Kontakt den Link klickt, steuert der Knoten den Vorgang wie in Einstellungen für DOI Links beschrieben.
Einstellungen für DOI Links
Hier erfahren Sie, wie Sie die URLs für Ihre Erfolgs- und Fehlerseiten eingeben. Wenn Kontakte den an sie gesendeten DOI Link klicken, werden sie vom Knoten auf diese Seiten umgeleitet.
7. Forwarding success URL: Kontakte werden auf diese Seite umgeleitet (z.B. https://www.lifestlylelabels.com/success.html), wenn der Knoten alle unter Aktionen bei erfolgreichem DOI konfigurierten Aktionen erfolgreich durchführen kann. Emarsys bietet keine Vorlagen für Erfolgsseiten, die Seite sollte aber im Wesentlichen Folgendes kommunizieren: "Vielen Dank, hiermit bestätigen wir Ihre Registrierung."
8. Forwarding error URL: Kontakte werden auf diese Seite umgeleitet, wenn der Knoten nicht alle in Aktionen bei erfolgreichem DOI konfigurierten Aktionen erfolgreich durchführen konnte. Das kann folgende Ursachen haben:
a. Bei Emarsys ist es zu einem Systemausfall gekommen. In diesem Fall funktioniert der Link wieder, sobald der Systemausfall vorbei ist.
b. Der Knoten kann die DOI-Daten nicht in die Kontaktdatenbank schreiben, weil die Zielfelder gelöscht oder geändert wurden. In dem Fall müssen Sie dieses Problem zuerst lösen. Wenn Sie Hilfe benötigen, wenden Sie sich bitte an den Emarsys Support.
Emarsys bietet keine Vorlagen für Fehlerseiten, die Seite sollte aber im Wesentlichen Folgendes kommunizieren: "Es ist etwas schiefgelaufen, bitte versuchen Sie es in ein paar Minuten noch einmal. Sollte der Fehler wiederholt auftreten, kontaktieren Sie bitte unseren Customer Support."
In diesen URLs können Sie nur bestimmte Platzhalter und Personalisierungsvariablen verwenden. Bevor die URL aufgerufen wird, werden die Platzhalter durch (URL-codierte) Nutzerwerte ersetzt. Weitere Informationen erhalten Sie unter: Platzhalter oder Personalisierungsvariablen zur Forwarding success URL hinzufügen
Aktionen bei erfolgreichem DOI
Nach einem erfolgreichen DOI geschieht Folgendes:
9. Das aktuelle Datum wird im Feld DOI_Date, die IP-Adresse des Kontakts im Feld DOI_IP gespeichert (in den Knoteneinstellungen können Sie beide Felder anpassen). In Ihrer Kontaktdatenbank wird der Opt-in-Status aktualisiert (in den Knoteneinstellungen können Sie das Zielfeld für das opt-in anpassen).
10. Eine optionale benutzerdefinierte Aktion wie das Schreiben oder Aktualisieren eines alternativen Opt-in-Felds wird ausgeführt oder es wird ein externes Event getriggert (z.B. um den Registrierungsvorgang mit einer Welcome Tactic fortzusetzen).
Bitte wählen Sie im Dropdown Execute Event (on success, optional) nicht das Eintrittsevent (z.B. das externe Event "New contact registration"/Neue Kontaktregistrierung) aus; wenn Sie das tun, funktioniert der Knoten Double Opt-In nicht.
Personalisierungs-Token für den DOI_Url Wert erstellen
1. Navigieren Sie zu Content > Personalisierung, klicken Sie Token erstellen und wählen Sie Kontaktdaten aus.
2. Geben Sie dem Token einen Namen.
3. Wählen Sie eine Kategorie für das Token aus oder erstellen Sie eine Kategorie.
4. Wählen Sie als Referenz das Feld DOI_Url aus (dieses Feld wurde während der Konfiguration des Knotens Double Opt-In erstellt).
3. Aktivieren Sie die Checkbox Feldcontent ist für das Senden erforderlich. Das stellt sicher, dass die E-Mail nur gesendet wird, wenn der Inhalt des Felds DOI_Url präsent ist.
Triggered E-Mail für den DOI-Versand erstellen
1. Navigieren Sie zu Kanäle > Triggered E-Mail, wählen Sie das Tab Mail-Streams aus und klicken Sie E-Mail Stream erstellen.
2. Wählen Sie den passenden E-Mail-Typ (d.h. "Benutzerdefinierte HTML E-Mail" oder "Blockbasierte E-Mail), wählen Sie eine Vorlage aus und klicken Sie Kampagne erstellen.
3. Auf der Seite E-Mail-Einstellungen wählen Sie unter Trigger-Einstellungen die Option Externes Event aus und wählen Sie das Event Send DOI-Mail, das während der Konfiguration des Knotens Double Opt-In automatisch erstellt wurde.
4. Bearbeiten Sie die E-Mail. bis sie Ihren Anforderungen entspricht.
5. Fügen Sie einen CTA Button zur Kampagne hinzu (z.B. Registrierung bestätigen), wählen Sie den Button aus und klicken Sie das Icon Link Editor. Fügen Sie das zuvor erstellte Personalisierungs-Token DOI_Url zum Feld URL und optional zum Feld Titel hinzu.
6. Wenn Sie fertig sind, klicken Sie Speichern.
Konfiguration des Knotens "Double Opt-In" testen
Um zu überprüfen, ob Ihr Knoten für das Double Opt-In korrekt konfiguriert ist, kopieren Sie den Link aus dem Kontaktfeld, das Sie als Feld DOI_Url konfiguriert haben, hängen Sie den String &debug an das Ende des Links an und öffnen Sie den Link in Ihrem Browser.
Reporting zum DOI-Erfolg abrufen
Die Performance Ihres Programms überprüfen Sie auf den Screens E-Mail Reporting und Trend-Reporting.
Kontaktdaten zur Forwarding success URL hinzufügen
Der DOI-Knoten ermöglicht Ihnen, eine begrenzte Zahl von Kontaktdatensubstitutionen zu verwenden. Diese Platzhaltersubstitution unterscheidet sich von der Peronalisierungsfunktion, die in der Emarsys Plattform verfügbar ist, daher können Sie nur eine eingeschränkte Gruppe von Variablen in einer anderen Syntax verwenden. Bevor die URL aufgerufen wird, werden die Platzhalter durch (URL-codierte) Nutzerwerte ersetzt. Ein möglicher Link sieht so aus: http://www.test.com/doiconfirm.php?uid=$uid$
| Platzhalter | Output-Beschreibung | Beispiel |
|---|---|---|
| $uid$ | alphanumerische User ID | ePTfQQ3lyv |
| $userid$ | alphanumerische User ID | ePTfQQ3lyv |
| $user_id$ | alphanumerische User ID | ePTfQQ3lyv |
| $pers_3$ | E-Mail-Adresse des Nutzers | John.smith%40example.com |
| $email$ | E-Mail-Adresse des Nutzers | John.smith%40example.com |
Um andere Platzhalter (z.B. den Kampagnennamen) oder zusätzliche Parameter anzuhängen, müssen Sie diese direkt im URL-Feld der Kampagne einfügen, und zwar nach der Variable $DOI_Url$. Alle zusätzlichen Parameter müssen an die Forwarding URLs angefügt werden, zum Beispiel http://t.de/param=1#hash.
Die folgenden Parameter können Sie nicht an Forwarding URLs anfügen, weil sie intern verwendet werden: a, sub, rid, cid, uid, pid, debug.