1. Using Oracle Commerce
  2. Design Your Store Layout
  3. Customize slots

Customize slots

Slots provide a means of content variation similar to stacks, however, only a single variant of a slot will be returned to the visitor’s browser based on server-side rules.

Configure audience-based content slots

You can create several versions of your store content in order to reach a variety of target audiences. For example, content images may be based on gender, or age, categories.

To do so, you can add a Content Variation Slot to any layout.

To configure audience-based content:

  1. Click the Design icon and display the Layout tab.
  2. Navigate to any layout by using the filter options.
  3. Select your preferred layout and click the Grid View icon.
  4. Locate the relevant section where you would like to place a Content Variation Slot and highlight an existing region.
  5. Either:

    Select an existing region and ensure all widgets are removed so that just the region itself remains.

    Or

    Add a new row (which contains regions) above or below using the arrows on the row menu bar.

  6. See Work with layout components for details on adjusting a region’s width settings, and removing widgets.
  7. Open the Components menu, select Content Variation Slot and drag to the empty region. You will see a control (or default) variant, and an unassigned variant.
  8. Drag and drop widgets from the Components menu to the default variant, as required.
  9. Highlight the unassigned variant by clicking its name. You now have several configuration options available for the unassigned variant. These include, customizing the slot, choosing a target audience, or, configuring the slot settings, as described below:

    Note: Audiences are defined when a set of rules are created based on attributes of the shopper profile, and are then used for personalizing the shopper’s experience. See Define Audiences for more details.

    To customize the slot, click the following options:

    • Add variant ‘+’ button on the far right to add up to a maximum 10 variants, these can be easily re-ordered via drag and drop.

      Note: The order of the variants follows a left to right sequence, with the leftmost variant (after the default) having the highest priority.

    • Remove variant ‘x’ button to the right of each variant name to remove it. You cannot remove the default, and you must have at least one variant in addition to that default.
    • Target icon to open the targeting modal, where you can name each variant as required. (This modal can also be opened by double clicking the variant name.)

    To target an audience:

    • Click the target icon to display the target audience configuration options.
    • Enter the name of the variant.
    • Select your target audience name. This can be chosen from a list of predefined audiences as soon as you being typing. You cannot assign an audience to the default variant.
    • Choose your audience from the list of available audiences.
    • (Optional) Select a start and end date.

      Note: Results vary depending on the combination of dates and audiences chosen: you can select a date without specifying an audience, in which case, the default of ‘All Shoppers’ is applied; you can select an audience without specifying start and end dates, in which case, the results are shown for an immediate start date, and an indefinite end date; when a start date is not specified, the results shown relate to an immediate start date; when an end date is not specified, the results shown relate to an indefinite end date.

    • Click ‘Add a Variant’ if you wish to add more variant slots.

      Note: You can reorder the variants by dragging each one to a new position of priority.

    To configure the slot settings:

    • Click the Settings icon to display the configuration options.
    • Choose your slot name and description details.
    • Click Save to confirm your settings.
  10. Save your configurations.
  11. Drag and drop widgets from the Components menu to the variant(s) as required.

    Note: You can drag a Progress Tracker, Vertical tabs, or an Accordion stack on to the variants of a slot, sometimes referred to as a nested stack.

  12. You must ensure that you publish the changes made to your store after assigning audiences to slots, otherwise the personalized content will not be displayed on the storefront.

Configure role-based content slots

When an Agent accesses your store in order to gain insight into a shopper’s perspective, they can view content based on their access role. You can, therefore create several versions of your store where the content is determined by the relevant access role. For example, the role of an Agent Supervisor, Administrator, or an Account Manager may be assumed. See Create new orders for more details.

To configure a role-based content slot:

  1. Open the Design icon and display the Layout tab.
  2. Navigate to any layout by using the filter options.
  3. Select your preferred layout and click the Grid View icon.
  4. Locate the relevant section where you would like to add a role-based content slot and highlight an existing region.
  5. Either:

    Select an existing region and ensure all widgets are removed so that just the region itself remains.

    Or

    Add a new row (which contains regions) above or below using the arrows on the row menu bar.

  6. See Work with layout components for details on adjusting a region’s width settings, and removing widgets
  7. Open the Components menu, select the ‘Role Based Slot’ option, and drag to the empty region. You will see a control (or default) variant, and an unassigned variant.
  8. Highlight the unassigned variant by clicking its name. You now have several configuration options available for the unassigned variant. These include, customizing the slot, configuring the slot settings, or choosing an Agent access role, as described below:

    To customize the slot, click the following options:

    • Add variant ‘+’ button on the far right to add up to a maximum 10 variants, these can be easily re-ordered via drag and drop.
    • Remove variant ‘x’ button to the right of each variant name to remove it. You cannot remove the default, and you must have at least one variant in addition to that default.
    • Target icon to open the targeting modal, where you can name each variant as required. (This modal can also be opened by double clicking the variant name.)

    To configure your slot settings:

    • Click the Settings icon to display the configuration options.
    • Choose your slot name and description details.
    • Click Save to confirm your settings.

    Role-based slot variants provide access differently than other roles. Roles are generally only containers and do not provide access by themselves. Roles contain privileges that provide access. However, role-based slots variants do provide access. Ensure that you are providing the correct level of access for your users by setting up the variants correctly.

    The following example shows how role-based slots work:
    • You define a role-based content slot and configures one variant for the CS Agent role, which is a container for the CS Agent privilege and another variant for the CS Agent Supervisor role, which is a container for the CS Agent Supervisor role.
    • You then create a custom role, Special Agent, that contains the CS Agent, Marketing and Preview privileges.
    • Then you remove the CS Agent role from a specific user and give that user the Special Agent role instead.
    • The user no longer sees the content in the variant for CS Agent, even though they have the CS Agent privilege. Because of the differences with role-based slot variants, you must ensure that you add Special Agent to the CS Agent variant.

    To select the Agent access role:

    • Click the target icon to display the access role configuration options.
    • Enter the name of the variant.
    • Choose your role from the list of available roles. This can be chosen from a list of predefined roles as soon as you being typing. You cannot assign a role to the default variant.
    • Click ‘Add a Variant’ if you wish to add more variant slots.

    Note: You can reorder the variants by dragging each one to a new position of priority.

  9. Save your configurations.
  10. Drag and drop widgets from the Components menu to the variant(s) as required.

    Note: You can drag a Progress Tracker, Vertical tabs, or an Accordion stack on to the variants of a slot, sometimes referred to as a nested stack.

  11. You must ensure that you publish the changes made to your store after assigning audiences to slots, otherwise the personalized content will not be displayed on the storefront.