Les flux de produits Daisycon se configurent directement dans MyDaisycon. Quand vous sélectionnez un flux de produits, vous pouvez choisir le format d'export et ajuster les paramètres disponibles. MyDaisycon génère automatiquement l'URL du flux de produits correspondante.
Vous pouvez aussi créer ou modifier vous-même une URL de flux de produits avec des paramètres de requête. C'est utile pour les intégrations automatisées ou quand vous avez besoin de plus de contrôle sur les données renvoyées par le flux de produits.
Cet article explique les paramètres disponibles pour l'URL du flux de produits et leur correspondance avec les paramètres de MyDaisycon.
Configurer un flux de produits dans MyDaisycon
Le moyen le plus simple de créer une URL de flux de produits est de passer par Matériel > Flux de produits dans MyDaisycon. Sélectionnez le flux de produits souhaité et ouvrez Utiliser le flux de produits.
Sélectionnez d'abord le format souhaité. Daisycon prend en charge XML, JSON et CSV. Les options de configuration disponibles changent automatiquement selon le format sélectionné.
Vous pouvez configurer des paramètres comme l'encodage des caractères, les balises XML ou JSON, le délimiteur et le caractère d'encadrement CSV, les fins de ligne, le traitement du HTML, les données non standardisées, le média et un Sub ID. L'URL du flux en bas de l'interface est mise à jour automatiquement quand la configuration change.
Pour la plupart des intégrations, nous vous recommandons de créer la configuration dans MyDaisycon et de copier l'URL générée. Les paramètres d'URL décrits ci-dessous sont utiles si vous voulez créer, vérifier ou modifier vous-même une URL de flux.
Structure de l'URL du flux de produits
Les flux de produits Daisycon utilisent l'URL de base suivante :
https://daisycon.io/datafeed/
Les paramètres sont ajoutés sous forme de chaîne de requête. Le premier paramètre commence par ? et les paramètres suivants sont séparés par &.
Une URL de flux de produits simple peut ressembler à ceci :
https://daisycon.io/datafeed/?program_id=7611&media_id=22848&standard_id=1&language_code=nl&locale_id=1&type=xml&encoding=utf8
Paramètres obligatoires du flux de produits
| Paramètre | Description | Exemple |
|---|---|---|
media_id |
ID du média de l'éditeur pour lequel le flux de produits est demandé. L'accès aux campagnes et aux flux de produits peut dépendre du média sélectionné. | 22848 |
standard_id |
ID du standard de flux de produits Daisycon utilisé par le flux. | 1 |
language_code |
Langue du flux de produits. |
nl, en, de
|
locale_id |
Pays cible du flux de produits. |
1 pour les Pays-Bas |
Vous pouvez aussi récupérer les valeurs disponibles de standard_id et locale_id via les services API communs de Daisycon.
Sélectionner des campagnes
Utilisez program_id[] si vous voulez uniquement les produits de certaines campagnes. Vous pouvez répéter ce paramètre pour inclure plusieurs campagnes.
Par exemple :
program_id[]=7611&program_id[]=14007
Une URL de flux générée par MyDaisycon peut aussi contenir program_id quand le flux concerne une seule campagne.
Format d'export
| Paramètre | Description | Valeurs |
|---|---|---|
type |
Détermine le format de sortie du flux de produits. |
xml, json, csv
|
encoding |
Détermine l'encodage des caractères des données exportées. | ASCII, ISO-8859-1, ISO-8859-15, UTF-8, UTF-16 ou Windows-1252. UTF-8 est la configuration par défaut dans MyDaisycon. |
Paramètres XML et JSON
Pour les exports XML et JSON, vous pouvez configurer les noms utilisés pour la racine et pour chaque produit. Ces paramètres sont disponibles directement dans MyDaisycon.
| Paramètre | Description |
|---|---|
root_tag |
Définit le nom de l'élément racine ou de l'objet racine. La configuration standard dans MyDaisycon utilise datafeed. |
item_tag |
Définit le nom utilisé pour un produit. La valeur par défaut peut varier selon le format d'export. Par exemple, MyDaisycon utilise actuellement product pour XML et product_info pour JSON. |
Paramètres CSV
Les exports CSV ont des paramètres supplémentaires pour séparer les champs, encadrer les valeurs des champs et séparer les lignes.
| Paramètre | Description | Exemples |
|---|---|---|
csv_explode |
Définit le délimiteur CSV. Le délimiteur sépare les champs au sein de chaque ligne. | Virgule (,), point-virgule (;), barre verticale (|), dièse (#) ou tabulation. |
csv_enclose |
Définit le caractère d'encadrement utilisé autour des valeurs des champs. | Guillemet double ("), guillemet simple ('), barre verticale (|) ou accent circonflexe (^). |
line_ending |
Définit comment les lignes CSV sont séparées. |
LF, CR ou CRLF. |
N'utilisez pas le même caractère pour le délimiteur et l'encadrement CSV
Les valeurs de csv_explode et csv_enclose doivent être différentes. Le délimiteur indique où un champ se termine et où le suivant commence, tandis que le caractère d'encadrement indique les limites de la valeur d'un champ.
Par exemple, ne configurez pas les deux paramètres avec une barre verticale (|). Utiliser le même caractère pour les deux peut rendre la structure du CSV ambiguë et entraîner une mauvaise lecture du fichier.
Encoder les caractères CSV dans l'URL
Les caractères spéciaux utilisés comme valeurs de paramètres de requête doivent être encodés pour l'URL quand vous créez vous-même une URL de flux. MyDaisycon le fait automatiquement pour l'URL générée.
| Caractère | Valeur encodée pour l'URL |
|---|---|
Barre verticale (|) |
%7C |
Guillemet double (") |
%22 |
Dièse (#) |
%23 |
Point-virgule (;) |
%3B |
Par exemple, si vous utilisez une barre verticale comme délimiteur CSV, l'URL peut contenir :
csv_explode=%7C
Informations générales sur les produits
Le paramètre general détermine si les informations générales de Daisycon sur les produits sont incluses dans l'export. Il accepte true ou false.
Les informations générales peuvent contenir des champs propres à Daisycon, comme des identifiants de produit, des informations sur la devise, le statut du produit, des dates de modification et des données internes servant à identifier les modifications des produits.
Cela correspond au paramètre Infos générales dans MyDaisycon.
Données non standardisées de l'annonceur
Daisycon mappe les informations produits fournies par les annonceurs au standard de flux de produits Daisycon applicable. Les champs de l'annonceur qui ne peuvent pas être mappés à un champ Daisycon standardisé sont considérés comme des données non standardisées.
Indiquez rawdata=true pour inclure ces champs d'origine non standardisés dans l'export. La valeur par défaut est false.
Dans MyDaisycon, ce paramètre s'affiche sous le nom Utiliser les données non standardisées. Il est disponible pour les flux XML et JSON, mais pas pour les exports CSV.
Sélectionner, renommer et réorganiser des champs
Le paramètre fields permet de ne renvoyer que certains champs. Les noms de champs sont séparés par des virgules et l'ordre dans le paramètre détermine l'ordre dans lequel les champs sont renvoyés.
Par exemple :
fields=title,description,link
Vous pouvez aussi renommer un champ dans la sortie. L'exemple suivant renvoie le champ link sous le nom url :
fields=title,description,link=url
Quand vous utilisez fields, indiquez tous les champs que vous voulez recevoir dans le flux de produits.
Traitement du HTML
Les informations produits fournies par les annonceurs peuvent contenir du HTML. Le paramètre html_transform détermine comment ce HTML est traité.
| Valeur | Résultat |
|---|---|
none |
Le HTML n'est ni supprimé ni encodé. |
strip |
Les balises HTML sont supprimées du contenu exporté. |
encode |
Le HTML est encodé dans le contenu exporté. |
La valeur par défaut est none.
Caractères spéciaux HTML et sauts de ligne
D'autres paramètres permettent de contrôler l'export du contenu lié au HTML.
| Paramètre | Description |
|---|---|
xhtml_strict |
Active ou désactive le traitement XHTML strict. Les valeurs acceptées sont true et false. La valeur par défaut est false. |
nl2br |
Si la valeur est true, les sauts de ligne dans le contenu des produits sont convertis en éléments HTML <br/>. |
Filtrer les données du flux de produits
Les URL de flux de produits prennent en charge des filtres si vous voulez uniquement récupérer les produits qui répondent à certaines conditions. Vous pouvez combiner les filtres avec les autres paramètres d'URL décrits dans cet article.
Consultez Filtrage des flux de produits pour les possibilités de filtrage et des exemples.
Pagination
Vous pouvez récupérer les flux de produits volumineux en plusieurs parties grâce à la pagination. C'est utile quand traiter un flux complet en une seule fois n'est pas pratique pour votre application.
Consultez Pagination des flux de produits pour les paramètres de pagination disponibles et des exemples.
En-têtes de réponse des flux de produits
En plus des données produits, chaque réponse de flux de produits contient des en-têtes avec des informations utiles :
-
Last-Modified : la dernière fois que des produits du flux ont été ajoutés ou modifiés. Renvoyez cette valeur dans un en-tête de requête
If-Modified-Since. Si le flux de produits n'a pas changé, vous recevez une réponse304 Not Modifiedsans contenu. - X-Total-Count : le nombre total de produits dans le flux. Utilisez-le pour vérifier que vous avez reçu tous les produits.
- X-Current-Count et X-Next-Url : uniquement avec la pagination. Le nombre de produits sur cette page et l'URL de la page suivante.
-
Retry-After : uniquement avec une réponse
429 Too Many Requests. Le nombre de secondes à attendre avant de réessayer.
Découvrez comment utiliser ces en-têtes dans Règles et consignes pour télécharger et traiter les flux de produits.
Exemples d'URL de flux de produits
Flux XML
L'exemple suivant récupère un flux de produits XML :
https://daisycon.io/datafeed/?program_id=7611&media_id=22848&standard_id=1&language_code=nl&locale_id=1&type=xml&encoding=utf8
Flux CSV avec un délimiteur personnalisé
L'exemple suivant utilise une barre verticale comme délimiteur CSV et un guillemet double comme caractère d'encadrement :
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
Flux JSON avec données non standardisées
L'exemple suivant récupère du JSON et inclut les champs non standardisés de l'annonceur :
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
Méthode recommandée pour créer une URL de flux de produits
Si possible, configurez d'abord le flux de produits dans MyDaisycon. C'est plus simple pour choisir des options compatibles et vous obtenez une URL générée que vous pouvez copier directement.
La configuration manuelle de l'URL est surtout utile pour les intégrations qui génèrent des requêtes de flux de manière dynamique, qui ont besoin de champs spécifiques, qui utilisent des filtres ou la pagination, ou qui ont besoin de différentes configurations d'export à partir du même flux de produits.