Synchronisation massive des produits

L’outil de Synchronisation des produits vous permet d’automatiser la manière dont Connectif examinera le catalogue de produits de votre eCommerce et le mettra à jour dans votre Boutique Connectif. Grâce à son interface, vous pourrez choisir l’option de synchronisation massive, par Web Scraping ou via le Flux de produits, ainsi que configurer ce processus.

 

En plus des méthodes de synchronisation et de vérification de l’interface de Connectif, il est également possible d’importer et de mettre à jour des produits en réalisant des appels à l’API de Connectif. Pour plus d’informations, consultez la documentation associée.

 

Comment y accéder 

Vous pouvez accéder à la fonctionnalité de synchronisation massive des produits via le chemin "Ecommerce > Catalogue" en cliquant sur   Synchronisation des produits.

Synchronisation massive des produits - 01-min.png

 

Interface

L’interface principale de la Synchronisation des produits est composée de 3 blocs :

1. Onglets : pour naviguer entre les deux options de synchronisation, ainsi que consulter le registre des synchronisations :

  • Web Scraping : pour automatiser la synchronisation via la consultation de Connectif sur le catalogue de l’eCommerce.
  • Flux de produits : pour automatiser la synchronisation via la consultation d’un flux de produits préalablement publié.
 

Une seule option de synchronisation peut être activée. Pour savoir comment configurer chaque type de synchronisation massive des produits, consultez la section Fonctionnement

  • Journal de synchronisation : pour consulter les derniers processus de synchronisation et leurs détails.

2. Panneau principal : où se trouvent les options de chaque onglet.

3. Retour à la liste des intégrations : pour revenir au Catalogue une fois l’intégration configurée.

Synchronisation massive des produits - 2-min.png

 

Fonctionnement

Vous pouvez activer des synchronisations massives des produits de votre catalogue dans Connectif avec leur état dans votre eCommerce. Pour cela, deux méthodes sont disponibles, qui fonctionnent différemment :

  • Le Web Scraping, qui effectue des requêtes une par une à votre serveur web pour mettre à jour les informations.
  • Le Flux de produits, qui effectue une requête pour télécharger le fichier de votre flux et traiter l’état de vos produits.

 

1. Activer une synchronisation via Web Scraping

  

Le Web Scraping consiste en la vérification, par Connectif, des URLs des pages produit présentes dans votre catalogue Connectif. Lorsqu’il est activé, à l’heure et à la fréquence définies, Connectif visite ces URLs une à une, à la recherche de la balise de produit consulté présente dans votre eCommerce, afin de mettre à jour l’état des produits dans Connectif et le synchroniser avec les informations actuellement présentes sur votre site. Si ces produits n’existent pas dans le catalogue de votre eCommerce, Connectif ne les visitera pas. 

Dans l’onglet (1), allez dans Web Scraping et cliquez sur Configurer.

Synchronisation massive des produits - 3-min.png

Dans le Panneau principal (2), configurez la Périodicité de la synchronisation, c’est-à-dire la fréquence à laquelle vous souhaitez que Connectif accède à votre eCommerce et visite, une à une, les pages des différents produits pour créer, mettre à jour ou désactiver les produits dans le catalogue de Connectif, selon leur état sur votre site.

Vous pouvez choisir parmi les options "1 jour", "2 jours", "3 jours" et "1 semaine".

Synchronisation massive des produits - 4-min.png

Choisissez l’Heure à laquelle vous souhaitez que chaque processus de synchronisation ait lieu.

Synchronisation massive des produits - 5-min.png

Dans la section Configuration avancée, vous pouvez définir deux éléments qui aideront à optimiser les performances de la mise à jour du catalogue en fonction des performances de votre site.

  • Dans le menu déroulant Temps d’attente entre les produits, vous pouvez choisir si vous souhaitez que Connectif attende entre les différentes visites de produit et, le cas échéant, combien de temps il doit attendre. Selon la taille de votre catalogue, vous pouvez augmenter ou diminuer le temps pour éviter de surcharger votre site.

Synchronisation massive des produits - 6-min.png

  • Dans le sélecteur Inclure les produits désactivés, vous pouvez choisir si vous souhaitez que Connectif ne visite pas les produits marqués comme désactivés lors du processus de synchronisation. Cette option réduit la charge du site et améliore les performances de la synchronisation par Web Scraping.

Synchronisation massive des produits - 7-min.png

Une fois la configuration de la synchronisation définie, cliquez sur Activer pour programmer la synchronisation, ou sur Activer et synchroniser immédiatement pour exécuter une synchronisation et programmer la suivante selon la périodicité définie.

Synchronisation massive des produits - 9-min.png

 

2. Activer une synchronisation via Flux de produits

  

La synchronisation massive via Flux de produits est beaucoup plus rapide et réduit la charge sur votre serveur web, car elle effectue une seule requête pour télécharger le fichier de votre eCommerce, au lieu d’une requête pour chaque produit.
Un seul Flux de produits peut être ajouté, il doit donc être complet. 

 

Cette requête est effectuée à la période et à l’heure configurées. Connectif enregistre une copie du flux original à ce moment-là. Par conséquent, si une modification est apportée au flux après l’exécution d’une synchronisation ou pendant une synchronisation en cours, celle-ci ne sera pas reflétée dans Connectif avant la prochaine opération de synchronisation.

  

Les produits passent à l’état "Désactivé" si le produit n’apparaît pas dans le flux pendant 10 jours. Cette vérification est effectuée quotidiennement. 

Dans les onglets (1), allez à Flux de produits et cliquez sur Configurer.

Synchronisation massive des produits - 8-min.png

Dans le Panneau principal (2), dans la section Ajouter un flux de produits, ajoutez l’URL du flux de produits à partir duquel Connectif extraira les informations de votre catalogue.

  

Le flux de produits est un fichier XML qui doit être publiquement accessible, c’est-à-dire que l’URL du flux doit être publique, sans htaccess. Ce document contient une série d’objets décrivant les propriétés d’un produit, sous forme de balises et de valeurs. 

Synchronisation massive des produits - 11-min.png

 

Spécifications du Flux de produits :

 

À la fin de cet article (ou en cliquant sur ce lien), vous trouverez un document exemple de flux de produits.

Vous y trouverez également un fichier téléchargeable contenant le schéma utilisé pour décrire la structure et les contraintes des contenus des documents XML de flux de produits (ou en cliquant sur ce lien).

  • Lorsque Connectif tente de lire le flux à une URL, il utilise l'en-tête 'User-Agent' : 'Connectif'. Cela peut être utile si vous devez autoriser l'accès à la ressource uniquement pour certaines applications.
  • Vous pouvez utiliser le modèle de flux tel que spécifié par Google. Si vous utilisez un autre format, seul l’élément "Produit" sera autorisé au deuxième niveau, c’est-à-dire que le flux peut contenir au maximum trois niveaux : celui qui contient la liste des produits, l’article lui-même et la/les propriété(s) du produit.
  • Champs Google que Connectif convertit automatiquement :
    • G:AUTO_PRICING_MIN_PRICE, G:SALE_PRICE, G:PRICE : sont formatés pour supprimer la devise et être traités comme des nombres.
    • G:AVAILABILITY : les valeurs autorisées par Google 'in_stock', 'in stock' sont acceptées et transformées en notre valeur valide "instock".
    • G:GOOGLE_PRODUCT_CATEGORY, G:PRODUCT_TYPE : les caractères requis par Google ">" pour la séparation des catégories sont remplacés par celui autorisé par Connectif "/".
  • L'encodage du flux doit être en UTF-8.
  • Les champs qui ne sont pas mappés dans le flux sont respectés et ne sont pas écrasés.
  • Les produits créés via des mécanismes autres que le flux ne sont pas désactivés.
  • Si le format Google n'est pas utilisé, les données relatives aux prix doivent être au format numérique.
  • Il est possible d'utiliser plusieurs balises portant le même nom.
  • Lorsqu’un champ non détecté automatiquement est mappé manuellement, le chemin vers ce champ correspond aux noms de chaque niveau de balise jusqu’à la valeur, séparés par un ">".
  • Tous les champs qui, dans un mappage, sont de type "array" : si ceux-ci apparaissent plusieurs fois dans le flux, Connectif recueillera toutes les valeurs dans ce champ.
  

Si vous utilisez des catégories personnalisées pour les produits de votre boutique et que votre flux de produits est de type Google, vous pouvez les ajouter dans la balise G:PRODUCT_TYPE, puis les configurer dans le mappage pour que Connectif les récupère. Pour plus d'informations sur l'envoi de catégories personnalisées de produits, consultez la documentation officielle de Google.

Synchronisation massive des produits - 10-min.png

Configurez la Périodicité de la synchronisation, c’est-à-dire à quelle fréquence vous souhaitez que Connectif accède à votre flux de produits pour en extraire les informations. Vous pouvez choisir les options "1 jour", "2 jours", "3 jours" et "1 semaine".

Choisissez l’Heure à laquelle vous souhaitez que chaque processus de synchronisation ait lieu.

Cliquez sur Suivant .

Synchronisation massive des produits - 12-min.png

Dans le panneau principal (2), vous devrez sélectionner les valeurs détectées du flux de produits et les associer à celles de la fiche de contact de Connectif.

 

Le champ mappé comme "URL du produit" est validé avec les domaines autorisés.

Pour cela, cliquez sur chacun des champs de la colonne Champs de produit détectés automatiquement et faites-les glisser vers la colonne centrale, de façon à ce qu’ils correspondent aux champs de la fiche produit de Connectif (colonne de droite).

  

La sélection des champs à mapper est obtenue à partir des champs uniques d’un échantillon de produits de votre flux.

Synchronisation massive des produits - 13-min.png

Si un champ de votre flux de produits que vous souhaitez associer n’apparaît pas dans la sélection des valeurs, vous devrez sélectionner la valeur "Chemin du champ", l’associer au champ correspondant et saisir manuellement le chemin et chacun de ses niveaux dans le même format que celui affiché pour les autres champs dans Connectif.

Synchronisation massive des produits - 15-min.png

Copiez le chemin et ses différents niveaux, comme illustré dans l’exemple.

Synchronisation massive des produits - 14-min.png

Saisissez-les dans Connectif avec le format correspondant. Chaque niveau du chemin saisi doit être séparé par le symbole ">".

 

Si vous changez le nom d’un champ mappé dans votre flux de produits, vous devrez également le mettre à jour dans Connectif.

Synchronisation massive des produits - 16-min.png

 

Dans notre exemple, le champ "product_tags" a été créé à partir du chemin illustré dans l’image précédente. Dans ce cas, le chemin complet serait : RSS>CHANNEL>ITEM>G:PRODUCT_TAGS.

Une fois la configuration de la synchronisation déterminée, cliquez sur Activer pour planifier la synchronisation, ou sur Activer et synchroniser immédiatement pour exécuter une synchronisation et programmer la suivante selon la période définie.

 

3. Désactiver un type de synchronisation pour pouvoir en activer un autre 

Il n’est pas possible d’avoir les deux processus de synchronisation actifs en même temps, donc si l’un est actif, il doit être désactivé avant de pouvoir configurer l’autre.

Pour cela, allez à l’Onglet (1) du type de synchronisation que vous avez activé et, dans le Panneau principal (2), cliquez sur Désactiver.

Synchronisation massive des produits - 17-min.png

 

4. Vérifier le Journal de Synchronisation

Dans les Onglets (1), accédez à Journal des synchronisations

Dans le panneau principal (2), vous pourrez consulter les dates d'exécution des processus de synchronisation passés, ainsi que les éventuels changements d’état de chacune des synchronisations.

 

Quel que soit le délai d'exécution défini pour le processus de synchronisation, le processus de désactivation des produits sera exécuté tous les jours, de sorte que la liste affichera plus de processus que ceux indiqués dans la configuration.

Synchronisation massive des produits - 18-min.png

 

 

Félicitations !
Vous êtes arrivé à la fin de la leçon.

 


Continuez à apprendre !

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