Multi-language site Integration - Bloomreach Experience - Open Source CMS

Multi-language site Integration

Does your site support multiple languages? 

We currently 32 major languages. If you have a specific language you're interested in, let your Bloomreach representative know so we can add it to our roadmap. Find the complete list of supported languages in the Multi-language support page.
To support your multi-language site, your Bloomreach representative helps you with product feeds and domain keys. Each of your site's supported languages needs its own product feed and domain key.

Do I need different account IDs, too? 
Your account ID remains the same across all languages on your site.

Domain keys

Bloomreach treats each language as a separate catalog identified with a domain key. Your Bloomreach representative provides the values you need for each catalog's domain_key parameter. Pass the domain_key value for the appropriate language in all pixel fires and API calls. 

The domain_key is required for the pixel? 
The domain_key parameter is required for pixel fires on multi-language sites.
If you only support one language on your site, then the domain_key parameter is optional for pixel fires.

A domain key identifies the specific version of a site when one account ID hosts multiple site versions with unique characteristics, including languages. Bloomreach uses your domain_key parameter value to ensure that only query and analytics data pertaining a particular site version are used for Bloomreach features.

Product feed

Generate a separate product feed for each language. Include all the product information in your complete product feed. This information differs for optional delta feeds.

 

Full feed

Delta feed

Do you send it?

Required

Optional

Frequency

Daily

Hourly

Products to include

All

Products with updates OR

Subset with or without updates

 

Fields to include

All fields

Subset of fields OR

All fields

Update prices

Mark products OOS

Mark products absent from feed OOS

❌ 

Add new products

Examples

Request

GET http://core.dxpapi.com/api/v1/core/?
account_id=<Bloomreach Provided Account ID>
&domain_key=example_com
&request_id=8438674518839
&url=test
&request_type=search
&search_type=keyword
&q=hdmi
&rows=10
&start=0
&fl=pid,title,brand,sku_swatch_images

example supports both English and French on their live site. Bloomreach provides them two domain_key values:

  • example_com 
  • example_com_FR

When Mei visits the English version of their site, all the pixel and API calls include the following domain key: domain_key=example_com

When René visits the French version of example's site, the domain key looks like this:

domain_key=example_com_FR

example also generates two full product feeds everyday, one with English data and the other with French data. Bloomreach processes these feeds into their respective catalogs. English data is used for any API call that includes the example_com domain key, and French data is used for example_com_FR calls.

Similarly, example also generates two hourly delta feeds, one for English and one for French.

Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?