Produktlisten
Publisher mit einer CSV-Datei auf einzelne Produkte verlinken.
Bei einem Programm mit Produktliste verlinken Publisher auf einzelne Produkte statt auf eine Seite. Du lädst deine Produkte als CSV-Datei hoch, und jeder freigeschaltete Publisher bekommt einen Link pro Produkt. Auf dieser Seite erfährst du das Dateiformat, wie du hochlädst, wie Uploads geprüft werden und was mit Produkten passiert, die du entfernst.
Das Linkziel wählst du beim Anlegen des Programms. Es lässt sich später nicht ändern. Nutzt dein Programm eine einzelne Ziel-URL, hat es keine Produktliste. Siehe Programm anlegen.
Kurz gesagt:
- Drei Spalten:
productId,name,url. Höchstens 5.000 Produkte und 2 MB pro Datei. - Jeder Upload ersetzt die ganze Liste. Produkte, die in der Datei fehlen, werden inaktiv.
- cli.gs prüft zuerst die ganze Datei. Eine fehlerhafte Zeile bedeutet: Nichts wird importiert.
- Links auf inaktive Produkte funktionieren weiter: Sie führen auf die Startseite deines Shops.
Das CSV-Format
Die Datei hat genau drei Spalten mit dieser Kopfzeile:
productId,name,url
SKU-1,Trailschuh,https://shop.example/p/sku-1
SKU-2,"Regenjacke, Herren",https://shop.example/p/sku-2
SKU-3,Wandersocken,https://eu.shop.example/p/sku-3| Spalte | Regeln |
|---|---|
productId | Buchstaben, Ziffern, ., _ und -, 1 bis 64 Zeichen, eindeutig in der Datei. Wird der letzte Teil des Publisher-Links. |
name | Pflicht, bis 191 Zeichen. Publisher sehen ihn in ihrer Produkttabelle. |
url | Eine vollständige http://- oder https://-Adresse auf einer der erlaubten Domains des Programms (Subdomains eingeschlossen). |
Die Datei ist Standard-CSV, durch Kommas getrennt. Ein Feld mit Komma oder Anführungszeichen steht in doppelten Anführungszeichen, und "" steht für ein Anführungszeichen darin. Eine Byte-Order-Mark, wie Excel sie schreibt, ist kein Problem, und Leerzeilen werden ignoriert. Höchstens 5.000 Produkte und 2 MB pro Datei.
Hochladen
- Öffne das Programm und scroll zu Produkte.
- Wähle unter CSV-Datei deine Datei aus.
- Klicke auf Produkte hochladen.
Bei Erfolg siehst du, wie viele Produkte importiert wurden. Der Bereich zeigt dann die Anzahl der Produkte und eine Vorschau der ersten Einträge.
Du kannst jederzeit eine neue Liste hochladen, solange das Programm nicht archiviert ist, auch während es live ist. Die neue Liste gilt sofort.
Prüfung: alles oder nichts
cli.gs prüft die ganze Datei, bevor es irgendetwas speichert. Ist auch nur eine Zeile falsch, wird nichts importiert, und deine aktuelle Liste bleibt, wie sie ist. Ein halb importierter Katalog wäre schlimmer als ein abgelehnter: Niemand bemerkt die fehlende Hälfte, bis ein Link ins Leere geht.
Die Fehlermeldung nennt die Zahl der Probleme. Sie listet die ersten zehn mit Zeilennummer auf, zum Beispiel:
- „Zeile 1: Die Kopfzeile muss genau productId,name,url lauten.“
- „Zeile 14: Produkt-ID „SKU-14“ kommt doppelt vor.“
- „Zeile 15: „SKU 15“ ist keine gültige Produkt-ID.“ (Leerzeichen sind nicht erlaubt)
- „Zeile 27: shop.other.example gehört nicht zu den erlaubten Domains des Programms.“
- „Zeile 40: drei Spalten erwartet.“ (oft ein Komma im Namen ohne Anführungszeichen)
Produkt-URLs werden schon beim Upload gegen deine erlaubten Domains geprüft. So erfährst du es sofort, statt später zu merken, dass ein Produkt still auf deine Startseite zurückfällt. Liegt ein Produkt auf einer anderen Domain, trag diese zuerst unter Linkziel ein. Bei einem eingereichten oder laufenden Programm prüft cli.gs diese Änderung, bevor sie gilt. Siehe Prüfung und Lebenszyklus.
Die Liste ersetzen
Jeder Upload ersetzt die ganze Liste. Die hochgeladene Datei ist der vollständige Katalog, keine Ergänzung:
- Produkte in der neuen Datei werden angelegt oder aktualisiert (Name und URL).
- Produkte, die in der neuen Datei fehlen, werden inaktiv.
- Ein inaktives Produkt, das in einer späteren Datei wieder auftaucht, wird wieder aktiv, mit demselben Link.
Um ein Produkt hinzuzufügen, lade deine vollständige Liste mit der neuen Zeile hoch.
Inaktive Produkte und unbekannte IDs
Ein Publisher-Link auf ein inaktives Produkt funktioniert weiter. Der Besucher landet auf der Startseite deines Shops (deiner Shop-Website) statt auf dem Produkt, und der Klick zählt trotzdem. Ein Verkauf aus diesem Besuch bringt Provision wie jeder andere. So führen Links, die schon in Artikeln oder Videos stehen, nie auf eine Fehlerseite.
Ein Link mit einer Produkt-ID, die nie auf deiner Liste stand, führt ins Leere. Er zeigt eine „nicht gefunden“-Seite.
Publisher und die Produktliste
Freigeschaltete Publisher sehen deine Produkte mit ihrem persönlichen Link für jedes einzelne. Sie können die Liste als CSV mit einer zusätzlichen Spalte affiliateUrl herunterladen. Siehe Links verwenden.