Installation

Aperçu

Recommendations est le composant IA de Selligent by Zeta. Toutes les actions, y compris la collecte de données, la formation d'algorithmes et la réalisation de prédictions, sont gérées par Zeta. Cela rend Recommendations très simple à configurer et à utiliser.

Remarque: L'autorisation de lancement doit être définie pour accéder au module Recommendations.

Le processus de configuration se compose de deux étapes.

Insertion des balises :

  • Si vous utilisez Site, vous n'avez rien à faire.

  • Si vous n'utilisez pas Site, une balise Javascript doit être insérée sur les pages de votre site web.

Partage de catalogue :

  • Si votre catalogue de produits est déjà importé par Zeta lors du paramétrage Recommendations initial, vous n'avez rien à faire.

  • Si ce n'est pas le cas, vous devrez sélectionner le(s) fichier(s) de votre catalogue de produits qui se trouve(nt) sur une URL accessible au public (HTTP, HTTPS, FTP, FTPS, SFTP) au cours du paramétrage du catalogue Recommendations.

    Si le flux de votre catalogue de produits n'est pas encore disponible sur une URL accessible au public, veuillez exécuter l'une des étapes suivantes :

    • Créez un catalogue de produits exporté depuis votre CMS (Adobe Commerce, Prestashop, WooCommerce, Hybris, Websphere, Shopify, VTEX, etc).

      Remarque : L'exportation d'un catalogue de produits (flux) consiste simplement à exporter votre base de données de produits dans un fichier dont vous définissez vous-même le format et le contenu. La plupart des systèmes CMS fournissent des extensions permettant d'exporter les flux dans un format standard (Google Shopping, Shopzilla, CSV standard, etc.) et nous les prenons tous en charge. Consultez la documentation de votre CMS pour savoir comment procéder.


      -OU-

    • Créez une exportation de catalogue de produits à partir d'une liste Selligent. Cela peut se faire par le biais d'une exportation de données.

      -OU-

    • Créez une exportation du catalogue de produits à partir de toute autre source que vous utilisez.

    Une fois que l'exportation du flux du catalogue de produits est disponible, téléchargez-la sur une URL accessible au public (HTTP, HTTPS, FTP, FTPS, SFTP).
    Elle peut ensuite être sélectionné dans le paramétrage du catalogue Recommendations.

 

Insertion des balises

Si vous utilisez Recommendations sur votre site web pour afficher des sélections de produits dynamiques, vous devez insérer une balise JavaScript dans vos pages (si vous utilisez déjà Site, vous pouvez ignorer cette étape). Cet extrait de code JavaScript vous est fourni. Il est utilisé pour collecter les données comportementales et, sur la base de ces données, il affiche des sélections de produits en temps réel pendant que vos visiteurs surfent sur votre site web. Si vous n'insérez pas cette balise, Recommendations ne dispose d'aucune information à traiter et ne peut de ce fait pas afficher de sélections de produits sur vos pages.

Pour insérer la balise, vous devez copier l'extrait de code que vous trouverez sur la page Profil de votre compte et le coller dans les pages de votre site web. Si vous utilisez un CMS standard (Wordpress, Adobe Commerce, Prestashop ou encore Shopify), il vous suffit d'ajouter cet extrait dans l'un des templates de vos pages, dans l'idéal à la fin du code HTML avant la balise de fermeture body.

Avant l'insertion de la balise, vos pages HTML disposeront de la structure suivante :

Copier 
<!DOCTYPE html>
<html>
    <head>
        <title>Your awesome site's title</title>
    </head>
    <body>
        [...Loads of stuff here...]
    </body>
</html>

Une fois l'extrait JS Recommendations inséré, il ressemblera à ceci :

Copier 
<!DOCTYPE html>
<html>
    <head>
        <title>Your awesome site's title</title>
    </head>
    <body>
        [...Loads of stuff here...]
        <script type="text/javascript">
            [...The content of your tag...]
        </script>
    </body>
</html>

Une fois l'extrait inséré et les données collectées, vous recevrez une notification sur votre page Profil.

Maintenant que l'acquisition des données est finalisée, vous pouvez vérifier les paramètres de votre catalogue de produits ici.

 

Plus en détail

Si vous souhaitez en savoir plus sur le fonctionnement du module Recommendations, continuez votre lecture. L'application Recommendations est composée de 2 parties qui communiquent entre elles :

L'extrait JavaScript asynchrone décrit ci-dessus, qui est placé sur votre site et interagit avec les serveurs Recommendations. L'extrait JavaScript charge la bibliothèque JavaScript de Recommendations de manière asynchrone chaque fois qu'un visiteur charge une page de l'un des vos sites web.

Cet extrait lance différentes requêtes vers les serveurs Recommendations chaque fois qu'une page est chargée. L'action la plus importante exécutée par l'extrait est la séquence suivante :

Elle recherche le code HTML <div class="thRecommendations" data-widgetid="test"></div> à l'intérieur de la page HTML du client.

  • Si elle ne trouve rien, rien ne se passe.
  • Si elle trouve quelque chose, elle insère un contenu comprenant des sélections de produits graphiques dans le balisage HTML. Le balisage précédemment trouvé ressemblera alors à ce qui suit (les caractéristiques de ce contenu dépendent de la configuration que vous utilisez) :
Copier 
<div class="thRecommendations" data-widgetid="test">
    <iframe src=".. api CustomerX r..aHR09OT0lS?widgetid=test" width="256px" height="526px" id="thiframe" 
            frameborder="0" marginwidth="0" marginheight="0" scrolling="no" seamless="">[...]</iframe>
</div>

Graphiquement, ce balisage rend une liste d'images produit, sur la base de différents paramètres (l'historique de navigation des visiteurs, le contexte, la configuration Fournisseur). La liste des sélections de produits personnalisées est de ce fait affichée sur chaque page dans laquelle le code <div class="thRecommendations" data-widgetid="test"></div> est présent.

Cette manière d'ajouter un contenu dynamique dans la page est particulièrement pratique pour les marketers. Elle demande en effet très peu d'efforts d'intégration (insertion de la balise et configuration du flux de produits). Si vous souhaitez créer des fonctionnalités personnalisées, ou utiliser Recommendations comme technologie back-end ou à l'intérieur d'une application mobile native, vous pouvez effectuer la plupart de ces actions à l'aide de l'API Recommendations. Pour accéder à l'API, veuillez contacter l'équipe en charge de votre compte Zeta ou votre partenaire Zeta certifié.

Remarque: La documentation de l'API Recommendations est disponible ici.