Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Permet Cette fonctionnalité vous permet de configurer des imports automatiques "génériques" qui seront lancés toutes les nuits à partir d'un fichier CSV via FTP(S).

Ce fichier CSV doit être créé et importé sur un espace de stockage accessible via le protocole FTP(S) de votre choix.

Vous devrez ensuite configurer les accès de cet espace dans SPREAD pour que nous puissions nous y connecter toutes les nuits pour importer les données.

Warning

Pour des raisons de sécurité, il est fortement conseillé de réserver un espace de stockage FTP dédié à cette fonctionnalité, avec des accès dédiés à SPREAD.

Traitement des colonnes

Si, dans le fichier fourni, certains colonnes ne respectent pas le format attendu, l'ensemble de la ligne sera ignoré ignorée et pas importénon importée.

Caractéristiques du fichier CSV

...

vide)site_customer_email_encrypted
Colonne du fichierFormat attenduDétailsPeut être vide ?Colonne SPREAD
nameTexteChaîne100 caract. maxOuisite_customer_name
firstnameChaîne100 caract. maxOuisite_customer_firstname
emailChaîne (adresse email valide)100 caract. maxOui (si `email_encrypted` est fourni)site_customer_email
optinChiffre (1 chiffre max)1 : optin
0 : optout
-1 : inconnu
Noncustomer_isoptin
email_encryptedTexte255 caract. maxemail_encryptedChaîne255 caract. max. Doit être un md5 de l'adresse email.Oui (si `email` est fourni)
external_idChaîne250 caract. max.Oui (si `email` ou `email_encrypted` est fourni)
languageTexteChaîne120 caract. maxOuisite_customer_lang
birthdayDateFormat : yyyy-mm-ddOuisite_customer_birthday
genderTexteChaînemale : homme
female : femme
Ouisite_customer_gender
addressTexteChaîne250 caract. maxOuisite_customer_address
cpTexteChaîne20 caract. maxOuisite_customer_cp
cityTexteChaîne250 caract. maxOuisite_customer_city
countryTexteChaîne100 caract. maxOuisite_customer_country
companyTexteChaîne100 caract. maxOuisite_customer_company
occupationTexteChaîne100 caract. maxOuisite_customer_fonction
phone
TexteChaîne
25 caract. maxOuisite_customer_teloptin_phoneChiffre (1 chiffre max)1 : optin
0 : optout
Oui (si `phone` n'est pas fourni)site_customer_tel_optin
mobileTexteChaîne25 caract. maxOuisite_customer_mobile
optin_mobileChiffre (1 chiffre max)1 : optin
0 : optout
Oui (si `mobile` n'est pas fourni)site_customer_mobile_optin
cagnotteChiffrecustomer_cagnotte_amountactionsChiffrecustomer_action_countviewsChiffrecustomer_view_countsharesChiffrecustomer_share_countlast_action_creation_dateDate + Heure

yyyy-mm-dd HH:ii:ss ou "0000-00-00 00:00:00" ( veut dire vide )

customer_last_action_dtturnoverChiffrePeut être à virgulecustomer_ca_totalorder_countChiffrecustomer_order_countlast_order_dateDate + Heureyyyy-mm-dd HH:ii:ss ou "0000-00-00 00:00:00" ( veut dire vide )customer_last_orderemails_receivedChiffre32 chiffres maxsite_customer_email_recieved_countemails_read_percentageChiffre5 chiffres maxsite_customer_percentage_email_reademails_clicked_percentageChiffre5 chiffres maxsite_customer_percentage_email_clickedcreation_dateDate + Heureyyyy-mm-dd HH:ii:ss ou "0000-00-00 00:00:00" ( veut dire vide )site_customer_crea_dtlast_modification_dateDate + Heureyyyy-mm-dd HH:ii:ss ou "0000-00-00 00:00:00" ( veut dire vide )site_customer_real_updt_dtorder_idTexteorder_idorderorder_numTexteorder_numorder_statusChiffre

Correspond à la date de création du compte sur votre site.


order_idChaîne

order_numChaîne

order_statusNumérique-1 : Erreur
0 : Annulée
10 : Enregistrée
20 : Payée
50 : Envoyée
100 : Reçue par le clientorder_state

order_creation_dateDate + Heureyyyy-mm-dd HH:ii:ss ou "0000-00-00 00:00:00" ( veut dire vide )order_crea_dt
order_amountChiffreNumériquePeut être à virgule. Jusqu'à 7 chiffres avant la virgule, 2 aprèsorder_amount

Importer des champs personnalisés

...

Le nom de colonne attendu pour importer un champ personnalisé est customfield_XXXX où "XXXX" est l'identifiant numérique unique de votre champ personnaliséspersonnalisé.

Par exemple si votre champ a l'identifiant "123456", le nom de la colonne sera customfield_123456.

Info

La liste des identifiants de vos champs personnalisés est disponible dans "Paramétrage > Tracker > Exemples de code" de votre backoffice SPREAD.

En fonction du type de champ, voici les informations à connaître pour la définition des valeurs dans vos fichiers d'import :

Type du champFormat attenduDétails
Champ texte
Texte
Chaîne500 caractères max
Champ numérique
Chiffre
NumériquePeut être à virgule (sera arrondi à 5 chiffres après la virgule). Les zéros en début de chaîne seront supprimés.

Oui / Non

Chiffre
Numérique (1 chiffre max)

-1 : Non
1 : Oui

Champ dateDate + Heureyyyy-mm-dd HH:ii:ss ou "0000-00-00 00:00:00" (veut dire vide)
Choix unique (boutons radio)
Texte
ChaîneLa valeur sélectionnée parmi les choix configurés dans votre champ personnalisé
Choix multiples (cases à cocher)
Texte
ChaîneListe des valeurs sélectionnées, séparées par un "pipe" (" | " : sous mac Alt + Maj + L, sous windows Alt gr + 6)

Exemple

Pour un choix multiple dont la question serez "Quels animaux possédez vous?". Réponses possibles : Chien, Chat, Hamster, Rat

Lors d'un import vous pouvez remplir ce champs de la sorte : Chien|Chat|Rat


Info

Notez qu'il n'est pas nécessaire de définir tous vos champs personnalisés dans votre fichier d'import si vous souhaitez n'en importer qu'un : vous n'avez qu'à définir seulement ceux que vous souhaitez importer.

Importer des consentements

Vous pouvez également importer des consentements configurés pour votre site.

Pour importer un consentement, vous devez importer 2 colonnes : 

  1. la valeur du consentement :
    1. elle doit avoir pour valeur soit 1 pour "Oui / Consentement accepté", soit 0 pour "Non / Consentement refusé"
    2. le nom de cette colonne est `consent_date_XXXXX` où XXXXX est le nom technique du consentement, disponible sur la page de configuration du consentement en question, sous le nom "Identifiant technique".
  2. la date d'acceptation ou de refus du consentement
    1. elle doit avoir pour valeur la date à laquelle le consentement a été accepté ou refusé par le client
    2. le nom de cette colonne est `consent_value_XXXXX` où XXXXX est le nom technique du consentement, disponible sur la page de configuration du consentement en question, sous le nom "Identifiant technique".

Importer des attributs produits

Vous pouvez également importer les attributs produits de vos commandes.

Pour importer un ou plusieurs attributs, vous devez importer autant de colonnes que de groupes d'attributs. Les colonnes doivent obligatoirement avoir un nom qui respecte le format suivant :

  • product_attributes_X où X est un chiffre. Chaque chiffre doit être différent d'une colonne à l'autre.

Vous devrez donc avoir autant de colonnes d'attributs produits que le maximum d'attributs produit que vous aurez sur une commande.

Les différents attributs au sein d'un groupe d'attributs doivent être séparés par un pipe ("|").

Exemple : 

Code Block
languagetext
Nom:pantalon|Couleur:bleu foncé|taille:38

Ceci ajoutera un groupe d'attributs produits avec 3 attributs : Nom, Couleur et taille qui auront les valeurs ci-dessus assignées.

Vous pouvez ajouter autant d'attributs produits que vous souhaitez par groupe de produits ; de plus, il n'est pas obligatoire qu'ils soient identiques.