Table des matières
Faire votre téléversement initial
Si vous êtes un client Smart Insight, vous pouvez toujours choisir de téléverser vos données de ventes sur nos serveurs SFTP. Veuillez toutefois noter qu'il s'agit d'une option historique qui présente plusieurs inconvénients comparée à l'utilisation de l'API de données de ventes. Si vous préférez quand même utiliser notre SFTP, veuillez contacter le Support Emarsys.
Une fois votre fichier de données de vente prêt et formaté selon nos spécifications, téléversez-le sur la page données de ventes.
Pour ouvrir la page Données de ventes, allez à Admin > Sources de données, et dans la case Données de ventes cliquez sur Configurer les téléversements de données de ventes (s'il s'agit de votre téléversement de fichier) ou bien sur Gérer les données de ventes (si vous avez déjà téléversé au moin un fichier de données de ventes).
Doublons de données
- Si vous téléversez ici plus d'une fois le même fichier, cela n'entraînera pas de doublons de données si le nom de fichier ne change pas.
- Si vous téléversez le même fichier avec un nom différent (par exemple avec un horodatage actualisé), ou téléversez différents fichiers contenant les mêmes commandes, alors les données seront dupliquées.
Les colonnes dans l'en-tête de votre fichier de données de ventes doivent être dans le même ordre que ce qui a été convenu pendant l'implémentation d'intégration Smart Insight. Dans le cas contraire, le téléversement échouera.
Les colonnes sont affichées dans l'ordre en haut de la page Données de ventes, par exemple :
Assurez-vous que les champs requis sont saisis en prenant en compte la casse, sinon ils ne seront pas reconnus par le système. 'Prix' n'est pas la même chose que 'prix'. 'Prix' est reconnu ccomme un champ personnalisé et se verra attribué un préfixe, tel que f_, qui ressemblera à f_Price. Dans ce cas-là, le champ prix sera manquant.
Le téléchargement manuel via la page de Données de ventes est l'approche recommandée pour réaliser votre téléversement initial des données de vente historiques pendant le processus d'intégration, puisque cela vous permet de valider le fichier et de corriger toutes les erreurs immédiatement. Procéder comme suit :
- Sur la page des Données de vente, cliquez sur Valider/télécharger le fichier.
- Recherchez votre fichier de données et sélectionnez-le.
- Si des problèmes sont détectés, ils seront listés comme avertissements et erreurs. Résolvez-les et relancez le téléversement.
- Si aucun problème n'est détecté, finalisez le téléversement en cliquant sur Activer le téléversement.
Vous ne pourrez pas télé verser votre fichier de données de ventes tant qu'il contient des erreurs, vous devez donc les résoudre d'abord.
Configurer les mises à jour régulières
Si vous êtes un client Smart Insight, vous pouvez toujours choisir de téléverser vos données de ventes sur nos serveurs SFTP. Veuillez toutefois noter qu'il s'agit d'une option historique qui présente plusieurs inconvénients comparée à l'utilisation de l'API de données de ventes. Si vous préférez quand même utiliser notre SFTP, veuillez contacter le Support Emarsys.
Après avoir fait un téléversement unique de vos données de ventes historiques, vous devez configurer les mises à jour régulières. La manière la plus simple d'automatiser les importations de données de ventes régulières vers Emarsys est d'utiliser notre API de données de ventes.
Ouvrez la page Données de vente en allant à Admin > Sources de données, et dans la case Données de vente cliquez sur gérer les données de ventes. Cliquez ensuite sur Afficher les détails de téléversement de l'API, qui affichera toutes les informations dont vous avez besoin pour configurer l'importation en toute simplicité.
Les téléversements de données de vente sont incrémentaux, ce qui signifie que les nouveaux téléversements s'ajoutent aux données de vente existantes sans les effacer.
Doublons de données
Deux solutions de contournement existent pour résoudre ce problème :
- Divisez le contenu du fichier en 2 fichiers et téléversez-les à nouveau, ou bien
- Dupliquez une des lignes dans le fichier et téléversez-le à nouveau.
L'une ou l'autre de ces solutions de contournement entraînera des données dupliquées dans Smart Insight. Pour résoudre ce problème, vous devez purger la base de données Smart Insight et téléverser à nouveau vos données de ventes historiques propres.
Spécifications de l'API de données de ventes
Endpoint
POST https://admin.scarabresearch.com/hapi/merchant/<merchant-id>/sales-data/api
Paramètres du chemin
| Nom | Type | Description |
|---|---|---|
| merchant-id | chaîne | Votre ID marchand en 16 lettres fourni par Emarsys. |
Paramètres de l'en-tête
La requête doit contenir un en-tête Autorisation avec la valeur suivante :
Porteur <jeton>
<token> est un jeton de sécurité, qu'on peut obtenir en cliquant sur le bouton Montrer les détails de téléversement API sur la page Données de vente.
Corps de la requête
Vous devez téléverser les données de ventes sous forme de fichier .csv en tant que charge utile binaire (data-binary) dans le corps de la requête. Voir Formater votre fichier de données de ventes pour les détails sur le format accepté.
Exemple de requête (curl)
curl --request POST \ --header 'Authorization: Bearer <token> \ --header 'Content-type: text/csv' \ --header 'Accept: text/plain' \ --data-binary @/myhome/salesdata-2018-03-26.csv \ https://admin.scarabresearch.com/hapi/merchant/<id>/sales-data/api
Live streaming
Par défaut nos serveurs rassemblent, valident et soumettent les événements par groupes toutes les heures. Si l'API n'est pas appelée après chaque événement d'achat dans une requête séparée (pas plus souvent que toutes les 5 minutes), vous pouvez ajouter le paramètre ?live=false au bout de l'URL d'endpoint. Les données de vente seront alors traitées plus fréquemment qu'une fois par heure.
Compression
Le format de compression gzip est supporté. Pour utiliser des fichiers compressés en gzip, utilisez l'en-tête Content-Encoding: gzip.
Réactions
| Code HTTP | Message |
|---|---|
| 200 | Le téléversement est accepté (avec des avertissements possibles). |
| 200 | Les) événement(s) est/sont mis en attente par Live API. Voir le statut à l'intérieur d'une heure à Emarsys > Admin > Sources de données > Données de ventes |
| 400 | Le téléversement est rejeté à cause d'erreurs. |
| 401 | Le jeton de sécurité est invalide ou manquant. |