Skip to content

Multiple Markets

A market can be view as a data containment area that separates behaviour data from different sites. The different functions of the Apptus eSales apps are divided, used, and managed by market. The market definition is at the core of eSales Enterprise functionality and is highly linked to the business needs of the retailer.

Defining a market

A market can be considered as a group of visitors the can benefit from the behavioural data from other each other. The most common market definition is a geographical location, such as a country. It can also be a visitor segmentation based on their business need, such as carpenters and plumbers, that use the same retailer but with different expectations on product relevance.

To ensure quality in behavioural data, a decent amount of visitor interactions must be present on each market.

Multiple markets and products

There are three approaches when considering how to model products in regard to the market definitions.

  1. A product is unique per market and the market has one locale. This is the eSales standard.
  2. A product is unique per market and the market has several locales. This requires localised attributes.
  3. A product is not unique per market and is used on several markets. This is recommended to be used when segmenting a market based on visitor business needs.

The most common approach is to use one product per market and locale, even for retailers with more than one market.

Import products and variants

Products and variants all have their unique identifying keys. Using markets requires the keys to also be unique even though the actual product item is the same.

A common approach is to append both the product and variant keys with the market identifier. For example a product key used in a market with one locale, <product_key>1234567-1</product_key>, can in a multi-market site be <product_key>1234567-1_fr_ca</product_key> and <product_key>1234567-1_en_ca</product_key>.

It is recommended to include a product attribute defining what markets the products are available in. This is to ensure functionality such as Promotions and Demotions in eSales.

Example

Fashion/apparel/lifestyle product example
...
<product>
    <product_key>1234567-1_en_ca</product_key>
    <title>Free Run 2</title>
    <url>/en_ca/products/1234567</url>
    <has_image>true</has_image>
    <image_url>/images/products/1234567-1.jpg</image_url>
    <price>99.00</price>
    <market_id>en-CA</market_id>
    <locale>en-CA</locale>
    <release_date>2017-03-10</release_date>
    <section>men-running-shoes</section>
    <brand>Nike</brand>
    <colour>Black</colour>
    <variants>
        <variant>
            <variant_key>1234567-1-42_fr_en</variant_key>
            <size>42</size>
            <in_stock>true</in_stock>
        </variant>
        <variant>
            <variant_key>1234567-1-43_fr_en</variant_key>
            <size>43</size>
            <in_stock>true</in_stock>
        </variant>
    </variants>
</product>
<product>
    <product_key>1234567-1_fr_ca</product_key>
    <title>Free Run 2</title>
    <url>/fr_ca/products/1234567</url>
    <has_image>true</has_image>
    <image_url>/images/products/1234567-1.jpg</image_url>
    <price>99.00</price>
    <market_id>fr-CA</market_id>
    <locale>fr-CA</locale>
    <release_date>2017-03-10</release_date>
    <section>garçon-running-chaussures</section>
    <brand>Nike</brand>
    <colour>Noir</colour>
    <variants>
        <variant>
            <variant_key>1234567-1-42_fr_ca</variant_key>
            <size>42</size>
            <in_stock>true</in_stock>
        </variant>
        <variant>
            <variant_key>1234567-1-43_fr_ca</variant_key>
            <size>43</size>
            <in_stock>true</in_stock>
        </variant>
    </variants>
</product>
<product>
    <product_key>1234567-2_en_ca</product_key>
    <title>Free Run 2</title>
    <url>/en_ca/products/1234567/2</url>
    <has_image>true</has_image>
    <image_url>/images/products/1234567-2.jpg</image_url>
    <price>99.00</price>
    <market_id>en-CA</market_id>
    <locale>en-CA</locale>
    <release_date>2017-03-10</release_date>
    <section>men-running-shoes</section>
    <brand>Nike</brand>
    <colour>White</colour>
    <variants>
        <variant>
            <variant_key>1234567-2-42_en_ca</variant_key>
            <size>42</size>
            <in_stock>false</in_stock>
        </variant>
        <variant>
            <variant_key>1234567-2-43_en_ca</variant_key>
            <size>43</size>
            <in_stock>true</in_stock>
        </variant>
    </variants>
</product>
...
×
Copyright

This online publication is intellectual property of Apptus Technologies. 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 Apptus Technologies 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. Apptus Technologies 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