Hier finden Sie die technische Dokumentation unserer Pinterest App – automatischer Produktfeed für Pinterest.

Sie suche unser FAQ, um Antworten auf häufig gestellte Fragen zu erhalten?

Einrichtung und Konfiguration der App

Vielen Dank für die Installation unserer App zur Generierung eines automatisierten Pinterest Feeds und Ihr Vertrauen!

In den folgenden Schritten werden wir im Detail die Konfiguration und die Bestandteile des Feeds erläutern und wichtige Informationen bereitstellen.

Das nachfolgende Video führt Sie im Detail durch die Konfiguration der App und bietet viele visuelle Einblicke und Details:

1. Schritt: Installation & Aktivierung der App

Zunächst muss die App installiert und anschließend aktiviert werden.

Nachdem die App aktiviert ist, kann mit der Konfiguration gestartet werden.

2. Schritt: Erforderliche Konfiguration

Konfiguration öffnen

Um die Konfiguration der App durchzuführen, müssen Sie unter dem im Schritt 1 genannten Pfad nun auf Höhe der App „Konfigurieren“ anklicken. Somit gelangen Sie zur Konfiguration.

Hier finden Sie einen Screenshot mit dem genauen Punkt, an dem Sie die Konfiguration der App öffnen können:

Erforderliche Konfiguration durchführen

Hier finden Sie zunächst einen Screenshot mit allen relevanten Konfigurationsoptionen, die wir nachfolgend im Detail durchgehen.

Verkaufskanal

Dies ist ein von Shopware im Standard in jeder App vorgegebenes Feld, das für die Konfiguration nicht relevant ist.

Wird ein Verkaufskanal hier ausgewählt, kann die erforderliche Konfiguration nicht durchgeführt werden, da die Felder gesperrt werden. Dieses Feld also bitte nicht nutzen bzw. auf „Alle Verkaufskanäle“ stehen lassen.

URL des Produktfeeds

Hier finden Sie die URL, die später im Pinterest Business Hub hinterlegt werden kann. Kopieren Sie diesen einfach aus dem Feld.

Ist der Produktfeed noch nicht erstmalig generiert worden, so steht im später zu kopierenden URL Feld folgendes: „https://docs.feedgenie.de/help/not-generated“ HIER finden Sie ergänzend noch einen kleinen Beitrag bei Anzeige dieser URL.

Der Link des Produktfeeds erneuert sich erst, nachdem Sie folgendes durchgeführt haben: Aktualisieren des Feeds

Produktgruppe

Hier ist eine vorab konfigurierte Produktgruppe auszuwählen, die als Produktdatenquelle für den Feed dient.

Nur Produkte, die der hier definierten Produktgruppe zugewiesen sind, werden auch entsprechend übertragen. Alle anderen Produkte werden nicht in dem Feed übergeben.

Verkaufskanal erforderliche Konfiguration

Hier ist ergänzend zu der dynamischen Produktgruppe der Verkaufskanal auszuwählen, um den Produktexport einem Verkaufskanal zuzuweisen.

Domain

Hier ist die Domain zu definieren, unter der der Produktfeed später in dem voran genannten Feld URL des Produktfeeds erreichbar sein soll.

Währung

Hier ist die Währung zu definieren, in der die Produkte im Feed gemeinsam mit dem Preis ausgegeben werden sollen.

Abschluss der erforderlichen Konfiguration

Nun wurden die erforderlichen Konfigurationsschritte durchgeführt, sodass der Feed erstmalig generiert und anschließend genutzt werden kann. Bitte speichern Sie Ihre Änderungen. Es gibt jedoch noch viele weitere Konfigurationsmöglichkeiten sowie Hinweise zur Datenpflege.

Wenn Sie die zusätzliche Konfiguration, die Experten Konfiguration sowie die globale Spalten Konfiguration nicht durchführen wollen, können Sie direkt zu Schritt 6 gehen, um die erstmalige Generierung des Feeds anzustoßen.

Die gespeicherte Konfiguration der App wird nicht greifen, bis erstmalig die Aktualisierung des Feeds angestoßen wurde. In Schritt 6 finden Sie eine Anleitung zum auslösen der Aktualisierung des Feeds.

Um die Bestandteile der Produktdaten des Feeds einzusehen, klicken Sie HIER.

3. Schritt: Zusätzliche Konfiguration

Varianten einbeziehen

Mit diesem Toggle können Sie definieren, ob Varianten einbezogen werden sollen.

Achtung! Ist Varianten einbeziehen aktiviert, werden Parents von Variationssets nicht mehr übertragen sondern lediglich die Childs sowie Einzelprodukte.

4. Schritt: Experten Konfiguration

Diese Konfiguration ist ausschließlich für Experten gedacht! Zur korrekten Funktionalität der Generierung durch Cronjobs muss der Shopware Shop entsprechend konfiguriert werden. Keine Sorge, der Feed wird, sofern die Experten Konfiguration nicht durchgeführt wurde, Live erstellt, sobald Pinterest Daten abfragt.

Durch cronjob generiert

Mit diesem Toggle können Sie definieren, ob der Produktfeed durch einen Cronjob in Shopware generiert werden soll.

Folgenden Effekt hat dieses Feld je nach Aktivierung oder Deaktivierung:

Intervall in Sekunden

Mit diesem Zahlenfeld können Sie definieren, in welchem Intervall der Produktfeed bei Aktivierung des voran genannten Feldes „Durch cronjob generiert“ generiert werden soll. Der Intervall ist in Sekunden anzugeben.

5. Schritt: Globale Spalten Konfiguration

In der globalen Spalten Konfiguration können die optionalen Spalten aktiviert und deaktiviert werden, sodass diese im Produktfeed nicht ausgegeben werden. Im Standard sind alle Spalten aktiviert.

Folgende optionale Spalten können aktiviert und deaktiviert werden:

• Zusätzlicher Bildlink (additional_image_link)
• Produkttyp (product_type)
• Angebotspreis (sale_price)
• Marke (brand)
• GTIN (gtin)
• Elementgruppen ID (item_group_id)
• MPN (mpn)
• Altersgruppe (age_group)
• Farbe (color)
• Geschlecht (gender)
• Material (material)
• Muster (pattern)
• Größe (size)
• Variantenname der Variationsausprägungen (variant_names)
• Variantenwerte der Variationsausprägungen (variant_values)
• Kostenloser Versand (free_shipping_label)
• Zustand (condition)
• Google Produktkategorie (google_product_category)

Folgenden Effekt haben dieses Felder je nach Aktivierung oder Deaktivierung:

Auch nach dieser Konfiguration sollte zur Sicherheit immer die Aktualisierung des Feeds wie in Schritt 6 beschrieben durchgeführt werden.

6. Schritt: Aktualisieren des Feeds und erstmalige Anlage

Die Aktualisierung ist notwendig, um die gespeicherte Konfiguration auch auf den Feed anzuwenden, andernfalls haben die voran genannten Einstellungen keinen Effekt.

Die Aktualisierung des Feeds hat nichts mit den sich generell aktualisierenden Feed Inhalten zu tun, die Funktion ist hiervon losgelöst, sondern bezieht sich auf die in Schritt 2 bis 6 genannten Konfigurationen.

Zur Aktualisierung des Feeds, sodass dieser mit der neu gespeicherten Konfiguration übergeben wird, bestehen 2 Möglichkeiten, die nachfolgend beschrieben sind:

Option 1: Aktualisieren in der Produktübersicht

Diese Möglichkeit besteht in der gesamten Produktübersicht, hier können Sie eine Checkbox eines beliebigen Produktes anhaken. Nach anhaken der Checkbox eines Produktes finden Sie dann ebenfalls 3 Punkte oben rechts, mit Klick auf diesen können Sie dann mit einem Klick die Konfiguration aktualisieren.

Hier finden Sie einen Screenshot, der die Option der Aktualisierung in der Produktübersicht darstellt:

Nach ausführen der Aktualisierung wird der Feed zum ersten mal generiert bzw. bei Update der Konfiguration nach Ersteinrichtung generell aktualisiert, sodass die neue Konfiguration, die in der App defininert wurde, greift.

Option 2: Aktualisieren in der Produktdetailübersicht:

Bei dieser Möglichkeit reicht der Klick auf ein beliebiges Produkt in der Produktübersicht. 

Auf der Produktdetailübersicht des geklickten Produktes finden Sie oben rechts 3 Punkte, mit Klick auf diese und anschließendem Klick auf „Pinterest Feed Konfiguration aktualisieren“ können Sie die Konfiguration aktualisieren.

Hier finden Sie einen Screenshot, der die Option der Aktualisierung in der Produktdetailübersicht darstellt:

Nach ausführen der Aktualisierung wird der Feed zum ersten mal generiert bzw. bei Update der Konfiguration nach Ersteinrichtung generell aktualisiert, sodass die neue Konfiguration der App greift. Die URL wurde dann nach erstmaliger Generierung auch entsprechend HIER hinterlegt.

Bestandteile des Feeds

In diesem Abschnitt finden Sie alle Datenfelder die wir aus Shopware heraus übergeben können. Die Pflichtwerte sind von Pinterest vorgegeben und werden im Standard und auf Basis der Pflege der Produkte in Kombination mit der vorgenommenen Konfiguration übergeben.

Die Optionalen Werte sind durch Zusatzfelder und weitere Pflegeoptionen im Standard gegeben.

Definition von Zusatzfeldern

Da nicht alle Informationen für TikTok im Standard von Shopware gesetzt werden können, haben wir für Pinterest spezifische Zusatzfelder angelegt.

Die Zusatzfelder können dann pro Produkt individuell gepflegt werden, sodass Informationen speziell für Pinterest bereitgestellt werden können, um Ihren Social Commerce Handel zu optimieren.

Folgende Zusatzfelder setzen und nutzen wir für die App:

Hier ein Screenshot mit den gesetzten Zusatzfeldern zur Übersicht in Shopware 6 nach Installation und Aktivierung der App:

Sind die Felder gepflegt, werden die Informationen entsprechend pro Produkt über den Feed an Pinterest übergeben. Sind diese leer, greift entweder der Wert aus der globalen Konfiguration der App oder das Feld bleibt im Feed leer.

Pflichtwerte

Pinterest Feed Wert	Datenquelle in Shopware	Wertvorgabe	Konfigurationsmöglichkeit
availability	Lagerbestand	Lagerbestand >0 = in stock; Lagerbestand <=0 = out of stock	/
description	Beschreibung (HTML wird ausgeklammert)	Frei definierbar	/
id	Produktnummer	Frei definierbar	/
image_link	Bildlink des ersten Bildes	Vorgegeben vom System	/
link	Produktlink aus Shopware	Vorgegeben vom System	/
price	Preis (Brutto)	Frei definierbar	/
title	Name	Frei definierbar	/

Optionale Werte

Pinterest Feed Wert	Datenquelle in Shopware	Wertvorgabe	Konfigurationsmöglichkeit
additional_image_link	Weitere Bildlinks (bis zu 10 weitere)	Frei definierbar	/
product_type	Pinterest Produktfeed -> Zusatzfelder -> Produkttyp	Frei definierbar	/
sale_price	Preis, wenn das Feld „Streichpreis“ befüllt ist. Der gesetzte Streichpreis wir dann zum Pinterest Feed Wert „price“	Frei definierbar	/
brand	Hersteller	Frei definierbar	/
gtin	GTIN/EAN	Frei definierbar	/
item_group_id	Parent ID aus Shopware bei Varianten	Parent ID	/
mpn	Hersteller-Produktnummer	Frei definierbar	/
age_group	Pinterest Produktfeed Zusatzfelder -> Altersgruppe	newborn; infant; toddler; kids; adult
color	Pinterest Produktfeed Zusatzfelder -> Farbe	Frei definierbar	/
gender	Pinterest Produktfeed Zusatzfelder -> Geschlecht	female; male; unisex	/
material	Pinterest Produktfeed Zusatzfelder -> Material	Frei definierbar	/
pattern	Pinterest Produktfeed Zusatzfelder -> Muster	Frei definierbar	/
size	Pinterest Produktfeed Zusatzfelder -> Größe	Frei definierbar	/
variant_names	Varianten Identifikator (z.B. Größe) pro Variante	Variationsdefinition	/
variant_values	Varianten Ausprägungen (z.B. L, XL, XXL) pro Variante	Variationsdefinition	/
free_shipping_label	Versandkostenfrei inaktiv/aktiv	Versandkostenfrei Toggle grau/blau	/
condition	Zusatzfeld Zustand	new; refurbished; used	/
google_product_category	Pinterest Produktfeed Zusatzfelder -> Google Produktkategorie	Frei definierbar, bitte prüfen Sie die Vorgaben von Google Shopping!	Siehe Google Infos HIER

Konfiguration bei Pinterest

Um den in den voran genannten Schritten definierten und generierten Produktfeed für Pinterest bereitzustellen, loggen Sie sich bitte zunächst in das Business Hub ein bzw. erstellen Sie sich ein entsprechendes Konto.

ACHTUNG! Um einen Produktfeed bei Pinterest überhaupt hinterlegen zu dürfen, müssen viele Bedingungen seitens Pinterest erfüllt sein, diese finden Sie HIER.

Hier finden Sie ein umfangreiches Video, das die nachfolgende Schritte im Detail beleuchtet und erklärt:

Schritt 1: Datenquelle definieren

Zunächst muss der Katalog angelegt werden, sodass der Feed Link aus dem Feld URL des Produktfeeds der installierten App entsprechend kopiert und bei TikTok hinterlegt werden kann.

Schritt 2: Datenfeed mit URL hinterlegen

Nun sind Sie in der Maske bei Pinterest, um eine neue Datenquelle für Ihre Produktdaten hinzuzufügen.

Hier finden Sie die Ansicht bei Pinterest, die Sie erhalten, wenn Sie einen Feed hinterlegen wollen:

1. Datenfeed erstellen – los geht’s!

Zunächst müssen alle generellen Werte hinterlegt werden.

2. Datenfeed URL hinterlegen

Nun ist die URL einzufügen, die Sie aus der installierten Pinterest App kopieren können.

3. Datenfeed Aktualisierungszeitpunkt festlegen

Nun muss noch der Aktualisierungszeitpunkt festgelegt werden, der Abgleich erfolgt seitens Pinterest dann alle 24 Stunden.

Nun ist der Feed erfolgreich im Business Hub eingerichtet und die Produktdaten können aus Shopware zu Pinterest übertragen werden.

Schritt 3: Berichte & Error Handling

Nach erfolgreichem ersten Abgleich der Daten, werden Sie eventuell einen Bericht erhalten, den Sie in Ihrem Commerce Manager einsehen können.

Changelog