> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Migration von Newsletter V2 zu E-Marketing-Manager

> Vom Newsletter-Modul V2 auf den E-Marketing-Manager umstellen, im laufenden Betrieb und ohne Unterbrechung für die Abonnenten.

Der E-Marketing-Manager löst das Newsletter-Modul V2 ab. Die Umstellung lässt sich im laufenden Shopbetrieb durchführen, weil beide Systeme eine Zeit lang nebeneinander laufen können und Sie das neue zunächst nur im Testmodus sichtbar machen.

## Was der E-Marketing-Manager zusätzlich kann

* neuer Mitteilungs-Editor mit überarbeiteten Plugins
* Anmeldung bei Zielgruppen im Bestellprozess
* bestellabhängig gefilterter Versand
* Verifizierungs-E-Mail bei Abmeldung abschaltbar
* Informations-E-Mail bei erfolgreicher Abmeldung
* E-Mails einschließlich HTML-Kopfbereich bearbeitbar
* Blacklist-Eintrag auf Abonnenten beschränkbar
* Verifizierungs-E-Mails nach Subshops gruppierbar

Dazu kommt eine überarbeitete Bedienoberfläche mit kontextbezogener Hilfe zu allen wichtigen Funktionen.

## Schritt 1: Voraussetzungen prüfen

Der E-Marketing-Manager muss von der WEBSALE AG freigeschaltet sein.

> [!WARNING]
>
> Während der Migration darf im Newsletter-Modul V2 nichts mehr geändert werden, also keine Newsletter angelegt und kein Versand gestartet werden. Stimmen Sie das mit allen ab, die Zugang zum Modul haben, bevor Sie beginnen.

## Schritt 2: Die Shopkonfiguration erweitern

Ergänzen Sie die `shop.config` um die Abschnitte `<eMarketingManager>` und `<eMarketingManager-Txt>`.

Wegweiser: [E-Marketing-Manager](https://dokumentation.websale.de/v8s/marketing-funktionen/e-marketing-manager.md)

## Schritt 3: Die Templates anlegen

Legen Sie die vier Templates des E-Marketing-Managers an, wie auf der Integrationsseite beschrieben.

Wollen Sie dieselben Shop-Templates weiterverwenden wie bisher, trennen Sie für die Dauer der Migration die beiden ExternInclude-Aufrufe voneinander. Tragen Sie dafür im Abschnitt `<eMarketingManager>` die Templatenamen aus dem Newsletter-Modul V2 ein und klammern Sie die Aufrufe.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{!ST-Test}
   ~WS-ExternInclude($WS-NewsletterLink$)~
{/!ST-Test}

{ST-Test}
   ~WS-ExternInclude($WS-eMarketingManagerLink$)~
{/ST-Test}
```

> [!WARNING]
>
> `ST-Test` prüft den **Design-Testmodus**, nicht den allgemeinen Testmodus des Shops. Ein Aufruf mit `?test=on` allein zeigt Ihnen also weiterhin das alte Modul. Sie müssen den Design-Testmodus einschalten, sonst prüfen Sie die ganze Migration am falschen System.

Der Sinn dieser Klammerung ist, dass Ihre Kunden während der gesamten Migration unverändert das alte Modul sehen, während Sie am selben Template das neue testen.

Wegweiser: [Testmodi des Shops ein-/ausschalten](https://dokumentation.websale.de/v8s/domains/testmodi-des-shops-ein-ausschalten.md)

## Schritt 4: Die Verifizierungs-E-Mails anpassen

Die Gruppierung der Verifizierungs-E-Mails hat sich geändert, deshalb lassen sich die alten Mails nicht übernehmen.

Kopieren Sie den Quelltext der Verifizierungs-E-Mails aus dem Newsletter-Modul V2 und fügen Sie ihn in die Mails Ihrer neuen Verifizierungsgruppe ein. Das geschieht im Online-Servicebereich.

## Schritt 5: Funktionstests durchführen

Prüfen Sie die neuen Templates im Design-Testmodus, indem Sie sich beispielsweise für eine Zielgruppe anmelden.

Erhalten Sie die Meldung, dass der Dienst noch nicht richtig konfiguriert sei, prüfen Sie zuerst, ob der Subshop im Online-Servicebereich bereits einer Verifizierungsgruppe zugewiesen ist. Das ist die häufigste Ursache.

## Schritt 6: Altes entfernen und Neues freigeben

Erst wenn die Tests durchgelaufen sind:

1. Entfernen Sie die Abschnitte `<NewsletterV2>` und `<NewsletterV2-Txt>` aus der `shop.config`.
2. Löschen Sie die nicht mehr benötigten Templates.
3. Entfernen Sie die `ST-Test`-Klammerung aus Schritt 3, sodass alle Besucher das neue Modul sehen.

> [!WARNING]
>
> Entfernen Sie die Klammerung erst, wenn Sie die Abschnitte des alten Moduls entfernt haben und die neuen Templates stehen. Sonst sehen Ihre Kunden für die Dauer der Umstellung gar kein Newsletter-Formular.

## Schritt 7: Das alte Modul abschalten lassen

Informieren Sie die WEBSALE AG, damit der Dienst für das Newsletter-Modul V2 abgeschaltet wird. Erst damit ist die Migration abgeschlossen.

## Verwandte Themen

* Wegweiser: [E-Marketing-Manager](https://dokumentation.websale.de/v8s/marketing-funktionen/e-marketing-manager.md)
* Wegweiser: Testmodi des Shops ein-/ausschalten


## Related topics

- [E-Marketing-Manager](https://dokumentation.websale.de/v8s/marketing-funktionen/e-marketing-manager.md)
- [Materialien E-Marketing-Manager](https://dokumentation.websale.de/v8s/materialien/materialien-emarketing-manager.md)
- [REST eMarketingManager](https://dokumentation.websale.de/v8s/schnittstellen/rest-osb-dienste/rest-emarketingmanager.md)
- [Newsletter-Gutscheine](https://dokumentation.websale.de/v8s/gutscheine-anbieten/newsletter-gutscheine.md)
- [NL- (Newsletter-Anmeldung im Bestellprozess)](https://dokumentation.websale.de/v8s/referenz/tags/nl.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.