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.
Note
Connect one of the advanced features tariffs to use data about user behavior on the site in campaigns.
The feed upload function will become available after you generate a script for your site in the Settings → Web tracking menu. You can switch between the Upload feed and Feed sample tabs.
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. In the right tab, you can see an example:
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 Yespo.
| Advanced | Pro |
|---|---|
| <g:id> | <g:id> |
| <g:title> | <g:title> |
| <g:brand> | <g:brand> |
| <g:google_product_category> | <g:google_product_category> |
| <g:description> | <g:description> |
| <g:link> | <g:link> |
| <g:image_link> | <g:image_link> |
| <g:availability> | <g:availability> |
| <g:price> | <g:price> |
| <g:sale_price> | |
| <g:new> |
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].
Feed Uploading
Click on the Upload a product data feed button to open the settings window:
Fill in the following information:
- The default feed language.
- Feed link.
- Feed type (Product data type is set by default).
- Update frequency.
Multilingual feed
If you have several language versions of your website and communication with customers in campaigns in different languages, add other feed language versions. The language of product recommendations on the site may also depend on feed language versions.
Language detection occurs automatically if you add an optional language parameter to the feed according to the Google specification. If it is missing, you can configure the settings manually by clicking on the globe icon in the field where you need to enter the feed URL. Specify the default feed language here.
After that, the option to download another version will become available.
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 on the globe icon again:
If you use multilingual messages, the substitution of the feed data into the email 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, the latter is set by default. In this case, messages will be sent as follows:
| Contact languages | Message languages | Feed languages | Result |
|---|---|---|---|
| UK or ENG | The contact will receive a message in the corresponding language with product substitution in the same language | ||
| DE | Will not receive a message because there is no feed on DE | ||
| Not specified | DE, UK, ENG Primary: DE | UK, ENG Primary: ENG | Will not receive a message, because the DE feed, which is not in the system, should also be pulled into the main version of the message (DE) |
| ESP (or any other language other than the language of messages) | Will not receive a message, because the DE feed, which is not in the system, should also be pulled into the main version of the message (DE) |
Important
Always set the same default language for message and feed.
By default, only the product feed can be uploaded to the system. If you need to work with other feeds, such as news or promotions, order their setup from Yespo support specialists.
Setting update frequency
The feed update frequency is the same for all its language versions. When setting up a schedule, choose one of three options:
- Every day at a certain time;
- Every week on a specific day and time;
- Another period — selecting this option will open a chat window with our support, where you can order a special feed update schedule.
When setting the feed update frequency in Yespo, build on the actual update of your product list.
You can download the feed instantly or schedule a time (e.g., if you set up web tracking in the morning, but you have a product feed update scheduled at 20:00).
Checking the correctness of the feed and product preview
After a successful feed downloading, 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, without categories should tend to zero.
If you have added a multilingual feed, you will have several tabs with different versions.
To make sure that the product data has been pulled up correctly, click the View products button.
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 category Jackets:
Missing product information will be marked in red. Use the upper left corner filter to display error data for the required parameter. The filter helps to find products with errors by:
- Product ID;
- Product Name;
- Product Brand;
- Product URL;
- Product Price;
- Product Category;
- Product in Stock;
- Product Image.
To get to the settings page where you previously added a feed and set the frequency of its updates, click the Set up feed button in the general web tracking settings section.
Click the Update feed now button to update the feed without waiting for the time specified in the settings.
Possible mistakes
A feed may be invalid if there are errors in the structure. In this case, it will not load, and an error will appear with a description of what needs to be done:
You may also encounter other errors when loading a feed. List of the most common ones:
| Description | Recommendation |
|---|---|
| The resource is not available at the specified URL | The resource must be accessible via HTTP or HTTPS |
| Unsupported file format | Only XML files are supported |
| Some products are missing required parameters: - google_product_category - product_type | The product feed must conform to one of the Google RSS 2.0 XML specifications Look at the feed example |
| Internal service error | Contact support |
When using a multilingual feed, errors can only be detected in certain versions of it. In this case, the tab with such a feed will be highlighted in red. This version will not affect other feeds, and you will only need to fix the bug in this version. If you receive an error notification, follow the recommendations, make the necessary changes, and re-upload the feed. Up to this point, the previously successfully uploaded version will be used or nothing if the addition is the first.
Updated 4 months ago