Créer et afficher des offres avec la gestion des décisions

Dans l’interface utilisateur de la collecte de données, sélectionnez Datastreams, puis sélectionnez votre flux de données, par exemple Luma Mobile App.

Sélectionnez pour Experience Platform et Modifier dans le menu contextuel.

Dans l’écran Datastreams > > Adobe Experience Platform, assurez-vous que Offer decisioning, Segmentation Edge et Adobe Journey Optimizer sont sélectionnés. Si vous souhaitez suivre la leçon sur Target, sélectionnez également Destinations Personalization. Voir Paramètres Adobe Experience Platform pour plus d’informations.

Pour enregistrer votre configuration de flux de données, sélectionnez Enregistrer .

Accédez à Balises et recherchez votre propriété de balise mobile, puis ouvrez la propriété .

Sélectionnez Extensions.

Sélectionnez Catalog.

Recherchez l’extension Adobe Journey Optimizer - Decisioning.

Installez l’extension . L’extension ne nécessite pas de configuration supplémentaire.

Dans l’interface utilisateur de Journey Optimizer, sélectionnez Components dans la liste GESTION DES DÉCISIONS du rail de gauche.

Sélectionnez Emplacements dans la barre supérieure.

Si aucun emplacement nommé Mobile JSON, Mobile comme Type de canal et JSON comme Type de contenu est répertorié, vous devez créer un emplacement. Sinon, continuez à Créer des offres.

Sélectionnez Créer un emplacement.

1. dans la section Détails, saisissez Mobile JSON comme Nom, sélectionnez Mobile à partir de Type de canal et JSON à partir de Type de contenu.
2. Sélectionnez Enregistrer pour enregistrer l’emplacement.

Dans l’interface utilisateur de Journey Optimizer, sélectionnez Offres dans GESTION DES DÉCISIONS dans le rail de gauche.

Dans l’écran Offres, sélectionnez Parcourir pour afficher la liste des offres.

Sélectionnez Créer une offre.

Dans la boîte de dialogue Nouvelle offre, sélectionnez Offre personnalisée et cliquez sur Suivant.

À l'étape Détails de Créer une offre personnalisée :

1. Saisissez un nom pour l’offre, par exemple Luma - Juno Jacket, et saisissez une date et heure de début et une date et heure de fin. En dehors de ces dates, l’offre ne sera pas sélectionnée par le moteur de décision.

2. Sélectionnez Suivant.

   

À l’étape Ajouter des représentations de Créer une offre personnalisée :

1. Sélectionnez Mobile dans la liste Canal et sélectionnez Mobile JSON dans la liste Placement.

2. Sélectionnez Personnalisé pour Contenu.

3. Sélectionnez Ajouter du contenu. Dans la boîte de dialogue Ajouter la personnalisation :

   1. Si un sélecteur Mode est disponible, assurez-vous qu’il est défini sur JSON.

   2. Saisissez le code JSON suivant :

      code language-json

      { "title": "Juno Jacket", "text": "On colder-than-comfortable mornings, you'll love warming up in the Juno All-Ways Performance Jacket, designed to compete with wind and chill. Built-in Cocona™ technology aids evaporation, while a special zip placket and stand-up collar keep your neck protected.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/jackets/wj06-purple_main.jpg" }

   3. Sélectionnez Enregistrer.

      

4. Sélectionnez Suivant.

   

À l’étape Ajouter des contraintes de l’étape Créer une offre personnalisée :

1. Définissez Priority sur 10.

2. Désactivez l’option Inclusion capping.

3. Sélectionnez Suivant.

   

À l’étape Réviser de Créer une offre personnalisée :

1. Vérifiez l’offre, puis sélectionnez Terminer.
2. Dans la boîte de dialogue Enregistrer l'offre, sélectionnez Enregistrer et approuver.

Répétez les étapes 3 à 8 pour créer quatre offres supplémentaires avec des noms et un contenu différents. Toutes les autres valeurs de configuration, par exemple Date et heure de début ou Priorité, sont similaires à la première offre que vous avez créée. Vous pouvez rapidement créer des offres en double et les modifier.

1. Dans l’interface utilisateur de Journey Optimizer, sélectionnez Offres dans le rail de gauche, puis sélectionnez Offres dans la barre supérieure.

2. Sélectionnez la ligne de l’offre que vous avez créée.

3. Dans le volet de droite, sélectionnez Autres actions et, dans le menu contextuel, sélectionnez Dupliquer.

   Utilisez le tableau ci-dessous pour définir les quatre autres offres.

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-fixed
   Nom de l’offre	Contenu des offres dans JSON
   Luma - bouteille d’eau Affirmée	{ "title": "Affirm Water Bottle", "text": "You'll stay hydrated with ease with the Affirm Water Bottle by your side or in hand. Measurements on the outside help you keep track of how much you're drinking, while the screw-top lid prevents spills. A metal carabiner clip allows you to attach it to the outside of a backpack or bag for easy access.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/gear/fitness-equipment/ug06-lb-0.jpg" }
   Luma - Teinte de condition physique désirée	{ "title": "Desiree Fitness Tee", "text": "When you're too far to turn back, thank yourself for choosing the Desiree Fitness Tee. Its ultra-lightweight, ultra-breathable fabric wicks sweat away from your body and helps keeps you cool for the distance.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/tees/ws05-yellow_main.jpg" }
   Luma - Adrienne Trek Jacket	{ "title": "Adrienne Trek Jacket", "text": "You're ready for a cross-country jog or a coffee on the patio in the Adrienne Trek Jacket. Its style is unique with stand collar and drawstrings, and it fits like a jacket should.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/jackets/wj08-gray_main.jpg" }
   Luma - Teinte de l’état de santé quotidien d’Aero	{ "title": "Aero Daily Fitness Tee", "text": "Need an everyday action tee that helps keep you dry? The Aero Daily Fitness Tee is made of 100% polyester wicking knit that funnels moisture away from your skin. Don't be fooled by its classic style; this tee hides premium performance technology beneath its unassuming look.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/men/tops/tees/ms01-black_main.jpg" }

En dernière étape, vous devez créer une offre de secours, c’est-à-dire une offre envoyée aux clients s’ils ne sont pas éligibles pour d’autres offres.

1. Sélectionnez Créer une offre.

2. Dans la boîte de dialogue Nouvelle offre, sélectionnez Offre personnalisée et sélectionnez Suivant.

3. À l’étape Détails de Créer une offre de secours, saisissez un Nom pour l’offre, par exemple Luma - Fallback Offer, puis sélectionnez Suivant.

4. À l’étape Ajouter des représentations de Créer une offre de secours :

   1. Sélectionnez Mobile dans la liste Canal et sélectionnez Mobile JSON dans la liste Placement.

   2. Sélectionnez Personnalisé pour Contenu.

   3. Sélectionnez Ajouter du contenu.

   4. Dans la boîte de dialogue Ajouter une personnalisation, saisissez le code JSON suivant et sélectionnez Enregistrer :

      code language-json
      { "title": "Luma", "text": "Your store for sports wear and equipment.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png" }

   5. Sélectionnez Suivant.

À l’étape Réviser de Créer une offre de secours :

1. Vérifiez l’offre, puis sélectionnez Terminer.
2. Dans la boîte de dialogue Enregistrer l'offre, sélectionnez Enregistrer et approuver.

Dans l’interface utilisateur de Journey Optimizer, sélectionnez Offres dans le rail de gauche.

Sélectionnez Collections dans la barre supérieure.

Sélectionnez Créer une collection.

Dans la boîte de dialogue Nouvelle collection, saisissez un nom pour votre collection, par exemple Luma - Mobile App Collection, sélectionnez Créer une collection statique, puis cliquez sur Suivant.

Dans Luma - Mobile App Collection, sélectionnez les offres que vous souhaitez inclure dans la collection. Pour ce tutoriel, sélectionnez les cinq offres que vous avez créées. Vous pouvez facilement filtrer la liste à l’aide du champ de recherche, par exemple en tapant Luma.

Sélectionnez Enregistrer.

Dans l’interface utilisateur de Journey Optimizer, sélectionnez Offres dans le rail de gauche.

Sélectionnez Decisions dans la barre supérieure.

Sélectionnez Créer une décision.

À l’étape Details de Créer une décision d’offre :

1. Saisissez un Nom pour la décision, par exemple Luma - Mobile App Decision, saisissez Date et heure de début et Date et heure de fin.
2. Sélectionnez Suivant.

À l’étape Ajouter des portées de décision de Créer une décision d’offre :

1. Sélectionnez Mobile JSON dans la liste Placement.

2. Dans la mosaïque Critères d'évaluation, sélectionnez Ajouter.

   1. Dans la boîte de dialogue Ajouter une collection d’offres, sélectionnez votre collection d’offres. Par exemple : Luma - Mobile App Collection.

   2. Sélectionnez Ajouter.

      

3. Assurez-vous que Aucun est sélectionné pour Eligibilité, et que La priorité des offres est sélectionnée comme Méthode de classement.

4. Sélectionnez Suivant.

   .

À l’étape Ajouter une offre de secours de Créer une décision d’offre :

1. Sélectionnez votre offre de secours, par exemple Luma - Fallback offer.
2. Sélectionnez Suivant.

À l’étape Summary de Create a new offer décision :

1. Sélectionnez Terminer.
2. Dans la boîte de dialogue Enregistrer la décision d’offre, sélectionnez Enregistrer et activer.
3. Dans l’onglet Decisions , votre décision est prise avec l’état Live.

Dans l’interface utilisateur de Journey Optimizer, sélectionnez Offres.

Sélectionnez Decisions dans la barre supérieure.

Sélectionnez votre décision, par exemple Luma - Mobile App Decision.

Dans la mosaïque Portées de décision, sélectionnez Copier.

Dans le menu contextuel, sélectionnez Étendue de la décision.

Utilisez n’importe quel éditeur de texte pour coller la portée de la décision en vue d’une utilisation ultérieure. La portée de décision présente le format JSON suivant.

{
    "xdm:activityId":"xcore:offer-activity:xxxxxxxxxxxxxxx",
    "xdm:placementId":"xcore:offer-placement:xxxxxxxxxxxxxxx"
}

Dans Xcode, assurez-vous que AEP Optimize est ajouté à la liste des modules dans les dépendances de modules. Voir Swift Package Manager.

Accédez à Luma > Luma > AppDelegate dans le navigateur de projet Xcode.

Assurez-vous que AEPOptimize fait partie de votre liste d’importations.

import AEPOptimize

Vérifiez que Optimize.self fait partie du tableau des extensions que vous enregistrez.

let extensions = [
    AEPIdentity.Identity.self,
    Lifecycle.self,
    Signal.self,
    Edge.self,
    AEPEdgeIdentity.Identity.self,
    Consent.self,
    UserProfile.self,
    Places.self,
    Messaging.self,
    Optimize.self,
    Assurance.self
]

Accédez à Luma > Luma > Model > Data > décisions dans le navigateur de projet Xcode. Mettez à jour les valeurs activityId et placementId avec les détails de la portée de décision que vous avez copiés à partir de l’interface de Journey Optimizer.

Accédez à Luma > Luma > Utils > MobileSDK dans le navigateur de projet Xcode. Recherchez la fonction func updatePropositionOD(ecid: String, activityId: String, placementId: String, itemCount: Int) async . Ajoutez le code suivant :

// set up the XDM dictionary, define decision scope and call update proposition API
Task {
   let ecid = ["ECID" : ["id" : ecid, "primary" : true] as [String : Any]]
   let identityMap = ["identityMap" : ecid]
   let xdmData = ["xdm" : identityMap]
   let decisionScope = DecisionScope(activityId: activityId, placementId: placementId, itemCount: UInt(itemCount))
   Optimize.clearCachedPropositions()
   Optimize.updatePropositions(for: [decisionScope], withXdm: xdmData)
}

Cette fonction :

• configure un dictionnaire XDM xdmData, contenant l’ECID pour identifier le profil pour lequel vous devez présenter les offres.

• définit decisionScope, un objet qui est basé sur la décision que vous avez définie dans l’interface Journey Optimizer - Gestion des décisions et qui est défini à l’aide de la portée de décision copiée depuis Créer une décision. L’application Luma utilise un fichier de configuration (decisions.json) qui récupère les paramètres de portée, en fonction du format JSON suivant :

  code language-swift
  "scopes": [ { "name": "name of the scope", "activityId": "xcore:offer-activity:xxxxxxxxxxxxxxx", "placementId": "xcore:offer-placement:xxxxxxxxxxxxxxx", "itemCount": 2 } ]

  Cependant, vous pouvez utiliser n’importe quel type d’implémentation pour vous assurer que les API d’optimisation obtiennent les paramètres appropriés (activityId, placementId et, itemCount) pour construire un objet DecisionScope valide pour votre implémentation.
  Pour plus d’informations : les autres valeurs de clé du fichier decisions.json sont destinées à une utilisation ultérieure et ne sont pas pertinentes et utilisées actuellement dans cette leçon et dans le cadre du tutoriel.

• appelle deux API : Optimize.clearCachePropositions et Optimize.updatePropositions. Ces fonctions effacent toutes les propositions mises en cache et mettent à jour les propositions de ce profil.

Accédez à Luma > Luma > Views > Personalization > EdgeOffersView dans le navigateur de projet Xcode. Recherchez la fonction func onPropositionsUpdateOD(activityId: String, placementId: String, itemCount: Int) async et examinez le code de cette fonction. La partie la plus importante de cette fonction est l’appel API Optimize.onPropositionsUpdate, qui

• récupère les propositions du profil actuel en fonction de la portée de la décision (que vous avez définie dans Journey Optimizer - Gestion des décisions),
• récupère l'offre à partir de la proposition,
• libère le contenu de l’offre afin qu’elle puisse s’afficher correctement dans l’application ; et
• déclenche l’action displayed() sur l’offre qui renvoie un événement à l’Edge Network informant l’affichage de l’offre.

Toujours dans EdgeOffersView, ajoutez le code suivant au modificateur .onFirstAppear. Ce code garantit que le rappel pour la mise à jour des offres n’est enregistré qu’une seule fois.

// Invoke callback for offer updates
Task {
    await self.onPropositionsUpdateOD(activityId: decision.activityId, placementId: decision.placementId, itemCount: decision.itemCount)
}

Toujours dans EdgeOffersView, ajoutez le code suivant au modificateur .task. Ce code met à jour les offres lorsque la vue est actualisée.

// Clear and update offers
await self.updatePropositionsOD(ecid: currentEcid, activityId: decision.activityId, placementId: decision.placementId, itemCount: decision.itemCount)

Recréez et exécutez l’application dans le simulateur ou sur un appareil physique à partir de Xcode, en utilisant .

Accédez à l’onglet Personalisation.

Sélectionnez Edge Personalisation.

Faites défiler l’écran jusqu’en haut de l’écran pour afficher deux offres aléatoires affichées à partir de la collection que vous avez définie dans la mosaïque DECISION LUMA - MOBILE APP DECISION.

{width="300"}

Les offres sont aléatoires, car vous avez donné à toutes les offres la même priorité et le classement de la décision est basé sur la priorité.

Consultez la section instructions de configuration pour connecter votre simulateur ou périphérique à Assurance.

Sélectionnez Configurer dans le rail gauche et sélectionnez en regard de Réviser et simuler sous ADOBE JOURNEY OPTIMIZER DECISIONING.

Sélectionnez Enregistrer.

Sélectionnez Réviser et simuler dans le rail de gauche. La configuration du flux de données est validée et celle du SDK dans votre application.

Sélectionnez Demandes dans la barre supérieure. Vos demandes Offres s’affichent.

Vous pouvez explorer les onglets Simuler et Liste d’événements pour en savoir plus sur les fonctionnalités, en vérifiant votre configuration de la gestion des décisions Journey Optimizer.