Excel - metadatos de TV por episodios

Descripción general

Esta referencia describe los campos de la plantilla de metadatos de Excel de TV. Los campos siguen la jerarquía series > season > episode de Roku. Para descargar la plantilla y consultar las reglas de formato, estructura, límites de filas y tipo de archivo, consulta la Descripción general de metadatos de Excel.

Entrega el libro y los archivos que referencia mediante el método de Aspera o S3 aprobado durante la incorporación.

Cada fila representa un solo episodio. Los campos se agrupan por nivel (Serie, Temporada, Episodio) para indicar a qué parte de la jerarquía corresponde cada uno.

Los campos se agrupan en: Información del paquete, Bloque de la serie, Bloque de la temporada, Descriptores de contenido del episodio, Cortes publicitarios y puntos de referencia, Reparto y equipo de filmación del episodio, Activos, Ilustraciones y Disponibilidad.

Información del paquete

provider

Nombre del propietario del contenido, estudio o cadena.

contentType

Tipo de contenido del paquete. Para la plantilla de Excel de TV, este valor es episode (distinto del valor tv que se usa para identificar el tipo de contenido de TV en otros lugares, por ejemplo, en el campo /package/video/type de la Referencia XML de TV).

language

Idioma del título, las sinopsis, el video, los subtítulos descriptivos, los subtítulos, los doblajes de audio o las ilustraciones que se indican en la fila. Debe ajustarse a un código de idioma admitido. Se recomienda incluir un código de región para distinguir variantes como es-MX y es-ES.

asset_id

Identificador único e inmutable de un episodio. La empresa socia genera o proporciona este ID. Debe coincidir con el ID del título en el documento de Avails para facilitar el seguimiento durante el procesamiento en Roku. Límite de 50 caracteres.

episode_eidr

ID de EIDR del episodio, si existe uno.

episode_tms_id

ID de Gracenote del episodio, si existe uno.

Bloque de la serie

series_id

Identificador único e inmutable de una serie. La empresa socia genera o proporciona este ID. Debe coincidir con el ID de la serie en el documento de Avails. Límite de 50 caracteres.

series_title

Título de la serie, en el idioma definido en la columna language. Incluye únicamente el nombre como debe aparecer en la plataforma. No agregues información entre paréntesis que no forme parte del título.

series_tms_id

ID de Gracenote de la serie, si existe uno.

series_release_date

Fecha original en que la serie estuvo disponible por primera vez en cualquier presentación. Debe incluir, como mínimo, un año de estreno correcto.

series_genres

Clasificación por género del contenido. Cada serie debe entregarse con al menos un género admitido. Consulta la lista enumerada de géneros.

El género se especifica solo a nivel de serie. No hay un campo de género separado para cada episodio. La Referencia XML de TV usa la misma estructura.

series_tags

Etiquetas de texto libre que describen el contenido además de su género. El equipo editorial y el motor de recomendaciones de Roku las usan para ayudar a los usuarios a encontrar contenido. No hay límite de cantidad ni una lista predefinida de etiquetas. Se distinguen mayúsculas y minúsculas, por lo que debes mantener un uso consistente.

series_cast

Nombres de los miembros del reparto de la serie.

series_directors

Nombre del director o los directores de la serie.

Los metadatos de Excel actualmente admiten solo la función de director para los créditos del equipo de filmación.

series_brief_synopsis

Una sinopsis de la serie, en el idioma definido en la columna language. Límite de 100 caracteres. Obligatorio para la distribución en Linear OTT.

series_short_synopsis

Una sinopsis breve de la serie, en el idioma definido en la columna language. Límite de 250 caracteres.

series_long_synopsis

Una sinopsis larga opcional de la serie, en el idioma definido en la columna language. Límite de 500 caracteres.

localized_series_brief_synopsis

Una sinopsis localizada de la serie, en el idioma definido en la columna localized_language. Límite de 100 caracteres. Obligatorio para la distribución en Linear OTT.

Bloque de la temporada

season_id

Identificador único e inmutable de una temporada. La empresa socia genera o proporciona este ID. Debe coincidir con el ID de la temporada en el documento de Avails. Límite de 50 caracteres.

season_number

Posición numérica de la temporada dentro de la serie. Determina el orden de visualización de sus episodios. Los valores deben reflejar el orden original de emisión o exhibición. Solo se permiten números enteros mayores que 0.

Descriptores de contenido del episodio

episode_title

Título del episodio, en el idioma definido en la columna language. Incluye únicamente el nombre como debe aparecer en la plataforma. No agregues información entre paréntesis que no forme parte del título.

episode_number

Posición numérica del episodio dentro de su temporada. Determina el orden de visualización en la plataforma. Los valores deben reflejar el orden original de emisión o exhibición; no deben usarse números de producción. Solo se permiten números enteros.

original_spoken_language

Idioma original de producción del episodio. El valor debe usar un código de idioma admitido. Se recomienda incluir un código de región para distinguir variantes como es-MX y es-ES.

[!NOTE]
este campo no lleva el prefijo episode_ en la plantilla, pero aplica a nivel de episodio, no a nivel de serie.

country_of_origin

El país principal donde se produjo el episodio, y donde están establecidos los principales creadores, el equipo de filmación y los productores. Debe ajustarse a un código ISO 3166-1 alfa-2 admitido.

[!NOTE]
este campo no lleva el prefijo episode_ en la plantilla, pero aplica a nivel de episodio, no a nivel de serie.

episode_release_date

Fecha original en que el episodio estuvo disponible por primera vez en cualquier presentación. Debe incluir, como mínimo, un año de estreno correcto.

episode_runtime

Duración total del episodio, en minutos enteros.

rating_system y episode_ratings

rating_system contiene la autoridad de clasificación (por ejemplo, USA_PR), y episode_ratings contiene el valor de clasificación correspondiente (por ejemplo, TV-14) para dicha autoridad. Se debe proporcionar, para cada episodio, una clasificación de TV válida de la autoridad de clasificación del territorio en el que estará disponible el contenido. Si no ha sido clasificado por la autoridad oficial de ese territorio, usa en su lugar una clasificación válida de USA_PR, según las pautas de tvguidelines.org.

La clasificación se especifica solo a nivel de episodio. No hay un campo de clasificación separado para la serie.

episode_tags

Etiquetas de texto libre que describen el episodio además de su género. Se aplican las mismas reglas que para series_tags.

episode_brief_synopsis

Una sinopsis del episodio, en el idioma definido en la columna language. Límite de 100 caracteres. Obligatorio para la distribución en Linear OTT.

episode_short_synopsis

Una sinopsis breve del episodio, en el idioma definido en la columna language. Límite de 250 caracteres.

episode_long_synopsis

Una sinopsis larga opcional del episodio, en el idioma definido en la columna language. Límite de 500 caracteres.

localized_episode_brief_synopsis

Una sinopsis localizada del episodio, en el idioma definido en la columna localized_language. Límite de 100 caracteres. Obligatorio para la distribución en Linear OTT.

closed_captions

Indica si el título entregado contiene subtítulos descriptivos. El indicador Y/N es obligatorio para todo el contenido destinado a Roku Channel en EE. UU. Proporcionar este indicador no obliga por sí mismo a entregar un archivo de subtítulos descriptivos; la empresa socia determina si son obligatorios para esa entrega.

closed_captions_exemption

Código de exención de la FCC para el requisito de subtítulos descriptivos. Obligatorio en EE. UU. si closed_captions = N.

Cortes publicitarios y puntos de referencia

Los cortes publicitarios y los puntos de referencia se especifican solo a nivel de episodio. No hay campos separados para la serie.

episode_ad_breaks

Identifica los cortes publicitarios para contenido financiado con anuncios. Los valores deben tener una precisión de milisegundos. Si el video contiene fotogramas negros para un corte publicitario, proporciona el código de tiempo en el punto medio de ese intervalo. Este campo no es obligatorio para SVOD, pero Roku puede ingerir datos con precisión de fotogramas si están disponibles.

episode_cue_points

Identifica los tiempos de inicio y fin de los créditos iniciales, resúmenes, créditos finales y material detrás de cámaras. Los valores deben tener una precisión de milisegundos.

Escribe los puntos de referencia como una única cadena de texto separada por comas en una celda. En XML, esta información se proporciona en elementos cuePoint anidados; consulta la Referencia XML de TV.

Formato: una lista separada por comas de pares type=startTime>endTime.

Ejemplo:

intro=00:05:10.253>00:07:15.123,recap=00:01:12.456>00:03:12.052

Reparto y equipo de filmación del episodio

episode_cast

Nombres de los miembros del reparto del episodio.

episode_director

Nombre del director o los directores del episodio.

Los metadatos de Excel actualmente admiten solo la función de director para los créditos del equipo de filmación.

Activos

video_file_name

Nombre de archivo del video, en el idioma definido en la columna language, entregado mediante el método aprobado. Solo se permite un video por asset_id. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales.

video_file_language

Idioma principal del diálogo hablado o el texto visible del archivo de video. Si no hay diálogo ni texto visible, usa el idioma hablado por la audiencia a la que está destinado el contenido. También aplica a closed_caption_file_name y forced_subtitle_file_name. Solo se permite un idioma.

audio_layout

Descriptor de diseño de audio para el archivo de video entregado.

descriptive_audio_file_name

Solo para archivos de audio descriptivo. Nombre de archivo del audio descriptivo, en el idioma definido en descriptive_audio_language, entregado mediante el método aprobado. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales.

descriptive_audio_language

Solo para archivos de audio descriptivo. Idioma principal de la pista de diálogo hablado del archivo de audio. Solo se permite un idioma.

closed_caption_file_name

Roku considera muy recomendable entregar subtítulos descriptivos. La empresa socia es responsable de determinar si son obligatorios para una entrega específica.

Si se proporcionan, indica el nombre del archivo de subtítulos descriptivos entregado mediante el método aprobado, en el idioma definido en la columna language. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales. Su idioma se deriva de video_file_language.

forced_subtitle_file_name

Nombre de archivo de los subtítulos narrativos forzados, en el idioma definido en video_file_language, entregado mediante el método aprobado. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales. Su idioma se deriva de video_file_language.

Ilustraciones

series_keyart_file_name

Nombre de archivo de la imagen de arte clave con texto, en el idioma definido en la columna language, entregado mediante el método aprobado. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales.

series_boxcover_file_name

Nombre de archivo de la imagen de carátula con texto en 4:3 para la serie, en el idioma definido en la columna language, entregado mediante el método aprobado. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales.

series_poster_file_name

Nombre de archivo de la imagen de portada con texto, en el idioma definido en la columna language, entregado mediante el método aprobado. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales.

series_background_file_name

Nombre de archivo de la imagen de fondo sin texto a nivel de serie, entregado mediante el método aprobado. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales.

episode_background_file_name

Nombre de archivo de la imagen de fondo sin texto a nivel de episodio, entregado mediante el método aprobado. El nombre debe coincidir exactamente con el archivo entregado, incluidas las mayúsculas y minúsculas, y no debe contener espacios en blanco ni caracteres especiales.

Disponibilidad

Los cuatro campos siguientes son preferidos, como se indica en las tablas. Ninguno es obligatorio.

vod_type

Tipo de monetización del episodio. Se permiten varios valores separados por comas, siempre que territory, episode_start_date y episode_end_date sean idénticos entre ellos.

territory

Códigos de país de los territorios donde está disponible el contenido. Se permiten varios códigos de país separados por comas, siempre que vod_type, episode_start_date y episode_end_date sean idénticos entre ellos.

episode_start_date

Fecha de inicio de la disponibilidad del contenido. La fecha debe ser anterior a episode_end_date; las fechas no deben ser iguales.

episode_end_date

Fecha de finalización de la disponibilidad del contenido. La fecha debe ser posterior a episode_start_date; las fechas no deben ser iguales.