Nœud "Partager des Données"

Le nœud “Partager des données”, de type action, sert à envoyer des données à partir d’un nœud précédent "Obtenir des produits". Son utilisation permet de recevoir les données produit pour les utiliser à différentes fins par le client. Par exemple, il est possible de les intégrer aux composants natifs du eCommerce pour afficher des produits recommandés sans avoir besoin d’un Contenu Web.

 

L’utilisation du nœud “Partager des données” consommera une activité de votre Boutique chaque fois qu’il sera exécuté pour chaque contact.

  

Pour configurer l’utilisation de ce nœud, vous aurez besoin d’un expert ayant des connaissances en programmation.

 

Comment y accéder ?

Dans vos workflows, faites glisser le nœud "Partager des données" depuis le menu de droite jusqu’à la zone de conception. Vous pouvez accéder à sa configuration en cliquant sur  (Modifier la configuration du nœud).

Nœud “Partager des données” - 1-min.png

 

Interface

L’interface principale du nœud "Partager des données" est composée de trois blocs :

1. Identifiant : pour introduire un terme permettant d’identifier le nœud et, par la suite, de récupérer les données dans le eCommerce via cet identifiant. 

2. Nœud source : pour indiquer à Connectif à partir de quel nœud obtenir les données. Il ne peut s’agir que d’un nœud source de type “Obtenir des produits”.

 

Si aucun nœud "Obtenir des produits" n’est placé avant le nœud "Partager des données", le sélecteur apparaîtra vide et l’interface affichera une alerte d’erreur.

3. Champs du nœud source : pour sélectionner les champs que nous voulons recevoir. Les champs en gris sont
obligatoires et ne peuvent pas être désélectionnés.

Nœud “Partager des données” - 2-min.png

 

Fonctionnement

Les nœuds de type action sont ceux qui exécutent des opérations spécifiques dans les flux. Le nœud “Partager des données” est utilisé pour envoyer des données au eCommerce à partir d’un nœud précédent "Obtenir des produits". Son utilisation permet de recevoir les données produits pour ensuite les utiliser côté client selon les besoins.

L’un de ses usages les plus répandus permet de personnaliser les composants natifs afin d’afficher des produits personnalisés au contact à partir d’un workflow sans avoir à utiliser un Contenu Web. Particulièrement utile dans les intégrations avec VTEX.

 

Le nœud "Obtenir des produits" transmet les données produits au nœud "Partager des données", qui se charge ensuite de les envoyer au eCommerce.

Il fonctionne de manière similaire au nœud "Afficher du contenu web" de Connectif, à la différence que les données ne sont pas affichées sur le site web, mais récupérées via l’identifiant assigné et envoyées dans la réponse du scrippet.

 

1. Utilisation du nœud dans un workflow pour partager les données

Le nœud "Partager des données" peut être utilisé dans un workflow exactement comme un nœud "Afficher du contenu web", à la différence que, dans ce cas, aucun contenu n’est affiché sur la page mais le eCommerce reçoit les données pour ensuite les utiliser comme souhaité.

Dans l’exemple suivant, il est utilisé avec le déclencheur "Lors de la visite d’une page" pour extraire les produits consultés et les envoyer au eCommerce.

 

Si vous souhaitez exécuter la récupération des données plusieurs fois par client, il est nécessaire de désactiver dans le workflow les limitations des nœuds "Lors de la visite d’une page" et "Partager des données".

Nœud “Partager des données” - 3-min.png

 

2. Configuration du nœud "Partager des données"

Dans l’interface du nœud, attribuez un Identifiant (1) à utiliser ensuite pour récupérer les données du nœud (point 3).

Nœud “Partager des données” - 4-min.png

Sélectionnez le Nœud Source (2), qui doit toujours être un "Obtenir des produits", à partir duquel les informations produit seront extraites pour être partagées dans ce nœud "Partager des données".

Nœud “Partager des données” - 5-min.png

Choisissez les Champs du nœud source (3), pour définir quelles informations seront partagées sur les produits obtenus vers le eCommerce.

Nœud “Partager des données” - 6-min.png

 

3. Extraction des données du nœud pour leur utilisation dans le eCommerce

Une fois le nœud configuré et le workflow activé, pour pouvoir récupérer ces données dans le eCommerce et ensuite les utiliser dans les composants natifs, il faut utiliser la fonction suivante :

const identifier = "academy-example";
const sharedData = window.connectif.managed.getSharedDataById(identifier);

Dans cette fonction, l’"identifier" indiqué doit toujours être celui qui est configuré dans le nœud "Partager des données". En suivant l’exemple avec notre identifiant "academy-example", une fois récupéré, le code pourrait ressembler à ceci :

const identifier = "academy-example";

const getAndProcessSharedData = (identifier) => {
  const sharedData = window.connectif.managed.getSharedDataById(identifier);
  if (sharedData && sharedData.products.length > 0) {
    // process the data found according to need
  }
};

const handleSharedDataReceivedEvent = (event) => {
  if (event?.detail?.id === identifier) {
    getAndProcessSharedData(identifier);
  }
};

document.addEventListener(
  "connectif.managed.shared_data_received",
  handleSharedDataReceivedEvent
);

if (
  window.connectif &&
  window.connectif.managed
) {
  getAndProcessSharedData(identifier);
}
 

Succès ! 
Vous êtes arrivé à la fin de la leçon.

  

Vous avez encore des doutes ? 
N’oubliez pas que nos spécialistes Connectif sont à votre disposition. Pour les contacter, ouvrez simplement un ticket au Support en cliquant sur le bouton bleu “Aide” de votre tableau de bord.

 


Continuez à apprendre !

Pour exploiter tout le potentiel de votre compte Connectif, nous vous recommandons de poursuivre avec les articles suivants :