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

Comms Expert
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 the type, in this case: 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

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