Tout d'abord, si vous voulez en savoir plus sur les avantages de l'historique des achats, commencez ici.
Pour commencer, il est nécessaire d'avoir des connaissances de base sur la gestion des listes et des contacts et sur l'API Symplify. Les lecteurs sont supposés avoir une certaine familiarité avec l'interface graphique de Symplify.
Cet article vous informera sur :
- Préparation de votre fichier
- Configuration du transfert FTP
- Configuration du transfert d'API
- Lignes de crédit
Préparez votre fichier
Pour commencer une importation, vous devez préparer un dossier. Le format des données de l'historique des achats est très strict. Il doit avoir ce format exact, sinon l'importation échouera. Le délimiteur doit être un point-virgule (;) et les colonnes doivent avoir l'ordre spécifié ci-dessous. Certaines colonnes sont obligatoires et d'autres sont facultatives. Si vous souhaitez inclure des champs facultatifs, tous les champs facultatifs qui précèdent votre champ dans l'ordre doivent être inclus. Les données peuvent être vides, vous pouvez donc simplement ajouter des points-virgules pour les champs facultatifs intermédiaires que vous ne voulez pas ajouter. Les champs personnalisés peuvent être nommés pour l'utilisateur dans l'interface utilisateur de Symplify.
NOTE ! Le fichier ne doit pas contenir de ligne d'en-tête. La première ligne doit contenir des données.
* Champs obligatoires
** Non obligatoire, mais fortement recommandé
Pour que les données des champs personnalisés soient analysées correctement, les dates doivent être formatées selon la norme ISO-8601 et les prix doivent être formatés en 000000.00 (point décimal).
Les données ne sont qu'une annexe, donc si les mêmes données sont importées deux fois, la deuxième importation sera une annexe, et n'écrasera pas l'importation précédente.
Assurez-vous que votre fichier est dans un format CVS valide. Par exemple, vous ne pouvez pas avoir un seul " dans les données ( comme dans 6″ monitor) dans les données car cela rendrait le fichier CVS invalide.
Configuration à l'aide du transfert de fichiers FTP
Lorsque votre fichier a été préparé, téléchargez-le sur votre FTP Symplify.
Votre contact chez Symplify vous aidera à vérifier le fichier et à terminer la préparation.
Pour en savoir plus sur les lignes de crédit (ci-dessous), suivez-ce lien.
Configuration à l'aide du transfert d'API
Après la préparation du dossier, il est temps de faire la première demande à l'API. Vous aurez besoin de l'ID de la liste à laquelle vous souhaitez associer les données de l'historique des achats.
Une fois ces informations recueillies, il est temps de faire la demande. La réponse, si tout s'est bien passé, contiendra un identifiant unique qui sera utilisé ultérieurement.
Pour lancer l'importation, une demande POST avec des métadonnées décrivant l'importation est envoyée:
POST <server>/rest/<customerId>/purchasehistory/imports
Exemple de corps de réponse
{“id”: “bd48b5cc-b118-4062-8d06-09efa765592b”}
Après la demande initiale et le retour d'un identifiant, il est temps de télécharger vos données. Utilisez l'identifiant obtenu dans la réponse à la première demande pour télécharger vos données :
POST <server>/rest/<customerId>/purchasehistory/imports/<id>/data
CONTENT-TYPE: text/csv
<data from file>
Exemple de corps de réponse
{“batchId”: “101111”}
REMARQUE : les données ne sont qu'une annexe, donc si les mêmes données sont importées deux fois, la deuxième importation sera une annexe et n'écrasera pas l'importation précédente.
Lorsque le fichier a été téléchargé avec succès, vous pouvez interroger l'API pour suivre la progression des importations. Utilisez le batchId de la requête précédente. Vous pouvez continuer à interroger la méthode jusqu'à ce que vous receviez une réponse avec le statut "FINISHED".
N'interrogez pas trop souvent, car cela mettrait inutilement le système à rude épreuve. Un sondage toutes les 30 secondes ou toutes les minutes est normalement suffisant.
GET <server>/rest/<customerId>/batches/<batchId>
Corps de réponse
{
“id”: 101111,
“type”: “IMPORT”,
“customerId”: 0,
“startTime”: 1394636797030,
“endTime”: 1394636799710,
“affected”: 500,
“processed”: 500,
“total”: 501,
“status”: ” PENDING|IN_PROGRESS|FINISHED”
}
Lignes de crédit
Une ligne de crédit est une ligne où la quantité est un nombre négatif.
Lorsqu'une ligne de crédit est importée, le nombre (Qté) est réduit à zéro, quel que soit le nombre de lignes de PH nécessaires.
Exemple
Orignalid;Sku;Qty
A100;iPhone;2
A100;iPhone;3
A100;iPhone;2
Si vous importez ensuite une ligne de crédit avec "-3" (Qté), ce qui suit est censé se produire :
Orignalide; Sku; Qté
A100; iPhone; (crédité)
A100; iPhone; 2 (réduit de 1)
A100; iPhone; 2
En d'autres termes, les lignes 1 et 2 sont diminuées en fonction du "-3" de la ligne de crédit.
La particularité de "COLUMN1" est qu'en combinaison avec la colonne "Date de transaction", elle peut être utilisée pour identifier une ligne spécifique à mettre au crédit (si le compte est <0). Il devrait alors (si vous voulez pouvoir gérer des lignes de crédit) être un identifiant de produit unique.
Après l'importation, une ligne créditée est répertoriée dans une couleur "bleue" sur la carte de contact du destinataire.
Les lignes créditées seront négligées par les segments PH basés sur les règles "achetées", et uniquement ciblées par les segments PH basés sur les règles "créditées".
Ajout de lignes d'historique d'achat (PH) avec l'API
Nous vous recommandons d'utiliser des importations par lots pour la synchronisation avec plusieurs lignes d'historique d'achat. Toutefois, pour de plus petites quantités, vous pouvez également importer des lignes d'historique d'achat avec cette ressource API (maximum 100 lignes à la fois) :
POST <server>/rest/<customerId>/purchasehistory/rows
{
"rows":[
{
"originalId": "A100",
"transactionDate": "2020-10-30T10:00:00-04:00",
"itemPrice": "5.00",
"count" : 3,
"totalPrice": "15.00",
"column1": "",
"column2": "",
"column3": "",
"column4": "",
"column5": "",
"column6": "",
"column7": "",
"column8": "",
"column9": "",
"column10": "",
"column11": "",
"column12": "",
"column13": "",
"column14": "",
"column15": "",
"column16": "",
"column17": "",
"column18": "",
"column19": "",
"column20": "",
"column21": "",
"column22": "",
"column23": "",
"column24": "",
"column25": "",
"column26": ""
}
]
}