Récupération de Recommendations avec l’API de diffusion

Les API Adobe Target et Adobe Target Recommendations peuvent être utilisées pour envoyer des réponses aux pages web, mais également dans des expériences non HTMLS, y compris les applications, écrans, consoles, emails, kiosques et autres périphériques d’affichage. En d’autres termes, lorsque les bibliothèques Target et JavaScript ne peuvent pas être utilisés, l’ TargetAPI de diffusion nous permet toujours d’accéder à l’ensemble des fonctionnalités Target pour offrir des expériences personnalisées.

REMARQUE

Lorsque vous demandez du contenu contenant des recommandations réelles (produits ou éléments recommandés), utilisez l’API de diffusion Target.

Pour récupérer les recommandations, envoyez un appel du POST de l’API de diffusion Adobe Target avec les informations contextuelles appropriées, qui peuvent inclure un ID utilisateur (à utiliser avec des recommandations spécifiques au profil telles que les éléments récemment consultés par l’utilisateur), le nom de mbox approprié, les paramètres de mbox, les paramètres de profil ou d’autres attributs. La réponse comprend les entity.ids recommandés (et peut inclure d’autres données d’entité) au format JSON ou HTML, qui peuvent ensuite être affichés sur l’appareil.

L’ API de diffusion pour Adobe Target expose toutes les fonctionnalités existantes fournies par une requête Target standard.

REMARQUE

L’API de diffusion :

  • Permet de récupérer des expériences ou des offres pour un emplacement et une audience d’une manière RESTful.
  • Ne nécessite aucune authentification.
  • Publications uniquement.
  • Ne traite pas les cookies ni les appels de redirection.
  • Ne nécessite ni ne reconnaît les "rôles utilisateur". Il récupère simplement du contenu ou signale des événements sur les serveurs Edge Target.

Pour utiliser l’API de diffusion pour diffuser des Target expériences, y compris des recommandations, procédez comme suit :

  1. Créez une activité Target (A/B, XT, AP ou Recommendations) à l’aide du compositeur d’après les formulaires (et non du compositeur d’expérience visuelle).
  2. Utilisez l’API de diffusion pour obtenir une réponse aux requêtes générées par l’activité Target que vous venez de créer.

Création d’une recommandation à l’aide du compositeur d’expérience d’après les formulaires

Pour créer des recommandations qui peuvent être utilisées avec l’API de diffusion, utilisez le compositeur d’après les formulaires.

  1. Tout d’abord, créez et enregistrez une conception basée sur JSON à utiliser dans votre recommandation. Pour obtenir un exemple de code JSON, ainsi que des informations d’arrière-plan sur la manière dont les réponses JSON peuvent être renvoyées lors de la configuration d’une activité basée sur les formulaires, consultez la documentation sur la création de conceptions de recommandations. Dans cet exemple, la conception est nommée JSON simple.

    côté serveur-create-recs-json-design.png

  2. Dans Target, accédez à Activités > Créer une activité > Recommendations, puis sélectionnez Formulaire.

    côté serveur-create-recs.png

  3. Sélectionnez une propriété, puis cliquez sur Suivant.

  4. Définissez l’emplacement où vous souhaitez que les utilisateurs reçoivent la réponse de la recommandation. L’exemple ci-dessous utilise un emplacement nommé api_charter. Sélectionnez votre conception basée sur JSON, créée précédemment, nommée JSON simple.
    côté serveur-create-recs-form.png

  5. Enregistrez et activez la recommandation. Cela produira des résultats. Une fois les résultats prêts, vous pouvez utiliser l’API de diffusion pour les récupérer.

Utilisation de l’API de diffusion

La syntaxe de l’API de diffusion est la suivante :

POST https://{{CLIENT_CODE}}.tt.omtrdc.net/rest/v1/delivery

  1. Notez que le code client est requis. Pour rappel, votre code client se trouve dans Adobe Target en accédant à Recommendations > Paramètres. Notez la valeur Code client dans la section Jeton API de recommandation .
    client-code.png
  2. Une fois que vous disposez de votre code client, créez votre appel API de diffusion. L’exemple ci-dessous commence par l’appel de l’API de remise des mbox Web mise en cache fourni dans la collection Postman de l’API de diffusion, en apportant des modifications pertinentes. Par exemple :
    • les objets browser et address ont été supprimés du Body, car ils ne sont pas nécessaires pour les cas d’utilisation non HTMLS.

    • api_ charteris est répertorié comme nom de l’emplacement dans cet exemple

    • entity.id est spécifié, car cette recommandation est basée sur la similarité de contenu, ce qui nécessite qu’une clé d’élément actif soit transmise à Target.

      server-side-Delivery-API-call.
      pngN’oubliez pas de configurer correctement vos paramètres de requête. Par exemple, veillez à spécifier
      {{CLIENT_CODE}} selon les besoins.
      client-code3

  3. Envoyez la requête. Cette opération s’exécute par rapport à l’emplacement api_charter, qui comporte une recommandation principale qui s’exécute dessus, définie avec votre conception JSON et qui génère une liste d’entités recommandées.
  4. Recevez une réponse basée sur la conception JSON.
    server-side-create-recs-json-response2.
    pngLa réponse inclut l’identifiant de clé, ainsi que les identifiants d’entité des entités recommandées.

L’utilisation de l’API de diffusion avec Recommendations permet ainsi d’effectuer des étapes supplémentaires avant d’afficher des recommandations au visiteur sur un périphérique autre que le périphérique HTML. Par exemple, vous pouvez utiliser la réponse de l’API de diffusion pour effectuer une recherche supplémentaire en temps réel des détails d’attribut d’entité (inventaire, prix, évaluation, etc.) à partir d’un autre système (tel qu’une plateforme CMS, PIM ou eCommerce), avant d’afficher les résultats finaux.

Grâce à l’approche décrite dans ce tutoriel, vous pouvez obtenir n’importe quelle application pour exploiter la réponse de Target afin de fournir des recommandations personnalisées.

Exemple de mises en œuvre

Les ressources suivantes fournissent des exemples de différentes mises en oeuvre non axées sur les HTMLS. Gardez à l’esprit que chaque mise en oeuvre sera unique en raison du système et des périphériques impliqués.

Ressource Détails
Adobe Target partout : implémentation côté serveur ou dans IoT Adobe Summit 2019 Lab qui offre une expérience pratique pour une application React qui tire parti des API côté serveur Adobe Target.
Adobe Target dans une application mobile sans SDK Adobe Ce guide explique comment configurer Adobe Target dans votre application mobile sans installer le SDK Adobe. Cette solution utilise l’affichage web du SDK Tealium et le module Commandes distantes pour envoyer et recevoir des requêtes à l’API visiteur Adobe (Experience Cloud) et à l’API Adobe Target.
Fonctionnement d’Adobe Target dans les applications mobiles Fonctionnement de Target avec le SDK Mobile
Configuration Target extension in Experience Platform Launch and Implementing Target des API Étapes de configuration de l’extension Target dans Experience Platform Launch, ajout de l’extension Target à votre application et implémentation des API Target pour demander des activités, prérécupérer des offres et passer en mode aperçu visuel.
Client de noeud Adobe Target SDK Open Source Target Node.js v1.0
Présentation côté serveur Informations sur les API de diffusion côté serveur Adobe Target, les API de diffusion par lots côté serveur, le SDK Node.js et les API Recommendations Adobe Target.
Recommendations de contenu Adobe Campaign dans Email Blog qui décrit comment exploiter les recommandations de contenu dans les emails via Adobe Target et Adobe I/O Runtime dans Adobe Campaign.

Gestion de la configuration Recommendations avec les API

La plupart du temps, les recommandations sont configurées dans l’interface utilisateur d’Adobe Target, puis utilisées ou accessibles via les API Target, pour des raisons telles que celles mentionnées dans les sections ci-dessus. Cette coordination entre l’interface utilisateur et l’API est courante. Cependant, il arrive parfois que les utilisateurs souhaitent effectuer toutes les actions via les API (configuration, ainsi que l’utilisation des résultats). Bien que beaucoup moins courant, les utilisateurs peuvent absolument configurer, exécuter, et exploiter les résultats des recommandations entièrement à l’aide des API.

Nous avons appris dans une section précédente comment gérer les entités Recommendations Adobe Target et les diffuser côté serveur. De même, Adobe I/O vous permet de gérer les critères, les promotions, les collections et les modèles de conception sans avoir à vous connecter à Adobe Target. Une liste complète de toutes les Recommendations API se trouve ici, mais voici un résumé à titre de référence.

Ressource Détails
Collections Répertorier, créer, obtenir, modifier et supprimer des collections
Critères Listez et obtenez des critères.
Conceptions Répertorier, créer, obtenir, modifier, supprimer et valider des conceptions.
Entités Enregistrez, supprimez et obtenez des entités.
Promotions Répertorier, créer, obtenir, modifier et supprimer des promotions.
Critères de catégorie Répertorier, créer, obtenir, modifier et supprimer des critères de catégorie.
Critères personnalisés Répertorier, créer, obtenir, modifier et supprimer des critères personnalisés.
Critères d’élément Répertorier, créer, obtenir, modifier et supprimer des critères d’élément.
Critères de popularité Répertorier, créer, obtenir, modifier et supprimer des critères de popularité.
Critères d’attribut de profil Répertorier, créer, obtenir, modifier et supprimer des critères d’attribut de profil.
Critères récents Répertorier, créer, obtenir, modifier et supprimer des critères récents.
Critères de séquence Lister, créer, obtenir, modifier et supprimer des critères de séquence.

Documentation de référence

Résumé et révision

Félicitations ! En terminant ce tutoriel, vous avez appris à :

Sur cette page