Referencia de campos de Avails y CTL
Campos de EMA y requisitos, formatos y ejemplos del libro de Avails y CTL de Roku.
Cómo usar esta referencia
Para MovieLabs EMA, consulte las definiciones de campos de EMA Avails. La siguiente referencia proporciona los nombres exactos de las columnas, los requisitos, los formatos y los ejemplos del libro de Excel de Avails y CTL de Roku.
Las tablas siguen el orden del libro de Excel de Roku, desde la columna A hasta la AR. Conserve los encabezados exactamente como se muestran, incluidas las mayúsculas, las minúsculas y los espacios.
- Obligatorio: complete el campo en cada fila de datos.
- Condicional: complete el campo cuando se cumpla la condición indicada.
- Opcional: deje el campo en blanco si no corresponde. No use
N/Anin/a.
Los ejemplos ilustran la sintaxis y no otorgan derechos. Use los valores de su acuerdo con Roku. Una lista separada por comas contiene varios valores en una celda cuando el campo permite una lista. Use un solo valor de Territory por fila. Combine derechos o valores de idioma únicamente cuando los demás atributos de disponibilidad sean idénticos. Consulte las ventanas de disponibilidad y los derechos de idioma.
Identificación del envío y fechas
| Columna | Encabezado exacto | Requisito | Significado y formato | Ejemplo |
|---|---|---|---|---|
| A | Instructions | Conserve la columna y la fila de sugerencias. | Instrucciones para completar la plantilla y descripciones de los escenarios en los archivos de ejemplo. Ingrese los datos reales del título y los derechos en los campos que se indican a continuación. | Los archivos de ejemplo describen el escenario en esta columna. |
| B | Content Partner | Obligatorio | Texto. Nombre del propietario del contenido, estudio o cadena que ofrece el contenido a Roku. | Example Studio |
| C | Content Type | Obligatorio | Un valor permitido: movie, episode o shortForm. Corresponden a film, tv y clip en la ingesta, respectivamente. | episode |
| D | License Type | Obligatorio | Derechos permitidos: AVOD, SVOD, FVOD, Linear OTT. Los valores deben coincidir con los derechos de distribución acordados con Roku. Varios derechos pueden compartir una fila cuando todos los demás atributos coincidan. | AVOD, Linear OTT |
| E | Excluded Rights | Opcional | Derechos de distribución excluidos de la oferta. Use los mismos valores permitidos que License Type. | Linear OTT |
| F | Start Date | Obligatorio | Fecha y hora como texto: YYYY-MM-DD, YYYY-MM-DDTHH:MM:SS o YYYY-MM-DDTHH:MM:SSZ en UTC. Use open cuando no se especifique una fecha de inicio. Una fecha sin hora comienza a la medianoche local. | 2027-01-01 |
| G | End Date | Obligatorio | Los mismos formatos de fecha y hora que Start Date. open significa que no se especifica una fecha de fin. end of term permite la disponibilidad hasta el fin de los términos del acuerdo con Roku. Una fecha sin hora termina a las 23:59:59 locales. | 2027-12-31 o end of term |
Consulte las definiciones de tipos de contenido y la correspondencia de identificadores, los tipos de licencia y el comportamiento de las fechas antes de preparar una fila con varios derechos o una ventana con horas específicas.
Origen idiomas y territorios
| Columna | Encabezado exacto | Requisito | Significado y formato | Ejemplo |
|---|---|---|---|---|
| H | Country of Origin | Obligatorio | Un código de país ISO 3166-1 alfa-2. El país principal donde se produjo el título y donde están establecidos sus principales creadores, equipo de filmación y productores. Es distinto del territorio de distribución. | US |
| I | Original Spoken Language | Obligatorio | El idioma en el que se produjo originalmente el contenido, usando códigos de idioma admitidos. Se pueden separar varios idiomas originales con comas. | en-us, fr-ca |
| J | Language | Obligatorio | Derechos de idioma ofrecidos a Roku. Para un solo idioma, use un código de idioma admitido con el campo LocalizationType separado, o pares language:localizationType en el mismo campo. Para varios idiomas, incluya la localización en cada par. | en-us:dub, es-mx:sub |
| K | LocalizationType | Condicional: obligatorio para un solo idioma cuando su tipo de localización no se incluye en Language. | Uno de los valores sub, dub, subdub, any. dub incluye el audio en el idioma original. Cuando la localización se proporciona dentro de Language, el campo separado puede dejarse en blanco. | dub |
| L | Excluded Languages | Opcional | Códigos de idioma admitidos para los idiomas que no deben estar disponibles. Separe varios idiomas con comas. | de, fr |
| M | Territory | Obligatorio | Un valor por fila: un código de país o territorio de distribución, normalmente ISO 3166-1 alfa-2, o un valor de grupo admitido. Los valores de grupo admitidos incluyen LATAM y WW; confirme con Content Operations qué países abarcan antes de usar un grupo. | US |
| N | ExcludedTerritories | Opcional | Códigos ISO 3166-1 alfa-2 de los países o territorios excluidos de la disponibilidad. Separe varios valores con comas. | DE, FR |
Use los códigos de idioma admitidos y las explicaciones sobre localización. Los derechos de idioma no proporcionan los archivos de audio o subtítulos que falten. Si los valores incluidos y excluidos se superponen, confirme la combinación prevista con Content Operations en lugar de suponer cómo se resolverán los conflictos.
Identificación de títulos y episodios
| Columna | Encabezado exacto | Requisito | Significado y formato | Ejemplo |
|---|---|---|---|---|
| O | Series Title | Condicional: obligatorio para episode. | El nombre de la serie tal como debería aparecer en la plataforma. Excluya elementos entre paréntesis que no formen parte del título, como (Classic), un año de estreno, una indicación de temporada o un formato de video. | Die Hart |
| P | Series ID | Condicional: obligatorio para episode. | Identificador único e inmutable de la serie, proporcionado por el socio. Debe coincidir con series_id en la ingesta, ser el mismo en todos los episodios y ser diferente del Title ID del episodio. Máximo 50 caracteres; solo caracteres alfanuméricos, guiones y guiones bajos. | roseriesid_123 |
| Q | Title | Obligatorio | Nombre de la película, episodio o clip. Excluya elementos entre paréntesis que no formen parte del título, como (Classic), un año de estreno, (Season 1) o (HD). | The Recruit |
| R | Title ID | Obligatorio | Identificador único e inmutable de la película, episodio o clip, proporcionado por el socio. Debe coincidir con asset_id en la ingesta. Máximo 50 caracteres; solo caracteres alfanuméricos, guiones y guiones bajos. Reutilice el mismo identificador para un mismo título en sus filas de disponibilidad y actualizaciones. | roepisodeid_123 |
| S | Season Number | Condicional: obligatorio para episode. | Número entero que sigue la secuencia de emisión o distribución original. No se permiten letras. | 1 |
| T | Episode Number | Condicional: obligatorio para episode. | Número entero que sigue la secuencia de emisión o distribución original del episodio dentro de su temporada. No use números de producción, como 201 para indicar la temporada 2, episodio 1. | 1 |
La ingesta requiere un Season ID separado para los títulos episódicos. Proporciónelo en los metadatos de ingesta; no agregue una columna a este libro.
Duración formato y accesibilidad
| Columna | Encabezado exacto | Requisito | Significado y formato | Ejemplo |
|---|---|---|---|---|
| U | Run Time | Obligatorio | Duración en minutos enteros. El valor mínimo es 1. | 22 |
| V | Format | Obligatorio | La resolución de video más alta disponible: SD, HD o UHD. Se supone que las resoluciones inferiores están disponibles conforme a esta declaración. | HD |
| W | DBO | Opcional | Recaudación bruta de taquilla nacional, como texto. | $2,000,000 |
| X | Closed Captioning | Obligatorio | Booleano: true si el contenido incluye subtítulos descriptivos; de lo contrario, false. | true |
| Y | Caption Exemption | Condicional: obligatorio para la disponibilidad en Estados Unidos cuando Closed Captioning es false. | Código de exención de subtítulos descriptivos aplicable, del 1 al 6. Consulte los códigos de exención de subtítulos descriptivos. | 1 |
| Z | Audio Description | Opcional | Booleano que indica si se incluye una pista de descripción de audio. La descripción de audio narra información visual relevante para personas ciegas o con baja visión. | true |
| AA | Audio Description Exemption | Condicional: obligatorio cuando se requiere descripción de audio para el contenido, pero no se proporciona. | Texto que describe el motivo de exención aplicable. | Proporcione el motivo aplicable al título. |
Para las limitaciones de entrega y reproducción de fuentes UHD, consulte los requisitos de video. Declarar una resolución en un CTL no cambia esos requisitos. Para los subtítulos descriptivos y la descripción de audio, siga las indicaciones de entrega de accesibilidad aplicables.
Metadatos descriptivos clasificaciones y audiencia
| Columna | Encabezado exacto | Requisito | Significado y formato | Ejemplo |
|---|---|---|---|---|
| AB | Original Release Date | Obligatorio | Fecha del primer estreno en cualquier presentación, con formato YYYY-MM-DD. También se acepta solo el año, YYYY. | 2026-03-12 o 2026 |
| AC | Genre | Obligatorio | Uno o más valores de género admitidos, separados por comas. | drama |
| AD | Tags | Opcional | Palabras clave o categorías que describen el título para su selección. Proporcione por separado las etiquetas destinadas a la publicación en los metadatos de ingesta. Consulte las prácticas recomendadas de metadatos. | amistad, pueblo costero |
| AE | Rating Source | Obligatorio | Sistema de clasificación admitido que corresponde al título y al territorio de distribución. Debe combinarse con un valor de ese sistema. Consulte las clasificaciones. | USA_PR |
| AF | Rating Value | Obligatorio | Un valor admitido que pertenezca al Rating Source especificado. Consulte la Política de contenido dirigido a niños para conocer los requisitos de contenido dirigido a niños. | TV-PG |
| AG | Kids-Directed | Condicional: establezca true para contenido dirigido a niños; en los demás casos es opcional. | Booleano. Consulte la Política de contenido dirigido a niños para conocer la definición, el requisito de aprobación y las instrucciones de envío. | false |
| AH | Recommended Age Group | Opcional, cuando Kids-Directed es true. | Uno de los valores ages_1-3, ages_4-6, ages_7-9, ages_10plus. | ages_7-9 |
| AI | Main Cast | Obligatorio | Reparto principal, separado por comas, con los nombres en formato Nombre Apellido. | Kevin Hart, John Travolta |
| AJ | Synopsis | Obligatorio | Descripción breve que se usa para seleccionar contenido. Máximo 250 caracteres. Es independiente de los campos de sinopsis que se entregan con los metadatos de ingesta. | Sinopsis ilustrativa de este episodio de ejemplo. Sustitúyala por una sinopsis precisa antes del envío. |
Los ejemplos de esta referencia son ilustrativos. Use el reparto, las clasificaciones y los demás metadatos reales de su título. Consulte los géneros y las clasificaciones para conocer los valores permitidos.
Identificadores externos e información adicional
| Columna | Encabezado exacto | Requisito | Significado y formato | Ejemplo |
|---|---|---|---|---|
| AK | External ID Source | Opcional | Fuente del identificador externo: TMS (Gracenote), IMDb o Wiki (Wikipedia). Para varias fuentes, use pares source:ID separados por comas, como se describe a continuación. | TMS:E12345678, IMDb:tt12345678 |
| AL | Series External ID | Opcional | Identificador de terceros para la serie. | El identificador de la serie en la fuente indicada. |
| AM | External ID | Opcional | Identificador de terceros para la película, episodio o clip individual. | El identificador del título en la fuente indicada. |
| AN | Screener Link | Opcional | URL para reproducir o descargar una copia de revisión. Incluya cualquier contraseña de acceso necesaria para verla. La copia de revisión sirve para seleccionar contenido. | https://example.com/screener |
| AO | Exclusive | Opcional | Booleano que indica si el título está disponible exclusivamente en The Roku Channel. | false |
| AP | Notes | Opcional | Información adicional de disponibilidad que no se incluye en otros campos. Para contenido lineal, incluya el número de emisiones, las restricciones de transmisión y otros límites pertinentes. | Máximo dos emisiones por día. |
| AQ | Merchant of Record | Opcional | Entidad a la que deberían atribuirse las transacciones financieras, si es diferente de Content Partner. | Example Distribution |
| AR | Day Parting | Opcional, solo para contenido lineal. | Texto que describe las restricciones por horario que se aplican al contenido. | Describa la regla de segmentación horaria acordada. |
Para una sola fuente externa, indique la fuente y proporcione el identificador del título o de la serie asociado en el campo de identificador externo correspondiente. Para varias fuentes, use identificadores precedidos por la fuente, como TMS:E12345678, IMDb:tt12345678, Wiki:example_title. Los identificadores externos no sustituyen los campos obligatorios Title ID o Series ID que se proporcionan a Roku.
Regrese a la preparación del libro o a la descripción general.
Updated about 5 hours ago