Regions let you use different product attributes such as list price, sale price, catalog names, and availability for groups of users. Typically, these users are from one geographic area or region-for example, an international retailer could set up one region for each country where they do business. (Regions can be used more abstractly so long as the basic requirements are met.)
To add region support, you need to
Tell your Algonomy team. They’ll enable regions for your site.
Update your feed. The variable values are sent through the feed and associated to a region ID. See Product Region Flat File Feed for a complete list of attributes that you can set for a region.
Update your site integration. In the integration logic, you only identify the user’s region ID. When the region ID is known for a user, the recommendations that are returned use the available values for that region.
The user does not need to be logged in.
Region ID can vary during a session.
If the feed didn’t contain region-specific data for a particular product, the recommendation shows the default product data.
Regions and Recommendations
In general, region data does not change the recommendations that are returned (except for products that are out of stock in certain regions). Regional information is substituted after recommendations are generated for a user. Backfill strategies become especially important when you’re working with sites with multiple regions.
The language will be deduced by the region, as set in the region feed file.
For example, you could set up a country like Switzerland with 3 regions and 3 languages:
RegionId ch-FR, Region: Switzerland-France, Language-tag: ch-FR
RegionId ch-DE,Region: Switzerland-Germany, Language-tag: ch-DE
RegionId ch-IT, Region: Switzerland-Italy, Language-tag: ch-IT
How To Make This Code Work For You
Add the following lines of code to your page tags, adding the required information to them:
||Replace Region ID with the ID that represents the current shopper's region. The set of valid region IDs are determined by you and set up in the region feed.|
setRegionId() in the Primary Code Block.
Primary Code Block
Set the region ID with the
rid parameter in