Login

Security and Compliance

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.

The window for loading product feed into the system

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:

Feed sample

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:title>

<g:brand>

<g:google_product_category>

<g:description>

<g:link>

<g:image_link>

<g:availability>

<g:price>

<g:id>

<g:title>

<g:brand>

<g:google_product_category>

<g:description>

<g:link>

<g:image_link>

<g:availability>

<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 support@yespo.io.

Feed Uploading

Click on the Upload a product data feed button to open the settings window:

Feed settings

Fill in the following information:

  1. The default feed language.
  2. Feed link.
  3. Feed type (Product data type is set by default).
  4. 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.

Set the default feed language

After that, the option to download another version will become available.

Adding translated feed

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:

Setting the language for different feed versions

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

DE, UK, ENG

Primary:
DE

UK, ENG

Primary: 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

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.

Request custom feed

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.

Update frequency

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.

Multilingual feed

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:

Product feed view

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.

Search filter

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.

Set up feed

Click the Update feed now button to update the feed without waiting for the time specified in the settings.

Update feed now

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:

Product feed error notification

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

Errors in product parameters

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.

Errors in the feed language versions

Any Questions?
We’re always happy to help!
Discount services
Schedule a Call
Fill in the form, and our specialists will call you back as soon as possible.
Discount services
Chat Support
We’re waiting for your questions!
Discount services
Email
Contact the support team