Understanding Lytics / Product Documentation / Content Affinity Engine

Content Collections

Content collections allow you to programmatically partition the documents which has been scraped and analyzed by the Lytics content affinity engine. Where audiences are segments of users, collections are segments of content. This is not only useful to view and curate content at a macro level, but building a content collection is also an essential step in the process of setting up content recommendations.

Building a content collection

You can build a content collection in Lytics by navigating to Content > Collections from the dashboard. Then click the New Collection button above the list of current collections in your account.

Collections can either be dynamic or locked. In the collection builder you can toggle this between these two options.

collection toggle

Dynamic content collections

Dynamic collections are rule-based, so individual pieces of content may enter or exit the collection over time. Dynamic collections are built by selecting and setting content filters which determine what content is present in the collection at any given time. Preview content currently in the collection by hovering over a content card and clicking Preview this content.

For example, you can create a collection that includes all articles published in the last 7 days. This setting is ideal for making sure your content collection remains fresh.

Locked content collections

A locked content collection is a static collection of documents that you hand-select using the collection builder. Content filters can be used as a searching mechanism to help find the specific documents you would like to add to your custom collection. You can add content items to the collection by hovering over a content card and clicking Select this content.

hover state

Selected content items are indicted by cards with a blue border. Once you save the collection, documents are not added or removed until you edit and save the collection again.

selected content

Content Filters

There are a number of filters available when navigating the content collection builder. These filters can be combined in such a way that narrow down the documents in the collection using "AND" logic.

Filter content by title, description, or URL

This filter acts as a catch-all text search for the title, description, and URL of the document. It can be a full or partial match to any of these fields, and the input is case sensitive. You can enter multiple values for this filter type, and the results are not mutually exclusive. That is, if you have entered the search terms "Dog" and "Cat", each of the documents returned should contain "Dog" or "Cat", but not necessarily both ("OR" logic).

Perhaps the most common use of this field is to filter by a url path. For example, say you're looking to build a dynamic collection of all blog posts from your website, and the URL of your blog posts match the following pattern: http://yourdomain.com/blog/name-of-your-post. To build this collection you can enter /blog/ into this filter.

blog filter

Content type

The type of a document is derived by the Lytics content affinity engine while analyzing and indexing the document. A document maybe be classified as any of the following:

  • Article
  • Discussion
  • Email
  • FAQ
  • Image
  • Job
  • Other
  • Person
  • Post
  • Product
  • Profile
  • Video

These checkbox filters allow you to to view content of only the selected type(s). For example, if you want to build a dynamic collection of videos to recommend to users, you might select the Video content type.

video filter

Published date

This filter allows you to limit documents based on their date of publication. You may filter documents published after a date relative to the current time or after a static date in time. Relative dates may be set by increments of days, weeks, months, or years.

Using a relative date filter allows you ensure that the content in your collection is evergreen. For example you may want to only recommend content that was published in the last week:

evergreen content

If you launched a new product recently, you may want to build a collection of content relevant to that launch. Using the static date filter set to the day before the launch, combined with other filters could help achieve this.

static date filter

Features

The features filter allows you to select whether or not the content should have a description and/or a thumbnail image. Both the image and description fields are extracted from HTML meta tags during the scraping process of the content affinity engine. Enabling these settings may be especially useful if you are looking to implement content recommendations into a space on your website and you wish to include more than just a title and link to the content.

features filter

Author

The author filter allows you to include only articles written by the author(s) selected. If you have a long list of artists, you can use the search bar to find the author(s) you are looking for.

author filter

Topics

The topics filter lists all the topics present in your account. You may select one or multiple to filter the content by. You can use the search bar to find the topics you are looking to filter by. Building a collection filtered by topic can be especially helpful when running a topic specific campaign. For example, if you're running a holiday campaign you may build a collection related to a number of holiday topics:

topics-filter

Advanced filtering

If you are looking to filter your content by an additional field such as product ID, word count, or language, this is possible by creating a content collection through the Lytics REST API. Content collections can be created through the segment create endpoint content as the source table. To create the filter, you must make a request containing SegmentQL. If you need assistance creating a custom content collection, you can reach out to our support team [email protected].

Content Collection Overview

You can view the summary, or overview page for an existing content collection by navigating to Content > Collections. Then click into an existing collection from the list.

Reporting & Statistics

You should see a summary page which will include some statistics for the collection such as the number of documents in the collection, the number of topics relevant to those documents, and the number of campaigns the collection is used in. There are additional charts reflecting the breakdown of authors and the top 8 topics in the collection. You can also see the history of edits to the collection, and which Lytics personalize campaigns are currently using the collection.

content collection summary

Documents view

Under the documents tab,there is a list of documents in the collection in a similar tiled view as the editor. From this view you can preview any of the docs by clicking Preview this content when hovering over the tile.

content documents view

Managing Content Collections

From the overview page you can edit a content collection by clicking the Edit button, this will take you to the content collection builder. You can also duplicate or delete the current collection from the menu under the ... icon. Duplicating the collection will take you to the builder to edit a new content collection with the same definition.

duplicate and delete

NOTE: The option to delete the collection will not be present if it is used in a personalize campaign. To delete it, you must remove it from any and all active campaigns it is being used in.

Content Recommendations

For more information, see how the recommendation engine can use collections in recommendations.