--- title: Fehlersuche slug: campaign/docs/fehlersuche docTags: createdAt: 2026-08-06T15:53:57.193Z --- :::hint{type="info"} **Note** Dieses Kapitel richtet sich an Administratoren und Entwickler mit Administratorrechten in Shopware. ::: Dieses Kapitel beschreibt, wie Sie als Nutzer von Shopware als E-Commerce Plattform in Verbindung mit Optimizely Campaign mit Fehlfunktionen umgehen können. Erfahren Sie mehr über [häufige Fehlerquellen](docId\:KtUEQcOg9dpL4Tdh7y6gE), die bei der Konfiguration und im Betrieb der Shopware-Integration auftreten können und wie Sie die [Protokollierung](docId\:KtUEQcOg9dpL4Tdh7y6gE) von Ereignissen und ausgeführten Aufgaben starten, um den Betrieb zu überwachen und bei Problemen die Fehlerquelle ausfindig zu machen. ## Probleme bei der Einrichtung Wenn bei der Installation, der Konfiguration und im Betrieb Probleme auftreten, die Sie nicht beseitigen können, wenden Sie sich an die [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV). ## Häufige Fehlerquellen | Fehler | mögliche Ursache | Lösung | | ------------------------------------------------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | Kunden können sich nicht zum Newsletter anmelden. | Die Firewall des Shop-Systems blockiert den Verbindungsaufbau zu Optimizely Campaign. | Überprüfen Sie die Netzwerkkonfiguration des Shop-Systems. | | | Der Autorisierungs-Code der Empfängerliste ist ungültig. | Überprüfen Sie den Autorisierungs-Code der Empfängerliste und erstellen Sie ggf. einen neuen Autorisierungs-Code. | | | Die Opt-In-ID ist ungültig. | Überprüfen und korrigieren Sie die Opt-In-ID. | | Der Katalog-Export schlägt fehl. | Die Firewall des Shop-Systems blockiert den Verbindungsaufbau zu Optimizely Campaign. | Überprüfen Sie die Netzwerkkonfiguration des Shop-Systems. | | | Der private SSH-Schlüssel wurde unvollständig oder fehlerhaft hinterlegt. | Geben Sie den SSH-Schlüssel erneut ein. | | | Das Passwort des privaten SSH-Schlüssels wurde unvollständig oder fehlerhaft hinterlegt. | Geben Sie das Passwort des privaten SSH-Schlüssels erneut ein. | ## Protokollierung Die Shopware-Integration enthält eine Funktion zur Protokollierung von Ereignissen und ausgeführten Aufgaben, wie beispielsweise die Protokollierung des Katalog-Exports. Mithilfe der Protokolldateien können Sie bei Problemen mit der Shopware-Integration die entsprechenden Fehlerquellen ausfindig machen. Die Protokollierung steuern Sie über einen **Cronjob**, den Sie in Ihrem Shopware-System aktivieren müssen. ### Protokollierung konfigurieren Um den Cronjob für die Protokollierung zu konfigurieren, führen Sie die folgenden Schritte aus: 1. Melden Sie sich mit Administrator-Rechten im Backend von Shopware an. 2. Wählen Sie in der Menüleiste **Einstellungen** > **Grundeinstellungen**. ![Bild: Grundeinstellungen](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/uFoqNyGY2vxUlUFoh33Ob-20260720-145428.png "Bild: Grundeinstellungen") 3. Wählen Sie **System** > **Cronjobs**. ![Bild: Cronjobs auswählen](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/x7rl7ZDp02lmvBzjF7w4V-20260720-145428.png "Bild: Cronjobs auswählen") 4. Finden Sie in der Liste den Cronjob **Optivo** **ErrorHandler** und klicken Sie auf **Bearbeiten** :inlineImage[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/hKLokDek-pkQCDllEHcos-20260720-145428.png" alt="Bild" caption width="20" height="20"}. ![Bild: Cronjob suchen und bearbeiten](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/kELVSjcHtC-Uov_7QZDqr-20260720-145428.png "Bild: Cronjob suchen und bearbeiten") 5. Aktivieren Sie das Kontrollkästchen neben **Aktiv**. ![Bild: Cronjob aktivieren](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/PwHUBnyQ-pRImQvzDRHHh-20260720-145428.png "Bild: Cronjob aktivieren") 6. Wählen Sie in der Drop-down-Liste **Intervall** ein Zeitintervall für den Cronjob aus. Mit dem Zeitintervall legen Sie fest, in welchen zeitlichen Abständen einzelne Protokolleinträge zusammengefasst werden. ![Bild: Zeitintervall auswählen](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/S2Qwk0pdlhr5OaANeBksd-20260720-145428.png "Bild: Zeitintervall auswählen") 7. Klicken Sie auf **Speichern**. 8. Um den Cronjob zu aktivieren und die Protokollierung zu starten, rufen Sie die URL auf. In der Regel lautet die URL `http:///backend/cron` :::hint{type="info"} **Note** In der Liste der Cronjobs sehen Sie den Eintrag **Processing Optivo ErrorHandler** (wenn der Job aufgrund seiner Intervall-Einstellungen ausgeführt wird). ::: ### Protokollierung im Backend-Log 1. Wählen Sie **Einstellungen** > **Logfile**. ![Bild: Logfile im Einstellungsmenü](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/5tBM5Le9wiKqe9iHz1Q7b-20260720-145428.png "Bild: Logfile im Einstellungsmenü") 2. Entnehmen Sie der Liste die protokollierten Ereignisse der Shopware-Integration. Um die Details eines Eintrag einzusehen, klicken Sie auf das Lupen-Symbol in der Spalte **Optionen**. Einträge, die die Shopware-Integration in die Liste geschrieben hat, erkennen Sie an dem Namen **optivobroadmail** in der Spalte **Benutzer**. ![Bild: Lupensymbol](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/NhclplhwbSbMj5UuzOhmi-20260720-145428.png "Bild: Lupensymbol") ### Protokolldateien im System-Log Die Shopware-Integration schreibt ihre Meldungen in den Kanal broadmail im Reiter **System-Log**. Sie finden dort die aktuellsten, noch nicht durch den Cronjob archivierten Einträge. ![Bild: Reiter System-Log](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/kxr355l5aPjrwjntbd1eY-20260720-145428.png "Bild: Reiter System-Log") Um die Details einer Meldung anzuzeigen, klicken Sie auf das Lupensymbol. **Beispiel:** Die folgende Nachricht weist darauf hin, dass der Produktexport gestartet wurde. Die Ausführung schlug allerdings fehl, weil keine Benutzerkennung in den Einstellungen der Shopware-Integration eingegeben wurde. ```php CronJobsSubscriber::onOptivoProductExport: missing export sftp username ``` Wenn Sie die archivierten Einträge anzeigen möchten, öffnen Sie die Drop-down-Liste links neben **Download**. Wenn Sie eine Protokolldatei auf Ihrem Rechner zu speichern, klicken Sie auf **Download**. :::hint{type="info"} **Note** Wenn Sie Fehlermeldungen der Programmiersprache PHP bei der Nutzung der Shopware-Integration erhalten, senden Sie die Fehlermeldungen mit einem Screenshot und einer Beschreibung des Vorgangs, bei dem das Problem aufgetreten ist, an die Optimizely [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV). Eventuell muss ein Entwickler/Administrator Ihres Shopware-Systems die exakten Fehlermeldungen der Protokolldatei des Linux-Systems auslesen und an Optimizely weiterleiten. :::