Multiple markets¶

A market can be view as a data containment area that separates behavior data from different sites. The different functions of the Voyado Elevate apps are divided, used, and managed by market. The market definition is at the core of Elevate 3 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 behavioral 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 behavioral 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.

A product is unique per market and the market has one locale. This is the Elevate standard.
A product is unique per market and the market has several locales. This requires localized attributes.
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 boost and bury in Elevate.

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>
    <color>Black</color>
    <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>
    <color>Noir</color>
    <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>
    <color>White</color>
    <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>
...