Dans cet exercice, vous allez configurer l’événement et le parcours qui doivent être déclenchés lorsqu’une personne aime un produit dans le cadre du flux de chatterbot.
Connectez-vous à Journey Orchestration en vous rendant à Adobe Experience Cloud.
Cliquez sur Journey Orchestration.
Vous serez redirigé vers la vue Parcours dans Journey Orchestration.
Tout d’abord, assurez-vous d’utiliser l’environnement de test approprié. L’environnement de test à utiliser est appelé --aepSandboxId--
. Pour passer d’un environnement de test à un autre, cliquez sur Production Prod (VA7) et sélectionnez l’environnement de test dans la liste. Dans cet exemple, l’environnement de test est nommé AEP Enablement FY21.
Vous vous trouvez ensuite dans la vue Accueil de votre environnement de test --aepSandboxId--
.
Dans le menu, cliquez sur Événements.
Sur l’écran Événements, une vue similaire s’affiche. Cliquez sur le bouton Ajouter.
Une configuration d’événement vide s’affiche alors.
Tout d’abord, attribuez un nom à votre événement comme suit : ldapAddToCartEvent et remplacez ldap par votre ldap et ajoutez une description du type Ajouter à l’événement de panier.
La sélection suivante correspond au Type d’ID d’événement. Sélectionnez Généré par le système
La sélection de schéma suivante s’affiche. Un schéma a été préparé pour cet exercice. Utilisez le schéma Système de démonstration - Schéma d’événement pour le site web (Global v1.1) v.1.
Après avoir sélectionné le schéma, plusieurs champs sont sélectionnés dans la section Payload. Il n’est pas nécessaire d’ajouter des champs.
Cliquez sur Enregistrer pour enregistrer vos modifications.
Votre événement est maintenant configuré et enregistré.
Cliquez à nouveau sur votre événement pour ouvrir à nouveau l’écran Modifier l’événement .
Passez la souris sur le champ Payload pour afficher trois icônes.
Cliquez sur l’icône Afficher. Vous verrez maintenant un exemple de la charge utile attendue.
Votre événement comporte un eventID d’orchestration unique, que vous pouvez trouver en faisant défiler la charge vers le bas jusqu’à ce que _experience.campaign.orchestration.eventID s’affiche.
L’identifiant d’événement est ce qui doit être envoyé à Adobe Experience Platform pour déclencher le Parcours que vous allez créer ensuite. Souvenez-vous de cet eventID, car vous en aurez besoin dans l’un des exercices suivants.
"eventID": "8f38f6c9bc62d0617d0cf8d151921ad537f00c138cc4420a27624d9231e27aae"
Cliquez sur Ok et cliquez sur Enregistrer pour fermer la fenêtre contextuelle de votre événement.
Accédez à https://experience.adobe.com/#/data-collection/ et ouvrez votre propriété web.
Dans le menu de gauche, sélectionnez Éléments de données, recherchez l’élément de données ruleAddToCart et ouvrez cet élément de données.
Dans la configuration de cet élément de données SDK Web, accédez à _experience.campaign.orchestration.eventID et collez l’eventID de l’événement que vous avez créé à l’étape précédente.
Cliquez sur Enregistrer ou Enregistrer dans la bibliothèque.
Dans la collecte de données Adobe Experience Platform, accédez à Flux de publication et ouvrez votre Bibliothèque de développement qui est nommée Bibliothèque de contenu. Cliquez sur + Ajouter toutes les ressources modifiées, puis sur Enregistrer et créer pour le développement. Vos modifications seront désormais publiées sur votre site web de démonstration.
Dans cet exercice, vous allez créer une source de données externe pour connecter le Journey Orchestration à Offer Decisioning.
Dans le menu, cliquez sur Sources de données.
Vous verrez ensuite la liste Sources de données.
Cliquez sur Ajouter pour commencer à ajouter votre source de données.
Une fenêtre contextuelle de source de données vide s’affiche.
En tant que nom de la source de données, utilisez ldapXrayGetOffersInfo
et remplacez ldap
par votre LDAP. Dans cet exemple, le nom de la source de données est vangeluwXrayGetOffersInfo
.
Définissez la description sur : Retrieve Offers from Offer Decisioning
.
L’URL que vous devez utiliser est la suivante : --jwtOfferDecisioning--
. Dans cet exemple, l’URL est https://vangeluw.adobeio-static.net/api/v1/web/aepxrayINTENAB-1.0/getOfferForCustomer.json.
Pour que l’authentification soit utilisée, sélectionnez Aucune authentification.
Vous devez maintenant définir un premier FieldGroup, qui est essentiellement le nom de la demande que vous enverrez à l’API Offer Decisioning. Utilisez cette convention d’affectation des noms : ldapGetOfferText
donc dans ce cas, le nom doit être vangeluwGetOfferText
Vous devez également spécifier 5 valeurs dynamiques : eventId,eventNS,placementId,activityId,containerId
.
Définissez ensuite la Durée du cache sur 1 minute.
Vous devez maintenant disposer des éléments suivants :
Pour le payload de réponse, vous devez coller un exemple de la réponse qui sera envoyée par l’API d’Offer decisioning. Copiez la réponse JSON ici :
{
"offerResponse": {
"ode:createDate": 1605829730428,
"xdm:factors": {
"xdm:numberOfIneligibleOffers": "2"
},
"xdm:propositionID": "6ef540a3-df9a-4f6d-ae98-eb8f74a7172c",
"xdm:propositions": [
{
"xdm:activity": {
"repo:etag": "1",
"xdm:id": "xcore:offer-activity:1272b0c7aee6156b"
},
"xdm:options": [
{
"@type": "https://ns.adobe.com/experience/offer-management/content-component-text",
"dc:format": "text/plain",
"dc:language": [
"en-us"
],
"repo:etag": "1",
"xdm:content": "10% discount on Zeppelin Yoga Pant",
"xdm:id": "xcore:personalized-offer:1272a68868fcb019"
}
],
"xdm:placement": {
"repo:etag": "1",
"xdm:id": "xcore:offer-placement:12729df1e87caffa"
}
}
]
},
"placementId": "xcore:offer-placement:12729df1e87caffa"
}
Copiez la réponse JSON ci-dessus dans le presse-papiers, puis accédez à l’écran de configuration de la source de données personnalisée.
Cliquez sur l’icône Modifier la charge utile .
Une fenêtre contextuelle s’affiche, dans laquelle vous devez maintenant coller la réponse JSON ci-dessus.
Collez votre réponse JSON.
Cliquez sur Enregistrer.
Cliquez ensuite sur le bouton Ajouter un nouveau groupe de champs.
Vous disposez maintenant d’un autre groupe de champs vide.
Vous devez maintenant définir un second FieldGroup pour récupérer l’image d’offre à utiliser. Utilisez cette convention d’affectation des noms : ldapGetOfferImage
donc dans ce cas, le nom doit être vangeluwGetOfferImage
.
Vous devez également spécifier 5 valeurs dynamiques : eventId,eventNS,placementId,activityId,containerId
.
Définissez ensuite la Durée du cache sur 1 minute.
Vous devez maintenant disposer des éléments suivants :
Pour le payload de réponse, vous devez coller un exemple de la réponse qui sera envoyée par l’API d’Offer decisioning. Copiez la réponse JSON ici :
{
"offerResponse": {
"ode:createDate": 1605830325292,
"xdm:factors": {
"xdm:numberOfIneligibleOffers": "2"
},
"xdm:propositionID": "3478addf-773e-4b9c-9d28-133b3311e04f",
"xdm:propositions": [
{
"xdm:activity": {
"repo:etag": "1",
"xdm:id": "xcore:offer-activity:1272b0c7aee6156b"
},
"xdm:options": [
{
"@type": "https://ns.adobe.com/experience/offer-management/content-component-imagelink",
"dc:format": "image/png",
"dc:language": [
"en-us"
],
"repo:etag": "1",
"xdm:deliveryURL": "https://bit.ly/2IOaItW",
"xdm:id": "xcore:personalized-offer:1272a68868fcb019"
}
],
"xdm:placement": {
"repo:etag": "1",
"xdm:id": "xcore:offer-placement:1270759fed831304"
}
}
]
},
"placementId": "xcore:offer-placement:1270759fed831304"
}
Copiez la réponse JSON ci-dessus dans le presse-papiers, puis accédez à l’écran de configuration de la source de données personnalisée.
Cliquez sur l’icône Modifier la charge utile .
Une fenêtre contextuelle s’affiche, dans laquelle vous devez maintenant coller la réponse JSON ci-dessus.
Collez votre réponse JSON.
Cliquez sur Enregistrer.
La configuration personnalisée de la source de données est maintenant terminée. Faites défiler la page vers le haut et cliquez sur Enregistrer.
Votre source de données a été créée avec succès et fait partie de la liste Sources de données.
Dans le menu, cliquez sur Accueil.
Créez un parcours en cliquant sur le bouton Créer.
Vous verrez alors un écran de Parcours vide.
Dans l’exercice précédent, vous avez créé un Événement. Vous l’avez appelé comme suit ldapAddToCartEvent et avez remplacé ldap par votre ldap. Il s’agit du résultat de la création de l’événement :
Vous devez maintenant considérer cet événement comme le début de ce Parcours. Pour ce faire, accédez au côté gauche de l’écran et recherchez votre événement dans la liste des événements.
Sélectionnez votre événement, faites-le glisser et déposez-le sur le canevas de Parcours. Votre Parcours ressemble maintenant à ceci :
Pour la deuxième étape du parcours, vous devez ajouter une action ldapSmsTwilio . Accédez au côté gauche de l’écran à Actions. Sélectionnez ensuite l’action ldapSmsTwilio , puis faites-la glisser sur le deuxième noeud de votre parcours.
Vous verrez ce panneau s'ouvrir.
Accédez aux Paramètres d’action.
Cliquez sur l’icône Modifier pour le paramètre d’action TEXTMESSAGE.
Dans la fenêtre contextuelle qui s’affiche, cliquez sur Mode avancé.
Vous verrez alors :
Sélectionnez le code ci-dessous, copiez-le et collez-le dans l’ éditeur de mode avancé. Remplacez ldap
par votre propre ldap.
#{ldapXrayGetOffersInfo.ldapGetOfferText.offerResponse.'xdm:propositions'.at(0).'xdm:options'.at(0).'xdm:content'}
Vous devez maintenant configurer les 5 paramètres dynamiques comme indiqué sur le côté droit de la fenêtre contextuelle :
Cliquez sur le paramètre dynamic val.: eventId
. Pour eventId
, vous devez sélectionner l’ECID. Pour ce faire, collez le code ci-dessous. Remplacez ldap
par votre propre ldap.
@{ldapAddToCartEvent.--aepTenantId--.identification.core.ecid}
Cliquez ensuite sur le paramètre dynamic val.: eventNS
. Pour eventNS
, vous devez sélectionner l’ECID. Pour ce faire, collez le texte ci-dessous.
"ecid"
Cliquez ensuite sur le paramètre dynamic val.: placementId
. Pour placementId
, vous devez saisir l’ID de référencement de l’Offer decisioning pour l’emplacement Non numérique - Texte. Vous pouvez trouver l’ID d’emplacement de l’Offer decisioning en accédant à Adobe Experience Platform, aux composants, aux emplacements et en sélectionnant l’emplacement Non numérique - Texte.
Copiez l’ID de référencement et collez-le dans la fenêtre contextuelle en Journey Orchestration. De plus, veillez à ajouter "
au début et à la fin de l’ID de référencement. Il doit ressembler à ceci :
"xcore:offer-placement:12904821b6d8626f"
Cliquez ensuite sur le paramètre dynamic val.: activityId
. Pour activityId
, vous devez saisir l’Offer decisioning ID de décision. Vous pouvez trouver l’ID de décision d’Offer decisioning en accédant à Adobe Experience Platform, aux Offres, aux Décisions et en sélectionnant votre décision.
Copiez l’ID de décision et collez-le dans la fenêtre contextuelle en Journey Orchestration. N’oubliez pas d’ajouter "
au début et à la fin de l’ID de décision. Il doit ressembler à ceci :
"xcore:offer-activity:1290525f4441fd6e"
Cliquez ensuite sur le paramètre dynamic val.: containerId
. Pour containerId
, vous devez saisir le container instanceId, que vous avez récupéré via l’API dans l’exercice précédent. Copiez le conteneur instanceId et n’oubliez pas d’ajouter "
au début et à la fin de l’ID de décision. Il doit ressembler à ceci :
"32a2cb0f-63f8-3388-b156-94f4d917abe7"
Cliquez sur OK.
Cliquez sur l’icône Modifier pour le paramètre d’action MOBILENR.
Une fenêtre contextuelle s’affiche avec l’éditeur de mode simple.
Dans la fenêtre contextuelle qui s’affiche, cliquez sur Mode avancé.
Collez ce code dans l’éditeur de mode avancé. Cliquez sur OK.
substr(#{ExperiencePlatform.ProfileFieldGroup.profile.mobilePhone.number}, 0, 12)
FYI : Ce code est destiné à fonctionner avec les numéros de téléphone mobile à 12 chiffres (y compris le +), comme celui-ci : +32463622044.
Plusieurs autres pays ont des numéros de téléphone à 13 chiffres. Si votre numéro de téléphone portable contient 13 chiffres (y compris le +), vous devez mettre à jour ce code pour :
substr(#{ExperiencePlatform.ProfileFieldGroup.profile.mobilePhone.number}, 0, 13)
Cliquez deux fois sur OK .
Votre parcours ressemble maintenant à ceci :
Comme troisième étape du parcours, vous devez ajouter une action Email. Dans la partie gauche de l’écran, accédez à Actions et effacez le filtre de recherche. Sélectionnez ensuite l’action Email, puis faites-la glisser sur le deuxième noeud de votre parcours.
Sur le côté droit de l’écran, vous devez maintenant configurer l’email.
Accédez à Message et ouvrez la liste déroulante. Dans cette liste, vous devez sélectionner le modèle nommé all - Email avec offre.
La sélection de ce message permet d'ouvrir automatiquement un certain nombre de champs supplémentaires. Ce sont les champs qui le sont. ont été configurés pour être des champs dynamiques dans le modèle d'email. Vous devez maintenant lier chacun des champs dynamiques attendus à un champ provenant de la payload envoyée à Platform.
Commençons par le champ EMAIL.
Cliquez sur l’icône Modifier .
Une fenêtre s’affiche alors pour sélectionner un champ source à utiliser comme source de courrier électronique.
Accédez à #{ExperiencePlatform.ProfileFieldGroup.profile.personalEmail.address}
.
Cliquez sur OK.
Cliquez ensuite sur l’icône Modifier pour le champ LOGO DE MARQUE.
Accédez à Mode avancé et collez cette valeur :
"https://parsefiles.back4app.com/hgJBdVOS2eff03JCn6qXXOxT5jJFzialLAHJixD9/d632e769791f0a4dbe0b84058d282d45_logo.png"
Cliquez sur OK.
Cliquez ensuite sur l’icône Modifier pour le champ NOM DE LA MARQUE.
Accédez à Mode avancé et collez cette valeur :
"Luma"
Cliquez sur OK.
Cliquez ensuite sur l’icône Modifier pour le champ PRÉNOM.
Une fenêtre s’affiche alors pour sélectionner un champ source à utiliser comme source de courrier électronique.
Accédez à #{ExperiencePlatform.ProfileFieldGroup.profile.person.name.firstName}
.
Cliquez sur OK.
Cliquez ensuite sur l’icône Modifier pour le champ IMAGE DE L’OFFRE.
Dans la fenêtre contextuelle qui s’affiche, cliquez sur Mode avancé.
Vous verrez alors :
Sélectionnez le code ci-dessous, copiez-le et collez-le dans l’ éditeur de mode avancé. Remplacez ldap
par votre propre ldap.
#{ldapXrayGetOffersInfo.ldapGetOfferImage.offerResponse.'xdm:propositions'.at(0).'xdm:options'.at(0).'xdm:deliveryURL'}
Vous devez maintenant configurer les 5 paramètres dynamiques comme indiqué sur le côté droit de la fenêtre contextuelle :
Cliquez sur le paramètre dynamic val.: eventId
. Pour eventId
, vous devez sélectionner l’ECID. Pour ce faire, collez le code ci-dessous. Remplacez ldap
par votre propre ldap.
@{ldapAddToCartEvent.--aepTenantId--.identification.core.ecid}
Cliquez ensuite sur le paramètre dynamic val.: eventNS
. Pour eventNS
, vous devez sélectionner l’ECID. Pour ce faire, collez le code ci-dessous. Remplacez ldap
par votre propre ldap.
"ecid"
Cliquez ensuite sur le paramètre dynamic val.: placementId
. Pour placementId
, vous devez saisir l’identifiant de référencement de l’Offer decisioning pour l’emplacement Email - Image. Vous pouvez trouver l’ID d’emplacement d’Offer decisioning en accédant à Adobe Experience Platform, aux composants, aux emplacements et en sélectionnant l’adresse électronique - Image d’emplacement.
Copiez l’ID de référencement et collez-le dans la fenêtre contextuelle en Journey Orchestration. De plus, veillez à ajouter "
au début et à la fin de l’ID de référencement. Il doit ressembler à ceci :
"xcore:offer-placement:1290486b19d86276"
Cliquez ensuite sur le paramètre dynamic val.: activityId
. Pour activityId
, vous devez saisir l’Offer decisioning ID de décision. Vous pouvez trouver l’ID de décision d’Offer decisioning en accédant à Adobe Experience Platform, aux Offres, aux Décisions et en sélectionnant votre décision.
Copiez l’ID de décision et collez-le dans la fenêtre contextuelle en Journey Orchestration. N’oubliez pas d’ajouter "
au début et à la fin de l’ID de décision. Il doit ressembler à ceci :
"xcore:offer-activity:1290525f4441fd6e"
Cliquez ensuite sur le paramètre dynamic val.: containerId
. Pour containerId
, vous devez saisir le container instanceId, que vous avez récupéré via l’API dans l’exercice précédent. Copiez le conteneur instanceId et n’oubliez pas d’ajouter "
au début et à la fin de l’ID de décision. Il doit ressembler à ceci :
"32a2cb0f-63f8-3388-b156-94f4d917abe7"
Cliquez sur OK.
Cliquez ensuite sur l’icône Modifier pour le champ TEXTE DE L’OFFRE.
Dans la fenêtre contextuelle qui s’affiche, cliquez sur Mode avancé.
Vous verrez alors :
Sélectionnez le code ci-dessous, copiez-le et collez-le dans l’ éditeur de mode avancé. Remplacez ldap
par votre propre ldap.
#{ldapXrayGetOffersInfo.ldapGetOfferText.offerResponse.'xdm:propositions'.at(0).'xdm:options'.at(0).'xdm:content'}
Vous devez maintenant configurer les 5 paramètres dynamiques comme indiqué sur le côté droit de la fenêtre contextuelle :
Cliquez sur le paramètre dynamic val.: eventId
. Pour eventId
, vous devez sélectionner l’ECID. Pour ce faire, collez le code ci-dessous. Remplacez ldap
par votre propre ldap.
@{ldapAddToCartEvent.--aepTenantId--.identification.core.ecid}
Cliquez ensuite sur le paramètre dynamic val.: eventNS
. Pour eventNS
, vous devez sélectionner l’ECID. Pour ce faire, collez le code ci-dessous. Remplacez ldap
par votre propre ldap.
"ecid"
Cliquez ensuite sur le paramètre dynamic val.: placementId
. Pour placementId
, vous devez saisir l’ID de référencement de l’Offer decisioning pour l’emplacement Non numérique - Texte. Vous pouvez trouver l’ID d’emplacement de l’Offer decisioning en accédant à Adobe Experience Platform, aux composants, aux emplacements et en sélectionnant l’emplacement Non numérique - Texte.
Copiez l’ID de référencement et collez-le dans la fenêtre contextuelle en Journey Orchestration. De plus, veillez à ajouter "
au début et à la fin de l’ID de référencement. Il doit ressembler à ceci :
"xcore:offer-placement:12904821b6d8626f"
Cliquez ensuite sur le paramètre dynamic val.: activityId
. Pour activityId
, vous devez saisir l’Offer decisioning ID de décision. Vous pouvez trouver l’ID de décision d’Offer decisioning en accédant à Adobe Experience Platform, aux Offres, aux Décisions et en sélectionnant votre décision.
Copiez l’ID de décision et collez-le dans la fenêtre contextuelle en Journey Orchestration. N’oubliez pas d’ajouter "
au début et à la fin de l’ID de décision. Il doit ressembler à ceci :
"xcore:offer-activity:1290525f4441fd6e"
Cliquez ensuite sur le paramètre dynamic val.: containerId
. Pour containerId
, vous devez saisir le container instanceId, que vous avez récupéré via l’API dans l’exercice précédent. Copiez le conteneur instanceId et n’oubliez pas d’ajouter "
au début et à la fin de l’ID de décision. Il doit ressembler à ceci :
"32a2cb0f-63f8-3388-b156-94f4d917abe7"
Cliquez deux fois sur OK .
Pour cet exercice, votre Parcours est parfait comme maintenant.
Ajoutons un événement d’orchestration à Fin le Parcours. Dans la partie gauche de l’écran, accédez à Orchestration et sélectionnez Fin. Faites glisser et déposez ceci sur la 3e étape du Parcours.
Cliquez sur OK.
Votre Parcours ressemble maintenant à ceci.
Vous devez toujours donner un nom à votre Parcours. Pour ce faire, cliquez sur l’icône Modifier en haut à droite de l’écran.
Vous pouvez ensuite y saisir le nom du Parcours. Utilisez ldap - Ajouter au panier + Parcours Offres comme convention d’affectation des noms et remplacez ldap par votre LDAP.
Cliquez sur OK pour enregistrer vos modifications.
Vous avez maintenant ceci. Vous pouvez maintenant publier votre parcours en cliquant sur Publier.
Cliquez à nouveau sur Publier.
Une barre verte de confirmation s’affiche alors pour vous informer que votre Parcours est maintenant publié.
Après l’exercice précédent, vous aviez déjà créé un compte sur le site web. Vous devriez voir quelque chose comme ça sur Xray.
Accédez à n’importe quel produit de votre choix, puis cliquez sur Ajouter au panier.
Cliquez sur le bouton Ajouter au panier pour déclencher votre parcours. Vous devriez maintenant recevoir un SMS et un e-mail.
Vous avez maintenant terminé cet exercice.
Étape suivante : Résumé et avantages