How to place promotions in your newsletter

Learn the different ways to place Letterhead promotions in your newsletter

To place the upcoming promotions scheduled by promoters in your newsletter, first determine which integration method to use with your publishing system. We offer three methods:

1. Copy/Paste HTML

To use this option, your newsletter builder must support HTML editing.

  1. From your newsletter dashboard, find the promotion you want to place in the Upcoming scheduled promotions table — you can sort promotions by their scheduled date, promoter name, and promotion type.
  2. In the Promotion column, click Copy HTML under the promotion type and promoter's organization name.
  3. The window that opens displays the HTML block containing all elements of the selected promotion. Click the Copy button to copy the entire block of HTML:
  4. Paste the HTML code into the correct area of your newsletter editor, based on the promotion type the promoter purchased.
    1. Example in Mailchimp:

2. RSS feeds

To use this option, your newsletter builder must support RSS feed insertion.

To set up your RSS feed, you'll need the URL for the feed, which will give you access to the promotions you have in the system, to find your URL:

  1. From the Letterhead menu, go to Settings, once in Settings click Integrations on the upper right menu
  2. Scroll down to Promotions RSS to find the following URL:
    1. https://api.tryletterhead.com/feeds/promotions/?key=YOUR-KEY-HERE
    2. YOUR-KEY-HERE - you will replace this with your API key
  3. Email support@tryletterhead.com or submit a support ticket to request your API key
  4. To filter your promotions by date, type, or both, update your URL as follows:
Date (format YYYY-MM-DD) https://api.tryletterhead.com/feeds/promotions/?key=YOUR-KEY-HERE?date=2021-03-31
Type (number ID) — to find your promotion type ID, go to the Promotion types page https://api.tryletterhead.com/feeds/promotions/?key=YOUR-KEY-HERE?type=123
Date and Type https://api.tryletterhead.com/feeds/promotions/?key=YOUR-KEY-HERE?date=2021-03-31&type=123

 

Next, you'll log into the platform you use to create your newsletter. The exact process of placing RSS feeds into the newsletter will be different depending on what platform you are using, please review your provider's documentation, or if you use Mailchimp, follow our instructions below.

Using Mailchimp to place RSS promotion feeds 

  1. Pick where you want your promotion to appear in the template and add a text block, or any other block that supports entering text content, to that spot.
  2. Paste the following merge tags into the text block, and be sure to replace:
    1. YOUR-KEY-HERE with your API key
    2. YYYY-MM-DD with the promotion's scheduled date
    3. If you have more than one promotion type that you place in different sections of the newsletter, make sure to add &type=ID to the URL to filter your promotions by type
      *|FEEDBLOCK:https://api.tryletterhead.com/feeds/promotions/?key=YOUR-KEY-HERE?date=YYYY-MM-DD |*
      *|FEEDITEMS: |*
      *|FEEDITEM:CONTENT_FULL|*
      *|END:FEEDITEMS|*
      *|END:FEEDBLOCK|*
  3. RSS feed
  4. Mailchimp is going to do the work of pulling the promotions when you enter preview mode, but it is normal to see the feedblock with the merge tags when working in the editor.

Merge tags do not preview in the Template Editor. To test these merge tags, create a campaign from the saved template and use Mailchimp's preview and test tools. Source: Getting Started with Merge Tags for Email

preview rss promotion

If you'd like to pull a different promotion type in another section of the newsletter, just add another block of text in the new section filtering your promotions by type.

3. API

Our API allows you to access all data associated with your upcoming promotions in real-time. For more details on how to use our API please refer to the article API reference.