Listrak Predictive Content enables you to dynamically insert content from your website into your email campaigns.

FEATURES

  • The Listrak Predictive Content Crawler automatically finds and indexes content on your website.
  • The Listrak Recommendation Engine systematically infers subscriber interests based on product browse, product purchase, and content browse activities.
  • Content is assembled when emails are opened to serve each subscriber content relevant to their unique interests.

PREREQUISITES

In order to use Listrak Predictive Content, the Listrak Framework needs to be implemented on your content pages. Contact your Account Manager for your Merchant ID. Replace [Merchant ID] with your unique ID then copy and paste this block of code directly above the</body> tag on your content pages.

<!-- Listrak Analytics – Javascript Framework -->
<script type="text/javascript">
var biJsHost = (("https:" == document.location.protocol) ? "https://" : "http://"); (function (d, s, id, tid, vid) {
var js, ljs = d.getElementsByTagName(s)[0];
if (d.getElementById(id)) return; js = d.createElement(s);
js.id = id; js.src = biJsHost + "cdn.listrakbi.com/scripts/script.js?m=" + tid + "&v=" + vid; ljs.parentNode.insertBefore(js, ljs); })(document, 'script', 'ltkSDK', '[Merchant ID]', '1');
</script>

ACTIVATING THE PREDICTIVE CONTENT CRAWLER

The Predictive Content Crawler is responsible for finding and indexing your website content. There are two ways to tell our crawler which pages are considered content items on your site: URL Rules or meta tags.

You can mix and match the URL rules and Listrak-content meta tags in your configuration. The Listrak-content tag will override any URL rules you have set in the URL rules manager.

ADD URL RULES TO YOUR CONTENT MANAGER

URL Rules use URL patterns to include or exclude areas of a website from being indexed. These URLs can be configured inside the content manager. Rules should be written in regular expression where * equals a wildcard. Rules are read top-to-bottom. As a general rule of thumb, place the includes at the bottom to avoid recommending content items you are trying to exclude.

Example Ruleset:
Exclude: mysite.com/blog/author-pages/*
Exclude: mysite.com/admin/*
Include: blog.mysite.com/*
Include: mysite.com/videos/*

The TEST RULE area can be used to confirm a sampling of content items will be included or excluded.

Listrak encourages you to write rules that exclude the following types of pages:

Paging:
Identify what a URL looks like when you are on the second page of an article or the second page of a category listing. 

For example, if your URLs look like this: mysite.com/blog/article-name/page-2/You could write this rule to exclude anything beyond the first page.Exclude: */page-*/

Category Pages:
To exclude something like this: mysite.com/blog/category/example-category-name/Exclude: */category/*/

Search Pages:
To exclude something like this: mysite.com/blog/search/an-example-search-hereExclude: */search/*

Comment Pages:
For example, if your URLs look like this: mysite.com/blog/article-name/commentsExclude: */comments


ADD LISTRAK-CONTENT TAGS TO EXPRESSLY INCLUDE OR EXCLUDE A SPECIFIC PAGE


If you want more granular control over your content, you can optionally use Listrak-Content meta tags to tell our system which pages are content.

Copy and paste the Listrak-content tag between the <head></head> tags to include or exclude individual content items.

 <meta name="listrak.content" content="true" />
<meta name="listrak.content" content="false" />

When the Listrak-content meta tag is set to true, the page will be eligible to recommend even if the content does not match a URL rule.

When the Listrak-content meta tag is set to false, the content item will not be eligible to recommend even if it matches a rule.

 A QUICK NOTE ON CANONICAL URLS

Canonical URLs are the URLs that you want your visitors to see. To avoid creating duplicate content items, Listrak honors canonical URLs. When a canonical URL is detected, we will index and store content assets and activity under the canonical URL. You should craft your URL rules based on the canonical URL.

 ADDING NEW CONTENT

Once activated, the Listrak Predictive Content Crawler will run on autopilot. Listrak will detect new content as it is published to your website. There is no feed or upload necessary for our crawler to discover new content. If a newly added page has not been indexed, you can visit the page on your site to kickstart the crawl process on that new content item.
 
CONTENT ASSETS

The following assets are stored for each content item:

  • Image
  • Title
  • Description
  • Tags
  • Publish Date
  • Expiration Date
  • Page Views
  • URL

Our crawler looks at the content on your page and any meta tags (including standard meta tags, open graph, etc), to determine the best assets to use for each page. If you are looking for more granular control over what is captured for a particular content item, you can use a Listrak meta tag to specify specific assets.

IMPROVING CONTENT ASSETS WITH LISTRAK META TAGS

By default, Listrak will extract the best possible assets for each content item. To override the defaults, simply add one or more of the following optional meta tags between the <head></head> area of your page.
 
<meta name='listrak.title' content=‘Example Title' />

<meta name='listrak.description' content=‘Here is a short description or teaser text.' />

<meta name='listrak.image' content='http://www.mysite.com/heroimage.jpg' />

<meta name='listrak.published_time' content='2025-01-01 03:56:06' />

<meta name='listrak.expiration_time' content='2025-01-12 03:56:06' />

IMPROVING INTEREST TAGS WITH LISTRAK META TAGS


Listrak uses tags to make content associations. If you wish to improve the interest tags associated with a content item you can pass in one tag or a comma-separated list of tags for each content item, up to 10 tags can be added. We will fill in any remaining tags if you send us less than 10.

COMMA SEPARATED LIST OF INTEREST TAGS (up to 10 tags):
<meta name="listrak.tags" content=“Tag 1, Tag 2, Tag 3" />

INDIVIDUAL INTEREST TAG:
<meta name="listrak.tag" content=“Tag" /> 


CONTENT ASSET META TAGGING TIPS

TITLES: There is no character limit for titles. Pick a length that works for you and then be consistent in your own character count. This will make it easier to build your content designs when you know roughly how much text to expect. We suggest creating titles with more than two words.

DESCRIPTION: There is no character limit for description. Choose a length that works for you and then be consistent in your own character count. 160 characters is a common character count for description.

IMAGE: You should consider two things when selecting an image:

  • Try to select an image that is at least as wide as your widest email template. If you have an email template of 600 pixels, try to use images that are at least 600 pixels in width. This will offer you the greatest flexibility when placing content in your templates.
  • Try to maintain a consistent image ratio. This will give your messages a consistent look and feel. You can also experiment with how your image would look at 600 x 230 x 187 pixels wide– all of which are common layout widths.

TIP: 600 pixels wide x 280 pixels tall is a starter size you could start with if you are unsure where to begin.

PUBLISH TIME: Publish Time is used by Listrak to determine when the content item was created on your website. When using the What's New recipe, for example, Publish Time (date) will be used to determine what content has the most recent Publish Date.

EXPIRATION TIME: Content with a limited shelf life can be set to self-expire after a certain date using the Expiration Time (date) meta tag. For example, if you had content with a sale with a specific end date, you can use the Expiration Time to stop recommending the content after the sale has passed.

NOTE: [* ISO 8601 Data elements and interchange formats - for example 2025-01-01 03:56:06]

 
USING THE CONTENT MANAGER

Once content begins populating in the content manager, you can begin disabling individual items you do not want to recommend. Click the toggle beside any item to disable it.
 
ADDING PREDICTIVE CONTENT TO EMAIL

Once you have eligible content items in your content manager, you are ready to begin adding content to your HTML or Composer emails.

In Composer you have access to the Predictive Content recipe.

In HTML, you have access to the Predictive Content, New Content, and Popular Content recipes. In HTML, you also have the ability to crop images to square or 4:3 aspect ratios.

Recommendations are compiled at the time of open for each person on your list. Each person will receive a unique set of recommendations based on their past behavior. Once an email is opened, the content will not change (so a visitor can go back to read an article they have saved to their inbox).

If the predictive content is sent in a recurring campaign (for example, a weekly email), the subscriber will get a new set of content each time the message is sent. You can create a recurring message and set it on autopilot with confidence that the subscriber will get relevant content every week.
 
REPORTING

The Predictive Content Dashboard gives you insight into how your email subscribers are engaging with content items, tags, and content blocks. For each area, you are able to see the number of times the item, tag or block was recommended, the number of times they were clicked and their click-through rate.
 
FAQ/TROUBLESHOOTING

SCENARIO 1: CONTENT FROM MY WEBSITE IS NOT SHOWING UP IN THE CONTENT MANAGER.

Possibility 1: A required content asset is missing

Content must contain an image, title, and short description to be eligible.
In the content manager, uncheck Hide content that won't be recommended. Is your content item showing but showing as ineligible? If so, add Listrak meta tags to add the missing image, title or description.

Possibility 2: Content does not match a URL rule
Content page must match a content rule or contain a Listrak-Content=true meta tag.
Copy the URL of your content item into a Notepad. Navigate to the content manager and visit the URL Rules tab. Paste the URL into the TEST URL area to confirm the content item matches a URL rule.
See Also: Add URL Rules to Your Content Manager

Possibility 3: Meta content tag is missing
If you are using the meta content method, visit the content item and view the source code to confirm the meta tag is appropriately placed on the page.
See Also: Add Listrak-Content Tags to Expressly Include or Exclude a Specific Page

Possibility 4: A Canonical URL is present and the Canonical URL does not match a rule
View the source of your content page to see if there is a canonical URL meta tag present on the page. If a canonical URL is present, copy and paste the canonical URL into a Notepad. Navigate to the content manager and visit the URL Rules tab. Paste the canonical URL in the TEST URL area to confirm the canonical URL matches a URL rule. Revise your rules accordingly. Content is indexed and stored by canonical URL. Content items that redirect to another URL are ignored in favor of the canonical URL. This prevents duplicate content items from entering your content manager.
See Also: Handling Canonical URLs

SCENARIO 2: DUPLICATE CONTENT IS SHOWING IN AN EMAIL OR IN THE CONTENT MANAGER

Possibility 1: You have duplicate content on your website
Typically, seeing the same article twice in an email or in the content manager, means you have the same information saved in two different URLs. Navigate to the content manager and search for the title of the article to confirm this is the case.
When content is saved more than one place, select a single reference URL and add a canonical URL meta tag to all duplicates of that page. Content is indexed and stored by canonical URL.
See Also: Handling Canonical URLs

SCENARIO 3: PUBLISH DATE IS NOT SET OR THE NEW CONTENT RECIPE ISN'T PULLING IN THE MOST RECENTLY PUBLISHED CONTENT

Possibility 1: Crawler cannot detect a good date from your content
Navigate to the content manager to confirm a publish date is being captured for your content. If the publish date is not being captured, add a Listrak meta tag to set the publish date.
See Also: Improving Content Assets with Listrak Meta Tags

SCENARIO 4: Disabled Content is Being Recommended in Test Messages

Possibility 1: Content is cached from a prior test
Once a content item is disabled in the content manager, it will no longer be recommended to new openers. Anyone who has previously opened the email will continue to see the same content they viewed when they opened the message. Because test emails do not have a unique ID, using the SEND TEST option is not an accurate method to see what recommendation you would receive as a standard email recipient. 

Did this answer your question?