Generic selectors
Nur exakte Treffer
Suche im Titel
Suche im Inhalt
Post Type Selectors
Inhaltsverzeichnis anzeigen

CSV Schnittstelle einrichten

In diesem Artikel richten wir die CSV Schnittstelle mit affiliate-toolkit ein. Sie können damit Produkte und Listen von unzähligen Shops anbinden.

CSV-URL herausfinden

Als erstes müssen Sie die CSV-Feed-URL herausfinden. Bei den meisten Affiliate-Netzwerken finden sie ein Tool für "Create a Feed" oder ähnliche Funktionen.

Hier z.B. das Tool zum erstellen eines Feeds für AWIN:

Die Feed-URL ist mit dem roten Kasten. Je nach Anbieter kann sie anders aussehen. Beachten Sie bitte, das diese URL nicht gekürzt werden sollte. Kopieren Sie die vollständige URL in das URL Feld des Shops.

Wichtig ist, das Sie CSV (UTF8 wenn verfügbar) auswählen, Wenn verfügbar können Sie auch GZIP aktivieren. Unser Plugin unterstützt nicht den Import von ZIP Dateien.

Anforderungen für die Nutzung der Schnittstelle

Wir laden den CSV-Feed vom jeweiligen Anbieter herunter und importieren diesen in eine temporäre Tabelle.

Beachten Sie bitte, das Ihre Datenbank diese größe auch zulässt. Ein Feed mit einem Gigabyte wird auch die Datenbank mit einem Gigabyte belasten. Manche Hoster haben hier Limits.

Auf Ihrem Host muss die PHP-Option "allow_url_fopen" aktiv sein. Diese Option aktiviert die URL-fähigen fopen-Wrapper, die den externen Zugriff auf URL-Objekte wie Dateien ermöglichen.

Installation der CSV Erweiterung

Laden Sie sich die Erweiterung von unserer Webseite herunter. Klicken Sie hierzu auf "Download now":

Die ZIP-Datei können Sie anschließend ganz normal über die WordPress-Plugin-Installation hochladen und installieren. Nach der Aktivierung ist die CSV-Schnittstelle auch unter Shop-API auswählbar.

Einrichtung des Shops für CSV-Feeds

Legen Sie nun in affiliate-toolkit unter Shops einen neuen Shop an.

1) TItel des Shops intern

Die Bezeichnung kann frei gewählt werden und wird nur intern verwendet.

2) Datenlieferant

Hier wählen Sie hier CSV API aus.

3) Feed List URL

Fügen Sie hier die Feed-URL ein welche Sie aus dem jeweiligen Create a Feed Tool generiert haben.

4) CSV Zeichensatz

Standardmäßig werden die Dateien mit dem UTF8-Zeichensatz geöffnet. Sie müssen in dem Fall also nichts eingeben.

Es gibt CSV-Dateien welche einen anderen Zeichnsatz haben. In diesem Fall müssen Sie den notwendigen Zeichensatz eingeben. Falls die Datei z.b. den Windows Zeichensatz 1252 verwendet, können sie "ISO-8859-1" eingeben. Die Zeichen werden dann beim Import von Codepage 1252 zu UTF8 konvertiert.

5) Spalten Trennzeichen

Dieses Trennzeichen trennt die Felder voneinander. Sie müssen entweder direkt im Create a Feed Tool sehen um welches Trennzeichen es sich handelt oder Sie müssen die Datei im Editor öffnen und prüfen um welches zeichen es sich handelt.

Wir unterstützen aktuell folgende Trennzeichen:

  • Tab
  • Pipe (|)
  • Zirkumflex (^)
  • Komma (,)
  • Semikolon (;)

6) Import-Modus

Der Import-Modus gibt an, wie die Datei importiert werden soll. So kann gewählt werden zwischen:

  • Datei-Stream
    Ihre Datei wird im Stream geöffnet und auf den Webspace geschrieben. Dadurch wird der Arbietsspeicher nicht zu sehr belastet, weil immer in Blöcken kopiert wird. Manche Anbieter unterstützen das allerdings nicht.
  • Datei-Download
    Hierbei wird die Datei via wp_remote_get abgerufen (in den Arbeitsspeicher geladen) und danach auf die Festplatte geschrieben. In dem Zuge können auch Zeilenumbrüche entfernt werden.
  • Webclient
    Ähnlich zu Datei-Download allerdings wird hier ein Web-Request außerhalb von WordPress abgesetzt. Die Datei wird auch komplett in den Speicher geladen und anschlißend auf die Festplatte geschrieben.
  • GZIP Komprimierung
    Ihre Datei wird im Stream geöffnet und währendessen auch gleich entpackt auf den Webspace geschrieben. Dadurch wird der Arbietsspeicher nicht zu sehr belastet, weil immer in Blöcken kopiert und entpackt wird.

7) Erste Zeile ist Spaltenkopf

Wenn Ihre Datei einen Spaltenkopf enthält, wählen Sie diese Option aus. Die meisten Anbieter schicken einen Spaltenkopf mit der Datei mit. Andernfalls erhalten Sie lediglich Spalte 1 bis Spalte x als Feldname.

8) Zeilenumbrüche vor dem Import entfernen

Diese Option kann zum bereinigen der Import-Datei dienen. Manche Anbieter fügen Zeilenumbrüche in Artikelbeschreibungen ein welche beim Import zu Problemen führen kann. Diese Option entfernt die Zeilenumbrüche vor dem Import.

9) Zeichenbegrenzung

Wenn z.b. der Produktitel oder die Produktbeschreibung das Trennzeichen selbst enthält, fügt man entweder ein Anführungszeichen (") um den Text oder ein Hochkomma (') um den Text.

10) Wartezeit bevor Datei heruntergeladen wird

Hier kann eine Wartezeit vor dem Upload definiert werden. In der Regel benötigt man dies nicht.

11) Ersten x Zeilen ignorieren

Wenn Ihre Importdatei in den ersten Zeilen eine Zusammenfassung stehen hat, dann wäre gut wenn man diese Zeilen überspringt. Nur so können die Spalten auch korrekt eingelesen werden.

12 Vor-Filter (ein Begriff pro Zeile)

Hiermit können Sie dem Feed Suchbegriffe beim Import vorgeben. Nur wenn dieser Suchbegriff in der Zeile vorhanden ist, wird die Zeile auch import. So können z.b. Kategorien "Technik" importiert werden aber "Fashion" wird ignoriert.

Import der Feeds

Nachdem Sie den Shop gespeichert haben, werden die erkannten Felder aufgelistet. Diese Felder müssen nun zugeordnet werden. Links sehen Sie den Feldnamen von affiliate-toolkit. Rechts müssen Sie den Feldnamen in der CSV auswählen.

1) Prefix

Hier können Sie an das Feld einen Wert vorne anhängen. z.b. wird beim Prefix "https://" aus dem Feld "domain.com/prd1" ein "https://domain.com/prd1"

2) Feldname

Wählen Sie hier den richtigen Feldnamen aus. Sobald die Daten importiert wurden, Sehen Sie auch einen Beispielwert in Klammer stehen.

3) Suffix

Hier können Sie an das Feld einen Wert hinten anhängen. z.b. wird beim Sufix "?ref=1" aus dem Feld "https://domain.com/prd1" ein "https://domain.com/prd1?ref=1"

4) Fallback

Enthält das Feld keinen wert, wird der Fallback-Wert genommen.

5) Benutzerdefinierte Felder

Hier könenn Sie noch eigene Felder mit Werten aud er CSV befüllen lassen.

Herunterladen des Feeds

Nachdem Sie die Felder verknüpft haben, können Sie die Produktdaten laden.

Man erkennt das der Shop mit "Download & Import erforderlich" orange markiert ist.

Hier ist der Produkt-Feed noch nicht importiert. Man hat dazu zwei Möglichkeiten:

  • Warten bis der Cronjob die Arbeit erledigt hat (das passiert im Hintergrund)
  • Den Import manuell anstoßen (das kann zu einem Timeout führen)

Den Import kann man manuell anstoßen indem man den den Haken bei "Download & Import erforderlich" setzt. Anschließend speichert man den Shop.

Beispiel-Konfigurationen

Hier haben wir noch einige Beispielkonfiguration zusammengestellt. Es kann natürlich vorkommen, das sich die Konfiguration bei Ihnen in der Zwischenzeit geändert hat.

CSV Shop für Mediamarkt bzw. Saturn

Diese Konfiguration haben wir für Mediamarkt verwendet.

CSV Shop für CJ Affiliate (früher: Commission Junction) Feeds

Wir versuchen hier noch eine Beispielkonfiguration zu finden.

CSV Shop für Webgains

Diese Konfiguration haben wir für Webgains verwendet.

CSV Shop für Belboon

Diese Konfiguration haben wir für Belboon verwendet.

Datenbank Tabellen & Dateien

Sie finden in Ihrer Datenbank eine neue Tabelle mit dem Namen {prefx}_atkp_csv_{shopid}.

Im Verzeichnis "/wp-content/uploads/affiliate-toolkit" finden Sie außerdem die zugehörige Feed-CSV Dateien:

Produkte über das Backend importieren

Suchlisten erstellen

Eine Liste ist eine Gruppe von Produkten. Sie können hier Such- und auch Erweiterte Listen anlegen. Wir haben hierzu auch einen separaten Artikel geschrieben.

So fügen Sie eine Produktbox auf Ihrer Seite ein.

Wir haben hierzu einen separaten Artikel verfasst. Diesen finden Sie hier. Die Erklärung für Shortcodes finden Sie hier.

Aktualisiert: 21. Februar 2023
Sie verwenden affiliate-toolkit noch nicht?
Die Einrichtung dauert weniger als 5 Minuten und schon können Sie die ersten Produkte importieren!
Erfahren Sie mehr über die PaketeKostenlose Version herunterladen
Brauchen Sie noch Hilfe?
Ihre Frage einreichen
Bitte geben Sie uns die Details, unser Support-Team wird sich mit Ihnen in Verbindung setzen.
linkedin facebook pinterest youtube rss twitter instagram facebook-blank rss-blank linkedin-blank pinterest youtube twitter instagram