Skip to content

Markets and locales

Markets

A market typically refers to a specific geographical region. Markets are characterized by product assortment, user behaviour and merchandising support:

  • Each market has its own set of products.
  • User behavior within a market is collected and analyzed to understand trends, power recommendations, and support reporting.
  • Merchandising actions such as boosts and page rules are configured independently per market.

Market defintion validation

An Elevate market is correctly defined if all of the following are true:

  • Do products have the same variants available market-wide?
  • Do all site visitors expect the same online availability for all items?
  • Should trends and popularity be based on all site visitors' behavior together?
  • Should merchandising actions apply uniformly across all users?

Assortment requirements

Products within a market must be fundamentally the same across the market. This means products cannot have differences in their structure or availability for different site users. Specifically:

  • Each product must have the same variants for all site users.
  • Variants must have the same online availability for all site users.
  • All variants within a product must have the same set of price types, ensuring consistent pricing.

Assortment support

While products structure and availability must be fundamentally the same, markets support assortment variations such as:

  • Content localized for multiple locales
  • Store-specific availability for physical store stock
  • Multiple currencies and price types specified at request time

Market identifiers

Each market is identified by a unique market identifier, which is required for nearly all types of requests. Product data, content, and behavioral statistics are all linked to one or more markets.

Market identifier conventions

  • Market identifiers must be consistent across all integration points
  • Market identifiers are case-sensitive
  • All product data and content keys belonging to a market must be unique
  • All product data and content keys must be consistent across all markets, e.g. a product with the same key on different markets are assumed to be the same for all intents and purposes

Locales

A locale is a language and country combination that enables correct handling and analysis of text content. Each market supports one or more locales.

Locales are used to:

  • Analyze and process text content correctly for search and recommendations
  • Improve classification by providing language context
  • Support multilingual content within a single market

Supported locales

The following locales are currently supported:

bg-BG, cs-CZ, da-DK, de-AT, de-CH, de-DE, el-GR, en-001, en-150, en-AU, en-CA, en-GB, en-IE, en-IN, en-PH, en-HK, en-TW, en-MO, en-US, es-ES, es-MX, et-EE, fi-FI, fr-BE, fr-CA, fr-CH, fr-FR, fr-LU, fr-MC, he-IL, hr-HR, hu-HU, is-IS, it-CH, it-IT, ja-JP, ko-KR, lt-LT, lv-LV, nb-NO, nn-NO, no-NO, nl-BE, nl-NL, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sk-SK, sr-RS, sv-FI, sv-SE, tr-TR, uk-UA, vi-VN, zh-CN, zh-HK, zh-TW, zh-MO

×
Copyright

This online publication is intellectual property of Voyado Lund AB. Its contents can be duplicated in part or whole, provided that a copyright label is visibly located on each copy and the copy is used in conjunction with the product described within this document.

All information found in these documents has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither Voyado Lund AB nor the authors shall be held liable for possible errors or the consequences thereof.

Software and hardware descriptions cited in these documents might be registered trademarks. All trade names are subject to copyright restrictions and may be registered trademarks. Voyado Lund AB essentially adheres to the manufacturer’s spelling. Names of products and trademarks appearing in this document, with or without specific notation, are likewise subject to trademark and trade protection laws and may thus fall under copyright restrictions.

CLOSE