Create code-based experience channel

Objective

Recall that the business requirements are that any of Connection 5G’s systems should be able to return an appropriate offer. Whether it’s a customer agent’s computer, an in-store kiosk, a mobile app, or the website, the customer should receive the same offer experience. The only AJO channel that can do that is a Code-based Experience (CBE), one of the inbound AJO channels. While a CBE can return HTML, its primary function is to return information about what offer should be presented to the receiving system, with that system knowing what to do with that offer information. Unlike the web channel, CBEs aren’t automatically rendered or reported. While it’s a little more manual work for the customer, they offer a lot of flexibility as they can be configured to return JSON that any mobile, web, or IoT system can use to execute decisions.

  1. If necessary, expand the Administration menu item in the left rail (you will likely need to scroll down) and click on Channels. You land on the ‘Channel configurations’ page.

  2. Click the blue Create channel configuration button

  3. On the ‘Channel configuration details’ page, name the channel jsonOffer_cbe

    note
    NOTE
    Since a CBE can be called by any number of clients across N number of platforms, we’re going to name this CBE something generic to location, but specific to the fact that it returns offers in the JSON format.
  4. Set the Select channel drop-down to Code-based experience.

    note warning
    WARNING
    We won’t set a Marketing action in this lab because it adds unneeded complexity for our demonstration, but since CBEs can be accessed by any number of systems, in a real use case you’d set all the possible marketing actions for this channel so that DULE labels are enforced.
  5. Tick the Web box in the ‘Code-based experience settings’ area and keep the Single page option selected.

  6. In the Page URL text box, enter the text https://connection5g.com/home

  7. In the Location on page text box, enter the text jsonOfferContainer

    note
    NOTE
    Not every Experience Event sent to the Edge triggers a request for personalized offers. You’ll create a Journey in the next section where this CBE will be configured with the selection strategy you just configured. The ‘Location on page’ setting is the name of the parameter passed in Experience Events that tells the Experience Edge to return any offers that are assigned to that CBE. It’s also often referred to as a surface. Be it a mobile app, web page, or some other IoT device, if the jsonOfferContainer value is passed to the Edge, along with the correct eventType via an Experience Event, the Edge will execute the logic configured thus far in the lab and return the appropriate offer.
  8. Click the JSON radio button in the ‘Format’ section. When finished, your CBE channel config should look like this:

    Completed Code-Based Experience channel configuration with JSON format selected

  9. Once everything looks correct, click the blue Submit button in the upper right corner.

TIP
Once it saves, you’re taken back to the Channel configuration page, and you see your newly created CBE.

Recap

On this page, you configured a Code-Based Experience (CBE) channel and set up a new inbound channel that can return offer decisions in JSON format so external systems (like web pages, apps, or kiosks) can request and receive the appropriate offers based on the selection strategy you built earlier.

recommendation-more-help
blueprints-learn-help-blueprints