Enriching the Product Feeds¶
The better data we receive, the better and more personalized solution we can build for you. You may need to expose additional product attributes in the product feed.
Product feeds & Secondary product feeds¶
The preferred way to add more product data to Hello Retail is to update the product feed with the missing attributes. If altering the original data feed is not an option, Hello Retail supports multiple product feeds. You can create a secondary feed that includes only the additional product attributes.
We match products across feeds by their canonical URL. If you create a secondary product feed, include the product’s canonical URL so we can identify it. Hello Retail will merge the attributes from both feeds.
Note
Maintain one primary feed that includes the full product catalog. Secondary feeds must reference the same products and must not introduce new products. Feeds can contain different attributes. For example, the primary feed can include inventory and price, while a secondary feed includes color and description.
The format for the secondary feed should follow our general guidelines (example feed).
Enrich Product data through HTML¶
If you cannot deliver the additional product data in the product feed, you can add a hidden HTML element on the product page that we will read. This is not ideal and should only be used when adding data to a feed is not possible. Limitations include:
- Product data is only updated when a user visits the product page. Products with low traffic will update less frequently. If you use these fields for search, rarely visited products may not be searchable by those fields until visited.
When using this option, provide the element in the following format.
<div hidden id="hello-retail-product-data" data-hr-color="green" data-hr-size='["s","m","xl"]'>
</div>
You can include any attributes except price. For security reasons, we do not collect price from HTML; price must come from the product feed. If a value contains HTML, HTML-encode the value inside the data attribute.
Example of data types:¶
- Single value:
data-hr-color="blue" - List:
data-hr-sizes='["s","m"]'