Document Content Assets and Content Slots

Learning Objectives

After completing this unit, you’ll be able to:

  • Explain why you should clearly document content assets and slots.
  • List three types of content slots you can use in a storefront.
  • List three data elements you should include in your content asset and slots spreadsheet.
  • List three tasks merchandisers perform when configuring content slots.
  • List three tasks web developers perform when configuring content slots.

Introduction

A content slot is a preconfigured place on the storefront where a merchant can showcase products, categories, content assets, static HTML, or product recommendations. A content asset can be a flash graphic, product carousel, product search result set, or marketing graphic. Product recommendations are based on Commerce Cloud Einstein merchant-configured algorithms that generate lists of recommended products.

Because merchants can schedule when to display assets, content slots are an easy way to show fresh information on a storefront without a lot of developer time. It’s cost-effective, fast, and easy.

Maintaining content assets and slots is a lot easier when you document them and assign clear IDs. With logical naming conventions, you can ensure there’s no confusion over which slots belong where on each type of storefront page. This is where the content inventory and control document comes in.

With this document, you can get early feedback about slot and content asset details. When you do the work up front, you reduce launch overhead, and you’re more likely to follow best practices, such as using only up to six slots on a page to optimize page performance.

Note

Note

We recommend that you use the Commerce Cloud Storefront Reference Architecture (SFRA) wireframes as the foundation from which to make changes to the number and type of slots you display.

What’s in a Content Slot?

Two types of people create content slots: web developers and merchandisers. Here’s the typical process.

  1. A merchandiser starts by designing the overall storefront layout. This person defines the page templates needed, content placement on the pages, and how content should appear in individual slots.
  2. The web developer adds code to HTML pages, creates rendering templates, and uploads the code to the server. Templates (ISML files) define the storefront look and feel.
  3. A merchandiser uses Business Manager to configure and schedule slot configurations.

Content slot templates are stored in a special slot folder on the server for easy retrieval.

Slot Types

In Business Manager, merchandisers configure three types of slots for use in a storefront: global, category, or folder. The type defines which templates Salesforce B2C Commerce uses on the storefront. For global slots, B2C Commerce checks all templates in the slot folder. For category and folder slots, B2C Commerce only checks the templates that are specified in the category or folder configurations.

Content Types

In Business Manager, merchandisers can configure these content types within a slot.

  • Product—specific products
  • Category—all products in a specified category
  • Content Asset—a specific content asset
  • HTML—plain text or HTML code
  • Product Recommendations—recommended products derived from Commerce Cloud Einstein algorithm

Once merchants configure the slot and content types and assign them to content assets and templates, they schedule the display of assets. What a great way to roll out new product promotions!

As the functional architect, you document the slot IDs as they relate to the content assets, so they’re easy to use and maintain after launch.

Let’s Look at an Example

This is a Commerce Cloud Storefront Reference Architecture (SFRA) sample page.

SFRA content slots: cat-summer-style, cat-womens-dresses, and cat-womens-jewelry

In addition to the header and search field, this page contains three content slots. Let’s call them cat-summer-style, cat-womens-dresses, and cat-womens-jewelry. By using cat for category, we’re following a consistent naming convention.

Map the Slots and Assets

Create a document like this to map the content slots to content assets. This is your content inventory and control document.

Page Content Slot/Asset Name Photo/Video Responsible Due Date Frequency
Commerce
Category Landing (men) Splash image, Caption, Link, and Copy Slot/HTML cat_landing_men Marketing Joe 10/03 Monthly
Category Landing (women) Splash image, Caption, Link and Copy Slot/HTML cat-landing-women Marketing Joe 10/03 Monthly
Non-Commerce
Home Page - Technology Image, Copy, Flash Slot/HTML Stock Bree 11/2 Monthly
Home Page How-to 2 videos, 2 images, Links, Copy Asset Marketing Yan 10/2 Annual
Store Locator 1 image, Copy Slot Stock Yan Done Seasonal
Investor Relations 1 image, Copy Asset Stock Maury Done Annual
Customer Service 2 images, Copy, Flash Asset Stock Joe 10/2 Annual

Add More Details

Add columns to the sheet to be as detailed as possible.

Column Header Sample Cell Content
Technology
  • General pane infrastructure is a Flash app.
  • Pass in a list of other Flash files that will load into each pane.
  • Each pane is an individual Digital XML file.
Rendering Template Location core_clientname/cartridge/template/default/slots/contents/slider.isml
Slot ID home-slider
Slot Type Global
Slot Configuration Yes
Content Type Content Asset
Number of Assets 3
Content Assets

home-slide-1

home-slide-2

home-slide-3

Content Asset Example

ID: home-slide-1

Name: Home Page Hero Carousel Slide 1

Block Image: images/homepage/slider/images.png

Block Title:

Block CTA Text: Handcrafted Luxury

Block CTA Link: Discovery

Block Title Alignment: Left

Add as many columns and rows as you have data. An easy rule of thumb is to include all the details about content slots and assets that will ultimately help your implementation be successful.

Next Steps

We learned about content slots and how they relate to content assets. We also learned why it’s important to document these details early in the implementation process, and the kinds of data to include.

Now it’s time to learn about the functional specification document (FSD).

Resources

Trailhead: Salesforce B2C Commerce for Developers

Copyright

Rights of ALBERT EINSTEIN are used with permission of The Hebrew University of Jerusalem. Represented exclusively by Greenlight.

retargeting