Tagging

the brightauthor\ connected tagging feature lets you create tags to organize your media and playlists and play different content on different players this page describes the different types of tags, provides an example of how to create and apply them, and explores some advanced tagging options unique to brightauthor\ connected tag types user tags to add tags to media and players, you must assign the following values in the user tags menu (note that tags can simply be a name, or can be more complex and contain a name, type, and value) tag name enter any name to describe the tag tag type select either string , numeric , boolean , date , string array , or numeric array the value of the tag will match the tag type for example, if you select numeric , your tag value must be numeric value boolean and date tags will automatically provide valid value formats "you may get an "unable to save tag for device please try again!" error when adding user tags to a device this message is incorrect your user tags will save and you can close the error message or navigate away from it " player tags player tags are applied to registered players on a network instead of to media content to access player tags, select a player in the network tab and then open the tags menu in the right pane this will let you assign the same tag fields to that player as you can assign to content with user tags (see user tags, above, for more details about these fields) system tags system tags are built into brightauthor\ connected system tags are innate properties like media type (video, image, audio), file location, and file name, and are automatically generated for all tagged media in brightauthor\ connected system tags are treated the same as user tags and can be used in media rules on tagged playlists tagging content to create a content tag create a folder and make sure that the content you want to tag is in that folder select the content ( fluffycat jpg in image 1) select the tags section on the right expand the user tag drop down, and select add tag expand the new tag and enter the tag name and value ( value is not mandatory) see user tags, above, for an explanation of the different fields select the save icon in the top right a tag symbol will appear in the top left corner of the content thumbnail (see the arrow in image 1), and a success notification will appear at the top of the screen for all non array tag types, each tag may only have one unique value per piece of media for more information about how array tag types work, see advanced tagging , below currently, tags cannot be assigned to more than one media item at a time tagging players to create a player tag you should have already created a tag name and value pair for your content (see tagging content, above) select a registered player under the network tab add the tag name and value in the tag menu at right as you type, a drop down menu will appear with tag names that have already been entered on media assets to ensure that you enter the correct name/value select the save icon in the top right creating tagged playlists once content has been tagged, you can create tagged playlists which contain all relevant tagged media and which will automatically track tag additions or removals tagged playlists use media rules, which can use system and user tags, to determine their contents create and apply your tags to your media before creating a tagged playlist, so you can view contents in real time as media rules are applied tagged playlists only pull from the selected content library directory in order to create the playlist with all the content desired, make sure that all tagged media relevant to your playlist exists under the same file directory creating a tagged playlist (example) for example, if you want to create a playlist containing all media tagged as "animal cat" to play in a section of a store, create a tagged playlist to display all content that matches the animal tag with a value of "cat" to do this (assuming you tagged content as shown in the user tags section above) select tagged playlist under content > new component > tagged playlist enter a name and select create note that tagged playlist names that only contain numbers are not valid and cannot be saved select the directory that contains your content and select add media rule (see image 2) enter the correct tag name, condition, and value to create the rule note that value can contain multiple comma separated values when used with the contains , contains all , or contains any conditions once the rule is created, all the media with the tag should appear in the results section you can optionally change the ttl (time to live) value in the properties pane (under tagged playlist ) from the default value of 5 minutes and/or change the default match rules and order content by settings select the save icon (next to add media rule ) adding a tagged playlist to a presentation once you have created your tagged playlist, you can add it to a presentation to do this create a presentation (under docid 0vm0utpl2j8dss dfnhmo ) or select an existing presentation add a tagged playlist widget from the widgets tab into the presentation (see image 3) player tag matching acts as a secondary filter, allowing you to exclude items from the playlist based on the tags assigned to the player decide how you want to match your tag names (not values) select one of match all media tags to player tags the player will only play content from the playlist that has the same set of tags as the player match any the player will play content from the playlist that has least one media tag that matches a player tag match all media tags tag names on content must exist on the player to be played match all player tags tag names on the player must also exist on the content to be played match player tags disabled all content from the tagged playlist will play without regard to assigned player tags save the presentation publish the presentation to the desired group go to the network tab add the correct device tag to the player if you have not done so already (see tagging players) now the player should play the content associated with the tags setting media order and duration you can change the media order and media duration in any tagged playlist to do this select the desired media in the results panel under properties , you can change the order and duration of the media (by default this is six seconds) the order can also be modified by clicking and dragging media in the results panel see image 4 updating tagged playlists adding and approving new content to add new content to an existing tagged playlist upload your new content into the folder that contains the original tagged playlist content add the media tags that you have assigned to the other content in the folder to the new content save the media tags go to the tagged playlist and select the "thumbs up" icon to approve the new content (see image 5, below) the presentation will update with the new content based on the interval setting ( ttl) that you assigned to the playlist this ttl interval setting is the frequency with which player checks bsn cloud servers for new media automatic approvals to avoid the approvals process and automatically include any new content that meets the criteria of your tagged playlist, you can go to the admin > subscriptions > network settings tab to enable automatic approvals deleting content to delete content from a tagged playlist, simply delete the content from the original folder, or remove the tags from that content advanced tagging features array tags two versions of array tagging are supported string arrays and numeric arrays array tags allow users to assign multiple values to the piece of media on a single tag name for example, in images 6 and 7, a string array tag named landscape has been applied to three pictures each picture has one or more tag values snow, forest, lake when the media rule contains snow, all three pictures appear under results when the rule contains forest, only two pictures are displayed under results validity dates you can assign validity dates to selected content when a validity date has been assigned, that content will only be displayed on screen during the assigned date range for example, this can be used to display seasonal content or sales to assign validity dates to content if you have not already done so, define the media rules in the tagged playlist select the content thumbnail select the enable validity date checkbox in the properties panel (see image 8) enter a start time/date and end time/date the time should be entered in utc timezone (not your local time) you must specify a validity date at least 24 hours in the future, or it may not work correctly