Create and display offers with Decision Management

In the Data Collection UI, select Datastreams, and select your datastream, for example Luma Mobile App.

Select for Experience Platform and select Edit from the context menu.

In the Datastreams > > Adobe Experience Platform screen, ensure Offer Decisioning, Edge Segmentation, and Adobe Journey Optimizer are selected. If you will do the Target lesson, select Personalization Destinations, too. See Adobe Experience Platform settings for more information.

To save your datastream configuration, select Save .

Navigate to Tags and find your mobile tag property and open the property.

Select Extensions.

Select Catalog.

Search for the Adobe Journey Optimizer - Decisioning extension.

Install the extension. The extension does not require additional configuration.

In the Journey Optimizer UI, select Components from DECISION MANAGEMENT in the left rail.

Select Placements from the top bar.

If no placement with name Mobile JSON, Mobile as Channel type and JSON as Content type is listed, you must create a placement. Otherwise, continue to Create offers.

Select Create placement.

1. in the Details section, enter Mobile JSON as the Name, select Mobile from Channel type and JSON from Content type.
2. Select Save to save the placement.

In the Journey Optimizer UI, select Offers from DECISION MANAGEMENT in the left rail.

In the Offers screen, select Browse to see the list of offers.

Select Create offer.

In the New offer dialog, select Personalized offer and click Next.

In the Details step of Create new personalized offer:

1. Enter a Name for the offer, for example Luma - Juno Jacket, and enter a Start date and time and an End date and time. Outside of these dates, the offer won’t be selected by the Decisioning engine.
2. Select Next.
   

In the Add representations step of Create new personalized offer:

1. Select Mobile from Channel list, and select Mobile JSON from the Placement list.

2. Select Custom for Content.

3. Select Add content. In the Add personalization dialog:

   1. In case a Mode selector is available, ensure it is set to JSON.

   2. Enter the following JSON:

      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. Select Save.
      

4. Select Next.
   

In the Add constraints step of the Create new personalized offer:

1. Set Priority to 10.
2. Toggle Include capping off.
3. Select Next.
   

In the Review step of Create new personalized offer:

1. Review the offer, then select Finish.
2. In the Save offer dialog, select Save and approve.

Repeat steps 3 - 8 to create four more offers with different names and content. All other configuration values, for example Start date and time or Priority, are similar to the first offer you created. You can quickly create duplicate and edit offers.

1. In Journey Optimizer UI, select Offers from the left rail, then select Offers from the top bar.

2. Select the row of the offer that you created.

3. In the right pane, select More actions and from the context menu select Duplicate.

   Use the table below to define the four other offers.

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-fixed
   Offer name	Offer content in JSON
   Luma - Affirm Water Bottle	{ "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 - Desiree Fitness Tee	{ "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 - Aero Daily Fitness Tee	{ "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" }

As a final step you must create a fallback offer, which is an offer sent to customers if they are not eligible for other offers.

1. Select Create offer.

2. In the New offer dialog, select Personalized offer and select Next.

3. In the Details step of Create new fallback offer, enter a Name for the offer, for example Luma - Fallback Offer, and select Next.

4. In the Add representations step of Create new fallback offer:

   1. Select Mobile from Channel list, and select Mobile JSON from Placement list.

   2. Select Custom for Content.

   3. Select Add content.

   4. In the Add personalization dialog, enter the following JSON and select Save:

      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. Select Next.

In the Review step of Create new fallback offer:

1. Review the offer, then select Finish.
2. In the Save offer dialog, select Save and approve.

In the Journey Optimizer UI, select Offers from the left rail.

Select Collections from the top bar.

Select Create collection.

In the New collection dialog, enter a Name for your collection, for example Luma - Mobile App Collection, select Create static collection, and click Next.

In Luma - Mobile App Collection, select the offers you want to include in the collection. For this tutorial, pick the five offers you created. You can easily filter the list using the search field, for example by typing Luma.

Select Save.

In the Journey Optimizer UI, select Offers from the left rail.

Select Decisions from the top bar.

Select Create decision.

In the Details step of Create a new offer decision:

1. Enter a Name for the decision, for example Luma - Mobile App Decision, enter Start date and time and End date and time.
2. Select Next.

In the Add decision scopes step of Create a new offer decision:

1. Select Mobile JSON from Placement list.

2. In the Evaluation Criteria tile, select Add.

   1. In the Add Offer Collection dialog, select your offer collection. For example, Luma - Mobile App Collection.
   2. Select Add.
      

3. Ensure that None is selected for Eligibility, and Offer priority is selected as the Ranking method.

4. Select Next.
   .

In the Add fallback offer step of Create a new offer decision:

1. Select your fallback offer, for example the Luma - Fallback offer.
2. Select Next.

In the Summary step of Create a new offer decision:

1. Select Finish.
2. In the Save offer decision dialog, select Save and activate.
3. In the Decisions tab, you see your decision with status Live.

In the Journey Optimizer UI, select Offers.

Select Decisions from the top bar.

Select your decision, for example Luma - Mobile App Decision.

In the Decision scopes tile, select Copy.

From the contextual menu, select Decision scope.

Use any text editor to paste the decision scope for later use. The decision scope has the following JSON format.

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

In Xcode, ensure that AEP Optimize is added to the list of packages in Package Dependencies. See Swift Package Manager.

Navigate to Luma > Luma > AppDelegate in the Xcode Project navigator.

Ensure AEPOptimize is part of your list of imports.

import AEPOptimize

Ensure Optimize.self is part of the array of extensions that you are registering.

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
]

Navigate to Luma > Luma > Model > Data > decisions in the Xcode Project navigator. Update the activityId and placementId values with the decision scope details you copied from the Journey Optimizer interface.

Navigate to Luma > Luma > Utils > MobileSDK in the Xcode Project navigator. Find the func updatePropositionOD(ecid: String, activityId: String, placementId: String, itemCount: Int) async function. Add the following code:

// 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)
}

This function:

• sets up an XDM dictionary xdmData, containing the ECID to identify the profile for which you have to present the offers.

• defines decisionScope, an object that is based on the decision you have defined in the Journey Optimizer - Decision Management interface and is defined using the copied decision scope from Create a decision. The Luma app uses a configuration file (decisions.json) that retrieves the scope parameters, based on the following JSON format:

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

  However, you can use any kind of implementation to ensure the Optimize APIs get the proper parameters (activityId, placementId and, itemCount), to construct a valid DecisionScope object for your implementation.
  For your information: the other key-values in the decisions.json file are for future use and not relevant and used currently in this lesson and as as part of the tutorial.

• calls two APIs: Optimize.clearCachePropositions and Optimize.updatePropositions. These functions clear any cached propositions and update the propositions for this profile.

Navigate to Luma > Luma > Views > Personalization > EdgeOffersView in the Xcode Project navigator. Find the func onPropositionsUpdateOD(activityId: String, placementId: String, itemCount: Int) async function and inspect the code of this function. The most important part of this function is the Optimize.onPropositionsUpdate API call, which

• retrieves the propositions for the current profile based on the decision scope (which you have defined in Journey Optimizer - Decision Management),
• retrieves the offer from the proposition,
• unwraps the content of the offer so it can be displayed properly in the app, and
• triggers the displayed() action on the offer which sends an event back to the Edge Network informing the offer is displayed.

Still in EdgeOffersView, add the following code to the .onFirstAppear modifier. This code ensures that the callback for updating the offers is registered only once.

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

Still in EdgeOffersView, add the following code to the .task modifier. This code updates the offers when the view is refreshed.

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

Rebuild and run the app in the simulator or on a physical device from Xcode, using .

Go to the Personalisation tab.

Select Edge Personalisation.

Scroll to the top, and you see two random offers displayed from the collection that you have defined in the DECISION LUMA - MOBILE APP DECISION tile.

img-md
w-300

The offers are random, as you have given all offers the same priority and the ranking for the decision is based on priority.

Review the setup instructions section to connect your simulator or device to Assurance.

Select Configure in left rail and select next to Review & Simulate underneath ADOBE JOURNEY OPTIMIZER DECISIONING.

Select Save.

Select Review & Simulate in the left rail. Both datastream setup is validated and the SDK setup in your application.

Select Requests at the top bar. You see your Offers requests.

You can explore Simulate and Event List tabs for further functionality, checking your setup of Journey Optimizer Decision Management.