You can use SmartBlock enrichment channels to include data customized to each site visitor in your product recommendation SmartBlocks.
Learn more about Recommendation SmartBlocks.
SmartBlock enrichment channels allow you to fetch data stored outside of Fresh Relevance and pull it directly into Recommendation SmartBlocks placed on your website. For example, you might want to show customized pricing per visitor, display current loyalty points, or update stock levels in real-time from your inventory management data.
Enrichment channels work through an API bridge, which sits between Fresh Relevance and your database, or equivalent system, and enables the transfer of data types that you specify.
So, when a visitor views a Recommendation SmartBlock on your site, the data you have defined in the linked enrichment channel is requested from your database and pulled into Fresh Relevance so it can be displayed in the SmartBlock.
Before you start
Things you need to know:
To ensure that SmartBlock enrichment channels are correctly configured, they must be set up as part of a Custom Technical Solutions (CTS) project. Our team work directly with you to get the data flow up and running correctly and efficiently.
To get started, contact your Customer Success representative.
Access SmartBlock enrichment channel settings
Once you have worked with our CTS team to complete the initial setup, you can access and edit the settings for your channel inside Fresh Relevance.
To do this:
Expand the User menu and go to Settings > Other integrations > SmartBlock enrichment.
Any channels already created are listed here. Select a channel to view or edit its properties.
Each channel you have set up has three tabs where you can edit various properties:
Settings
Item fields
Person fields
Settings
On the Settings tab, you can edit the channel name. This is the name you see when selecting a channel to include in a SmartBlock, so it should be informative and easy to distinguish if you have multiple enrichment channels.
This tab also contains the API endpoint URL. This URL is provided to your by our team as part of the initial setup, and the channel relies on this URL to work correctly, so you must not edit this URL without consulting with our CTS team.
Item fields
The following Fresh Relevance fields are included by default:
Site brand (
sb)Product ID (
prid)Currency (
curr)Language (
lang)
On this tab you can define which product fields you want to include in the content retrieval for use in your Recommendation SmartBlocks.
As you start typing in the Field name input, you see a list of standard fields which match. Select a field to add it.
To add custom item or product fields, use the prefixex.to specify an extend field, for example,ex.product_size.
Once you’ve selected all the item fields you want to use, select ADD, then select SAVE.
Person fields
This tab allows you to select the person data you want to include in the content retrieval.
As you start typing in the Field name input, you see a list of standard fields which match. Select a field to add it.
To add custom person fields, use the prefixextend., for example,extend.birthdate.
Once you’ve selected all the item fields you want to use, select ADD, then select SAVE.
To delete a field, select the Delete icon at the and of the table row. To delete multiple fields at once, select the checkbox for each field you want to delete, then select DELETE from the toolbar.
Add enrichment channels to a SmartBlock
Before you start
Enrichment channels can only be used with Recommendation SmartBlocks.
There are two steps involved in adding an enrichment channel to a SmartBlock; you must select the enrichment channel that you want to use, and you must also ensure that the fields configured in the channel are included in the SmartBlock layout.
To select an enrichment channel:
Go to Content > SmartBlocks.
On the Recommendation tab, create or edit your SmartBlock.
Select the Data tab.
Select the switch under SmartBlock data enrichment source to enable the feature, then expand the drop-down menu and select the channel you want to use.
Once you’ve finished configuring any other settings you want to use for your SmartBlock, select SAVE or SAVE AND USE.
Learn how to include person or item fields in your SmartBlock layout in Cart and SmartBlock layout merges.