Content Sources (via RSS)

OVERVIEW

Using sources allows you to pull content relevant to your Audience into your Content Hub from an external source. Our system will pull in stories from the active sources in your Instance at the top of every hour.

EFFORT

Basic
This is an approximation based on average time spend for existing Cerkl Broadcast clients.

ROLES

No items found.
These are the suggested technical resources needed to complete this task.

Content sources and Cerkl's XML Namespace

In any RSS or Atom feed, Cerkl treats all items or entries as updates with normal priority. Cerkl namespace enables users to specify content priority and also its type: Needs or Events.

Items in a feed will not be pulled in if the item’s date is properly formatted and an hour old, the item doesn’t have a date, title, or link, the RSS item doesn’t have a description or the item’s title is the same as another post from the past 30 days.

Priority

<cerkl:priorityneed>" 1 "</cerkl:priority>

Tag Description
cerkl:priority (Optional) 0 for normal. 1 for top priority. Default: 0.

Types

Needs

<cerkl:need>
       <cerkl:quantity>1</cerkl:quantity>
       <cerkl:date_needed>20 Aug 2016</cerkl:date_needed>
   </cerkl:need>
Tag Description
cerkl_quantity (Required) The quantity needed
cerkl:date_needed (Required) The goal date to receive the requested quantity by

Events

<cerkl:event>
       <cerkl:date_start>Wed, 20 Aug 2016 12:50:30 +0000</cerkl:date_start>
       <cerkl:all_day>false</cerkl:all_day>
       <cerkl:date_end>Wed, 20 Aug 2016 12:51:30 +0000</cerkl:date_end>
       <cerkl:location>Innovation Center</cerkl:location>
   </cerkl:event>

Tag Description
cerkl_date_start (Required) The datetime value when the event is starting. Default timezone is UTC -5
cerkl:all_day (True or False) If False, cerkl:date_end is required
cerkl_date_end The datetime corresponding to when the event is ending
cerkl_location (Optional) Event location

Examples

RSS

<?xml version="1.0" encoding="UTF-8" ?>
   <rss version="2.0" xmlns:cerkl="https://app.cerkl.com/cerkl-ns/1.0/">
       <channel>
           <title>Super Awesome</title>
           <link>http://www.super.awe.some</link>
           <description>Super Awesomeness</description>
           <lastBuildDate>Thu, 18 Aug 2016 10:30:00 -0500</lastBuildDate>
           <item>
               <title>Super Awesome Jobs</title>
               <link>http://examp.le/need</link>
               <description>We are looking for highly motivated, highly dedicated candidates!</description>
               <pubDate>Thu, 18 Aug 2016 10:30:00 -0500</pubDate>
               <cerkl:priority>1</cerkl:priority>
               <cerkl:need>
                   <cerkl:quantity>3</cerkl:quantity>
                   <cerkl:date_needed>01 Sep 2016</cerkl:date_needed>
               </cerkl:need>
           </item>
           <item>
               <title>Team Lunch</title>
               <link>http://examp.le/event</link>
               <description>Super Awesome Team Lunch is happening this Wednesday!</description>
               <pubDate>Mon, 15 Aug 2016 10:00:00 -0500</pubDate>
               <cerkl:priority>1</cerkl:priority>
               <cerkl:event>
                   <cerkl:date_start>Wed, 17 Aug 2016 12:30:00 -0500</cerkl:date_start>
                   <cerkl:all_day>false</cerkl:all_day>
                   <cerkl:date_end>Wed, 17 Aug 2016 14:00:00 -0500</cerkl:date_end>
                   <cerkl:location>Super Awesome Restaurant</cerkl:location>
               </cerkl:event>
           </item>
       </channel>
   </rss>

Atom

<?xml version="1.0" encoding="UTF-8"?>
   <feed xmlns="http://www.w3.org/2005/Atom" xmlns:cerkl="https://app.cerkl.com/cerkl-ns/1.0/">
       <title>Super Awesome</title>
       <link type="application/atom+xml" rel="self" href="http://www.super.awe.some" />
       <updated>Thu, 18 Aug 2016 10:30:00 -0500</updated>
       <author>
           <name>Super Awesome</name>
           <uri>http://www.super.awe.some</uri>
       </author>
       <id>http://www.super.awe.some</id>
       <icon>https://app.cerkl.com/profiles/orgs/</icon>
       <generator uri="https://cerkl.com" version="1.0">
           Cerkl: Personalization. Automated.
       </generator>
       <entry>
           <author>
               <name>SA</name>
           </author>
           <title>Super Awesome Jobs</title>
           <id>http://examp.le/need</id>
           <link type="text/html" rel="alternate" href="http://examp.le/need"/>
           <content><![CDATA[ We are looking for highly motivated, highly dedicated candidates!]]></content>
           <updated>Thu, 18 Aug 2016 10:30:00 -0500</updated>
           <cerkl:priority>1</cerkl:priority>
           <cerkl:need>
           <cerkl:quantity>3</cerkl:quantity>
           <cerkl:date_needed>01 Sep 2016</cerkl:date_needed>
           </cerkl:need>
       </entry>
       <entry>
           <author>
           <name>SA</name>
           </author>
           <title>Team Lunch</title>
           <id>http://examp.le/event</id>
           <link type="text/html" rel="alternate" href="http://examp.le/event"/>
           <content><![CDATA[ Super Awesome Team Lunch is happening this Wednesday! ]]></content>
           <updated>Mon, 15 Aug 2016 10:00:00 -0500</updated>
           <cerkl:priority>1</cerkl:priority>
           <cerkl:event>
               <cerkl:date_start>Wed, 17 Aug 2016 12:30:00 -0500</cerkl:date_start>
               <cerkl:all_day>false</cerkl:all_day>
               <cerkl:date_end>Wed, 17 Aug 2016 14:00:00 -0500</cerkl:date_end>
               <cerkl:location>Super Awesome Restaurant</cerkl:location>
           </cerkl:event>
       </entry>
   </feed>

More info here.

INFO
If you have any questions at all, don’t hesitate to reach to our team via email support@cerkl.com or use the chat support in the bottom right-hand corner of any cerkl.com page for a quick answer.
Sections
PriorityTypesExamples