Importing a Product Feed

We use a product feed to generate personalized messages and product recommendations based on user behavior on the site. You can import the feed to your account after setting up web tracking on the Web Tracking tab.

👍

Note

Connect one of the advanced features tariffs to use data about user behavior on the site in campaigns.

Uploading feeds — product feed and market feed — happens on the Product Catalog tab.

The Product Catalog tab has three blocks:

• Product Data — uploading the main product feed;
• Market Feed — uploading local prices, availability, and other attributes for different markets;
• Other Options — ordering the setup of additional feeds (for example, a news or promo feed) from our support team.

Product Feed Requirements

The data must be in the XML, RSS 2.0 format according to the Google product specification. The file's mime type must conform to the XML specification application/xml, text/xml, application/rss+xml, application/xhtml+xml. You can see an example on the Feed sample tab in the Product feed block.

👍

Important

We recommend adding as many product parameters as possible to the product feed: size, color, accessory, material, etc. This directly affects the accuracy of the recommendation selection. The more diverse parameters a product feed contains, the more relevant products the message recipient or site visitor will see.

A list of required product attributes depends on which advanced segmentation plan you use in Reteno.

You may need to add attributes to configure some triggers and recommendations on the site. To correctly identify them in the feed, please contact our support team at [email protected].

Uploading a Product Feed

In the Product feed block, click Upload product feed. The settings window will become available:

Fill in the following information:

1. In the Feed URL field, enter a link to the file.
2. The default feed language.
3. Feed type (Product data is set by default).
4. Update frequency — Every day (you can choose a specific time or several times a day, for example at 07:00, 15:00, 21:00, and 02:00), Every week (with a choice of day of the week), or Another period. To request a custom update schedule, select Another period and contact our support team.

Multilingual Feed

If you have several language versions of your website and communication with customers in campaigns in different languages, you can add other feed language versions to your Reteno account. This is also necessary to display product recommendations on the site in the right language.

If the feed contains the optional language parameter according to the Google specification, the language is detected automatically. If the parameter is missing, specify the language manually: click the globe icon in the feed URL field and select the language from the list.

Specify the language of the main feed to get the option to add another language version through the Add translated feed button.

The feed should be the same in content and structure, only in a different language. After specifying a link to the location of the feed, set the language value for it, too, by clicking the globe icon again.

You can delete any added feed language version except the default one.

If you use multilingual messages, the substitution of the feed data into the message will depend on three parameters:

• primary message language;
• availability of the feed language versions;
• the language recorded in the contact card.

For example, German is the default language for multilingual messages, and there are also versions of messages in Ukrainian and English. At the same time, feeds are loaded only in UK and ENG, with the latter set as default. In this case, messages will be sent as follows:

📘

Important

Always set the same default language for messages and the feed.

If you need to work with other feeds, such as news or promotions, order their setup from Reteno support specialists in the Other Options block.

Click Upload now to import the feed to Reteno, or Upload by schedule to wait for the next scheduled update.

Market Feed

If you have several departments, regions, or points of sale (for example, a chain with several branches) where product prices and availability differ, the market feed is designed for this. It lets you set up local prices, availability, and other parameters for each market. The market feed does not replace the main product feed — it complements it with local values.

A market is a region defined by the customer: a country, a city, a specific store, or any other area. Each market has its own unique market identifier. This same identifier is also stored as a system field in the contact card and in the order — this lets you show the user recommendations and prices that match their market.

Uploading a Market Feed

In the Market Feed block on the Product Catalog tab, click Upload market feed.

Enter a link to the CSV file in the Feed URL field.

👍

Important

• You can upload the market feed only after you've uploaded the main product feed.
• The market feed update frequency is not configured separately: it always syncs with the main product feed and updates on the schedule set for it. If you change the product feed schedule, the market feed will update according to the new schedule.

Click Upload now with the Product Feed to import the market feed right away together with the main feed, or Upload by schedule to wait for the next scheduled update.

Market Feed Requirements

The market feed is a CSV file. If a product has no row in the market feed for a given market, it is considered unavailable in that market and will not be shown to the user.

Required fields:

• id — must match the id in the main product feed;
• marketId — market identifier;
• availability — product availability in this market (1 — in stock, 0 — out of stock);
• salePrice — current product price in this market.

Optional fields:

• price — old price (before discount);
• currency — currency code;
• new — new item indicator.

You can see the file format on the Feed sample tab in the Market Feed block.

CSV file example:

id,marketID,availability,price,salePrice,currency
TV_123456,Kyiv_1,1,3000.00,2980.00,UAH
TV_123456,Kyiv_2,1,2990.00,2960.00,UAH
Laptop_1234590,Dnipro,1,12900.00,12800.00,UAH
Laptop_1234590,Odessa,0,13100.00,13000.00,UAH

In this example, the product TV_123456 is available in two markets (Kyiv_1 and Kyiv_2) at different prices — salePrice is the current price, price is the old price. The product Laptop_1234590 is unavailable in the Odessa market (availability is 0).

A contact belongs to a specific market only when marketId is set in their profile. If a contact has no marketId, the market feed restrictions don't apply to them.

Managing the Market Feed

To get to the settings page where you previously added the market feed, click Set up feed in the Market Feed block.

To delete the market feed, click Delete feed in the Market Feed block and confirm the deletion in the confirmation window.

Checking the Correctness of the Product Feed and Product Preview

After a successful upload of the main product feed, the following data will appear:

• the number of products in the feed;
• products in stock;
• products with a price equal to 0;
• products with non-existent categories (for example, you have category 1, category 2, category 3, and some products are assigned categories 4-7 that do not exist);
• products that do not have a category.

The number of products with a price equal to 0, with non-existent categories, and without categories should tend to zero.

If you uploaded a multilingual feed, you will see several tabs with the corresponding language versions.

Click the View products button to make sure the product data has been pulled in correctly.

In addition to invalid product groups, here you can see all feed positions or create a specific segment for viewing. For example, products in the Jackets category.

Missing product information will be marked in red. Use the filter in the upper left corner to display error data for a specific parameter. The filter helps you find products with errors in the following parameters:

• ID;
• name;
• brand;
• target page URL;
• price;
• category;
• product availability;
• image availability.

To get to the settings page where you previously added the product feed and set its update frequency, click Set up feed in the Product feed block.

Click Update feed now to update the product feed manually.

Possible Errors

A feed may fail to upload due to certain errors. In that case, an error message with a description will appear.

Errors common to both the product feed and the market feed:

Errors specific to the product feed:

Errors specific to the market feed:

When using a multilingual feed, errors can occur only in certain versions of it. In that case, the tab with that feed will be highlighted in red. This version will not affect the other feeds, and you will only need to fix the error in this version. When you receive an error notification, follow the recommendations, make the necessary changes, and re-upload the feed. Until then, the previously successfully uploaded version will be used, or nothing if this is the first upload.

FAQ

What happens if a product has no row in the market feed?

The product will be considered unavailable in the market for which there is no corresponding row, for contacts with the matching marketId, and it will not be shown to the user in recommendations.

In what order should I upload the product feed and the market feed?

Upload the main product feed first. You won't be able to upload the market feed without it: the market feed only contains local prices, availability, and other attributes, it references products by the id field from the main feed, and it doesn't contain data about the product itself (name, description, image, etc.).

Do I need to pass the market identifier for a contact separately?

Yes. For recommendations and prices to match a specific user's market, the market identifier needs to be passed in web tracking events and stored in the contact card. If a contact has no market identifier, recommendations are generated without taking the market into account — based on the general catalog.