Ein Begriff, den man oft im Alltag hört. Datenfeed. Aber was ist das? Folgend wird dieser Begriff detailliert erklärt und alle Fragen zum Thema beantwortet.

Ein Datenfeed ist eine Datei, die Informationen zu einem verkaufenden Produkt beinhaltet und durch dieser ist es möglich, mehrere Artikel automatisch einem Katalog hinzuzufügen und alte Artikel mit neuen zu ersetzen. Datenfeeds sind eine von vielen Möglichkeiten, die Facebook anbietet, um Artikel einem Katalog hinzuzufügen.

Die Erstellung von Datenfeeds ist über Facebook mit diesen Dateiformaten möglich:

• CSV (.csv)  -> enthält kommagetrennte Werte
• TSV (.tsv)   -> Wie CSV, werden aber mit Tabulatoren getrennt  
• XML (.xml) -> textbasiertes Dokument, strukturierte Erfassung von Daten.

Von den dreien ist CSV ist das am meisten benutzte Dateiformat, weil sie sich ohne Probleme mit Excel bearbeiten lässt.

Anforderungen an einen CSV-Datenfeed
In einer CSV-Datei müssen alle Werte mit einem Komma getrennt werden. Die Kopfzeile ist die erste Zeile der Datei, diese enthält die korrekte Beschriftung der Spezifikationen. Die Zeilen darunter enthalten Produktinformationen, die die Kopfzeile vorgibt. Werte werden als String (Zeichenkette), Integer (Zahl), Objekt, Float (durch Punkte getrennte Zahlen) oder Date (Datum, durch Bindestriche getrennt) übergeben, aber Werte, die schon Kommata enthalten, müssen in doppelte Anführungszeichen ( „“ ) gesetzt werden.

Facebook benötigt, bevor Kataloge veröffentlicht werden, die Information, in welcher die Kataloge eingeordnet werden. Jeder Katalog im Bereich eCommerce, der für Werbeanzeigen, Instagram Shopping und Dynamic Ads benutzt wird, braucht folgende Spalten:

• id (string) -> bis 100 Zeichen, eindeutige ID eines Artikels
• title (string) -> bis 150 Zeichen, spezifischer Artikelname
• description (string) -> bis 5000 Zeichen, Beschreibung des Artikels
• availability (string) -> Verfügbarkeit eines Artikels, folgende Werte müssen vorhanden sein: in order, available for order, preordern out of stock, discontinued
• condition (string) -> Zustand eines Artikels, folgende Werte müssen   vorhanden sein: new, refurbished, used, used_fair used_good, used_like_new

• price (string) -> Preis des Artikels, gefolgt vom ISO- Währungscode, mit Leerzeichen zwischen Preis und Währung
• link (string) -> URL-Link zur Produktseite
• image_link (string) -> URL-Link zum in den Ads verwendeten Artikelbild 

• brand (string) -> bis 100 Zeichen, Markenname des Produkts
• inventory (integer) -> Bestandteil des Artikels

 

Für Reisen werden folgende Spalten benutzt:

• destination_id (string) -> bis 100 Zeichen, Kennungs-ID des Reiseziels
• name (string) -> Name des Reiseziels
• type (string) -> bis 20 Zeichen, Attribute, die Reiseziel umschreiben (Beispiele: Strand, schnorcheln, Shopping usw.)
• addr1 (string) -> Adresse des Reiseziels: Straßenname, Hausnummer
• city (string) -> Die Stadt, in der das Reiseziel sich befindet.
• postal_code(string) -> PLZ des Reiseziels
• region (string) -> Region des Reiseziels (Bsp. Gemeinde, Bundesland, Kanton)
• country (string) -> Staat des Reiseziels
• image (object) -> Maximal 20 Stück und total 4MB Facebook empfiehlt für Dynamic Ads eine Auflösung von 1024px x 1024px.Für Werbeanzeigen 1200px x 630px
• url (string) -> Link zur Buchungsseite des Reiseziels

 

Für Hotels werden folgende Spalten benutzt:

• hotel_id (string) -> bis 100 Zeichen, ID des Hotels
• room_id (string) -> bis 100 Zeichen, ID für Zimmer des Hotels
• name (string) -> bis 150 Zeichen, Name des Hotels
• brand (string) -> Marke/ Name der Hotelkette
• description (string) -> bis 5000 Zeichen, Beschreibung des Hotels. Es  
  handelt sich um einen informativen, sachlichen und beschreibenden Text
• addr1 (string) -> Adresse des Hotels – Strassenname und Hausnummer
• city (string) -> Die Stadt, in der sich das Hotel befindet
• postal_code (string) -> PLZ der Stadt, in der sich das Hotel befindet
• region (string) -> Region, in welcher sich das Hotel befindet (Bsp. Gemeinde, Bundesland, Kanton)
• country (string) -> Staat, in welchem sich das Hotel befindet
• latitude (float) -> Geografischer Breitengrad, auf dem sich das Hotel befindet
• longitude (float) -> Geografischer Längengrad, auf dem sich das Hotel befindet
• neighborhood (string) -> bis zu 20, Auflistung der Nachbarschaftsbezirke
• base_price (string) -> Preis der günstigsten Zimmervariante pro Nacht    
  gefolgt vom ISO-Währungscode, mit einem Leerzeichen zwischen Preis und Währung
• image (object) -> 20 Stück und total 4MB Facebook empfiehlt für Dynamic Ads eine  Auflösung von 1024px x 1024px. FürWerbeanzeigen 1200px x 630px.
• url (string) -> Link zur Buchungsseite des Hotels
  
  

Für Hotels werden folgende Spalten benutzt:

• origin_airport (string) -> IATA Code des Abflugflughafens
• destination_airport (string) -> IATA Code des Ankunftsflughafens
• image (object) -> bis zu 20 Stück und total 4MB
  Facebook empfiehlt für Dynamic Ads eine Auflösung von 1024px x 1024px. Für Werbeanzeigen 1200px x 630px.
• description (string) -> bis zu 5000 Zeichen
  Beschreibung der Route. Es handelt sich um einen informativen, sachlichen und beschreibenden Text
• url (string) -> Link zur Produktseite des Flugs.

 

Dynamic Ads für Mietobjekte und Immobilienangebote

• home_listing_id (string) -> bis zu 100 Zeichen, ID der Immobilie.
• name (string) -> bis zu 150 Zeichen, Titel der Immobilie.
• availability (string) -> Aktuelle Verfügbarkeit der Immobilie. Es muss  zwingend einer folgender Werte übermittelt werden: for_sale, for_rent, sale_pending, recently_sold, off_market oder available_soon.
• address (string) -> Adresse der Immobilie – Strassenname und Hausnummer.
• city (string) -> Stadt, in der sich die Immobilie befindet.
• postal_code (string) -> PLZ der Stadt, in der sich die Immobiliebefindet
• region (string) -> Region, in welcher sich die Immobilie befindet.      
  (Bsp. Gemeinde, Bundesland, Kanton)
• country (string) -> Staat, in welchem sich die Immobilie befindet.
• latitude (float) -> Geografischer Breitengrad, auf dem sich die Immobilie befindet
• longitude (float) -> Geografischer Längengrad, auf dem sich die Immobilie befindet
• neighborhood (string) -> bis zu 20 Zeichen – Auflistung der Nachbarschaftsbezirke
• price (string) -> Kauf- oder Mietpreis der Immobilie gefolgt von ISO-Währungscode, mit Leerzeichen zwischen Preis und Währung
• image (object) -> bis zu 20 Stück und total 4MB. Facebook empfiehlt für Dynamic Ads eine Auflösung von1024px x 1024px. Für Werbeanzeigen 1200px x 630px
• url (string) ->Link zur Produktseite der Immobilie

Dynamic Ads für verschiedene Segmente des Automobilmarkts

• vehicle_id (string) -> bis zu 100 Zeichen, ID des Fahrzeugs.
• title (string) -> bis zu 150 Zeichen, Artikelname.
  Schlüsselwörter und Varianten wie z.B.Markennamen, Jahrgang, Attribute etc. dürfen enthalten sein, solange diese den Kataloganforderungen entsprechen
• description (string) -> bis zu 5000 Zeichen. Kurze Beschreibung des  
  Es handelt sich um einen informativen, sachlichen und beschreibenden Text
• url (string) -> Link zur Produktseite des Fahrzeugs
• make (string) -> Model des Fahrzeugs
• year (string) -> Jahrgang des Fahrzeugs
• value (integer) -> Kilometerstand bei gebrauchten Fahrzeugen. Bei Neuwagen ist der Wert immer Null
• unit (string) -> Masseinheit: Entweder in Kilometer ‘KM’ oder Meilen ‘MI’
• transmission (string) -> Getriebeart des Fahrzeugs. Entweder ‘Automatic’ oder ‘Manual’
• body_style (string) -> Karosseriestil des Fahrzeugs. Zur Auswahl  
  stehen convertible, coupe, hatchback, minivan, truck, suv, van, wagon, crossover, small_car oder other
• vin (string) -> Fahrgestellnummer des Fahrzeugs.
• exterior_color (string) -> Aussenfarbe des Fahrzeugs
• state_of_vehicle (string) -> Zustand des Fahrzeugs. Entweder new, used, oder CPO (certified pre-owned)
• addr1 (string) -> Die Adresse des Fahrzeughändlers in folgender
  Formatierung: {addr 1: ‘STREET ADDRESS’, city:‘CITY’, region: ‘STATE, COUNTY, REGION OR PROVINCE’, country: ‘COUNTRY’}
• latitude (float) -> Geografischer Breitengrad der Händleradresse
• longitude (float) -> Geografischer Längengrad der Händleradresse.
• neighborhood (string) -> bis zu 20, Auflistung der Nachbarschaftsbezirke
• price (string) -> Kauf- oder Mietpreis der Immobilie gefolgt vom
  ISO-Währungscode, mit Leerzeichen zwischen Preis und Währung
• image (object) -> bis zu 20 Stück, total 4MB Facebook empfiehlt für Dynamic Ads eine Auflösung von 1024px x 1024px. Für Werbeanzeigen 1200px x 630px.
• url (string) -> Link zur Produktseite der Immobilie

Optionale Spezifikationen für Dynamic Ads

• additional_image_link (string) -> bis zu 2000 Zeichen, bis zu 10 zusätzlichen Bild-URLs pro Artikel (Dynamic Ads 20 Bilder).
  URLs können mit “,”  getrennt werden.
• age_group (string) -> Folgende Werte dürfen übermittelt werden: newborn, infant, toddler, kids oder adult.
• color (string) -> bis zu 100 Zeichen – Farbe des Artikels als einzelnes Wort. Keine alphanumerische Beschreibung
• gender (string) ->Folgende Werte dürfen übermittelt werden: Female, Male oder Unisex
• item_group_id (string) -> Varianten eines Artikels. Bei dynamischen Anzeigen wählt Facebook nur einen Artikel der Gruppe aus, basierend auf dem Signal des Pixel- oder SDK-Events
• google_product_category -> Google-Produktkategorie des Artikels. Entweder (string) der Taxonomiepfad der Kategorie oder die aufgeführte ID
• material (string) -> bis zu 200 Zeichen, Material des Artikels.
  Folgende Werte dürfen übermittelt werden: cotton, leather oder denim
• pattern (string) -> bis zu 100 Zeichen – Beschreibung der Musterung eines Artikels
• product_type (string) -> bis zu 750 Zeichen Spiegelt i.d.R die Produktkategorien des internen Systems
• offer_price (string) -> Reduzierter Preis des Artikel. Preis gefolgt vom
  ISO-Währungscode, mit einem Leerzeichen zwischen Kosten und Währung
• offer_price_effective_date -> Sale-Zeitspanne eines Artikels. Wird in
  (timestamp) folgendem Format geschrieben: YYYY-MM DDT23:59+00:00/YYYY-MM-DDT23:59+00:00 (DatumTStartzeit+UTCZeitzone/DatumTEndzeit+UTCZeitzone)
• shipping (string)  Versanddetails für den Artikel, geschrieben als:  
  Land:Region:Dienstleistung:PreisISO-Währungscode. Um das kostenlose Versand-Overlay zu verwenden, wird als Preis 0,0 eingegeben.
• size (string) ->Artikelgrösse
• rich_text_description -> bis zu 500 Zeichen – Rich-Text (HTML)-
  (string )Beschreibung für den Artikel. Das Feld description
  bleibt als “Fallback” weiterhin erforderlich
• inventory (integer) -> Bestandszahl des Artikels. Muss positiv sein, damit ein Artikel verkauft werden kann
• gtin (string) -> Global Trade Item Number (GTINs) eines Bindestriche und Leerzeichen müssen ausgeschlossen werden. Unterstützte Werte sind
  UPC (Nordamerika, 12 Ziffern), EAN (Europa, 13 Ziffern), JAN (Japan, 8 oder 13 Ziffern) und ISBN (Bücher, 13 Ziffern)
• launch_date (date) -> Ermöglicht Vorbestellung eines Artikels. Das  
  Datum muss dem Format ISO-8601 (JJJJ-MM-TT) entsprechen
• expiration_date (date) -> Verfallsdatum eines Artikels. Das Datum muss
  dem Format ISO-8601 (JJJJ-MM-TT) entsprechen Abgelaufene Artikel werden auf Facebook nicht mehr angezeigt
• additional_variant_attribute -> Zusätzliche Attribute, die keine Kernattribute
  (string) sind (Größe, Farbe, Geschlecht, Muster etc.)
• custom_label_0 (string) -> bis zu 100 Zeichen – Zusätzliche, individuelle
  Informationen. Wenn weitere benutzerdefinierte Spezifikationen angelegt werden sollen, verhält sich die Endzahl fortlaufend: Custom_label_1

Überprüfung des Datenfeeds
Wenn der Datenfeed erstellt worden ist, sollte man vor der Veröffentlichung folgendes überprüfen:

Sichtbarkeit

• Felder id, title, description, price, inventory, link, image_link sollten zu erkennen
• Felder gtin oder mpn und brand sollten zu erkennen sein
• Felder rich_text_description (vorzugsweise) oder description sollten zu erkennen sein, gut formatiert (keine zusätzlichen Abstände, korrekte Interpunktion) und informativ sein (Informationen über Artikelgrösse, Material, Herkunft usw.)
• Sicherstellen, dass der Wert eines varient field (z.B. Grösse oder Farbe) für jede Produktvariante mit einer gemeinsamen item_group_id sichtbar ist. Auch für Produkte die nicht vorrätig sind
• Sicherstellen, dass die Felder offer_price und offer_price_effective_date zu erkennen sind, wenn das Product als „Daily Deal“ anbietbar sein soll

 

Format

• Sicherstellen, dass die Beschreibung keine HTML-Tags oder Zeichenelemente enthält
• Sicherstellen, dass der Preis im richtigen Format und in der richtigen Währung angegeben ist
• Sicherstellen, dass der offer_price für Artikel im Sale mitgeliefert wird
• Sicherstellen, dass die google_product_category (mind.) 2 Ebenen tief ist
• Produktvarianten müssen dieselbe item_group_id haben
• Sicherstellen, dass die Verfügbarkeits- und Bestandsfelder strategisch korrekt ausgefüllt werden
• additional_image_link als Spezifikation nutzen, um (bis zu 10) weitere Produktbilder hinzuzufügen
• Gewährleisten, dass die Produktbilder, Produkttitel und
• Produktbeschreibungen den Kataloganforderungen entsprechen

 

Reaktionsfähigkeit

• Überprüfen, ob die Link-URL mit einem HTTP-Status “200 OK” antwortet.
• Bei jedem (manuellen) Upload des Feeds vorab das Diagnosetool nutzen und alle Fehler beheben (Produkte mit Fehlermeldung sind ungültig und werden abgelehnt).
  Alle Warnungen überprüfen, da einige der Warnungen sich auf die Produkte auswirken können und verhindern, dass Produkte zum Kauf verfügbar sind.
• Gewährleisten, dass jedes Produkt mit den Facebook-Richtlinien übereinstimmt. Produkte, die gegen die Richtlinien verstoßen, werden als abgelehnt markiert und können nicht genutzt werden.

Fehlerbehebung
Nicht viele Feeds sind von Beginn an ohne Fehler. Je größer er ist, desto wahrscheinlicher können Fehler gefunden werden. Um solche zu beheben, sollte man das Datenfeed Debugger Tool benutzen. Sonst kann man unter dem Punkt „Fehlerdiagnose“ Hilfestellung um diese zu beheben.

Wenn bei der Diagnose rot markierte Fehler zu finden sind, sollte man diese unbedingt beheben, weil diese gravierenden Auswirkungen auf die Werbung haben. Gelb markierte Fehler müssen nicht zwingend behoben werden.

Feed-Regeln helfen dabei, kleine Änderungen an den Datei-Informationen vorzunehmen. Man kann beliebig viele Regeln hinzufügen und diese treten beim nächsten Upload sofort in Kraft. Regeln können wie folgt aussehen:

Gross- Kleinschreibung ändern
Zum Ändern des Spaltentexts in “nur Grossbuchstaben”, “nur Kleinbuchstaben”, “grosse Anfangsbuchstaben” oder “Grossbuchstaben am Satzanfang”.

Spalte einen Wert zuordnen
Mit dieser Regel können Spaltenprobleme behoben werden, indem Facebook die betroffene Spalte einer erkannten Spalte zuordnet. Dies ist meist dann der Fall, wenn Spezifikationen falsch benannt sind.

“Ersetzen”
Sucht und ersetzt bestimmte Informationen. So können mehrere Werte auf einmal ersetzen werden, wenn sie sich geändert haben oder falsch sind. Werden mehrere Regeln definiert, wendet Facebook sie der Reihe nach an.

Standardwerte festlegen
Hiermit kann für leere Felder ein Standardwert definieren werden. Das kann hilfreich sein, um leere Felder auszufüllen oder Spalten hinzuzufügen, die  vergessen wurden.

Regex-Ersetzung
Mit dieser Regel kann eine Zeichenfolge aus Buchstaben oder Zahlen anhand von regulären Ausdrücken gesucht und ersetzt werden. Werden mehrere Regeln definiert, wendet Facebook sie der Reihe nach an

 

Datenfeed hochladen und für Dynamic Ads aktivieren
Nachdem alles übeprüft und verbessert wurde, kann man den Datenfeeed über den Catalog Manager hochgeladen werden. Es muss nur der Eigentümer ausgewählt und ein Katalogname vergeben werden, dann kann man unter „Produktinfos hochladen“ alles hinzufügen.

Daraufhin wird dem Feed ein eindeutigen Namen gegeben, die Standardwährung festgelet und die Upload Methode definiert.

Als letztes wird unter „Einstellungen – Event Quellen“ das Facebook Pixel aktiviert werden, um den Feed nutzen zu können.

Foto von Markus Spiske von Pexels