How to set-up an integration with a third party CMS

  • How do I set up a pull integration with a third-party CMS?

    • The Content Marketing Platform allows you to create an arbitrary amount of “feeds” which can be retrieved via HTTP GET request. Using CMP workflows, you can publish articles to the top of one or more of these feeds. Then, by calling your feed endpoints regularly, you can check for new content, and where it exists, create a new article in your CMS database by mapping fields (article headline, body, author, source,metadata etc) to their respective elements in your CMS

  • I want to include additional information with my articles - such as a call to action or tags. How do I do this?

    • By attaching custom fields to your CMP workflow, you can easily send additional structured data to your CMS. These can be populated with a dropdown, radio button, checkbox, free text or date interface and retrieved from the “custom_fields” node in the feed.

    • A best practice is to always create custom fields for meta tags such as 'Meta Title' and 'Meta Descriptions' to enhance on-page SEO. Ensure that the custom fields are then mapped onto the CMS during ingestion accurately.
  • How do I ensure that the content delivered from the Content Marketing Platform is consistent with my website’s style?

    • All licensed content and by default, all custom content is delivered in purely semantic HTML. This means that while you will still be able to take advantage of h tags etc, they will be interpreted by your website’s global style. The text editor does allow the use of inline styles through raw HTML editing in cases where that is needed, but the standard interface is designed to prioritize the use of semantic HTML only.

  • How do I paginate through my feeds?

    • The pagesize parameter tells our API how many pieces of content you want to retrieve. The offset parameter tells it at which piece of content you want to start. To retrieve the second page of content, increment the offset by the pagesize.

  • How can I manage the updating and deletion of content?

    • Using the fields parameter, you can retrieve only the guid and modified_at elements of the feed. By calling the feeds with pagesize=999 and these fields only to minimize response size, you can determine if an article has been deleted (guid of existing article is no longer present) or updated (guid matches and modified_at has been updated since last poll time)

    • We recommend setting this as a batch task, paginating through full feeds, that can be instigated by an editorial user.

    • We recommend utilizing a Deleted Feed. The user can move an article to the Deleted Feed in the NewsCred Platform. Your integration can then be set-up to recognize when an article has been moved and trigger the 'delete' action when the feed is called from your CMS.
    • Of course, you can also delete the content in the CMS, but we recommend against allowing inconsistencies to develop between the feed and the CMS to avoid unexpected behavior.                   

Was this article helpful?
2 out of 2 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk