Versions de l’API d’exportation des contacts

Connectif permet d’automatiser les exportations massives de contacts et d’activités à l’aide de l’API d’exportation. Cette exportation comportera certaines modifications en fonction de la version de l’API utilisée. 

Dans cet article, sont expliquées les propriétés de l’API d’exportation des contacts et les modifications apportées dans chacune des versions.

1. Propriétés

• Si vous souhaitez automatiser périodiquement (quotidiennement, hebdomadairement...) l’exportation de tous vos contacts ou d’une grande partie d’entre eux et/ou de leurs activités, vous pouvez utiliser l’ API d’exportation.
• La demande d’exportation contient différentes propriétés modifiables, parmi lesquelles se trouve la version (version) de cette exportation.
• La propriété relative à la version d’exportation peut être spécifiée afin de générer un fichier CSV contenant certains champs, en fonction de la version sélectionnée.
• Ces versions présentent certaines variations. Ainsi, lors d’un changement de version, le fichier CSV généré comportera des différences dont il faut tenir compte (voir le point 2).
• Si aucune version n’est spécifiée, la V1 sera utilisée par défaut.
• Dans la fonctionnalité d’exportation des contacts de la plateforme, la version d’exportation sera toujours la plus récente.

2. Utilisation dans Connectif : modifications apportées dans les versions

Vous trouverez ci-dessous la liste des champs et des activités ayant subi des modifications dans chacune des versions, les versions les plus récentes étant présentées en premier :

Version 8

a. Activités

Champs ajoutés :

• ID externe du contact
   

b. Type d’activité : contact-created, newsletter-subscribe et newsletter-unsubscribe

Champs ajoutés :

• Source

   

Version 7

a. Contacts

Champs ajoutés :

• Consentement au suivi des e-mails

• Date du dernier refus du consentement au suivi des e-mails

• Date du dernier consentement au suivi des e-mails

Version 6

a. Contacts

Champs ajoutés :

• Dispose de l’autorisation pour les notifications push mobiles Android
• Dispose de l’autorisation pour les notifications push mobiles iOS
• Dispose de l’autorisation pour les notifications push mobiles

Version 5

a. Contacts

Champs ajoutés :

• Date de la dernière inscription à la newsletter
• Adresse IP de la dernière inscription à la newsletter    
• Source de la dernière inscription à la newsletter    
• Source de la dernière désinscription de la newsletter    
• Source de création

Champs modifiés :

• Date de la dernière désinscription : devient Date de la dernière désinscription de la newsletter

• Adresse IP de la dernière désinscription : devient Adresse IP de la dernière désinscription de la newsletter
   

b. Type d’activité : contact-created

Champs ajoutés :

• Source

Version 4

a. Type d’activité : contact-merged

Champs ajoutés :

• ID du contact précédent
   

b. Type d’activité : purchase

Champs ajoutés :

• ID du contenu

• Nom du contenu

• Tags du contenu

• ID du workflow

• Nom du workflow

• Tags du workflow

• Confiance de l’attribution

• Scénario d’attribution

   

Version 3

a. Contacts

Champs ajoutés :

• ID externe

b. Type d’activité : purchase

Champs ajoutés :

• Type de source

• Nom de la source

Version 2

a. Type d’activité : purchase

Champs ajoutés :

• Version du SDK (visible uniquement lorsque le canal Push mobile est activé)

• Version de l’application (visible uniquement lorsque le canal Push mobile est activé)

• Système d’exploitation du mobile (visible uniquement lorsque le canal Push mobile est activé)

• Version du système d’exploitation (visible uniquement lorsque le canal Push mobile est activé)

• Appareil

Champs modifiés :

• Source de l’achat : devient Source
   

b. Type d’activité : custom-event

Champs ajoutés :

• Source

• Version du SDK (visible uniquement lorsque le canal Push mobile est activé)

• Version de l’application (visible uniquement lorsque le canal Push mobile est activé)

• Système d’exploitation du mobile (visible uniquement lorsque le canal Push mobile est activé)

• Version du système d’exploitation (visible uniquement lorsque le canal Push mobile est activé)

• Appareil
   

c. Type d’activité : newsletter-subscribe

Champs ajoutés :

• Source

• Version du SDK (visible uniquement lorsque le canal Push mobile est activé)

• Version de l’application (visible uniquement lorsque le canal Push mobile est activé)

• Système d’exploitation du mobile (visible uniquement lorsque le canal Push mobile est activé)

• Version du système d’exploitation (visible uniquement lorsque le canal Push mobile est activé)
   

d. Type d’activité : product-visited

Champs ajoutés :

• Source

• Version du SDK (visible uniquement lorsque le canal Push mobile est activé)

• Version de l’application (visible uniquement lorsque le canal Push mobile est activé)

• Système d’exploitation du mobile (visible uniquement lorsque le canal Push mobile est activé)

• Version du système d’exploitation (visible uniquement lorsque le canal Push mobile est activé)

• Appareil
   

e. Type d’activité : cart-product-added et cart-product-removed

Champs ajoutés :

• Source

• Appareil
   

f. Type d’activité : web-page-visited

Champs modifiés :

• Referer de la page visitée : devient Referer
   

g. Type d’activité : email-link-clicked

Champs modifiés :

• Referer de la page visitée : devient Referer

Continuez à apprendre !

Pour tirer pleinement parti du potentiel de votre compte Connectif, nous vous recommandons de poursuivre avec les articles suivants :

• Connectif Copilot, pour découvrir le fonctionnement de l’assistant et son interface.

• Créer des e-mails avec Copilot, pour apprendre à utiliser l’assistant afin de créer rapidement des e-mails.

• Consulter les statistiques et les données dans Connectif, pour découvrir dans quels autres domaines de Connectif vous pouvez consulter les performances de votre e-commerce et l’activité de vos contacts.

• Data Explorer, pour découvrir comment créer vos propres rapports et les exporter facilement.