Vous êtes ici :
Configuration requise pour un fichier ETL
Les fichiers ETL contiennent des entrées telles que des utilisateurs, des produits, des membres de liste d'abonnements, des promotions, des transactions, et plus encore. Ces fichiers doivent être au format CSV et peuvent être cryptés ou compressés. Les formats de fichier doivent respecter les exigences explicites de schéma pour chaque fil de données ETL. Généralement, vous chargez automatiquement des fichiers ETL en utilisant le site SFTP, mais vous pouvez également charger manuellement un fichier.
Nommage et extensions de fichier
- Tous les fichiers doivent être au format de fichier CSV RFC-4180.
- Le codage des caractères doit être UTF-8, et toutes les longueurs maximales sont en octets codés en UTF-8.
- Les fichiers ETL peuvent être compressés et cryptés. Les extensions de fichier compressées valides sont .zip et .gz. L'extension de cryptage valide est .pgp.
- Les fichiers ne sont pas traités, sauf si leur nom correspond à la structure définie des schémas de fil de données ETL. Vous ne pouvez pas personnaliser le schéma d'un fichier ETL.
- Assurez-vous que le format de nommage des fichiers est cohérent pour chaque fil de données. Dans la plupart des cas, le nom du fil de données ETL est suivi d'une date et d'une heure, par exemple
user-yyyy-mm-dd_hh-mm-ss.csv. Marketing Cloud Personalization utilise la date pour traiter les fichiers dans l'ordre lorsque plusieurs fichiers sont chargés en même temps. - Lors de l'envoi de fichiers depuis Automation Studio pour le traitement ETL, omettez d'utiliser des minutes et des secondes dans les noms de fichier. Cela signifie que lorsque vous traitez plusieurs fichiers par jour depuis Automation Studio, nommez les fichiers sous le format
user-yyyy-mm-dd_hh.csv. Lors du traitement d'un seul fichier par jour depuis Automation Studio, nommez les fichiers sous le formatuser-yyyy-mm-dd.csv.
Structure de l'en-tête de fichier
Les fichiers traités par des composants ETL intégrés sont traités de façon cohérente, quel que soit le type ETL. Certains types de fil de données ont accès à des définitions d'en-tête supplémentaires en raison du type de données cible, mais les champs appartiennent généralement à quelques catégories différentes.
| Champ | Description |
|---|---|
id
|
L'ID de l'élément que vous chargez. Dans certains cas, le nom de cet en-tête est légèrement différent, par exemple dans le fil de données User ETL.
|
categories
|
Ce champ est applicable uniquement aux objets catalogue intégrés produit, article et publication de blog. |
relatedCatalogObject
|
La structure de traitement des objets de catalogue associés dans divers fils de données ETL. |
attribute
|
La structure de traitement des définitions d'attributs système et personnalisés. La personnalisation traite tous les champs qui commencent par attribute: en tant que type d'attribut défini dans le schéma ou que vous définissez en créant un attribut personnalisé. Lors de l'utilisation d'un attribut personnalisé, la valeur doit être le nom défini unique de l'attribut, pas l'étiquette utilisée pour afficher l'attribut dans Personnalisation. Les attributs de date personnalisés sont mis en forme en tant qu'horodatages d'époque Unix. |
Fréquence
Le système Personalization Gears inclut un écouteur intégré pour les fichiers du site SFTP. Toutes les 15 minutes, chaque fil de données ETL activé vérifie dans le répertoire /dataset/inbound tous les fichiers qui correspondent à la structure de noms de fichier attendue pour ce fil de données individuel. La recommandation générale de fréquence de traitement des fichiers est quotidienne. Cependant, si vous souhaitez traiter des fichiers plus fréquemment ou mettre à jour des données périmées, vous pouvez les charger toutes les heures. Des chargements plus fréquents garantissent que le système a le temps de traiter complètement les fichiers, ce qui empêche la formation d'une file d'attente de traitement des fichiers.
Champs système
La personnalisation inclut plusieurs champs système intégrés pour prendre en charge les attributs. Les champs système disponibles pour chaque type de fil de données ETL varient et ont des processus de traitement explicites. La création d'attributs portant le même nom qu'un attribut système entraîne des conséquences négatives pour les données, par exemple lors de l'insertion de l'attribut name d'un élément dans un fichier ETL Product. Bien que « name » soit un champ système, Personalization est lu dans un en-tête de colonne « attribute:name ». La création d'un attribut personnalisé appelé « nom » pour l'objet Catalogue de produits dans la page Objets Catalogue et Profil peut avoir des conséquences négatives pendant le traitement ETL.
Réinitialisation des valeurs par défaut
À l'exception du fil de données User ETL, tous les fils de données ETL peuvent réinitialiser les valeurs de champ sur leurs valeurs par défaut (sauf lorsque le champ est obligatoire, par exemple un ID). La réinitialisation d'une valeur se produit lorsqu'un enregistrement contient une valeur vide pour une colonne pendant le traitement. La personnalisation traite l'absence de valeur comme nulle et retire toutes les valeurs existantes de cette clé dans l'enregistrement Personnalisation. Vous pouvez utiliser ce processus pour retirer une ancienne description d'un article, retirer un attribut personnalisé pour une transaction ou retirer des catégories pour un produit.
La personnalisation suppose que chaque enregistrement a une valeur correspondante pour chaque colonne, même dans un fichier delta.
Certains champs système ont des valeurs non définies légèrement différentes d'une valeur absente. Certaines de ces clés s'appliquent uniquement à un sous-ensemble de types ETL, mais sont toutes répertoriées dans le tableau ci-dessous.
Nom du champ |
Valeur par défaut |
|---|---|
price
|
0 |
listPrice
|
0 |
rating
|
0 |
numRatings
|
0 |
inventoryCount
|
1 (l'article est considéré en stock) Cette valeur est réinitialisée par défaut uniquement si |
published
|
1/1/1970 |
expiration
|
Date de traitement + 100 ans (s'il a été exécuté le 04/12/2022, la date d'expiration est le 04/12/2122) |
promotable
|
True (l'article est promotionnel) |
Erreurs et consignation
- Si un en-tête de colonne ne correspond pas à un champ système, un attribut personnalisé ou un autre en-tête de colonne valide existant dans le schéma d'un fil de données ETL, Personalization ne charge pas ces enregistrements. Une erreur se produit lorsqu'une valeur de colonne ne reflète pas des données valides.
- Si vous rencontrez une erreur indiquant « Attention : Au moins un Produit est archivé. Les mises à jour ne seront pas visibles dans l'interface utilisateur. » Cela signifie qu'au moins un des éléments de votre fichier ETL est à l'état archivé. Un élément est archivé lorsque vous incluez l'en-tête de colonne
attribute:archivedet la valeur true dans le fichier ETL, ou lorsque vous cliquez sur Supprimer en regard de l'élément du catalogue. Pour désarchiver un élément, vérifiez que la colonneattribute:archivedest dans votre fichier ETL et que l'élément a la valeur false. - Une erreur indiquant « échec de l'extraction probablement dû à un délimiteur de colonne ou de ligne » indique qu'un fichier contient des erreurs de caractères, par exemple des guillemets doubles non fermés ou des virgules supplémentaires dans une valeur.
- Lorsque des erreurs se produisent pour un fil de données ETL, Personnalisation enregistre chaque message d'erreur dans la boîte de dialogue Journaux. Les journaux contiennent le numéro de ligne du fichier qui entraîne une erreur.
- La personnalisation échoue à une tâche ETL lorsque le seuil d'erreur atteint 10 %. Vous ne pouvez pas modifier le seuil d'erreur.
- Si un champ d'un enregistrement n'est pas correctement mappé avec le type de données indiqué par son en-tête, Personnalisation ignore l'enregistrement et ne le charge pas. Si le nombre d'instances de ce type d'erreur est suffisant, la personnalisation échoue dans le fichier ETL complet.
Limites de fil
Pour plus d'informations sur les limites en fils, consultez Limites de Marketing Cloud Personalization.
Limites en taille de fichier
Pour plus d'informations sur les limites en taille de fichier recommandées, consultez Limites de Marketing Cloud Personalization.
