SFCC Content Asset Integration

The Dynamic Content Salesforce Commerce Cloud (SFCC) integration can be set up to create SFCC content assets from content items in Dynamic Content. Once the integration is configured, all the user needs to do is create and publish content items of the specified content types from the Dynamic Content production view. The integration will create or update the corresponding content assets in SFCC. You can also specify mappings between properties in Dynamic Content content items and fields in SFCC content assets.

The content asset integration has a similar architecture to the content slot integration described in Salesforce Commerce Cloud integration. The main difference is that the content asset integration described on this page creates content assets in SFCC from content items published in the Dynamic Content production view and does not use any planning and scheduling features.

On this page we'll provide a technical overview of the integration and provide some examples of it in use.

For details of how to set up a content asset integration see setting up a content asset integration.

Integration overview

The basic flow of the integration is shown below.

SFCC content asset integration architecture
SFCC content asset integration architecture
  • A content item is published from the Dynamic Content production view
  • A webhook-event (Snapshot-published) is generated. If the content type of the asset is one of the types set up when the integration was configured, the webhook service will notify the integration and send it a "payload" containing information about the content item
  • The integration will determine the ID to use for the corresponding content asset in SFCC. The content asset ID will either be the content item ID or a value entered by the user, as detailed in the Mapping properties to fields in a SFCC content asset section of the Content asset integration configuration page.
  • If a content asset with this ID already exists, the content asset will be overwritten, otherwise a new item will be created.
  • The integration will request HTML for the content item from the content rendering service. The handlebars template specified when the integration was configured is used to generate the HTML for the content item. See the example wrapper template for more details.
  • The HTML is then added to the content asset.
  • The content asset name will be set to the content item name, except where a mapping has been configured for the name field.
  • Any additional mapped properties will be added to the corresponding fields in the content asset.
  • Any configured folders will be assigned to the content asset.
  • The content asset is now available to be previewed from within SFCC and can be included in an ISML template or within another content asset.

Simple content asset integration example

Blog content type with a mapped content asset ID

Here's a blog content item in the Dynamic Content production view. In this example the Dynamic Content SFCC integration has been configured to use the assetId property to map to the content asset ID in SFCC. We have entered a value of "winter-blog-asset" in this property. The content item is then saved and published.

Blog content item in Dynamic Content
Blog content item in Dynamic Content

The integration will then generate a content asset in SFCC. If a content asset with this ID already exists, then it would be overwritten.

To find the content asset in SFCC, go to the Merchant Tools section, choose Content and then find the library that was configured for this integration. In this example we are using the library "RefArchGlobal". Search for the content asset using its ID. The winter blog asset is shown in the list.

Searching for the content asset in SFCC using the value entered by the user
Searching for the content asset in SFCC using the value entered by the user

When the winter blog asset is opened you will notice that the name matches the name of the content item in Dynamic Content. The body of the content asset contains the HTML generated from the content item by the Content Rendering Service.

The HTML generated from the content item is added to the body of the content asset
The HTML generated from the content item is added to the body of the content asset

The example below shows a preview of the blog on its own page. In most cases you will include the content item in an ISML template or another content asset.

Previewing the blog content asset
Previewing the blog content asset

An example banner content item is shown below. In this example, when the integration was configured, no mapping section was included for the banner content type. The integration will use the content ID as the SFCC content asset ID.

An example banner content item in Dynamic Content
An example banner content item in Dynamic Content

The content is saved and then published. In order to find the content asset in SFCC, we need to find the content in Dynamic Content, by choosing "Get content ID" from the item's contextual menu in the Content Library.

Finding the content ID
Finding the content ID

We can then search for the content asset using the content ID. The content asset is created with the content ID and the content name.

Searching for the content asset using the content ID
Searching for the content asset using the content ID

The HTML is generated in the same way as the previous example.

The HTML is generated for the banner item and added to the content asset
The HTML is generated for the banner item and added to the content asset

Here's a preview of the content asset in its own page.

Previewing the banner content asset
Previewing the banner content asset

Content asset integration example with multiple mapped fields

In the example below we have mapped the properties in a blog content type to the specified fields in a SFCC content asset. Here's an example blog content item in Dynamic Content.

A blog content item showing the mapped fields
A blog content item showing the mapped fields

When a blog content item is published, the integration will create the corresponding content asset in SFCC. The fields that are specified in the mappings for this content type will be set to whatever values the user entered. For example, you can see the Page URL field set to "December-promotion-url" as entered in the content item. The HTML from the item's content has been added to the body field of the content asset.

The content asset in SFCC
The content asset in SFCC

The content asset has been set as online and can be previewed on its own page.

Previewing the blog asset on a stand alone page
Previewing the blog asset on a stand alone page

The URL contains the Page URL value that the user entered in Dynamic Content content item.

The URL contains the value entered by the user in the content item in Dynamic Content
The URL contains the value entered by the user in the content item in Dynamic Content

Video: content asset integrations

This video provides a technical overview of the architecture of a content asset integration, explains how to configure it and includes an example.

Content Rendering Service

Handlebars

Webhooks

Setting up a content asset integration

results matching ""

    No results matching ""