DocumentationAPI ReferenceChangelog

Tag Filtering

Suggest Edits

Guide to Using Tag Filtering for Device-Specific Content

Introduction:

Tag filtering is an advanced feature allowing for the targeted delivery of content based on device specifications. By setting tags on pages within playlists and on media within media folders, users can ensure that only content that matches device criteria is displayed. This guide will help you understand and utilize tag filtering for displaying different content on various devices.

1. Understand Tag Types:

  • Required Tag: If a page has a required tag, it will only be displayed on devices that have this tag.
  • Ignored Tag: If a page has an ignored tag, it won't be displayed on devices that have this tag.
  • Media Tags: These are tags associated with media files within a media folder. They determine which devices the media content can be displayed on.

2. Setting Up Tags on Playlists:

  • Navigate to the desired playlist.
  • For each page within the playlist, you'll find options to add both "Required Tags" and "Ignored Tags".
  • Add Tags:
    • If you want a page to be shown only on specific devices, add the respective tag(s) in the "Required Tags" section.
    • If you want a page to be excluded from specific devices, add the respective tag(s) in the "Ignored Tags" section.

3. Setting Up Tags on Media Folders:

  • Navigate to the desired media folder.
  • Here you'll find a tag filtering option. This matches tags of the media folder to media files within it.
  • For each media file, you can:
    • Add Media Tags: These determine on which devices the media can be displayed. If a device has no tags, it will display all media that doesn't have tags.
    • Activate 'Non-matching Fallback': Toggle this option if you want the media to be displayed on all devices irrespective of tags.

4. Configuring Device Tags:

  • Navigate to the device settings.
  • Here you can add or remove tags that the device possesses. This will determine the content it receives from playlists and media folders.
  • Ensure that the device tags align with the tags set on playlist pages and media files for appropriate content filtering.

5. Behavior of Tag Filtering:

  • When content is pushed to a device:
    • The system will first check the tags of the device.
    • It will then match these tags against the tags set on the playlist pages and media files.
    • Based on matches and mismatches, the system will filter and deliver content accordingly.
    • Media with 'Non-matching Fallback' active will always be delivered.

Examples of Tag Filtering:

  1. Playlists:

    • Scenario: A retail store wants to display a winter sale promotion only on devices in their stores located in cold regions.
    • Solution: They can add a "winter_region" tag to the winter sale page within their playlist. Devices in cold-region stores should also have the "winter_region" tag.

  2. Media Folders:

    • Scenario: A restaurant wants to display vegetarian dishes media to devices in their vegetarian section and non-vegetarian dishes to the rest.
    • Solution: Media files showcasing vegetarian dishes can have the tag "vegetarian". Devices in the vegetarian section should also have the "vegetarian" tag. Media files showcasing non-vegetarian dishes can activate the 'Non-matching Fallback' option to be shown everywhere else.

Conclusion:

Tag filtering is a powerful tool that provides granular control over content delivery based on device criteria. By appropriately tagging content and devices, businesses can ensure that the right content reaches the right audience, optimizing the user experience.

Updated 7 months ago