Récupération de Recommendations avec l'API de Diffusion

Les API Adobe Target et Adobe Target Recommendations peuvent être utilisées pour fournir des réponses aux pages Web, mais peuvent également être utilisées dans des expériences non HTML, y compris les applications, écrans, consoles, courriels, kiosques et autres périphériques d’affichage. En d’autres termes, lorsque les bibliothèques Target et JavaScript ne peuvent pas être utilisées, l’API de Diffusion Target nous permet toujours d’accéder à la gamme complète de fonctionnalités Target pour fournir 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 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), un nom de mbox approprié, des paramètres de mbox, des paramètres de profil ou d’autres attributs. La réponse inclura des 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 le périphérique.

L’API de Diffusion pour Adobe Target présente 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 de manière RESTful.
  • Ne nécessite aucune authentification.
  • Uniquement les publications.
  • Ne traite pas les cookies ou les appels de redirection.
  • Ne nécessite pas ou ne reconnaît pas les "rôles utilisateur". Il récupère simplement le contenu ou les événements de rapports sur les serveurs Edge Target.

Pour utiliser l’API de Diffusion pour diffuser 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 pouvant être utilisées avec l’API de Diffusion, utilisez le compositeur basé sur les formulaires.

  1. Tout d’abord, créez et enregistrez une conception JSON à utiliser dans votre recommandation. Pour un exemple de fichier JSON, plus des informations d’arrière-plan sur la façon dont les réponses JSON peuvent être renvoyées lors de la configuration d’une activité basée sur un formulaire, consultez la documentation sur 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.

    server-side-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.
    server-side-create-recs-form.png

  5. Enregistrez et activez la recommandation. Il 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 peut être trouvé en 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, générez votre appel d’API de Diffusion. L’exemple ci-dessous commence par l’appel de l’API de Diffusion des mbox Web liées fourni dans la collection Postman de l’API de Diffusion , en apportant les modifications appropriées. Par exemple :
    • les objets browser et address ont été supprimés du Body, car ils ne sont pas requis pour les cas d'utilisation non HTML.

    • api_ charteris est répertorié comme nom d’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 active soit transmise à Target.

      server-side-Diffusion-API-call.
      pngSouvenez-vous de configurer correctement vos paramètres de requête. Par exemple, veillez à spécifier
      {{CLIENT_CODE}} si nécessaire.
      client-code3

  3. Envoyez la demande. Cette opération s’exécute par rapport à l’emplacement api_charter, sur lequel une recommandation principale est exécutée, défini avec votre conception JSON 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 comprend 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 les recommandations au visiteur sur le périphérique non 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’un CMS, un PIM ou une plateforme de commerce électronique), avant d’afficher les résultats finaux.

En suivant l'approche décrite dans ce tutoriel, vous pouvez obtenir n'importe quelle application pour tirer parti de la réponse de Target pour fournir des recommandations personnalisées !

Exemple de mises en œuvre

Les ressources suivantes fournissent des exemples d’implémentations non axées sur HTML. Gardez à l’esprit que chaque implémentation sera unique en raison du système et des périphériques impliqués.

Ressource Détails
Consommation d'API RESTful dans AEM Comment créer et déployer un lot Adobe Experience Manager OSGi qui consomme des données d’un service Web RESTful tiers.
Adobe Target Everywhere - Mise en oeuvre côté serveur ou dans l’IoT Adobe Summit 2019 Lab qui fournit une expérience pratique pour une application React qui exploite les API côté serveur Adobe Target.
Adobe Target dans une application mobile sans le SDK Adobe Ce guide vous explique comment configurer l’Adobe Target dans votre application mobile sans installer le Adobe SDK. Cette solution utilise la vue Web Tealium SDK 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 Procédure de configuration de l'extension Target dans l'Experience Platform Launch, d'ajout de l'extension Target à votre application et d'implémentation des API Target pour demander des activités, prérécupérer des offres et entrer en mode prévisualisation visuelle.
Client de noeud Adobe Target Kit 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 de lot côté serveur, le SDK Node.js et les API Adobe Target Recommendations.
Recommendations de contenu Adobe Campaign par courriel Blog qui décrit comment exploiter les recommandations de contenu dans les courriels via Adobe Target et Adobe I/O Runtime à Adobe Campaign.

Gestion de la configuration Recommendations avec les API

La plupart du temps, les recommandations sont configurées dans l’interface utilisateur 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 IU-API est courante. Cependant, il arrive parfois que les utilisateurs souhaitent exécuter toutes les actions par le biais d’API, à la fois par la configuration et 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 antérieure 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 API Recommendations se trouve ici, mais voici un résumé pour référence.

Ressource Détails
Collections Liste, création, obtention, modification et suppression de collections.
Critères Liste et obtenir des critères.
Conceptions Liste, création, obtention, modification, suppression et validation de conceptions.
Entités Enregistrez, supprimez et obtenez des entités.
Promotions Liste, création, obtention, modification et suppression de promotions.
Critères de catégorie Liste, créer, obtenir, modifier et supprimer des critères de catégorie.
Critères personnalisés Liste, création, obtention, modification et suppression de critères personnalisés.
Critères d'article Liste, création, obtention, modification et suppression de critères d’élément.
Critères de popularité Liste, créer, obtenir, modifier et supprimer des critères de popularité.
Critères d’attribut de profil Liste, création, obtention, modification et suppression de critères d’attribut de profil.
Critères récents Liste, créer, obtenir, modifier et supprimer des critères récents.
Critères de séquence Liste, création, obtention, modification et suppression de critères de séquence.

Documentation de référence

Résumé et révision

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

Sur cette page