Hey, how can we help?

browse

TVBits Fields

Each row within the CSV file represents the metadata for the actual video content.  In addition to the common metadata fields utilized for File Delivery, the following fields are unique to WurlBits and their handling.

  • Is TVBits
    • This column signals that the asset is a pre-cut asset that is ready and approved for Bits creation. If it is, mark the field as “yes”.
  • Channel Slug
    • A single value, reference field by which to group Bits into a FAST channel. Length: 50 characters or less. Usage is for specific association of the Bits to a FAST channel, rather than generic categorization.
  • Channel Keys
    • A reference tag by which to group and/or search episodes. Usage is for specific embellishment of the Bits, rather than generic categorization. For example: Enter the value of “NFL” instead of football. Multiple keys can be supported so long as they are comma-separated and the entire field is enclosed within double quotes.  Example:  “NFL, NFC, AFC”. Please note that Google Sheets and Excel will auto-add double quotes if names are separated by a comma. 
  • Bits Segment Restriction Type
    • This field allows you to place restrictions on whether a video asset can be used to create Bits or not.  Permissible values within this field are: allow or deny.  This field is used in conjunction with the next field “Bits Segment Restriction Values”.
  • Bits Segment Restriction Values
    • Utilized in conjunction with the previous field “Bits Segment Restriction Type”. Values are start/end timecodes. Multiple restriction segments can be supported so long as they are comma-separated without spaces and the entire field is enclosed within double-quotes. Please note that Google Sheets and Excel will auto-add double quotes if names are separated by a comma. 
    • Note: If the Bits Segment Restriction Type field holds a value and this field is left blank, then the Segment Restriction Type applies to the entirety of the asset. It is similar to entering the start value of “00:00:00.000” and the actual end timecode or utilizing the keyword “all”.
  • Bits Region Restriction Type
    • This field allows you to place restrictions based on country code on media sharing.  Permissible values within this field are: allow or deny. This field is used in conjunction with the next field “Bits Region Restriction Values”
  • Bits Region Restriction Values
    • Utilized in conjunction with the previous field “Bits Region Restriction Type”.  Values are a list of ISO 3166-1 alpha-2 country codes separated by a space or the keyword “all”. Multiple regions are accepted as long as they are separated by spaces. 

Common Fields

For the latest specification, please refer to the ingestion File Delivery page. Please make a copy or download the CSV template for Bits here: ​Wurl Bits File Upload Metadata template.

Field Description
External ID An identifier for the asset as assigned by your internal CMS or management system.
Title (Required) Title of the video or episode, displayed to the viewer on the Video Service’s UI.
Internal Title Internal title you would like to use only inside the Wurl platform.
Description The description of the video or episode, usually displayed to the viewer on the services you distribute to.
Short Description Short description or synopsis of the video. Limited to 110 characters, anything after that will be truncated
Release Date Release Date of the Asset. Please use the YYYY-MM-DD format.
Movie entry type "Release Date" field is required with the correct format.
Video Filename
(Required)
The ​EXACT​ filename of the video file for the asset. Our automation uses this to link the asset components together. If it’s not exactly correct, the content will fail to register with Wurl.
Filenames must ​not​ include spaces or special characters (i.e. %, $, #, @, á, ę, ï, ô ù, etc.).
If there must be multiple versions of the same asset, the video filename for each version MUST be unique.
Artwork Filename The ​EXACT​ filename of the artwork or thumbnail file for the asset. Preferred format is JPG in a 16x9 aspect ratio at a resolution of 1920x1080 pixels or larger.
Filenames must ​not​ include spaces or special characters (i.e. %, $, #, @, á, ę, ï, ô ù, etc.).
Keywords Used for searching across your content within Wurl. This data may be made available to distribution services for use in their search tools.
Categories Specify a category for your video.
Series Name Name of series if the video is part of a series of content.
Season Number The season number if the video is part of a series.
Episode Number The episode number if the video is part of a series.
Series Artwork Filename The ​EXACT​ filename of the artwork or thumbnail file for the series if the video is part of a series. Preferred format is JPG in a 16x9 aspect ratio at a resolution of 1920x1080 pixels or larger.

Note: Filenames must ​not​ include spaces or special characters (i.e. %, $, #, @, á, ę, ï, ô ù, etc.).
Closed Caption Filename EXACT​ filename of the closed caption file for the asset with following requirements:
Captions must​ contain 0-aligned timecodes in order to properly sync with audio. Accepted formats are ​SCC or SRT.

Captions cannot be rolled up.

Captions must be delivered 0-aligned to the video in order to properly sync with audio.

Captions must not have dropframe timestamps.

Captions must use UTF-8 encoding.

SCC captions only support English characters.

SRT should be used to deliver captions with non-English characters.

Note: Filenames must ​not​ include spaces or special characters (i.e. %, $, #, @, á, ę, ï, ô ù, etc.).
Genre Source Genre Source you would like to ingest. Enter one of {wurl, roku, samsung, sinclair, nielsen, lg}
Genre Value Enter the Genre value
Rating Source Rating Source you would like to ingest. Enter one of {BMUKK, CNC, CBSC, FSK, AGCOM, ICAA, BBFC, CHVRS, MPAA, USA_PR, SAMSUNG, KMRB, DJCTQ, NCS, EIRIN, Régie du cinéma, Brazil LG, EU LG}
Rating Value Enter the Rating Value
Cut Points Timecodes within the video file where you wish for the content to break and an ad marker to be placed (format: 00:00:00.000 [HH:MM:SS.MSS],​ with comma-separated timecodes)
Entry Type Sets entry type field for the asset.
Enter "movie" for Movie. With movie entry type "Release Date" field becomes required.
Enter "shortFormVideo" for Short Form.
Enter "tvSpecial" for TV Special
Fill "Season Number", "Episode Number", and "Release Date" fields for "Series" entry type
Is Ad? Indicates that the asset is an ad slate. If it is, mark the field as “yes”. Ad slates are used for automatic insertion of markup used for ad insertion/substitution at playback. This will also display the asset type as "ad" on the scheduler.
Is Promo? Indicates that the asset is a promo. If it is, mark the field as “yes”. This will also display the asset type as "promo" on the scheduler.
Directors Names of Directors of the content. If there are more than one of each, then must be separated with a comma and the entire value in double-quotes.Please note that Google Sheets and Excel will auto-add double quotes if names are separated by a comma.
"Steven Spielberg, Ron Howard, Michael Mann"
Producers Names of Producers of the content. If there are more than one of each, then must be separated with a comma and the entire value in double-quotes. Please note that Google Sheets and Excel will auto-add double quotes if names are separated by a comma.
"Kathleen Kennedy, Frank Marshall, Steven Spielberg"
Actors Names of Actors of the content. If there are more than one of each, then must be separated with a comma and the entire value in double-quotes. Please note that Google Sheets and Excel will auto-add double quotes if names are separated by a comma.
"Harrison Ford, Kate Capshaw, Ke Huy Quan"

Channel Slug

A single value, reference field by which to group Bits into a FAST channel. Length: 50 characters or less. Usage is for specific association of the Bits to a FAST channel, rather than generic categorization.

Channel Keys

A reference tag by which to group and/or search episodes. Usage is for specific embellishment of the Bits, rather than generic categorization. For example: Enter the value of “NFL” instead of football. Multiple keys can be supported so long as they are comma-separated and the entire field is enclosed within double-quotes. Example: “NFL, NFC, AFC”. Please note that Google Sheets and Excel will auto-add double quotes if names are separated by a comma. 

Bits Segment Restriction Type

This field allows you to place restrictions on whether a video asset can be used to create Bits or not.  Permissible values within this field are: allow or deny.  This field is used in conjunction with the next field “Bits Segment Restriction Values”.

Bits Segment Restriction Values

Utilized in conjunction with the previous field “Bits Segment Restriction Type”. Values are start/end timecodes.  Multiple restriction segments can be supported so long as they are comma-separated and the entire field is enclosed within double-quotes.

Note: If the Bits Segment Restriction Type field holds a value and this field is left blank, then the Segment Restriction Type applies to the entirety of the asset.  It is similar to entering in the start value of “00:00:00.000” and the actual end timecode or utilizing the keyword “all”.

Bits Region Restriction Type

This field allows you to place restrictions based on country code on media sharing.  Permissible values within this field are: allow or deny. This field is used in conjunction with the next field “Bits Region Restriction Values”.

Bits Region Restriction Values

Utilized in conjunction with the previous field “Bits Region Restriction Type”.  Values are a list of ISO 3166-1 alpha-2 country codes separated by a space or the keyword “all”.

Rights Windows

Start and end period for when an asset can be scheduled/distributed.
Note that either the start period or the end period can be left blank or
absent. However, if choosing to enter a Rights Window, both values
cannot be blank or absent. Only a single window is supported in CSV.


Example: "start=Tue, 08 Apr 2014 00:00:00 -0500;end=Thu, 11 Sep
2050 00:00:00 -0500;scheme=W3C-DTF"

Show Limits

The number of times an asset can be scheduled within a particular time
period. Limits can be additive. Period options: “day”, “week”, “month”,
“year”, or “window”


Example: "period=day;value=1 period=window;value=23" means the
asset can be scheduled at a maximum of once per day, for a total of 23
times.


WurlBits CSV Examples

Asset pre-created as a Bit w/ Channel key

This example shows an ingested asset already prepared as Bit by the Content Company.  The Bit is linked to the channel by noting the channel’s ID (i.e. slug) within the Channel Slug column field. Additionally, this Bit can be distributed in any country.  In the example below, noted fields are emphasized for visibility. Please be mindful of the vertical format in the example below. When creating your CSV, please follow the horizontal format. 

External ID 123456
Title Sports Video ABC
Internal Title Sports Video ABC
Description A Wurl Bits of football
Short Description A Wurl Bits of football
Series Name  
Season Number  
Episode Number  
Keywords Sports
Categories Sports
Release Date 2023-05-18
Video Filename http://mysite.com/videos/456.mp4
Artwork Filename http://mysite.com/thumbnail/video-456.png
Series Artwork Filename  
Closed Caption Filename  
Genre Source Samsung
Genre Value Sports
Rating Source MPAA
Rating Value PG
Cut Points  
Entry Type  
Is Ad?  
Is Promo?  
Is Bits? yes
Burn-in Captions?  
Directors  
Producers  
Actors  
Channel Slug publisher_nfl_1
Channel Keys NFL
Bits Segment Restriction Type  
Bits Segment Restriction Values  
Bits Region Restriction Type allow
Bits Region Restriction Values all

Asset not allowed for Bits

This example highlights an asset ingested for FAST delivery, but not allowed for Bits usage. Please be mindful of the vertical format in the example below. When creating your CSV, please follow the horizontal format. 

External ID WL789
Title The Beginnings of Life
Internal Title The Beginnings of Life
Description Exploration into the beginnings of life
Short Description  
Series Name  
Season Number  
Episode Number  
Keywords Nature
Categories Nature
Release Date 2023-06-24
Video Filename http://www.mysite.com?series_id=789
Artwork Filename http://www.mysite.com/789.jpg
Series Artwork Filename  
Closed Caption Filename  
Genre Source  
Genre Value  
Rating Source MPAA
Rating Value G
Cut Points  
Entry Type Movie
Is Ad?  
Is Promo?  
Is Bits?  
Burn-in Captions?  
Directors  
Producers  
Actors  
Channel Slug  
Channel Keys  
Bits Segment Restriction Type deny
Bits Segment Restriction Values all
Bits Region Restriction Type  
Bits Region Restriction Values  

Asset allowed for Bits w/ restrictions on segment content

This example highlights an asset available for Bits creation, with time ranges restricted from being included in any created Bits.  This example Bit is linked to a channel by noting the channel’s ID (i.e. slug) within the Channel Slug column field. Please be mindful of the vertical format in the example below. When creating your CSV, please follow the horizontal format. 

External ID ABC123
Title Game of Throws - Winter Isn’t Coming
Internal Title Game of Throws - Winter Isn’t Coming
Description TV adaptation of the popular book series
Short Description  
Series Name  
Season Number 1
Episode Number 1
Keywords  
Categories Fantasy
Release Date 2023-12-18
Video Filename http://www.sbo.tv?series_id=123
Artwork Filename http://www.sbo.tv/123.jpg
Series Artwork Filename  
Closed Caption Filename  
Genre Source  
Genre Value Action
Rating Source USA_PR
Rating Value TV-Y7
Cut Points  
Entry Type Series
Is Ad?  
Is Promo?  
Is Bits?  
Burn-in Captions?  
Directors  
Producers  
Actors  
Channel Slug mysite_fantasy_1
Channel Keys  
Bits Segment Restriction Type deny
Bits Segment Restriction Values 00:01:00.0-00:31:30.830, 01:12:00.0-01:45:01.431
Bits Region Restriction Type  
Bits Region Restriction Values  

 

Previous
Next

Was this article helpful?

0 out of 0 found this helpful