[Premium]{class="badge positive" title="Découvrez les fonctionnalités incluses dans Target Premium."}

Intégrer Recommendations avec le courrier électronique

Adobe Target prend en charge la personnalisation au moment de l’envoi des recommandations dans les e-mails.

Trois méthodes sont disponibles pour intégrer Target Recommendations à votre fournisseur de service de messagerie (ESP). Les capacités de votre fournisseur de service de messagerie déterminent la méthode à utiliser. Votre gestionnaire de compte ou votre consultant peut vous aider à choisir l’option qui vous convient le mieux.

L’utilisation de la méthode 1 ou de la méthode 2 nécessite que votre fournisseur de service de messagerie effectue des appels à une API externe par client/par e-mail et attende que le contenu soit renvoyé. Ces méthodes ne sont pas prises en charge par tous les fournisseurs de service de messagerie. Contactez votre fournisseur pour déterminer s’il est compatible avec ce modèle d’intégration.

L’utilisation de la méthode 3 nécessite que votre fournisseur de service de messagerie rejoigne une liste de recommandations par ID de produit ou ID de catégorie à votre liste d’e-mails. Cette méthode peut être basée sur un attribut tel que le dernier produit consulté par le client, le dernier produit acheté ou la catégorie la plus consultée. Cependant, votre fournisseur de service de messagerie doit avoir accès à ces données dans son profil client pour effectuer la jointure. Contactez votre fournisseur de service de messagerie pour déterminer s’il a accès à ces données et s’il est compatible avec ce modèle d’intégration.

La personnalisation en temps ouvert des recommandations n’est pas prise en charge par Adobe Target.

Méthode 1 : utilisation de l’API de diffusion (privilégiée) delivery-api

L’API de diffusion est une requête POST qui fonctionne avec un courrier électronique au moment de la génération. Cette option est la méthode privilégiée pour le courrier électronique au moment de la génération.

Peu de clients de messagerie autorisant les requêtes POST, il est déconseillé d’utiliser cette API pour les cas d’utilisation à l’ouverture. Certains clients de messagerie, dont Gmail et Outlook, peuvent mettre en cache le contenu ou bloquer l’image et exiger que le destinataire autorise l’image de manière proactive pour qu’elle s’affiche.

Vous ne pouvez pas renvoyer le contenu par défaut à l’aide de l’API de diffusion.

Le code suivant est un exemple de requête de diffusion d’API :

curl -X POST \
  'https://clientcode.tt.omtrdc.net/rest/v1/mbox/?client=clientcode' \
  -H 'authorization: Bearer 3423614b-4843-4664-83c4-c6c3f6c8869b' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -d '{
  "mbox" : "email-mbox",
  "tntId" : "111499796294071-449025.28_44",
  "requestLocation" : {
    "host" : "prod"
  },
   "profileParameters" : {
   },
  "mboxParameters" : {
    "at_property": "b468a242-64a4-32a0-ca0c-890bddd78789",
    "entity.id": "article-123",
    "entity.event.detailsOnly" : "true"
  }
  "contentAsJson":  true
}'

Où clientcode est votre code client Target.

Pour plus d’informations, consultez la documentation de l’API de diffusion .

Méthode 2 : utilisation d’un modèle d’e-mail rawbox rawbox

Une rawbox est identique à une demande de mbox, à ceci près qu’elle concerne les environnements non web, comme les fournisseurs de service de messagerie (ESP). Puisque vous n’utilisez pas de fichier Adobe Experience Platform Web SDK ou at.js dans les demandes de rawbox, vous devez créer les demandes manuellement. Consultez les exemples ci-dessous pour savoir comment fonctionnent les demandes de rawbox dans les e-mails.

Cette approche vous permet de suivre les performances des recommandations dans les e-mails, de les tester normalement avec une recommandation et de continuer le suivi sur le site.

Configurez une activité Recommendations dans Target en utilisant l’option Compositeur d’expérience d’après les formulaires. Pour l’emplacement, sélectionnez le nom de la mbox que vous avez choisi d’utiliser dans la demande de rawbox issue du fournisseur de service de messagerie électronique. Choisissez un modèle d’e-mail. Au moment de la création du message, le fournisseur de service de messagerie lance un appel aux serveurs Target pour chaque rawbox dans chaque message généré. Votre fournisseur de service de messagerie électronique doit avoir un moyen d’inclure le code HTML renvoyé dans le message électronique envoyé.

Le système de messagerie que vous utilisez doit pouvoir gérer les scénarios suivants :

Une réponse valide est reçue, mais il n’y a aucune recommandation.

Le serveur Target expire et aucune donnée n’est renvoyée.

Exemple d’URL de requête

https://client_code.tt.omtrdc.net/m2/client_code/ubox/raw?mbox=mbox_name&mboxSession=1396032094853-955654&mboxPC=1396032094853-955654&mboxXDomain=disabled&entity.event.detailsOnly=true&mboxDefault=nocontent&mboxNoRedirect=1&entity.id=2A229&entity.categoryId=5674

Paramètres requis : reqparams

Paramètres facultatifs

Réponses potentielles du serveur Target

Méthode 3 : utilisation de l’API de téléchargement Recommendations download-api

Configurez une recommandation comme vous le faites habituellement, mais choisissez télécharger uniquement dans la section de présentation au lieu d’une combinaison modèle/mbox. Indiquez ensuite au fournisseur de services de messagerie le code de recommandation que vous avez créé. Le fournisseur de services de messagerie accède aux données de la recommandation au moyen d’une API. Ces données indiquent les articles à recommander pour une catégorie ou un article clé, tels que les articles d’un panier abandonné. Le fournisseur de services de messagerie stocke ces données, les associe à sa propre apparence, affiche des informations sur chaque article, puis les envoie dans les messages.

Avec cette option, le serveur de recommandations ne peut pas directement suivre les performances d’une recommandation, ni répartir le trafic entre plusieurs combinaisons algorithme/modèle. En outre, les recommandations ne sont liées à aucun profil du visiteur.

Pour plus d’informations sur l’API de téléchargement, voir API héritées > Téléchargement.