Skip to content

Setting Up MRSS Feed with Outbound Feeds

Feed Setup

The MRSS feed is a platform level Arc feed block with configurable and customizable parameters.

See How to set up and configure an Outbound Feed to configure the Media RSS feed.

Channel Configuration

1. RSS Title

Value for RSS title.

default: feedTitle environment value

2. RSS Description

Value for RSS description.

default: feedTitle + " News Feed"

3. RSS Language

Value for RSS language using an ISO-639 value. If left blank it will default to the value of feedLanguage set in your blocks.json. The tag can be removed by entering ā€œExcludeā€ in the field.

default: blank (uses feedLanguage)

4. Logo URL

Optional fully qualified URL of an image to use as the logo for the RSS feed.

default: no logo

Item Configuration

1. Title

ANS field(s) to use for the article headline, supports a JMESPath statement.

default: headlines.basic

2. Description

ANS field(s) to use for the article description, supports a JMESPath statement.

default: description.basic

3. Publication Date

ANS date field to display.

Select one: created_date, display_date, first_publish_date, last_updated_date, or publish_date

default: display_date

1. Include promo Images

Yes/No should the promo_items be added to media:content.

default: true

2. Image height and or width

A set of key value pairs where you can set an integer height and or width to resize all images. Zero means no resizing will be performed.

default: height: 0, width: 0

3. ANS image title key

ANS field for the promo_items title.

default: title

4. ANS image caption key

ANS field for the promo_items caption.

default: caption

5. ANS image credits key

ANS field for the promo_items credits.

default: credits.by[].name

Video

1. Select Video Using Key/Value Pairs

Criteria to be used to match a video encoding.

default: { bitrate: 5400, stream_type: ā€˜mp4’ }

Resolver Configuration

Each feed template needs to have a resolver applied. To create a resolver, you must configure the following fields:

1. Resolver Name

Unique name given to the resolver

2. Resolver Priority

Number to indicate priority order regex will be evaluated in (1 to 100). Lower numbers are evaluated first.

3. Regex Pattern

^/arc/outboundfeeds/mrss/?$|
^/arc/outboundfeeds/mrss/category/(.*)/?$|
^/arc/outboundfeeds/mrss/author/(.*)/?$|
^/arc/outboundfeeds/mrss/keyword/(.*)/?$|
^/arc/outboundfeeds/mrss/tags/(.*)/?$|
^/arc/outboundfeeds/mrss/tags_slug/(.*)/?$

4. URL Parameters

5. Websites

all

6. Content Source

feeds-content-api

There are also two optional content sources available out-of-the-box. See Content sources with Outbound Feeds for more information.

7. Patterns

These positions come from the regex pattern. There are a number of ways to pass a section (or author, keyword or tag) to the content source from the resolver. All of them use a grouping () in the regex.

Section - Pattern 1

^/arc/outboundfeeds/mrss/?$|
^/arc/outboundfeeds/mrss/category/(.*)/?$|
^/arc/outboundfeeds/mrss/author/(.*)/?$|
^/arc/outboundfeeds/mrss/keyword/(.*)/?$|
^/arc/outboundfeeds/mrss/tags/(.*)/?$|
^/arc/outboundfeeds/mrss/tags_slug/(.*)/?$

Author - Pattern 2

^/arc/outboundfeeds/mrss/?$|
^/arc/outboundfeeds/mrss/category/(.*)/?$|
^/arc/outboundfeeds/mrss/author/(.*)/?$|
^/arc/outboundfeeds/mrss/keyword/(.*)/?$|
^/arc/outboundfeeds/mrss/tags/(.*)/?$|
^/arc/outboundfeeds/mrss/tags_slug/(.*)/?$

Keywords - Pattern 3

^/arc/outboundfeeds/mrss/?$|
^/arc/outboundfeeds/mrss/category/(.*)/?$|
^/arc/outboundfeeds/mrss/author/(.*)/?$|
^/arc/outboundfeeds/mrss/keyword/(.*)/?$|
^/arc/outboundfeeds/mrss/tags/(.*)/?$|
^/arc/outboundfeeds/mrss/tags_slug/(.*)/?$

Tags - Text - Pattern 4

^/arc/outboundfeeds/mrss/?$|
^/arc/outboundfeeds/mrss/category/(.*)/?$|
^/arc/outboundfeeds/mrss/author/(.*)/?$|
^/arc/outboundfeeds/mrss/keyword/(.*)/?$|
^/arc/outboundfeeds/mrss/tags/(.*)/?$|
^/arc/outboundfeeds/mrss/tags_slug/(.*)/?$

Tags - Slug - Pattern 5

^/arc/outboundfeeds/mrss/?$|
^/arc/outboundfeeds/mrss/category/(.*)/?$|
^/arc/outboundfeeds/mrss/author/(.*)/?$|
^/arc/outboundfeeds/mrss/keyword/(.*)/?$|
^/arc/outboundfeeds/mrss/tags/(.*)/?$|
^/arc/outboundfeeds/mrss/tags_slug/(.*)/?$

Include - Terms

[{"term":{"type":"video"}},{"range":{"publish_date":{"gte":"now-2d","lte":"now"}}}]

We need to modify the default query so it will only return videos. The date you selected to display for Last Updated Date should also be used in the query. For more details on custom queries, see How to create a custom query with Outbound Feeds.

Exclude - Terms

If you need to exclude terms in your query, i.e. NOT, enter them here as an array formatted the same as the Include-Terms. For example to exclude all content with language ā€œesā€ you would use [{ā€œtermā€:{ā€œlanguageā€: ā€œesā€}}]. For more details on custom queries, see How to create a custom query with Outbound Feeds.

Exclude - Sections

You can enter a comma separated list of sections to exclude. For example /premium,/paid-content.

Feed - Size

Integer 1 to 100. Defaults to 100. If you added a size URL parameter, select the parameter option and select size and enter a default value.

Feed - Offset

Integer. Defaults to 0. If you added a from URL parameter, select the parameter option and select from and enter a default value.

Sort - publish_date:desc

If left blank it will default to publish_date:desc. Which ever date field you selected to display for the Last Modified Date is the date you should enter here. The format is date_field + : + sort order (desc or asc). Valid date fields are created_date, display_date, first_publish_date, last_updated_date, or publish_date.

Source-Exclude - A comma separated list of ANS fields to remove from the default list of ANS fields. See the default list of fields on Content sources with Outbound Feeds.

Source-Include - A comma separated list of ANS fields to add to the default list of ANS fields. See the default list of fields on Content sources with Outbound Feeds.

Include - Distributor - Name

If you only want content from a single distributor, enter the name here. You may only populate one distributor field.

Exclude - Distributor - Name

If you want to exclude content from a single distributor, enter the name here. You may only populate one distributor field.

Include - Distributor - Category

If you only want content from a single distributor category, enter the name here. You may only populate one distributor field.

Exclude - Distributor - Category

If you want to exclude content from a single distributor category, enter the name here. You may only populate one distributor field.

8. Default Template

Select the template you just created mrss-feed to use with this resolver.

9. Default output type

Select xml.

10. Content Mapped Template

blank

Media RSS URL

To preview your MRSS XML, modify the URL below with your client org and website name.

https://outboundfeeds.{CLIENTORG}.arcpublishing.com/pf/arc/outboundfeeds/mrss/?_website={CLIENTWEBSITE}

Additional Information