So fügst du einen benutzerdefinierten Web-Feed in eine E-Mail ein

Du wirst lernen

Hier erfährst du, wie du einen benutzerdefinierten Web-Feed in eine E-Mail einfügen und verwenden kannst. Ein benutzerdefinierter Web-Feed ermöglicht es dir, einen Daten-Feed von einer externen URL dynamisch in eine Klaviyo E-Mail einzufügen. Bevor eine E-Mail versendet wird, stellt Klaviyo eine HTTP-Anfrage an die URL und holt die Daten ab. Der Inhalt des Webfeeds kann dann in deiner E-Mail verwendet werden.

Der Vorteil von Webfeeds ist, dass sie es dir ermöglichen, eine einzige Vorlage zu verwenden und Inhalte dynamisch zu beziehen. Du musst nur den Feed auf dem neuesten Stand halten und Klaviyo sorgt dafür, dass frische Inhalte aus deinem Feed in jeden Versand eingefügt werden.

In diesem Artikel geht es um das Hinzufügen und Verwenden eines benutzerdefinierten Webfeeds in Kampagne und Flow.

Bevor du beginnst

Der erste Schritt zum Hinzufügen von dynamischen externen Inhalten zu jeder E-Mail in Klaviyo ist die Erstellung deiner Webfeed-Quelle. Dein Futter muss: 

• unter einer zugänglichen URL im JSON- oder XML-Format gehostet werden
• 3,3 MB oder kleiner sein
• Keine Umleitungs-URL verwenden 

Klaviyo stellt eine HTTP-Anfrage an die von dir angegebene URL und holt deine Feed-Daten ab. Da Flow E-Mail kontinuierlich sendet, hält Klaviyo den Inhalt deines Feeds auf dem neuesten Stand, indem es regelmäßig deine Feed-URL abfragt, um den Inhalt nach einem der folgenden Zeitpläne zu aktualisieren: 

• 15-minütiges Aktualisieren
  Klaviyo wird versuchen, deinen Feed alle 15 Minuten zu aktualisieren. Um dies zu erreichen, muss dein Feed innerhalb von fünf Sekunden geladen werden und mit einer erfolgreichen Antwort zurückkehren.

• Nächtliches Aktualisieren
  Wenn dein Feed nach drei Stunden länger als fünf Sekunden braucht, um zurückzukehren, versuchen wir stattdessen, deinen Feed nachts zu aktualisieren. Für die laufende nächtliche Aktualisierung muss dein Feed in weniger als 30 Sekunden geladen werden. 

Wenn wir deinen Feed in drei aufeinanderfolgenden Nächten nicht innerhalb von 30 Sekunden laden können, kannst du ihn nicht in deiner E-Mail verwenden. Flow E-Mails, die auf diesen Feed angewiesen sind, werden nicht mehr versendet, und Kampagne und Flow E-Mail werden nicht mehr versendet, bis der Feed entfernt oder das Problem mit deinem Feed behoben wurde.

Wenn wir bei der Abfrage deines Feeds eine Fehlerantwort erhalten, können wir nicht auf den Inhalt deines Feeds zugreifen. Wir folgen demselben Muster wie oben und versuchen es bis zu drei Tage lang erneut. In der Zwischenzeit wird die E-Mail nicht gesendet.

Wenn wir Probleme haben, auf deinen Web-Feed zuzugreifen, erhältst du In-App- und E-Mail-Benachrichtigungen, die dich darüber informieren. Ein einfacher Schritt zur Fehlerbehebung ist es, die Futteranforderungen zu überprüfen und sicherzustellen, dass sie den oben genannten Parametern entsprechen. 

Wenn du Änderungen an einem Feed vornimmst - z.B. die Größe verringern, um die Uploadzeit zu verkürzen oder ein Problem zu beheben, das zu einer Fehlerantwort führt - und möchtest, dass Klaviyo einen neuen Aktualisierungsversuch unternimmt, navigiere zu dem Feed auf der Registerkarte Data Feeds und klicke auf Update Data Feed. Wir werden deinen Feed testen und erneut validieren. Wenn dein Feed gültig ist und eine zeitnahe Antwort liefert, werden wir wieder versuchen, deine Inhalte aktuell zu halten. Dies ist ein guter Schritt zur Fehlerbehebung, wenn du Probleme beim Zugriff auf deinen Webfeed hast, auch wenn du keine Änderungen vorgenommen hast.

Django filtern

Wir unterstützen die Verwendung von Django-Filtern für die Variablen, die du einfügst. Im Folgenden findest du einige häufig verwendete Filter. Weitere Informationen findest du in unserem Leitfaden zum Anpassen von Variablen mit Hilfe von Filtern und im Glossar zu Variablenfiltern.

Zusammenfassung des Beitrags auf X Wörter begrenzen

Wenn du eine kurze Zusammenfassung eines Blogbeitrags unter dem Beitragstitel einfügen möchtest (und dein Feed diesen Zusammenfassungstext bereitstellt), kannst du den Truncate-Filter verwenden.

Um die Zusammenfassung eines Artikels auf 250 Zeichen zu begrenzen, kannst du zum Beispiel verwenden:

{{ item.summary|truncatechars:250 }}

Hinzufügen eines benutzerdefinierten Webfeeds

Richte deinen Feed ein

1. Klicke auf deinen Unternehmensnamen in der unteren linken Ecke von Klaviyo.
2. Klicke auf Einstellungen.
3. Klicke auf Andere.
   
4. Klicke auf Webfeeds.
5. Klicke auf Web-Feed hinzufügen.
   
6. Fülle die Felder des Webfeeds wie folgt aus:
   • Feed-Name
     Du wirst diesen Bezeichner später in deiner Vorlage verwenden, um auf den Inhalt des Feeds zuzugreifen. Gib deinem Feed einen kurzen, beschreibenden Namen. Wir empfehlen, Feeds entweder in Kleinbuchstaben (z. B. "MyDataFeed") oder in Großbuchstaben zu benennen, wobei Leerzeichen durch Unterstriche ersetzt werden (z. B. "MY_DATA_FEED"). Leerzeichen sind in Feed-Namen nicht erlaubt. 
   • Feed URL
     Der Endpunkt, den Klaviyo verwendet, um die Feed-Inhalte zu holen (d.h. die URL des zuvor konfigurierten JSON- oder XML-Feeds). Wenn dein Feed private Informationen enthält, empfehlen wir dringend, eine HTTPS-URL zu verwenden und einen Nonce-Abfrageparameter einzubauen, um deinen Feed zu sichern.
   • Anforderungsmethode
     Gib die HTTP-Methode an, die für die Abfrage deines Feeds verwendet werden soll. Wenn du dir nicht sicher bist, was du wählen sollst, wähle GET. 
   • Inhaltstyp
     Das Format des Feeds (entweder JSON oder XML). Wir empfehlen, wenn möglich JSON zu verwenden. Bei XML-Feeds wird der Feed in JSON umgewandelt.
7. Wenn du alle Felder ausgefüllt hast, klicke auf Webfeed hinzufügen. Wir werden versuchen, die Feed-URL abzufragen und überprüfen, ob dein Feed richtig funktioniert. Wenn ein Fehler auftritt, wird eine Fehlermeldung angezeigt und du kannst den neuen Feed nicht speichern, bis das Problem behoben ist.
   • Willst du das ausprobieren, hast aber keine eigene URL für deinen Webfeed? Verwende unsere. Kopiere die folgende URL für das Klaviyo Help Center in das Feed-URL-Feld und probiere sie in deinem eigenen Klaviyo-Konto aus:

     https://help.klaviyo.com/api/v2/help_center/en-us/articles.json

8. Klaviyo validiert deinen Feed und zeigt mögliche Fehler an. Nach der Validierung siehst du deinen Feed auf Klaviyo und er kann in E-Mails verwendet werden.
   

Vorschau deines Feeds

Es ist nützlich, einen Web-Feed in der Vorschau zu sehen, bevor du ihn in eine E-Mail einfügst. Zur Vorschau eines Feeds:

1. Suche auf der Seite Webfeeds deinen Feed. 
2. Klicke auf die drei Punkte und wähle dann Bearbeiten. 
   
3. Klicke auf der Detailseite des Feeds auf Vorschau. 

Bei der Vorschau deines Feeds siehst du entweder den Inhalt des Feeds oder eine Fehlermeldung, wenn wir den Feed nicht laden können. 

Wenn es sich bei deinem Feed um ein JSON-Array handelt, wird jede Zeile automatisch geparst und einzeln angezeigt. Wenn es etwas anderes ist, höchstwahrscheinlich ein JSON-Wörterbuch, zeigen wir das gesamte Wörterbuch an.

Wenn du deinen Feed aktiv weiterentwickelst, kannst du über die Schaltfläche Aktualisieren die neueste Version deines Feeds abrufen. Die Vorschauseite für einen Feed zeigt den gesamten Feed an. Wenn dein Feed sehr groß ist, kann es einige Sekunden dauern, bis der Inhalt angezeigt wird. Wenn die Abfrage deines Feeds mehr als 30 Sekunden dauert, wirkt sich das auf die Leistung jeder E-Mail aus, die auf diesen Feed angewiesen ist.

Jetzt, wo du einen Web-Feed hinzugefügt und seinen Inhalt in der Vorschau angezeigt hast, kannst du ihn in einer E-Mail verwenden.

Verwende einen Web-Feed in einer E-Mail

Für Kampagne holt Klaviyo jeden Feed einmal pro Sendung ab und lädt die zurückgegebenen Inhalte. Selbst wenn du an Tausende von Empfängern sendest, wird Klaviyo nicht Tausende von Anfragen an deine Server stellen.

Feed-Inhalt in einer Vorlage auffüllen

In unserem Beispiel-Webfeed aus dem vorherigen Abschnitt haben wir ein Array von Artikeln, in dem jeder Eintrag einen Namen, eine URL, eine Artikel-ID und mehr enthält. Nachdem ein Feed zu einer E-Mail hinzugefügt wurde, ist er über die Feeds-Variable verfügbar:

{{ feeds }}

Für den JSON-Feed oben können wir jetzt zum Beispiel den Inhalt des Artikel-Feeds referenzieren oder ausgeben, indem wir diese Syntax in unsere Vorlage aufnehmen:

{{ feeds.Klaviyo_Help_Center }}

Lass uns ein Beispiel durchspielen, bei dem wir über alle Einträge im Array iterieren und dabei bestimmte Variablen anzeigen. Wir verwenden hier den Klaviyo Blog-Feed als Beispiel und iterieren über Bilder.

1. Ziehe einen neuen Textblock in deine E-Mail und platziere ihn an der Stelle, an der der Webfeed angezeigt werden soll.
2. Aktiviere die Wiederholungsfunktion Block/Content Repeat: Klicke auf die Registerkarte Display Options des Textblocks und dann auf Create Repeat Rules.
3. In das Feld Wiederholen für fügst du feeds.YOUR_FEED_NAME ein, gefolgt von dem Namen der Variablen, die das Array enthalten, das du durchlaufen willst.
   • Da wir in unserem Beispiel auch über den Wert "articles" iterieren, wiederholen wir für: feeds.Klaviyo_Help_Center.articles.
4. Deine Daten können in einer Reihe von Variablen verschachtelt sein. Dein Feed könnte zum Beispiel folgendermaßen strukturiert sein: 

   rss: {
            ..... 
            Kanal: { 
                    ..... 
                        item: { 
                                .....}}}

   In diesem Fall würdest du feeds.YOUR_FEED_NAME.rss.Kanal.item als Wiederholung für verwenden.

5. Wenn du möchtest, dass dieser Block nur über eine bestimmte Anzahl von Einträgen iteriert, verwende das "slice" filtern. Um diesen Filter zu verwenden, passe den Wert Repeat For an, indem du den Filter am Ende hinzufügst:  feeds.Klaviyo_Help_Center.articles|slice:':3'
   In diesem Beispiel bewirkt |slice:':3', dass nur die ersten drei Einträge angezeigt werden. 
6. Für das Feld Artikel-Alias fügen Sie ein: Artikel
7. Wenn du die Funktion " Block-/Inhaltswiederholung" konfiguriert hast, kannst du Variablen über den Artikel "" alias einfügen.
8. Um Variablen zu identifizieren und hinzuzufügen, öffne die Vorschau deines Webfeeds und beziehe dich auf die Art und Weise, wie deine Daten strukturiert sind. Alle Daten, die in dem Array im Feld Wiederholung für verschachtelt sind, können als Variable verwendet werden.
   In diesem Beispiel sind alle Daten, die im Artikel-Array angezeigt werden, für die Verwendung in einer E-Mail verfügbar:
   
9. Für Daten der ersten Ebene fügst du einfach item vor dem Variablennamen in deinen Daten ein. Verwende zum Beispiel {{ item.title }}, um den Titel eines Artikels anzuzeigen, oder {{ item.url }}, um die URL eines Artikels anzuzeigen. 
10. Um auf Daten zuzugreifen, die in den Variablen der ersten Ebene verschachtelt sind, verwendest du die Punktschreibweise (z. B. {{ item.images.thumbnail_url }}). Mehr über Punktnotation und Vorlagen-Tag erfährst du in unserem Leitfaden zu Vorlagen-Tag und Variablensyntax. 
11. Wenn du deine Vorlage in der Vorschau ansiehst, wirst du feststellen, dass die Funktion Wiederholen Block/Inhaltswiederholung es diesem einfachen Textblock ermöglicht, automatisch alle Einträge in deinem Feed zu wiederholen. Nur die Variablen, die du im Textblock angibst, werden für jeden Eintrag angezeigt.
12. Wenn Sie ein Bild einfügen, beachten Sie bitte, dass Sie das Quellcodefeld des Textblocks bearbeiten und das Bild in einem <img src> Tag einschließen müssen.
    

Du hast einen benutzerdefinierten Web-Feed zu deiner E-Mail hinzugefügt und kannst nun dynamisch einen Daten-Feed von deiner externen URL auffüllen. 

Teste oder validiere deinen Feed

Wenn du eine E-Mail oder eine In-App-Benachrichtigung erhältst, dass wir Probleme mit dem Zugriff auf deinen Web-Feed haben:

1. Navigiere zu deinem Feed und klicke auf die Schaltfläche Update feed.
2. Wenn die Validierung abgeschlossen ist, kannst du zwei Arten von Fehlermeldungen sehen:
   • Ungültige Antwort
     Wenn wir beim Versuch, den Inhalt deines Feeds abzufragen, eine Fehlerantwort erhalten, teilen wir dir den Statuscode des Fehlers mit. Du musst das Problem beheben, das diese Fehlermeldung verursacht, bevor der Feed erfolgreich in einer E-Mail verwendet werden kann.
   • Leistungsproblem
     Wenn wir nicht innerhalb von 30 Sekunden eine Antwort von deinem Feed erhalten, führt dies zu Verzögerungen beim Versand. Du konntest deinen Feed zwar in der Vergangenheit speichern, aber um das Risiko von Sendeverzögerungen zu verringern, musst du das Leistungsproblem mit deinem Feed beheben, bevor du ihn erneut validieren und erfolgreich speichern kannst.

In beiden Fällen führt die Verwendung eines problematischen Feeds innerhalb einer Sendung zu Verzögerungen beim Versand oder deine E-Mail wird ganz abgebrochen. Für Flow ist es auch wahrscheinlich, dass E-Mails nicht gesendet werden.

Wir empfehlen, einen problematischen Feed aus allen E-Mails zu entfernen, während du dich um die offenen Probleme kümmerst, um Sendeunterbrechungen zu vermeiden.

Zusätzliche Ressourcen

• Fehlerbehebung für deinen Instagram-Webfeed in E-Mail
• Wie man Produkt-Feeds und Empfehlungen nutzt