Werbeeinverständnisse verwalten

Ermöglichen Sie Ihren Kunden die Registrierung oder Abbestellung für Newsletter in Ihrem Webshop. Die Daten, zu denen neben der E-Mail-Adresse auch weitere Kundendaten wie Name, Anschrift oder Interessengebiete gehören, werden in Felder der Optimizely Campaign Empfängerliste geschrieben. Diese Daten können Sie nachträglich aktualisieren.

Ihr Shop-System gilt als das führende System, das die Daten erhebt und an Optimizely Campaign weiterleitet. Bei Opt-In- und Opt-Out-Prozessen müssen Sie sicherstellen, dass der Kunde nach einem Klick auf den jeweiligen Bestätigungslink auch im Webshop an- bzw. abgemeldet wird. Dies erfolgt beispielsweise über eine Bestätigungsseite, über die Sie einen zusätzlichen Empfänger-ID-Parameter verarbeiten.

Aufbau der Empfängerliste

Um die Struktur der Empfängerlisten in Optimizely Campaign anzupassen, definieren Sie im Voraus, welche Benutzerdaten aus Ihrem Shop-System mit Optimizely Campaign synchronisiert werden sollen. Wenden Sie sich für die Konfiguration der Empfängerliste an die Kundenbetreuung, damit die Namen der Empfängerlistenfelder den Konventionen von Optimizely entsprechen.

Die Empfängerliste muss neben der E-Mail-Adresse und den personenbezogenen Daten ein ID-Feld zur Identifikation des Datensatzes im Shop-System enthalten. Hier sollten Sie optimalerweise einen kodierten Hash-Wert verwenden.

Befüllen Sie das Feld bmOptinSource, das die Quelle des Opt-Ins angibt. Geben Sie einen String in der Form ShopSystem/ShopName/Version ein, zum Beispiel WebShop/Schuhladen/1.1.2.

Übersicht des Opt-In-Prozesses

Soll sich aus dem Shop-System heraus ein Kunde für einen Newsletter anmelden, dann besteht der Opt-In-Prozess aus folgenden Schritten:

  1. Ihr Shop-System ruft die Optimizely Campaign HTTP-API auf und initiiert den Opt-In-Prozess. Dabei wird neben der E-Mail-Adresse auch eine ID zur Identifikation des Datensatzes im Webshop übergeben.
  2. Optimizely Campaign schickt dem Empfänger eine E-Mail mit der Aufforderung, die Anmeldung durch einen Klick auf einen Bestätigungslink zu bestätigen.
  3. Der Empfänger klickt auf den Bestätigungslink.
  4. Optimizely Campaign registriert die Bestätigung und der Empfänger erscheint in der Opt-In-Empfängerliste.
  5. Optimizely Campaign leitet den Empfänger via HTTP-Forwarding auf den Webshop weiter und ergänzt die URL um den Parameter, der zur Identifikation des Datensatzes im Webshop genutzt wird, wie zum Beipsiel https://www.example.com/newsletter/success?id=781278TZ.

    Sie müssen die URL der Bestätigungsseite für den Opt-In-Prozess im Voraus in Optimizely Campaign hinterlegen.

  6. Die Integration im Webshop nimmt den Aufruf unter /newsletter/success entgegen und greift auf den Wert des Parameters id zurück. Anhand des Wertes 781278TZ wird der Kundendatensatz identifiziert und zu den Newsletter-Empfängern im Shop-System hinzugefügt.

Sie müssen die ID zur Identifikation des Kundendatensatzes im Shop-System generieren und zwischenspeichern. In Optimizely Campaign wird diese ID in der Empfängerliste gespeichert.

Initiale Übertragung der Empfängerdaten und Start des Opt-In-Prozesses

Um einen Empfänger in eine Empfängerliste einzutragen und einen Opt-In-Prozess einzuleiten, wird der HTTP-Aufruf subscribe mit den Parametern bmRecipientId und bmOptInId aufgerufen. Weiterhin sollte das Feld bmOptinSource mit der Quelle des Opt-Ins befüllt werden, zum Beipsiel WebShop/Schuhladen/1.1.2. Das Feld customer-id enthält die ID des Kundendatensatzes.

Sie können weitere Felder aus der Empfängerliste als Parameter anhängen und zur Personalisierung des Mailings nutzen, z.B. salutation, firstname und lastname.

Beispiel-HTTP-Aufruf:

https://api.campaign.episerver.net/http/form/[AuthorizationCode]/[email protected]&bmOptInId=987654321&customer-id=1234ABCD&salutation=Herr&firstname=Max&lastname=Mustermann&bmOptinSource=SuperShop/Schuladen/1.2.1

Der Parameter bmRecipientId ist der Primärschlüssel der Empfängerliste (meistens die E-Mail-Adresse). Der Parameter bmOptInId legt den auszulösenden Opt-In-Prozess fest. Der Opt-In-Prozess enthält das im Optimizely Campaign Mandanten konfigurierte Mailing zur Anmeldebestätigung sowie die URL der Bestätigungsseite, auf die der Empfänger weitergeleitet wird.

Bestätigungslink und Bestätigungsseite

Sie müssen im Opt-In-Mailing einen Bestätigungslink als Feldfunktion {Double-Opt-In-Link} einfügen. Siehe Opt-In-Prozesse.

Die Feldfunktion wird zum individuellen Bestätigungslink des Empfängers umgewandelt und um den Parameter customer-id ergänzt: {Double-Opt-In-Link}?customer-id={customer-id}.

Der Parameter customer-id erhält den jeweiligen Wert aus der Opt-In-Empfängerliste.

Wenn der Mailing-Empfänger auf den Bestätigungslink klickt, wird er auf die hinterlegte Bestätigungsseite weitergeleitet: https://www.example-shop.com/newsletter/success?customer-id=8122.

Sie müssen die Integration im Shop-System so konfigurieren, dass beim Aufruf des Pfades /newsletter/success der Wert des Parameters customer-id ausgelesen und innerhalb des Shop-Systems weiterverwendet wird.

Sie können den Bestätigungslink um weitere Parameter ergänzen, sofern Ihre Empfängerliste entsprechende Felder beinhaltet. Wenn Ihre Empfängerliste beispielsweise das Feld shop-id beinhaltet, können Sie den Bestätigungslink um den Parameter shop-id ergänzen: {Double-Opt-In-Link}?customer-id={customer-id}&shop-id={shop-id}.

Abbestell-Link und Bestätigungsseite

Während Sie in einem Mandanten mehrere Opt-In-Prozesse anlegen können, wird nur ein Abbestell-Link je Mandant konfiguriert.

Der Abbestell-Link wird im Mailing an einer geeigneten Stelle platziert (zum Beispiel im Footer), sodass der Empfänger mit einem Klick den Newsletter abbestellen kann.

Wie auch der Bestätigungslink, leitet der Abbestell-Link den Empfänger zunächst auf Optimizely Campaign weiter, um die Abbestellung zu registrieren. Anschließend wird der Empfänger zu einer Bestätigungsseite weitergeleitet. Um die URL der Bestätigungsseite zu hinterlegen oder zu ändern, siehe URL der Bestätigungsseite ändern.

Sie können den Abbestell-Link außerdem um weitere Parameter ergänzen, sofern Ihre Empfängerliste entsprechende Felder beinhaltet: https://www.example.com/newsletter/unsubscribe?customer-id={customer-id}&shop-id={shop-id}.

Sie müssen die Integration in Ihrem Shop-System so programmieren, dass ein Aufruf des Pfades /newsletter/unsubscribe zu einer Austragung des Empfängers customer-id führt. Abhängig vom System, können Sie über den Parameter shop-id auch einen bestimmten Webshop oder eine Unterseite ansprechen. Sowohl customer-id als auch shop-id sind dem Shop-System bereits bekannt, da beide Werte bei der Anmeldung des Empfängers vom Shop-System in die Empfängerliste geschrieben wurden.

Kundendaten aktualisieren

Ändert ein Kunde im Webshop seine Daten (zum Beispiel Anschrift oder Telefonnummer), können Sie über die HTTP-API-Operation updatefields die Felder in der Empfängerliste aktualisieren. Zur Identifikation dient hierbei die E-Mail-Adresse als Primärschlüssel (Parameter bmRecipientId): https://api.campaign.episerver.net/http/form/[AuthorizationCode]/[email protected]&city=Aachen&zip=52070.

Mit dem API-Aufruf ändern Sie für den Empfänger [email protected] die Werte der Empfängerlistenfelder city und zip zu Aachen und 52070.

Empfänger aus Empfängerliste austragen

Bestellt ein Empfänger aus Ihrem Webshop heraus einen Newsletter ab, zum Beispiel über einen Link oder ein Kontrollkästchen, können Sie diese Abbestellung mit der API-Operation unsubscribe in Optimizely Campaign registrieren: https://api.campaign.episerver.net/http/form/[AuthorizationCode]/[email protected]

Der Parameter bmRecipientId identifiziert den Empfänger eindeutig über seine E-Mail-Adresse und die API-Operation meldet den Empfänger vom Newsletter ab. Der Empfänger wird in eine separate Abbestell-Liste eingetragen und nicht mehr angeschrieben. Siehe Abbesteller.