Katalog-Export konfigurieren

Dieses Kapitel richtet sich an Administratoren und Entwickler mit Administratorrechten in Shopware.

Dieses Kapitel beschreibt, wie Sie den Katalog-Export konfigurieren, wenn Sie Shopware als E-Commerce-Plattform mit Anbindung an Optimizely Campaign nutzen. Sie können Ihre Produktdaten wie Angebotstexte und Produktbilder von zu Optimizely Campaign übertragen und in Ihrem Newsletter nutzen. Weitere Informationen finden Sie auch in Content-Schnittstellen-Paragraph.

Funktionsweise

Die Integration liest einen in Shopware angelegten Feed aus und überträgt diesen an Optimizely Campaign. Sie können auf die in Shopware verfügbaren Filter zurückgreifen um einzelne Produktkategorien auszuschließen. Die Shopware-Integration exportiert Ihren Katalog in eine CSV Steht für „Comma-Separated Values“. Eine Textdatei mit Tabellendaten, die durch Kommazeichen voneinander getrennt sind.-Datei und überträgt diese automatisiert in bestimmten Zeitintervallen über eine sichere SFTP-Verbindung auf den Optimizely Server.

Voraussetzungen

Sie benötigen ein SSH-Schlüsselpaar und ein SFTP-Benutzerkonto, um eine sichere Verbindung aufbauen zu können. Wie Sie Schlüsselpaar erstellen, finden Sie unter:

Wenn Sie das Schlüsselpaar erstellt haben, benötigen Sie im nächsten Schritt ein Benutzerkonto auf dem Optimizely Server:

  1. Wenden Sie sich an die Kundenbetreuung. Teilen Sie ihr den Namen der CSV-Datei mit Ihrem Produktkatalog mit.
  2. Senden Sie Ihren öffentlichen Schlüssel (die Datei mit der Endung .pub) per E-Mail an die Kundenbetreuung.
  3. Senden Sie Ihren Key-Fingerprint in einer weiteren, gesonderten E-Mail an die Kundenbetreuung.

    Versenden Sie Ihren öffentlichen Schlüssel und Ihren Key-Fingerprint aus Sicherheitsgründen stets in zwei getrennten E-Mails.

    Wenn Ihr Benutzerkonto eingerichtet ist, erhalten Sie die Daten Ihres Benutzerkontos per E-Mail und Sie können mit der Konfiguration beginnen.

Konfigurationsschritte

  1. Konfigurieren Sie den Feed für den Katalog-Export.
  2. Konfigurieren Sie die Shopware-Integration für den Katalog-Export.
  3. Konfigurieren und aktivieren Sie den Cronjob Optivo ProductExport, um den täglichen Katalog-Export zu Optimizely Campaign zu automatisieren.

Schritt 1: Feed für den Katalog-Export konfigurieren

Die Shopware-Integration enthält einen Standard-Feed, den Sie duplizieren und an Ihre Anforderungen anpassen können (empfohlen).

Um den Feed für den Katalog-Export 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 Marketing > Produktexporte.

    Bild: Produktexporte im Marketing-Menü

  3. Finden Sie den Eintrag optivo broadmail und klicken Sie auf Diesen Feed bearbeiten .

    Bild: Diesen Feed bearbeiten

  4. Wählen Sie im Reiter Formatierung in der Drop-down-Liste Zeichenkodierung die Option UTF-8 aus.

    Bild: Kodierung auswählen

    Die Einträge in den Reitern Kopfzeile und Template wurden von der Shopware-Integration bei der Installation angelegt und sind Voraussetzung für einen reibungslosen Produktdatenaustausch mit der Content-Schnittstelle. Ändern Sie nicht die Einträge im Reiter Kopfzeile. Im Reiter Template können Sie bei Bedarf Änderungen vornehmen, wie in Schritt 5 und 6 beschrieben.

  5. Optional: Wechseln Sie in den Reiter Template und passen Sie die Versanddauer an, indem Sie die Anzahl der Tage ändern (standardmäßig 10).

    Bild: Versanddauer anpassen

    Ändern Sie nicht die Variablen und verwendeten Filter (wie z. B. |escape).

  6. Optional: Ändern Sie im Reiter Template den Versanddienstleister und die Versandart.

    Bild: Versanddienstleister ändern

    In der Standardeinstellung sind als Versanddienstleister und als Versandart Deutsche Post Standard hinterlegt.

    Ändern Sie nicht die Variablen und verwendeten Filter (wie z. B. |escape).

  7. Wenn Sie einzelne Produktkategorien vom Katalog-Export ausschließen und nicht zu Optimizely Campaign übertragen möchten, wechseln Sie in den Reiter Geblockte Kategorien und aktivieren Sie das entsprechende Kontrollkästchen.

    Bild: Produktkategorien ausschließen

  8. Klicken Sie auf Speichern.
  9. Finden Sie den optivo broadmail Feed und führen Sie in der Spalte Dateiname einen Rechtsklick auf dem Dateinamen aus. Wählen Sie im Kontextmenü Ihres Browsers die Option aus Link-Adresse kopieren.

    Bild: Link-Adresse kopieren

  10. Behalten Sie die URL des Feeds in der Zwischenablage oder speichern Sie die URL in einem Textdokument.

Schritt 2: Shopware-Integration für den Katalog-Export konfigurieren

  1. Wählen Sie in Shopware Einstellungen > Plugin Manager.

    Bild: Plugin Manager im Einstellungen-Menü

  2. Klicken Sie links in der Menüleiste auf Installiert.

    Bild: Menüpunkt Installiert

  3. Finden Sie in der Liste die Shopware-Integration im Plugin Manager Episerver Campaign und klicken Sie auf Öffnen .

    Bild: Shopware-Integration öffnen

  4. Geben Sie im Bereich Konfiguration die untenstehenden Daten ein:

    Bild: Bereich Konfiguration

    • Produktexport. Wählen Sie Ja aus.
    • Export Name. Geben Sie den Dateinamen Ihres Katalog-Exports ein.
    • Produktexport Link. Geben Sie die URL des Feeds für den Katalog-Export ein.
    • SFTP Benutzername. Geben Sie den Benutzernamen Ihres Kontos auf dem Optimizely Server ein.
    • SFTP Keyfile Passwort. Geben Sie das Passwort Ihres privaten SSH-Schlüssels ein.
    • SFTP Private Keyfile. Geben Sie Ihren privaten SSH-Schlüssel ein.
  5. Klicken Sie auf Speichern.

Schritt 3: Cronjob konfigurieren und aktivieren

Um den täglichen Katalog-Export zu Optimizely Campaign zu automatisieren, müssen Sie den Cronjob Optivo ProductExport konfigurieren und aktivieren.

  1. Wählen Sie in Shopware Einstellungen > Grundeinstellungen.

    Bild: Grundeinstellungen im Einstellungen-Menü

  2. Wählen Sie System > Cronjobs.

    Bild: Cronjobs auswählen

  3. Finden Sie in der Liste den Cronjob Episerver Campaign Product Export und klicken Sie auf Bearbeiten .

    Bild: Cronjob suchen

  4. Aktivieren Sie das Kontrollkästchen bei Aktiv.

    Bild: Cronjob aktivieren

  5. Wählen Sie in der Drop-down-Liste Intervall ein Zeitintervall aus, z. B. 1 Tag.

    Bild: Zeitintervall aussuchen

  6. Klicken Sie auf Speichern.
  7. Um den Cronjob zu aktivieren und die automatische Wiederholung (in dem von Ihnen eingestellten Zeitintervall) zu starten, rufen Sie die URL zur Ausführung Ihrer Cronjobs auf. Diese lautet in der Regel: http://<URL Ihres Shops>/backend/cron.

    Sie finden den Cronjob nach dem Aufruf der URL in der Liste der ausgeführten Cronjobs unter dem Eintrag Processing Episerver Campaign Product Export (wenn die Ausführung geplant ist).