--- title: Dynamische CSV- und XML-Artikel slug: campaign/docs/dynamische-csv-und-xml-artikel docTags: createdAt: 2026-08-06T15:53:47.718Z --- Mithilfe von dynamischen CSV- und XML-Artikeln können Sie individuelle Produktempfehlungen versenden. Die entsprechenden Produktdaten werden für jeden einzelnen Empfänger zum Versandzeitpunkt aus der CSV-Produktdatenquelle beziehungsweise XML-Produktdatenquelle geladen. :::hint{type="info"} **Note** URLs, die Bild-Dateien referenzieren, werden dynamisch während des Versands in das Mailing eingefügt. Stellen Sie entsprechend sicher, dass Ihr Server eine hohe Anzahl von Anfragen zum Zeitpunkt des Mailing-Versands bearbeiten kann. ::: ## Voraussetzungen - In Ihrem Mandanten sind dynamische CSV-Artikel und/oder XML-Artikel freigeschaltet. - CSV-Produktdatenquelle: siehe [Produktdaten mittels CSV-Datei exportieren](docId\:ABEvauHLK-KiTCpfYp5_H). XML-Quelle: siehe [XML verwenden](docId\:CaxhiIChOEZ4Uaq93q0Vo). ## Mapping-Referenz erstellen Zum Versandzeitpunkt liest Optimizely Campaign aus der Mapping-Referenz die Produkt-ID aus und lädt im zweiten Schritt anhand der Produkt-ID die entsprechenden Produktdaten aus der CSV-Produktquelle beziehungsweise der XML-Datenquelle. Um jedem Empfänger ein unterschiedliches Produkt senden zu können, müssen Sie eine Mapping-Referenz erstellen. In der Mapping-Referenz werden die individuellen Produktempfehlungen für jeden einzelnen Empfänger gelistet – in Form der Produkt-ID. Sie haben zwei Möglichkeiten, eine Mapping-Referenz zu erstellen: - **Empfängerliste**. Sie importieren die zu mappende Produkt-ID in ein Empfängerlistenfeld Ihrer Empfängerliste. - **Mapping-Datei**. Sie erstellen eine CSV-Datei, die die Empfänger-ID jedes einzelnen Mailing-Empfängers in einer eigenen Zeile listet. Zu jeder Empfänger-ID fügen Sie in einer weiteren Spalte die individuell zu mappende Produkt-ID hinzu. Struktur der Mapping-Datei. | A | B | | ---------------------------------------------------------- | ------------- | | [empfaenger1@example.com](mailto\:empfaenger1@example.com) | ProduktID123 | | [empfaenger2@example.com](mailto\:empfaenger2@example.com) | ProduktID456 | | [empfaenger3@example.com](mailto\:empfaenger3@example.com) | ProduktID789 | | und so weiter | und so weiter | :::hint{type="danger"} **Warning** Wenn Sie mehrere Produkt-IDs hintereinander setzen, dürfen nach dem Trennzeichen keine Leerzeichen folgen. Richtig: `123,456,789` Falsch: `123, 456, 789` ::: ### Empfängerliste als Mapping-Referenz verwenden 1. Um das entsprechende Empfängerlistenfeld für zu mappende Produkt-IDs einzurichten, wenden Sie sich an die [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV). Sie können in das Empfängerlistenfeld maximal 256 Zeichen übertragen. Wenn Sie das Limit überschreiten möchten, wenden Sie sich an die [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV). Sie können die empfänger-individuellen Produkt-IDs über mehrere Wege in Ihre Empfängerlisten importieren, beispielsweise per CSV-Import oder per SOAP-API. 2. Übertragen Sie die empfänger-individuellen Produkt-IDs in Ihre Empfängerliste. ### Mapping-Datei als Mapping-Referenz verwenden 1. Erstellen Sie eine CSV-Datei, die in der ersten Spalte die Empfänger-IDs aller Empfänger enthält. Jede Empfänger-ID muss in einer eigenen Zeile stehen. 2. Fügen Sie in der zweiten Spalte für jede Empfänger-Zeile die empfänger-individuellen Produkt-IDs hinzu. 3. Übertragen Sie die Mapping-Datei auf den Optimizely Server – in das Verzeichnis, das Sie bei der Einrichtung der dynamischen Artikel als Speicherort Ihrer Mapping-Datei angegeben haben. :::hint{type="info"} **Tip** Alternativ können Sie auch die Zusatzfunktion **Datei hochladen** verwenden. Sie finden die Zusatzfunktion **Datei hochladen** Optimizely Campaign Menü unter **Mehr**. (Um diese Funktion zu ferizuschalten, wenden Sie sich an die [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV).) ::: ## Dynamische CSV-Artikel bzw. XML-Artikel erstellen 1. Legen Sie im [Template-Kit](docId\:jRJZaVEfgoLqt9ai1hzyD) einen neuen Inhaltsparagraphen an, indem Sie auf **Neu: Inhaltsparagraph** klicken. ![Bild: Neuer Inhaltsparagraph](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/1VVObBNklqn4B-gFyX0ix-20260720-145330.png "Bild: Neuer Inhaltsparagraph") 2. Wählen Sie den Paragraphen-Typen Content-Schnittstelle aus, indem Sie auf **Content-Schnittstelle** klicken. ![Bild: Content-Schnittstelle](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/akFFp6Z0ahPHfZteIIW1t-20260720-145330.png "Bild: Content-Schnittstelle") 3. Klicken Sie auf **Übernehmen**. Sie haben einen neuen Inhaltsparagraphen vom Typ Content-Schnittstelle angelegt. Links in der Vorschau ist die Schaltfläche **Content-Schnittstellen-Artikel** verfügbar. 4. Klicken Sie auf **Content-Schnittstellen-Artikel**. Rechts im Fenster öffnet sich das Konfigurationsfenster des Content-Schnittstellen-Artikels. ## Dynamischen CSV-Artikel bzw. XML-Artikel konfigurieren Nachdem Sie einen dynamischen CSV-Artikel beziehungsweise XML-Artikel erstellt haben, müssen Sie den Artikel konfigurieren. Führen Sie dazu die folgenden Schritte aus: ### Empfängerliste als Mapping-Referenz 1. Öffnen Sie rechts im Konfigurationsfenster des Content-Schnittstellen-Artikels den Reiter **Empfängerliste**. ![Bild: Empfängerliste](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/L4jdcOzWtm9s4Eqk_3Rtw-20260720-145330.png "Bild: Empfängerliste") 2. Geben Sie im Feld **Empfängerlistenfeld** den Namen des Empfängerlistenfeldes an, das die Produkt-ID enthält. Setzen Sie den Namen in geschweifte Klammern: . 3. Wenn in dem Empfängerlistenfeld mehrere Produkt-IDs enthalten sind, geben Sie das verwendete Trennzeichen zwischen den einzelnen Produkt-IDs an. :::hint{type="info"} **Note** Falls Sie keine Angabe machen, wird das Komma als Trennzeichen vermutet. ::: 4. Wenn das Empfängerlistenfeld mehrere Produkt-IDs enthält, geben Sie die Positionsnummer des zu ladenden Produkts an. Beispiel: In Ihrem Empfängerlistenfeld sind drei kommaseparierte Produkt-IDs enthalten: „123,456,789“. Um das Produkt mit der Produkt-ID „789“ auszuwählen, tragen Sie die Positionsnummer „3“ ein, da sich die Produkt-ID „789“ an dritter Position in der Kette „123,456,789“ befindet. Wenn Sie keine Positionsnummer angeben, wird automatisch das Produkt auf der ersten Position ausgewählt. 5. Klicken Sie auf **Übernehmen**. Links in der Vorschau werden Ihnen die Daten Ihrer Konfiguration am Content-Schnittstellen-Artikel angezeigt. Zum Versandzeitpunkt werden die Produktdaten anhand der Konfiguration aus der CSV-Produktdatenquelle beziehungsweise XML-Produktdatenquelle geladen. ### Mapping-Datei als Mapping-Referenz 1. Öffnen Sie rechts im Konfigurationsfenster des Content-Schnittstellen-Artikels den Reiter **Mapping-Datei**. ![Bild: Mapping-Datei](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/zzIjCIokUT4JngxwAwrQ4-20260720-145330.png "Bild: Mapping-Datei") 2. Geben Sie im Feld **Dateiname** den Namen der Mapping-Datei ein. 3. Geben Sie im Feld **Empfängerlistenfeld, das die Empfänger-ID enthält (interne Bezeichnung)** die interne Bezeichnung des Empfängerlistenfelds an. Wenn Sie die interne Bezeichnung nicht kennen, wenden Sie sich an die [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV). 4. Wenn die Mapping-Datei in der Produkt-ID-Spalte mehrere Produkt-IDs enthält, geben Sie die Positionsnummer des zu ladenden Produkts an. Beispiel: In der Produkt-ID-Spalte sind drei Produkt-IDs enthalten: „123,456,789“. Um das Produkt mit der Produkt-ID „789“ auszuwählen, tragen Sie die Positionsnummer „3“ ein, da sich die Produkt-ID „789“ an dritter Position in der Kette „123,456,789“ befindet. Wenn Sie keine Positionsnummer angeben, wird automatisch das Produkt auf der ersten Position ausgewählt. 5. Klicken Sie auf **Übernehmen**. Links in der Vorschau werden Ihnen die Daten Ihrer Konfiguration am Content-Schnittstellen-Artikel angezeigt. Zum Versandzeitpunkt werden die Produktdaten anhand der Konfiguration aus der CSV-Produktdatenquelle beziehungsweise XML-Produktdatenquelle geladen.