Recommandations de contenu via un flux JSON

Des recommandations de contenu fournies en JSON brut plutôt que sous forme de widget déjà rendu, pour que vous les affichiez dans votre propre mise en page. Idéal pour un carrousel sur mesure, une application monopage, une application native, ou un bloc « vous aimerez aussi » qui doit correspondre exactement à votre propre design system.

Dans le panneau : Nouvelle campagne › App / API › API JSON — Recommandations de contenu.

Les étapes

Six étapes : Catalogue, Interactions, Recommandation, Données de la réponse, Code et Performance.

1. Catalogue

Votre catalogue de contenu — articles, guides, vidéos. Chaque élément a besoin d’un ID interne, d’un titre et d’une URL, plus une image si votre mise en page en utilise une. Les catégories et les tags méritent d’être bien renseignés : ce sont eux qui permettent aux recommandations de suivre un sujet plutôt que la seule popularité générale.

2. Interactions

Le moteur apprend de ce que les gens lisent, aiment, commentent et terminent. Comme c’est vous qui affichez le JSON, c’est à vous de signaler ces interactions — Personyze ne peut pas déduire une lecture d’une mise en page qu’il n’a pas dessinée.

Sauter cette étape est la raison habituelle pour laquelle une recommandation de contenu JSON renvoie la même liste générique à tout le monde : elle n’a aucun historique de lecture sur lequel se personnaliser.

3. Recommandation

Choisissez le contexte — page d’accueil, page d’article, page de catégorie — et l’algorithme. Les modificateurs disponibles :

Fenêtre temporelle — aujourd’hui, récemment, les derniers jours, la dernière semaine, ou toute la durée.
Portée de catégorie — toutes les catégories, ou la catégorie de l’article actuel.
Portée d’intérêt — à partir des centres d’intérêt déduits du visiteur.
Fraîcheur et ordre — les plus récents d’abord, les plus anciens d’abord, ajoutés récemment, ou nouveaux depuis la dernière visite du visiteur.
Co-occurrence — vus ensemble dans la catégorie actuelle.

Les filtres restreignent encore le choix — type de contenu, tag, catégorie, ou tout champ personnalisé de votre flux.

Voir Types d’algorithmes de recommandation pour le détail des algorithmes.

4. Données de la réponse

Personyze génère un tableau JSON d’objets, chacun contenant les champs que vous sélectionnez. Vous définissez ici votre propre contrat de réponse : choisissez exactement ce dont votre moteur d’affichage a besoin.

Pour chaque champ, choisissez le champ source de votre catalogue et donnez-lui le nom de clé voulu dans la sortie. Une sélection typique pour du contenu :

[
  {
    "internal_id": "nw-a001",
    "title": "How to layer for winter hiking",
    "category": "Skills",
    "image_1": "https://example.test/img/layering.jpg",
    "url": "https://example.test/journal/how-to-layer-for-winter-hiking"
  },
  ...
]

5. Code

L’assistant produit l’extrait à intégrer. Deux façons de l’utiliser :

Sur une page — l’extrait affecte le tableau JSON à une variable JavaScript que vous nommez, et votre propre code l’affiche.
Côté serveur ou depuis une application — appelez /rest/tracker-v1 et lisez le JSON dans le champ data de l’action correspondante. Voir Mettre en œuvre une application de recommandations personnalisée.

6. Performance

Les résultats une fois en ligne — limités par ce que vous signalez en retour, comme indiqué plus haut.

Remarque : il n’y a pas d’étape QA

Les campagnes API JSON n’ont pas d’étape QA, car il n’y a aucun contenu rendu à prévisualiser. Validez en récupérant le JSON et en le vérifiant vous-même : le bon nombre d’éléments, les champs sélectionnés présents, et des valeurs remplies plutôt que vides.

Voir aussi

API JSON — Recommandations de produits
Assistant Recommandations de contenu — la version sous forme de widget rendu.
Objet articles dans l’API REST.