Recommandations et catalogue de produits
OneTrace.pro sélectionne des produits pour chaque client : produits populaires, « achetés ensemble », similaires, consultés récemment et sélection personnalisée. Les recommandations s'affichent sur le site, dans les e-mails, les parcours et les campagnes. Elles nécessitent un catalogue de produits et des événements de consultation, de panier et d'achat.
La section s'ouvre depuis le menu Engagement → Recommandations. Tous les membres du projet peuvent la consulter ; le « Propriétaire », l'« Administrateur » et le « Gestionnaire » peuvent connecter des flux, modifier les paramètres et lancer un recalcul.
Catalogue de produits
En haut de la page figurent le nombre de produits du catalogue, le nombre de produits disponibles et le nombre de catégories. Tant que le catalogue est vide, il n'y a rien à recommander : connectez un flux ou chargez des produits via l'API.
Connecter un flux
- Dans le bloc Flux de produits, cliquez sur Ajouter un flux.
- Indiquez un Nom et l'URL du flux (lien vers le fichier).
- Choisissez le Format : YML (Yandex), Google Merchant, CSV, JSON ou JSON Lines.
- Dans le champ Mise à jour, choisissez la fréquence de relecture du flux : toutes les 1, 3, 6 ou 12 heures, ou une fois par jour.
- Si le flux est protégé par un mot de passe ou un jeton, renseignez l'En-tête Authorization, par exemple
Bearer …. Il est stocké chiffré. - Cliquez sur Enregistrer. Le premier import démarre immédiatement.
Dans les fichiers CSV et JSON, les colonnes sont reconnues d'après leur nom : id, name ou title, url, image, price, old_price, currency, available, category, brand (les noms russes équivalents sont aussi reconnus). Les autres colonnes sont considérées comme des caractéristiques du produit. L'id du produit doit correspondre à celui que le site transmet dans les événements, sinon les actions des clients ne seront pas reliées au catalogue.
Chaque flux affiche son statut (Actif ou Échec), l'heure du dernier import et le résultat : nombre de produits et de catégories lus, et nombre de produits marqués indisponibles. Le bouton Mettre à jour maintenant lance un import hors planification. Mettre en pause arrête les imports planifiés (statut « En pause »), et Mettre à jour maintenant lève la pause. Un flux en échec est retenté selon la planification ; le texte de l'erreur s'affiche en dessous.
À savoir :
- Les produits qui ne figurent plus dans le flux sont marqués indisponibles, et non supprimés : l'historique de leurs événements est conservé, et un produit qui réapparaît dans le flux redevient disponible.
- La suppression d'un flux conserve ses produits dans le catalogue.
Copies des images
Dans les paramètres du flux, vous pouvez activer Copier les images des produits dans notre stockage. Les images des e-mails et des widgets sont alors servies par le CDN de OneTrace.pro et ne dépendent plus de la disponibilité de votre site.
- Télécharger au plus … images par seconde, minute ou heure : une limite pour ne pas surcharger votre site. Par défaut, 5 par seconde.
- Sous le flux s'affichent le nombre d'images copiées, en file d'attente et non téléchargées. Tant qu'il n'y a pas de copie (ou si l'adresse de l'image a changé dans le flux), l'image d'origine est affichée.
- Les copies sont décomptées de la limite de stockage d'images du forfait. Si l'interrupteur n'est pas disponible, le stockage d'images n'est pas configuré dans votre installation.
Chargement via l'API
Les développeurs peuvent charger et supprimer des produits par des requêtes vers https://cdp.onetrace.pro/api/v1/products, jusqu'à 1000 produits et catégories par requête. Une clé secrète avec l'autorisation « Charger et supprimer des produits » est requise, voir Clés API et Intégration côté serveur.
Événements pour les modèles
Dans le bloc Événements pour les modèles, indiquez quels événements correspondent aux actions sur les produits :
| Champ | Exemple |
|---|---|
| Consultation de produit | product_viewed |
| Ajout au panier | product_added |
| Achat | order_completed |
| Propriété de l'id du produit | product_id : un champ unique dans l'événement ou un tableau products[] contenant ce champ |
| Ne pas recommander les produits achetés | 30, 90 ou 365 jours ; « Recommander à nouveau » pour les consommables |
Par défaut, les événements sont repris des paramètres des prédictions. Après Enregistrer, les modèles sont recalculés.
Modèles et calcul nocturne
La carte Modèles affiche le statut (En attente, Calcul en cours, Prêt, Pas de catalogue, Échec), l'heure du calcul et le nombre de liens entre produits.
Les modèles sont recalculés chaque nuit, ainsi qu'immédiatement après l'enregistrement des paramètres et avec le bouton Recalculer. Pendant le calcul et en cas d'erreur, les recommandations sont servies à partir de la version précédente.
Outre les liens, le calcul écrit dans les profils les attributs favorite_category, favorite_brand et top_products. Vous pouvez les utiliser dans les segments, par exemple « catégorie préférée : chaussures ».
Types de recommandations
| Type | Ce qu'il affiche | Où l'utiliser |
|---|---|---|
| Personnalisées | une sélection d'après les consultations, paniers et achats du client, en tenant compte de ses actions du jour | page d'accueil, e-mail « Vous aimerez aussi » |
| Populaires | les produits les plus demandés sur 30 jours, dans tout le catalogue ou une catégorie | nouveau visiteur, panier vide |
| Tendances | les produits dont l'intérêt a augmenté au cours de la dernière semaine | page d'accueil, newsletter « Nouveautés de la semaine » |
| Consultés ensemble | ce qui est consulté avec ce produit | fiche produit |
| Achetés ensemble | ce qui est acheté avec ce produit | panier, e-mail après commande |
| Similaires | produits de la même catégorie : marque, prix, caractéristiques | fiche produit, rupture de stock |
| Consultés récemment | les dernières consultations du client | navigation abandonnée |
Un nouveau visiteur sans historique reçoit les produits populaires. Seuls les produits disponibles figurent dans les sélections.
Vérifier les résultats
Dans le bloc Vérifier les résultats, choisissez le Type et indiquez l'ID du produit, l'ID de catégorie ou l'ID du profil, selon le type. Cliquez sur Afficher pour voir les fiches des produits que le client recevra.
Rapport d'effet
Le tableau Effet sur le site sur 30 jours présente pour chaque type les impressions, clics, CTR, achats et revenus. Un achat est comptabilisé si le client a acheté le produit dans les 7 jours suivant un clic sur une recommandation ; le revenu est calculé au prix du catalogue. L'effet des recommandations dans les e-mails est visible dans les rapports des campagnes et des parcours.
Où afficher les recommandations
- Sur le site : widgets prêts à l'emploi de la section « Site web » ou appel du traceur, voir Widgets de recommandations sur le site.
- Dans les e-mails : le bloc Produits de l'éditeur d'e-mails. Vous y choisissez Quels produits, Combien, le nombre de colonnes, Afficher le prix et Bouton sous le produit. Pour les types « Consultés ensemble », « Achetés ensemble » et « Similaires », le produit est pris dans l'événement qui a déclenché l'e-mail (Propriété de l'événement contenant l'id du produit) : c'est ainsi qu'est construit l'e-mail de panier abandonné. S'il n'y a aucun produit adapté, le bloc n'est pas affiché dans l'e-mail.
- Dans les modèles de tous les canaux : la fonction
recommendations():
{% for product in recommendations('personal', 4) %}
<a href="{{ product.url }}">{{ product.name }}</a> — {{ product.price }}
{% endfor %}