SmartBlock enrichment channels let you include visitor‑specific data in 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. Common use cases include visitor‑specific pricing, loyalty point balances, and real‑time stock levels from inventory systems.
Enrichment channels use an API bridge between Fresh Relevance and your database, or equivalent system, to transfer the data you specify.
When a visitor views a Recommendation SmartBlock, data defined in the linked enrichment channel is requested from your system and displayed in the SmartBlock
Before you start
Things you need to know:
SmartBlock enrichment channels must be set up as part of a Custom Technical Solutions (CTS) project. Our team works 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 the following 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, which is provided by our team during the initial setup. Do not edit this URL without consulting the 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 type 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 type 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, 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.
Adding an enrichment channel involves selecting the channel and ensuring its configured fields 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.