--- title: Werbeeinverständnisse verwalten slug: campaign/docs/EWNv-werbeeinverstpercentc3percenta4ndnisse-verwalten docTags: createdAt: 2026-08-06T15:53:47.341Z --- 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](docId\:ZWe1T3UPz3JW6_4mc76qV), 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](https://www.example.com/newsletter/success?id=781278TZ). :::hint{type="info"} **Note** 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. :::hint{type="info"} **Note** 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\]/subscribe?bmRecipientId=abc@example.com\&bmOptInId=987654321\&customer-id=1234ABCD\&salutation=Herr\&firstname=Max\&lastname=Mustermann\&bmOptinSource=SuperShop/Schuladen/1.2.1](https://api.campaign.episerver.net/http/form/\[AuthorizationCode]/subscribe?bmRecipientId=abc@example.com\&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](docId\:brctgpxx40MYcdYlF58GH). 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}`. :::hint{type="info"} **Tip** 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](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](docId:-XJiHsqB-CIy-zNeVEum2). 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=\&shop-id=\{shop-id](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\]/updatefields?bmRecipientId=abc@example.com\&city=Aachen\&zip=52070](https://api.campaign.episerver.net/http/form/\[AuthorizationCode]/updatefields?bmRecipientId=abc@example.com\&city=Aachen\&zip=52070). Mit dem API-Aufruf ändern Sie für den Empfänger [abc@example.com](mailto\:abc@example.com) 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\]/unsubscribe?bmRecipientId=abc@example.com](https://api.campaign.episerver.net/http/form/\[AuthorizationCode]/unsubscribe?bmRecipientId=abc@example.com) 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](docId:2wUKfol9g5WNDgfoer24-).