Recommandations et catalogue de produits

OneTrace.ru 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

1. Dans le bloc Flux de produits, cliquez sur Ajouter un flux.
2. Indiquez un Nom et l'URL du flux (lien vers le fichier).
3. Choisissez le Format : YML (Yandex), Google Merchant, CSV, JSON ou JSON Lines.
4. 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.
5. 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é.
6. 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.ru 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.

Stock

Toutes les boutiques ne gèrent pas le stock, sa prise en compte s’active donc séparément : l’interrupteur Tenir compte du stock se trouve dans les réglages de chaque flux et, pour les produits de l’API et des plugins de boutique, dans la carte de réglages de la section (Tenir compte du stock de l’API et des plugins). Il est désactivé par défaut.

• Activé — le stock est enregistré et un produit à stock nul est retiré de la vente. Les fonctions basées sur le stock fonctionnent, par exemple les parcours « bientôt épuisé ». Dans un flux, le stock provient de <count> (YML), g:quantity (Google) ou de la colonne stock, quantity (CSV et JSON) ; dans l’API, du champ stock.
• Désactivé — le stock n’est pas utilisé : le produit suit la disponibilité du flux ou le champ available, même si la boutique envoie un stock nul.

Chargement via l'API

Les développeurs peuvent charger et supprimer des produits par des requêtes vers https://cdp.onetrace.ru/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.

Langues du catalogue

Si votre site est disponible en plusieurs langues, chargez les traductions des produits : les widgets, la recherche et les e-mails afficheront alors les noms et les liens dans la langue du client.

• Flux dans une autre langue. Ajoutez un second flux (le même export dans une autre langue) et choisissez sa Langue du flux. Un tel flux ne crée pas de produits et ne les marque pas indisponibles : il ajoute les traductions des noms, des liens et des caractéristiques aux produits du flux principal ayant les mêmes id. Le champ apparaît si le projet compte plusieurs langues, voir Paramètres du projet, forfait et audit.
• Via l'API. Transmettez les traductions dans le champ translations du produit et de la catégorie, par exemple "translations": {"en": {"name": "Linen dress", "url": "https://shop.example/en/linen-dress"}}.

La langue est choisie automatiquement : sur le site, c'est la langue du visiteur transmise par le traceur ; dans un e-mail, celle de sa version, voir Versions linguistiques. S'il n'existe pas de traduction dans cette langue, le nom et le lien principaux sont affichés. La recherche de produits trouve un produit d'après son nom dans n'importe laquelle des langues. Dans le tableau des produits, les langues dans lesquelles le produit est traduit apparaissent à côté de son nom.

É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 :

Par défaut, les événements sont repris des paramètres des prédictions, et les autres valeurs du secteur de la boutique. 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, ainsi que, pour les secteurs à tailles, pref_… (la taille du client, voir Secteur de la boutique) et replenish_at (la date « il est temps de racheter »). Vous pouvez les utiliser dans les segments, par exemple « catégorie préférée : chaussures ».

Types de recommandations

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 %}