Show Menu
SUJETS×

Intégration de Recommandations dans la messagerie électronique

Informations sur les méthodes d’intégration de la messagerie à Recommandations.
Les capacités de votre fournisseur de service de messagerie déterminent la méthode à utiliser. Votre gestionnaire de compte ou votre représentant peut vous aider à choisir l’option qui vous convient le mieux.

Option 1 : utilisation de l’API de diffusion

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

clientcode est votre code client Target.
Veillez à renseigner une valeur unique pour sessionId et tntId ou thirdPartyId pour chaque destinataire d’e-mail (par exemple, pour chaque appel d’API). Si vous ne fournissez pas de valeurs uniques pour ces champs, la réponse de l’API peut ralentir ou échouer en raison du grand nombre d’événements générés dans un seul profil.
Pour plus d’informations, voir la documentation relative à l’API de diffusion .

Option 2 : utilisation d’un modèle de courrier électronique 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 électronique (ESP). Puisque vous n’utilisez pas de fichier mbox.js 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 courriers électroniques.
Cette approche vous permet de suivre les performances des recommandations dans les messages électroniques, de les tester normalement avec une recommandation et de continuer le suivi sur le site.
Configurez une activité Recommendations dans Adobe 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 de message électronique. Au moment de la création du message, le fournisseur de service de messagerie lance un appel aux serveurs Adobe 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 électronique utilisé doit pouvoir gérer les scénarios suivants :
Une réponse valide est reçue, mais il n’y a aucune recommandation.
  • Dans ce cas, la réponse correspondra au paramètre mboxDefault défini. Consultez l’explication de ce paramètre ci-dessous.
  • Le fournisseur de services de messagerie doit avoir un bloc HTML de recommandations par défaut à utiliser dans ce cas.
Le serveur Target expire et revient sans aucune donnée.
  • Dans ce cas, le serveur Target renverra le contenu suivant :
    //ERROR: application server timeout
  • L’application de messagerie électronique doit rechercher le texte et être capable de gérer l’erreur. Le fournisseur de services de messagerie électronique peut gérer ce cas de plusieurs façons :
    • Émettre immédiatement un autre appel de serveur (recommandé, éventuellement avec un compteur de tentatives)
    • Ignorer ce message électronique et passer au suivant
    • Mettre en file d’attente ce message électronique et réexécuter par lots les messages en échec à la fin de la première exécution
Exemple d’URL de demande :
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 :
Pour utiliser Recommendations dans un e-mail, l’appel de rawbox doit généralement inclure le entity.id ou le entity.categoryId , ou les deux, selon le type de critère de recommandation. L’exemple d’appel ci-dessus inclut les deux paramètres.
Paramètre
Valeur
Description
Validation
client_code
client_code
Code du client utilisé dans Recommandations. Votre conseiller Adobe peut vous fournir cette valeur.
mbox
mboxName
Nom de la mbox utilisée pour le ciblage.
Même validation que pour tous les appels de mbox.
250 caractères maximum.
Ne peut pas contenir les caractères suivants : ', ", %22, %27, <, >, %3C, %3E
mboxXDomain
disabled
Empêche la réponse de définir un cookie dans un environnement non web.
entity.id
(Requis pour certains types de critères : affichage/affichage, affichage/achat, achat/achat)
entity_id
productId sur lequel repose la recommandation (produit abandonné dans le panier ou achat précédent, par exemple).
Si le critère l’exige, l’appel de rawbox doit inclure le paramètre entity.id .
entity.event.detailsOnly
true
Si entity.id est transmis, il est vivement recommandé de transmettre également ce paramètre afin d’empêcher que la requête n’incrémente le nombre d’affichages de page comptés pour un article, et de ne pas fausser les algorithmes basés sur l’affichage des produits.
entity.categoryId
(Requis pour certains types de critères : les plus consultés par catégorie et les meilleurs vendeurs par catégorie)
category_id
Catégorie sur laquelle repose la recommandation (meilleurs vendeurs dans une catégorie, par exemple).
Si le critère l’exige, l’appel de rawbox doit inclure le paramètre entity.categoryId .
mboxDefault
https://www.default.com
Si le paramètre mboxNoRedirect est absent, mboxDefault doit être une URL absolue qui renverra le contenu par défaut si aucune recommandation n’est disponible. Il peut s’agir d’une image ou d’un autre contenu statique.
Si le paramètre mboxNoRedirect est présent, mboxDefault peut être n’importe quel texte indiquant qu’il n’y a aucune recommandation, par exemple no_content .
Le fournisseur de services de messagerie électronique devra gérer le cas où cette valeur est renvoyée et insérer le code HTML par défaut dans le message électronique.
mboxHost
mbox_host
Domaine qui est ajouté à l’environnement par défaut (groupe d’hôtes) lors du déclenchement de l’appel.
mboxPC
Empty
(Obligatoire pour les recommandations qui utilisent un profil de visiteur.)
Si aucun « thirdPartyId » n’a été fourni, un nouvel tntId est généré et renvoyé dans la réponse. Sinon, il reste vide.
Remarque  : Veillez à fournir une valeur unique pour mboxSession et mboxPC pour chaque destinataire d’e-mail (par exemple, pour chaque appel d’API). Si vous ne fournissez pas de valeurs uniques pour ces champs, la réponse de l’API peut ralentir ou échouer en raison du grand nombre d’événements générés dans un seul profil.
1 < Longueur < 128
ne peut pas contenir plus d’un seul « . » point ( . ).
Le seul point autorisé est utilisé pour le suffixe d’emplacement du profil.
Paramètres facultatifs  :
Paramètre
Valeur
Description
Validation
mboxPC
(Facultatif)
mboxPCId
Identifiant visiteur Target. Utilisez cette valeur pour effectuer le suivi du cycle complet d’un utilisateur qui revient sur votre site au cours de plusieurs visites ou lors de l’utilisation d’un paramètre de profil utilisateur.
Cette valeur doit correspondre au PCID Adobe Target réel de l’utilisateur, qui serait exporté du site web vers votre service de gestion de la relation client (CRM). Le fournisseur de services de messagerie électronique récupère cet identifiant auprès de votre système de gestion de la relation client ou Data Warehouse, puis l’utilise comme valeur de ce paramètre.
La valeur mboxPC s’avère également utile pour le suivi du comportement des visiteurs du site au cours de plusieurs visites et pour le suivi des mesures quand une recommandation fait partie d’une activité A/B.
Remarque  : Veillez à fournir une valeur unique pour mboxSession et mboxPC pour chaque destinataire d’e-mail (par exemple, pour chaque appel d’API). Si vous ne fournissez pas de valeurs uniques pour ces champs, la réponse de l’API peut ralentir ou échouer en raison du grand nombre d’événements générés dans un seul profil.
1 < Longueur < 128
Ne peut pas contenir plus d’un seul « . » point ( . ).
Le seul point autorisé est utilisé pour le suffixe d’emplacement du profil.
mboxNoRedirect
(Facultatif)
1
Par défaut, l’appelant est redirigé quand aucun contenu livrable n’est trouvé. Utilisez-le pour désactiver le comportement par défaut.
mbox3rdPartyId
xxx
Utilisez ce paramètre si vous utilisez votre propre identifiant visiteur personnalisé pour le ciblage des profils.
Réponses potentielles du serveur Target  :
Réponse
Description
//ERROR:
Générée par l’équilibreur de charge quand il ne peut renvoyer aucun contenu.
success
Le paramètre mboxNoRedirect est défini sur « true » (vrai) et le serveur ne renvoie aucune recommandation (c.-à-d. qu’il n’y a aucune correspondance pour la mbox ou que la mémoire cache du serveur n’est pas initialisée).
bad request
Il manque le paramètre mbox .
  • Le paramètre mboxDefault ou mboxNoRedirect n’est pas spécifié.
  • Le paramètre de requête mboxTrace est spécifié, mais pas mboxNoRedirect .
  • Le paramètre mboxTarget n’est pas spécifié si les noms de mbox se terminent par le suffixe -clicked .
Cannot redirect to default content, please specify mboxDefault parameter
mboxDefault non spécifié quand il n’existe aucune correspondance pour la demande et que le paramètre mboxNoRedirect n’est pas spécifié.
Invalid mbox name:= MBOX_NAME
Indique que le paramètre mbox contient des caractères incorrects.
Mbox name [MBOX_NAME] is too long
Indique que le paramètre mbox contient plus de 250 caractères.

Option 3 : utilisation du modèle Téléchargement uniquement

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 .