Connecting Froomle to your item feed

This page will help you to set up a connection where Froomle will download updates to your item catalogue from a feed provided by your CMS (Content Management System). Note that updates to your catalogue will have a certain delay and we can only ingest feeds according to the following standards. For an optimal item sync and applying advanced business rules, we recommend to use our Items API.

Frequency

Our default update frequency is 15 minutes in order to keep our catalog in sync with your latest updates. Depending on your business this frequency can be adapted, but note that delay depends on the frequency in which your source file is updated. Align with our support team to configure this.

Disabling content

We will specify filters and maximum age of recommendations when configuring your module. Disabling content that should no longer be recommended, can be done by using a specific category for filtering. Align with our support team to configure this.

Supported feed types

XML Feed

Froomle can ingest XML feed files that are according to the Froomle standard item structure. Find an example below. If your feed deviates from this standard, we require you to configure a new feed according to our standard item structure, or use another connector instead. Optional fields not matching the standard will be ignored.

For Froomle to connect to your feed, please provide us with the Feed URL, for example: https://www.mysite.com/myxmlfeed.xml.

XML Example:

<xml>
<item>
///Required fields
<item_id>2003/news-starcity</item_id>
<publication_datetime>Tue, 03 Jun 2003 09:39:21 GMT</publication_datetime>
<environment>mybrandname</environment> ///If not defined we use default
<item_type>article</item_type> ///If not defined we use default item_type
///Optional Fields - Optional fields not matching the standard will be ignored
<title>Star City</title>
<uri>http://liftoff.msfc.nasa.gov/news/2003/news-starcity.asp</uri>
<description>How do Americans get ready to work with Russians aboard the International Space Station? They take a crash course in culture, language and protocol at Russia's <a href="http://howe.iki.rssi.ru/GCTC/gctc_e.htm">Star City</a>.</description>
<category>News</category>
<category>Science</category>
<image_url>http://www.foo.com/article_thumbnail.jpg</image_url>
</item>
<item>
<title>Star City 2</title>
<item_id>2005/news-starcity</item_id>
<uri>http://liftoff.msfc.nasa.gov/news/2003/news-starcity.asp</uri>
<description>Description or full text of article</description>
<publication_datetime>Tue, 03 Jun 2008 09:39:21 GMT</publication_datetime>
<image_url>http://www.foo.com/article_thumbnail2.jpg</image_url>
<image_url>http://www.foo.com/article_thumbnail3.jpg</image_url>
</item>
</xml>

RSS Feed

RSS is a XML standard web feed that allows users and applications to access updates to websites in a standardized, computer-readable format.

The standard on RSS and a validator can be consulted on: https://www.rssboard.org/rss-specification.

We provide a mapping of RSS 2.0 to the Froomle item structure. If your feed deviates from this standard we require you to configure the feed according to our standard item structure. For Froomle to connect to your feed, please provide us with the Feed URL, for example https://www.mysite.com/myrssfeed.xml.

Mapping:

RSS source

Froomle

title

title

link

url

creator

author

pubDate

publication_datetime

category

categories

guid

item_id

description

description

image OR media:content url

image_url

RSS Example:

<rss version="2.0">
<channel>
<title>Liftoff News</title>
<link>http://liftoff.msfc.nasa.gov/</link>
<description>Liftoff to Space Exploration.</description>
<language>en-us</language>
<pubDate>Tue, 10 Jun 2003 04:00:00 GMT</pubDate>
<lastBuildDate>Tue, 10 Jun 2003 09:41:01 GMT</lastBuildDate>
<docs>http://blogs.law.harvard.edu/tech/rss</docs>
<generator>Weblog Editor 2.0</generator>
<managingEditor>editor@example.com</managingEditor>
<webMaster>webmaster@example.com</webMaster>
<item>
<title>Star City</title>
<link>http://liftoff.msfc.nasa.gov/news/2003/news-starcity.asp</link>
<description>How do Americans get ready to work with Russians aboard the International Space Station? They take a crash course in culture, language and protocol at Russia's <a href="http://howe.iki.rssi.ru/GCTC/gctc_e.htm">Star City</a>.</description>
<pubDate>Tue, 03 Jun 2003 09:39:21 GMT</pubDate>
<guid>http://liftoff.msfc.nasa.gov/2003/06/03.html#item573</guid>
<category>News</category>
<category>Science</category>
<media:content url="http://www.foo.com/article_thumbnail1.jpg"/>
<media:content url="http://www.foo.com/article_thumbnail1a.jpg"/>
</item>
<item>
<description>Sky watchers in Europe, Asia, and parts of Alaska and Canada will experience a <a href="http://science.nasa.gov/headlines/y2003/30may_solareclipse.htm">partial eclipse of the Sun</a> on Saturday, May 31st.</description>
<pubDate>Fri, 30 May 2003 11:06:42 GMT</pubDate>
<guid>http://liftoff.msfc.nasa.gov/2003/05/30.html#item572</guid>
<category>News</category>
<media:content url="http://www.foo.com/article_thumbnail2.jpg"/>
</item>
<item>
<title>The Engine That Does More</title>
<link>http://liftoff.msfc.nasa.gov/news/2003/news-VASIMR.asp</link>
<description>Before man travels to Mars, NASA hopes to design new engines that will let us fly through the Solar System more quickly. The proposed VASIMR engine would do that.</description>
<pubDate>Tue, 27 May 2003 08:37:32 GMT</pubDate>
<guid>http://liftoff.msfc.nasa.gov/2003/05/27.html#item571</guid>
<category>News</category>
<media:content url="http://www.foo.com/article_thumbnail3.jpg"/>
</item>
<item>
<title>Astronauts' Dirty Laundry</title>
<link>http://liftoff.msfc.nasa.gov/news/2003/news-laundry.asp</link>
<description>Compared to earlier spacecraft, the International Space Station has many luxuries, but laundry facilities are not one of them. Instead, astronauts have other options.</description>
<pubDate>Tue, 20 May 2003 08:56:02 GMT</pubDate>
<guid>http://liftoff.msfc.nasa.gov/2003/05/20.html#item570</guid>
<media:content url="http://www.foo.com/article_thumbnail4.jpg"/>
</item>
</channel>
</rss>

Most Content Management Systems provide out of the box RSS feeds. You can find a number of links here explaining how to set up such a feed for your CMS:

Wordpress

Automatically produces an RSS feed for the content you create. Every WordPress.com blog has multiple feeds. The main content feed can be accessed by adding /feed/ to your blog’s URL, and you can configure specific feeds. More info

Drupal

Drupal actually comes with two RSS feeds out of the box, and you probably have at least one of them running on your site. Read this blog for more details.

Shopify

Automatically produces an RSS feed for every blog that you create. The feed URL is the URL of the blog page with .atom appended. For example, http://store.myshopify.com/blogs/blogname.atom

JSON Feed

Froomle can ingest JSON feed files that are according to the Froomle standard item structure. Find an example below. If your feed deviates from this standard we require you to configure a new feed according to our standard item structure, or use our Items API instead.

For Froomle to connect to your feed, please provide us with the Feed URL, for example https://www.mysite.com/myjsonfeed.

For a JSON example of an item, refer to our Integration Handbook.

CSV Feed

Froomle can ingest CSV feed files that are according to the Froomle standard item structure. Find an example below. If your feed deviates from this standard we require you to configure a new feed according to our standard item structure, or use our Items API instead.

For Froomle to connect to your feed, please provide us with the Feed URL, for example https://www.mysite.com/mycsvfeed.csv.

CSV Example:

environment,item_id,item_type,title,description,uri,categories,tags,images,publication_datetime
your brand,client_item_id_001,article,Your item title,Full text or a summary,https://www.froomle.com/client_item_id_001,"[ ""/Sports/Football"", ""/News/National"" ]","[ ""Red Devils"", ""Martinez"", ""Heizel"", ""Qatar2022"" ]","[ ""https://www.froomle.com/content/client_item_id_001.jpg"" ]","""2021-07-29T13:02:03+02:00"""
your brand,client_item_id_001,article,Your item title,Full text or a summary,https://www.froomle.com/client_item_id_001,"[ ""/Sports/Football"", ""/News/National"" ]","[ ""Red Devils"", ""Martinez"", ""Heizel"", ""Qatar2022"" ]","[ ""https://www.froomle.com/content/client_item_id_001.jpg"" ]","""2021-07-29T13:02:03+02:00"""

API Feed

If your item catalogue is available on an API endpoint we can access, Froomle can fetch the data. If you want to use this option you need to specify the location, authentication, format & mapping rules of your data to our standard. Based on this we can set up our script to fetch & ingest the data.

⚠️ The Feed read by Froomle integration option is in beta, therefore it involves custom development and timeline. If you are interested in this feature, please contact the Froomle support team.