A data entity type can be defined as an object with certain properties, a key and value map. There are three main data entity types in Voyado Elevate 3: product, category, and ad.
The data entities are derived from a retailer's own systems, such as PIM, CMS, CRM, and ERP, and transformed by the retailer (or an implementing partner) into Elevate compatible XML and imported into Elevate with the RESTful API.
Each entity type have user-defined and configurable attributes as well as reserved attributes and attribute names. The attributes are based on a retailer's data model. The data model can be considered as the design specification for the XML, and lays the groundwork to a successful Elevate integration.
A general recommendation is that all data that can be used in Elevate such as attributes for sort, search, presentation, facets, and so on should be used in Elevate. This includes copy such as product descriptions from a CMS and price data from a PIM.
Reserved attributes and reserved attribute names, also known as reserved words for attributes, are not the same thing. A reserved attribute is an attribute with a name that is allowed in the data model but will be interpreted by Elevate in a specified way. A reserved attribute name is a word that is not allowed in the data model. Each data entity have their own set of reserved attribute names. Using a reserved attribute name in a data model will result in import errors.
A product is the main data entity in Voyado Elevate. Together with variants, it is how content is mainly represented in Voyado Elevate and hold all necessary information of an actual product. Products can have variants and be a part of one or several categories.
Variants are items that represent a product but due to different characteristics, or business reasons, must be accounted for separately. Variants can be placed in two different ways in a data model. Either the variant is nested inside the product or it is a stand-alone entity that has a product key link that connects it to its parent product. Product and variant keys must be unique.
Reserved product attributes
The following product attributes are reserved in Voyado Elevate:
product_key, variant_key, locale
Reserved product attribute names
The following product attributes names are reserved in Voyado Elevate:
Categories are modeled as a tree structure that is defined during imports. There is always a root and all categories have an identifying parent category.
Categories and products are tightly coupled as a category contains products and a product is a part of one or more categories. This relationship is also defined during the imports.
The maximum number of category trees is 100 and a category tree has a max depth of 10 levels. A tree can hold maximum 10 000 categories and each category can hold up to 100 attributes.
Categories also support custom attributes to enable retrieval of images, links, or localized names directly from a result without multiple queries.
Reserved category attribute names
The following category attributes names are reserved in Voyado Elevate:
The following example showcase the XML structure of a basic category tree. The category tree attribute product_attribute="section" is used to connect to the category attribute of a product. The corresponding category key value men-shoes-running-shoes can be found in the Fashion/apparel/lifestyle product example.
Ads are used to add banners, content blocks, and static page links to pages in addition to products that is relevant in the context. Context can be different for each visitor of a site.
Ads can be used as a static ad where static data is used. Ads can also be used as a live ad where static data is used together with a number of products connected to the ad, live products. Which products a visitor is shown in the ad depends on the visitor and how popular the products in the ad are. Products in a live ad will be internally ranked based on the active exposure strategy as set in the Business app, and will be personalized if possible.
Reserved ad attribute names
The following ad attribute names are reserved in Voyado Elevate:
A data format for managing synonyms was introduced with the Web API v2. Synonyms are used to extend searches of a phrase to include similar search phrases.
A synonym includes a locale, one search phrase, and one synonym phrase that will be used together with the search phrase. If the synonym is valid for all locales, the value global should be used.
Reserved synonym attribute names
The following synonym attribute names are reserved in Voyado Elevate:
locale, search_phrase, synonym_phrase
Data type availability
The synonym data entity type format is available with the Web API v2 only.
Special characters
Special characters in synonyms must be escaped using a preceding backslash, for example \' and \".
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.