Daisycon Produkt-Feeds können Sie direkt in MyDaisycon konfigurieren. Wenn Sie einen Produkt-Feed auswählen, können Sie das Exportformat wählen und die verfügbaren Einstellungen anpassen. MyDaisycon generiert die passende Produkt-Feed-URL automatisch.
Sie können eine Produkt-Feed-URL auch selbst mit Query-Parametern erstellen oder anpassen. Das ist praktisch für automatisierte Integrationen oder wenn Sie mehr Kontrolle über die Daten brauchen, die der Produkt-Feed zurückgibt.
In diesem Artikel finden Sie die verfügbaren Parameter für die Produkt-Feed-URL und wie sie zu den Einstellungen in MyDaisycon passen.
Einen Produkt-Feed in MyDaisycon konfigurieren
Am einfachsten erstellen Sie eine Produkt-Feed-URL über Material | Produktfeeds in MyDaisycon. Wählen Sie den gewünschten Produkt-Feed aus und öffnen Sie Produktfeed verwenden.
Wählen Sie zuerst das gewünschte Format. Daisycon unterstützt XML, JSON und CSV. Die verfügbaren Konfigurationsoptionen ändern sich automatisch je nach gewähltem Format.
Sie können Einstellungen wie Zeichenkodierung, XML- oder JSON-Tags, CSV-Trennzeichen und Einschlusszeichen, Zeilenenden, HTML-Verarbeitung, nicht standardisierte Daten, Medium und eine Sub ID konfigurieren. Die Feed-URL unten in der Oberfläche wird automatisch aktualisiert, wenn sich die Konfiguration ändert.
In den meisten Fällen empfehlen wir, die Konfiguration in MyDaisycon zu erstellen und die generierte URL zu kopieren. Die unten beschriebenen URL-Parameter können Sie nutzen, wenn Sie eine Feed-URL selbst erstellen, prüfen oder anpassen möchten.
Aufbau der Produkt-Feed-URL
Daisycon Produkt-Feeds verwenden die folgende Basis-URL:
https://daisycon.io/datafeed/
Parameter werden als Query-String hinzugefügt. Der erste Parameter beginnt mit ?, weitere Parameter werden mit & getrennt.
Eine einfache Produkt-Feed-URL kann so aussehen:
https://daisycon.io/datafeed/?program_id=7611&media_id=22848&standard_id=1&language_code=nl&locale_id=1&type=xml&encoding=utf8
Erforderliche Produkt-Feed-Parameter
| Parameter | Beschreibung | Beispiel |
|---|---|---|
media_id |
ID des Publisher-Mediums, für das der Produkt-Feed abgerufen wird. Der Zugang zu Kampagnen und Produkt-Feeds kann vom gewählten Medium abhängen. | 22848 |
standard_id |
ID des Daisycon Produkt-Feed-Standards, den der Feed verwendet. | 1 |
language_code |
Sprache des Produkt-Feeds. |
nl, en, de
|
locale_id |
Ziel-Locale des Produkt-Feeds. |
1 für die Niederlande |
Die verfügbaren Werte für standard_id und locale_id können Sie auch über die Daisycon Common API-Dienste abrufen.
Kampagnen auswählen
Verwenden Sie program_id[], wenn Sie nur Produkte bestimmter Kampagnen möchten. Sie können den Parameter wiederholen, um mehrere Kampagnen einzubeziehen.
Zum Beispiel:
program_id[]=7611&program_id[]=14007
Eine von MyDaisycon generierte Feed-URL kann auch program_id enthalten, wenn der Feed eine einzelne Kampagne darstellt.
Exportformat
| Parameter | Beschreibung | Werte |
|---|---|---|
type |
Legt das Ausgabeformat des Produkt-Feeds fest. |
xml, json, csv
|
encoding |
Legt die Zeichenkodierung der exportierten Daten fest. | ASCII, ISO-8859-1, ISO-8859-15, UTF-8, UTF-16 oder Windows-1252. UTF-8 ist die Standardkonfiguration in MyDaisycon. |
XML- und JSON-Einstellungen
Bei XML- und JSON-Exporten können Sie die Namen für das Root-Element und die einzelnen Produkte festlegen. Diese Einstellungen sind direkt in MyDaisycon verfügbar.
| Parameter | Beschreibung |
|---|---|
root_tag |
Legt den Namen des Root-Elements oder Root-Objekts fest. Die Standardkonfiguration in MyDaisycon verwendet datafeed. |
item_tag |
Legt den Namen für ein einzelnes Produkt fest. Der Standardwert kann je nach Exportformat unterschiedlich sein. MyDaisycon verwendet zum Beispiel derzeit product für XML und product_info für JSON. |
CSV-Einstellungen
CSV-Exporte haben zusätzliche Einstellungen zum Trennen von Feldern, zum Einschließen von Feldwerten und zum Trennen von Zeilen.
| Parameter | Beschreibung | Beispiele |
|---|---|---|
csv_explode |
Legt das CSV-Trennzeichen fest. Das Trennzeichen trennt die einzelnen Felder innerhalb jeder Zeile. | Komma (,), Semikolon (;), Pipe (|), Raute (#) oder Tabulator. |
csv_enclose |
Legt das Einschlusszeichen um Feldwerte fest. | Doppeltes Anführungszeichen ("), einfaches Anführungszeichen ('), Pipe (|) oder Zirkumflex (^). |
line_ending |
Legt fest, wie die einzelnen CSV-Zeilen getrennt werden. |
LF, CR oder CRLF. |
Nicht dasselbe CSV-Trennzeichen und Einschlusszeichen verwenden
Die Werte von csv_explode und csv_enclose müssen unterschiedlich sein. Das Trennzeichen zeigt, wo ein Feld endet und das nächste beginnt, das Einschlusszeichen markiert die Grenzen eines Feldwerts.
Stellen Sie zum Beispiel nicht beide Parameter auf eine Pipe (|) ein. Wenn Sie für beide dasselbe Zeichen verwenden, kann die CSV-Struktur mehrdeutig werden und die Datei falsch eingelesen werden.
CSV-Zeichen URL-kodieren
Sonderzeichen, die Sie als Wert eines Query-Parameters verwenden, sollten Sie URL-kodieren, wenn Sie eine Feed-URL manuell erstellen. MyDaisycon macht das bei der generierten URL automatisch.
| Zeichen | URL-kodierter Wert |
|---|---|
Pipe (|) |
%7C |
Doppeltes Anführungszeichen (") |
%22 |
Raute (#) |
%23 |
Semikolon (;) |
%3B |
Wenn Sie zum Beispiel eine Pipe als CSV-Trennzeichen verwenden, kann die URL Folgendes enthalten:
csv_explode=%7C
Allgemeine Produktinformationen
Der Parameter general legt fest, ob die allgemeinen Produktinformationen von Daisycon im Export enthalten sind. Er akzeptiert true oder false.
Allgemeine Informationen können Daisycon-spezifische Felder enthalten, wie Produkt-IDs, Währungsinformationen, Produktstatus, Änderungsdaten und interne Daten, mit denen Änderungen an Produkten erkannt werden.
Das entspricht der Einstellung Allgemeine Infos in MyDaisycon.
Nicht standardisierte Advertiser-Daten
Daisycon ordnet die Produktinformationen der Advertiser dem passenden Daisycon Produkt-Feed-Standard zu. Advertiser-Felder, die keinem standardisierten Daisycon-Feld zugeordnet werden können, gelten als nicht standardisierte Daten.
Setzen Sie rawdata=true, um diese ursprünglichen, nicht standardisierten Felder in den Export aufzunehmen. Der Standardwert ist false.
In MyDaisycon heißt diese Einstellung Nicht standardisierte Daten verwenden. Sie ist für XML- und JSON-Feeds verfügbar, aber nicht für CSV-Exporte.
Felder auswählen, umbenennen und sortieren
Mit dem Parameter fields können Sie nur bestimmte Felder abrufen. Feldnamen werden mit Kommas getrennt. Die Reihenfolge im Parameter bestimmt die Reihenfolge, in der die Felder zurückgegeben werden.
Zum Beispiel:
fields=title,description,link
Sie können ein Feld in der Ausgabe auch umbenennen. Das folgende Beispiel gibt das Feld link unter dem Namen url zurück:
fields=title,description,link=url
Wenn Sie fields verwenden, geben Sie alle Felder an, die Sie im Produkt-Feed erhalten möchten.
HTML-Verarbeitung
Produktinformationen von Advertisern können HTML enthalten. Der Parameter html_transform legt fest, wie dieses HTML verarbeitet wird.
| Wert | Ergebnis |
|---|---|
none |
HTML wird nicht entfernt oder kodiert. |
strip |
HTML-Markup wird aus dem exportierten Inhalt entfernt. |
encode |
HTML wird im exportierten Inhalt kodiert. |
Der Standardwert ist none.
HTML-Sonderzeichen und Zeilenumbrüche
Mit weiteren Parametern können Sie steuern, wie HTML-bezogene Inhalte exportiert werden.
| Parameter | Beschreibung |
|---|---|
xhtml_strict |
Aktiviert oder deaktiviert die strikte XHTML-Verarbeitung. Unterstützte Werte sind true und false. Der Standardwert ist false. |
nl2br |
Wenn auf true gesetzt, werden Zeilenumbrüche im Produktinhalt in HTML-<br/>-Elemente umgewandelt. |
Produkt-Feed-Daten filtern
Produkt-Feed-URLs unterstützen Filter, wenn Sie nur Produkte abrufen möchten, die bestimmte Bedingungen erfüllen. Filter lassen sich mit den anderen URL-Parametern aus diesem Artikel kombinieren.
Die verfügbaren Filterfunktionen und Beispiele finden Sie in Produkt-Feeds filtern.
Paginierung
Große Produkt-Feeds können Sie mit Paginierung in kleineren Teilen abrufen. Das ist nützlich, wenn es für Ihre Anwendung nicht praktikabel ist, einen kompletten Feed auf einmal zu verarbeiten.
Die verfügbaren Paginierungsparameter und Beispiele finden Sie in Produkt-Feed-Paginierung.
Antwort-Header von Produkt-Feeds
Neben den Produktdaten enthält jede Produkt-Feed-Antwort Header mit nützlichen Informationen:
-
Last-Modified: der letzte Zeitpunkt, an dem Produkte im Feed hinzugefügt oder geändert wurden. Senden Sie diesen Wert in einem
If-Modified-Since-Anfrage-Header zurück. Hat sich der Produkt-Feed nicht geändert, erhalten Sie eine304 Not Modified-Antwort ohne Inhalt. - X-Total-Count: die Gesamtzahl der Produkte im Feed. Damit können Sie prüfen, ob Sie alle Produkte erhalten haben.
- X-Current-Count und X-Next-Url: nur bei Paginierung. Die Anzahl der Produkte auf dieser Seite und die URL der nächsten Seite.
-
Retry-After: nur bei einer
429 Too Many Requests-Antwort. Die Anzahl Sekunden, die Sie warten müssen, bevor Sie es erneut versuchen.
Wie Sie diese Header nutzen, lesen Sie in Regeln und Richtlinien zum Herunterladen und Verarbeiten von Produktfeeds.
Beispiel-URLs für Produkt-Feeds
XML-Feed
Das folgende Beispiel ruft einen XML-Produkt-Feed ab:
https://daisycon.io/datafeed/?program_id=7611&media_id=22848&standard_id=1&language_code=nl&locale_id=1&type=xml&encoding=utf8
CSV-Feed mit eigenem Trennzeichen
Das folgende Beispiel verwendet eine Pipe als CSV-Trennzeichen und ein doppeltes Anführungszeichen als Einschlusszeichen:
https://daisycon.io/datafeed/?program_id=7611&media_id=22848&standard_id=1&language_code=nl&locale_id=1&type=csv&encoding=utf8&csv_explode=%7C&csv_enclose=%22&line_ending=LF
JSON-Feed mit nicht standardisierten Daten
Das folgende Beispiel ruft JSON ab und enthält nicht standardisierte Advertiser-Felder:
https://daisycon.io/datafeed/?program_id=7611&media_id=22848&standard_id=1&language_code=nl&locale_id=1&type=json&encoding=utf8&rawdata=true
Empfohlene Methode zum Erstellen einer Produkt-Feed-URL
Konfigurieren Sie den Produkt-Feed nach Möglichkeit zuerst in MyDaisycon. So können Sie leichter kompatible Optionen auswählen und erhalten eine generierte URL, die Sie direkt kopieren können.
Die manuelle URL-Konfiguration ist besonders nützlich für Integrationen, die Feed-Anfragen dynamisch erzeugen, bestimmte Felder benötigen, Filter oder Paginierung verwenden oder verschiedene Exportkonfigurationen desselben Produkt-Feeds brauchen.