Elementos del feed MRSS de Soluciones de Vídeo

En la tabla que se muestra a continuación se incluyen todos los campos que Soluciones de Vídeo reconoce en feeds XML y que, en algunos casos, espera encontrar. Solo se reconocen estos elementos.

Ir a un elemento concreto de la lista

---

Elementos obligatorios

<atom:link> <item> <dfpvideo:contentId> <dfpvideo:lastModifiedDate> <dfpvideo:version> <title>

Elementos recomendados y opcionales

<dfpvideo:cuepoints> <dfpvideo:keyvalues> <dfpvideo:thirdPartyContentId>

<media:content> <media:status>

<media:thumbnail> <pubDate>

Elementos de inserción dinámica de anuncios

_{Los elementos que se indican a continuación se emplean en la inserción dinámica de anuncios y deben usarse junto con los elementos mencionados más arriba.}

<dfpvideo:ingestUrl> <dfpvideo:lastMediaModifiedDate> <dfpvideo:closedCaptionUrl> <dfpvideo:fw_caid>

---

A continuación, le mostramos un ejemplo de los elementos en contexto dentro de un feed de muestra.

Ahora se distingue entre mayúsculas y minúsculas en el ID de contenido, por lo que un ID que tenga letras mayúsculas y minúsculas se considera diferente de un ID con las mismas letras pero solo en minúscula. Este cambio se refleja en sus informes de Ad Manager.

Elementos obligatorios

Elemento	Elemento secundario de	Requisito
<atom:link>	<channel>	Obligatorio
Descripción Identifica la información de paginación del feed. En este elemento, Ad Manager lee dos atributos: rel y href. rel indica la relación entre la URL del atributo href y el conjunto de resultados del feed. rel='next': indica que la URL de href dirige a la siguiente página del conjunto de resultados del feed. Si el feed contiene una etiqueta <atom:link> que incluye rel='next', significa que hay otra página de resultados. De lo contrario, la página que está activa en ese momento es la última del conjunto de resultados. href especifica una URL en la que se identifica el recurso de la etiqueta <atom:link>. Ejemplo <atom:link rel='next' href='http://www.feedprovider.com/video/account/vids?page3'/ Notas importantes: La primera vez que se crea una fuente de contenido en Ad Manager, se espera que el conjunto de URLs del feed devuelva el primer conjunto de resultados. Le recomendamos que utilice un conjunto de resultados de 100 elementos; es decir, que se muestren 100 elementos por página. Si una página del feed no contiene el elemento <atom:link>, Ad Manager considera que es la última.

Elemento	Elemento secundario de	Requisito
<item>	<channel>	Obligatorio
Descripción Identifica un elemento de vídeo único dentro del feed. En los feeds de vídeo de Ad Manager puede haber una o varias entradas <item>. Cada una de esas entradas debe contener tres elementos para que se puedan ingerir metadatos correctamente: <dfpvideo:contentId>, <dfpvideo:lastModifiedDate> y <title>

Elemento	Elemento secundario de	Requisito
<dfpvideo:contentId>	<item>	Obligatorio
Descripción Es un parámetro importante de las solicitudes de anuncios cuya función es identificar qué anuncios puede servir Ad Manager en el vídeo correspondiente. En Ad Manager se almacena como el ID de contenido del CMS.   El valor del ID de contenido debe ser una cadena y distingue entre mayúsculas y minúsculas. Este valor se puede usar en el parámetro vid de una solicitud de anuncio de vídeo. Ejemplo <dfpvideo:contentId>sdjfbadfb8w3489y</dfpvideo:contentId>

Elemento	Elemento secundario de	Requisito
<dfpvideo:lastModifiedDate>	<item>	Obligatorio
Descripción Indica cuándo se modificó por última vez cualquier aspecto del vídeo o de sus metadatos. Para que Ad Manager pueda ingerir contenido modificado, se debe indicar el valor lastModifiedDate y el feed debe estar en orden cronológico inverso; es decir, con el elemento más reciente en la parte superior. Todas las marcas de tiempo deben cumplir con la especificación RFC 822 o seguir el formato de la norma ISO 8601. Si la zona horaria no está incluida en la cadena de la marca de tiempo, el valor predeterminado es la hora estándar del Pacífico (PST). Ejemplos <dfpvideo:lastModifiedDate>2021-01-15T08:00:00+01:00</dfpvideo:lastModifiedDate> <dfpvideo:lastModifiedDate>Fri, 15 Jan 2021 08:00:00 EST </dfpvideo:lastModifiedDate> Consultar ejemplos de cada formato de fecha Ejemplos RFC 822 Fri, 15 Jan 2021 08:00:00 EST Fri, 15 Jan 2021 13:00:00 GMT Fri, 15 Jan 2021 15:00:00 +0200 ISO 8601 2021-01-15T12:00:00Z 2021-01-15T08:00:00+01:00

Elemento	Elemento secundario de	Requisito
<dfpvideo:version>	<channel>	Obligatorio
Descripción Indica la versión actual de la especificación MRSS que utiliza este feed. Debe ser un número entero y fijarse solo una vez por feed. Por el momento, el único valor válido que puede tener este campo es "2". Ejemplo <dfpvideo:version>2</dfpvideo:version>

Elemento	Elemento secundario de	Requisito
<title>	<item>	Obligatorio
Descripción El nombre de la entrada de vídeo. Ejemplo <title>Mi vídeo</title>

Elementos recomendados y opcionales

Elemento	Elemento secundario de	Requisito
<dfpvideo:cuepoints>	<item>	Varía*
Descripción * Es obligatorio incluirlo si el vídeo contiene pausas publicitarias mid‑roll. Identifica los puntos de inserción, expresados en segundos y separados por comas. Los puntos de inserción son los momentos en los que se puede insertar un anuncio en el vídeo. Se admiten hasta tres decimales en los segundos (por ejemplo, 55.532 segundos). El resto de los dígitos no se tendrán en cuenta. Hay un límite máximo de 1000 puntos de inserción en los vídeos. Cuando un vídeo alcance este límite, truncaremos todos los puntos de inserción. Ejemplo <dfpvideo:cuepoints>55.532,109</dfpvideo:cuepoints>

Elemento	Elemento secundario de	Requisito
<dfpvideo:keyvalues>	<item>	Opcional
Descripción Identifica cualquier metadato personalizado del vídeo. Tiene los siguientes atributos: key, value y type (que está limitado a los tipos de datos string).   Los pares clave-valor ingeridos a través de un feed MRSS están sujetos a los mismos requisitos de formato que los pares clave-valor definidos en la interfaz de Ad Manager. Compruebe que sus pares clave-valor cumplan con estos requisitos de formato. Ejemplos <dfpvideo:keyvalues key="episode" value="5" type="string"/> <dfpvideo:keyvalues key="season" value="2" type="string"/> <dfpvideo:keyvalues key="title" value="Título de ejemplo" type="string"/> <dfpvideo:keyvalues key="recommended count" value="5" type="string"/> <dfpvideo:keyvalues key="description" value="Texto de la descripción" type="string"/>

Elemento	Elemento secundario de	Requisito
<dfpvideo:thirdPartyContentId>	<item>	Opcional
Descripción Debe habilitar esta función antes de utilizarla. Para hacerlo, póngase en contacto con su gestor de cuentas. Este elemento se utiliza si tiene un feed MRSS personalizado que contiene vídeos de YouTube. No puede haber dos contenidos MRSS en su red que especifiquen el mismo vídeo de YouTube. Solo hay un atributo obligatorio en este elemento: Atributo "id": debe referirse a contentId en la fuente del contenido de YouTube. Ejemplo <dfpvideo:thirdPartyContentId cms="youtube" id='vNclnVLp_c0'/>

Elemento	Elemento secundario de	Requisito
<media:content>	<item>	Recomendado
Descripción Este elemento es un subelemento opcional del elemento <item> y tiene atributos que proporcionan metadatos útiles, como la URL de origen y la duración. Ad Manager puede leer los siguientes atributos del elemento <media:content>: El atributo "duration": Ad Manager solo reconoce una entrada de duración por <item>. Si se especifica más de una, se elige una entrada de duración al azar, que puede no ser la esperada. El valor de duración debe expresarse en segundos (números enteros, sin decimales). El atributo duration es obligatorio para entregar anuncios mid‐roll. Atributo "url": la URL directa del recurso de vídeo, que se utiliza solo para mostrar un enlace en los detalles de contenido que aparecen en la interfaz de Ad Manager. Ejemplo <media:content url='http://www.feedprovider.com/video?8eqe7e' duration='39'/>

Elemento	Elemento secundario de	Requisito
<media:status>	<media:content> o <item>	Opcional
Descripción Determina si el vídeo está marcado como activo, inactivo o archivado en Ad Manager. Si este elemento no se incluye, de forma predeterminada se considerará que el vídeo está activo. En lo referente a estos valores, el sistema no distingue entre mayúsculas y minúsculas, y pueden tener los siguientes estados: active: se considera "Activo" en Ad Manager. deleted: se considera "Archivado" en Ad Manager; los nuevos vídeos "deleted" no se ingieren. blocked: se considera "Inactivo" en Ad Manager. Si un usuario cambia el estado de un vídeo desde Ad Manager, se ignoran los cambios de estado posteriores del feed. Para que se vuelvan a tener en cuenta las actualizaciones de estado procedentes del feed, el usuario puede hacer clic en la opción Utilizar la configuración de la fuente de la interfaz de Ad Manager. Los editores y los partners de CMS pueden evitar que Ad Manager reacondicione el contenido ya subido inactivo u obsoleto realizando una de las siguientes acciones: (Recomendada) Admitir <media:status state="deleted"/> en el feed MRSS. Mantener el contenido en el feed, pero quitándole todos los elementos relacionados con la inserción dinámica de anuncios para que no sea apto para la ingestión VOD. Vaya a la sección Elementos de la inserción dinámica de anuncios para saber qué elementos concretos debe quitar. Estado del servicio cuando se utiliza la inserción dinámica de anuncios Para determinar el estado del servicio cuando se usa la inserción dinámica de anuncios, se tienen en cuenta el estado de la fuente y el del propio contenido. A continuación se indica qué comportamiento se debe esperar cuando se tienen en cuenta ambos valores: Estado de la fuente del contenido Estado del contenido           Estado del servicio              Activo Activo El contenido se sirve Activo Inactivo El contenido se sirve Activo Archivado El contenido no se sirve (error 404) Inactivo Activo El contenido no se sirve (error 404) Inactivo Inactivo El contenido no se sirve (error 404) Inactivo Archivado El contenido no se sirve (error 404) Archivado Activo El contenido no se sirve (error 404) Archivado Inactivo El contenido no se sirve (error 404) Archivado Archivado El contenido no se sirve (error 404)   Activo: cumple los requisitos para que se sirvan anuncios. Inactivo: no cumple los requisitos para que se sirvan anuncios.  Archivado: no cumple los requisitos para que se sirvan anuncios orientados a contenido concreto, pero se pueden servir anuncios orientados a toda la red. Si el estado de la fuente del contenido se marca como inactivo o archivado, o si el estado del contenido se marca como archivado, no se servirá mediante la inserción dinámica de anuncios. Ejemplos <media:status state="blocked" reason="http://www.reasonforblocking.com"/> <media:status state="deleted"/> <media:status state="active"/> (Ad Manager no ingiere el atributo reason.)

Elemento	Elemento secundario de	Requisito
<media:thumbnail>	<media:content> o <item>	Recomendado
Descripción Permite que aparezca la miniatura del vídeo en la interfaz de Ad Manager. Por ahora, Ad Manager solo necesita el atributo URL de este elemento, pero se pueden proporcionar otros atributos, como la altura, la anchura y la cantidad de tiempo que aparece en el vídeo la imagen que se usa como miniatura. En la interfaz de Ad Manager nunca se muestran miniaturas mayores de 280x190 píxeles. Si la URL enlaza a una imagen más grande, Ad Manager enlaza a la versión original, pero modifica visualmente la escala de imagen con CSS integrado para mostrarla en la interfaz. Ejemplo <media:thumbnail url='http://www.myfeed.com/account/sdjfbadfb8w3489y/bigtn.jpg' width='280' height='190'/>

Elemento	Elemento secundario de	Requisito
<pubDate>	<item>	Opcional
Descripción Identifica la fecha en que se publicó el contenido. Este elemento solo se usa en las reglas de anuncios de vídeo. Todas las marcas de tiempo deben cumplir con la especificación RFC 822 o seguir el formato de la norma ISO 8601. Si la zona horaria no está incluida en la cadena de la marca de tiempo, el valor predeterminado es la hora estándar del Pacífico (PST). Ejemplos <pubDate>2006-02-19T04:22:39+05:00</pubDate> <pubDate>Sun, 19 Feb 2006 09:22:39 +0000</pubDate> Consultar ejemplos de cada formato de fecha Ejemplos RFC 822 Wed, 31 Oct 2016 08:00:00 EST Wed, 31 Oct 2016 13:00:00 GMT Wed, 31 Oct 2016 15:00:00 +0200 ISO 8601 20161031 2016-10-31 2016-10-31T08:00:00+01:00

Elementos específicos de la inserción dinámica de anuncios

Elemento	Elemento secundario de	Requisito
<dfpvideo:ingestUrl>	<item>	Obligatorio*
Descripción * Es obligatorio para la inserción dinámica de anuncios. Es un nodo empleado para especificar la URL de ingestión de vídeo al archivo maestro m3u8 que se ha utilizado para acondicionarlo y generar la lista de reproducción. Atributo "type": debe asignársele el valor application/x-mpegURL (HLS) o application/dash+xml (DASH). Atributo "preconditioned": puede ser true o false en función de si la URL ingestURL del contenido ya se ha acondicionado para insertar anuncios mid‑roll en él; si es el caso, sus segmentos ya se han dividido en función de las pausas publicitarias. Si no se define explícitamente, el valor predeterminado de este atributo es false. El contenido se considera acondicionado si la duración de los segmentos de vídeo de la emisión se ha definido de forma precisa para que se introduzcan anuncios en los puntos de inserción. Si es el caso, debe incluirse el marcador #EXT-X-PLACEMENT-OPPORTUNITY en la emisión de HLS para indicar a Ad Manager que debe insertarse una pausa publicitaria en ese punto del contenido de vídeo. Más información sobre el contenido acondicionado y preacondicionado para insertar anuncios mid-roll Ejemplos Para HLS <dfpvideo:ingestUrl type="application/x-mpegURL" preconditioned="false">https://cdn.example.com/?v=123.m3u8</dfpvideo:ingestUrl> Para DASH <dfpvideo:ingestUrl type="application/dash+xml" preconditioned="true"> https://cdn.example.com//playlist.mpd </dfpvideo:ingestUrl> Un solo fragmento de contenido de vídeo puede tener tanto HLS como DASH. Se recomienda el uso de URLs de ingestión seguras (https).

Elemento	Elemento secundario de	Requisito
<dfpvideo:lastMediaModifiedDate>	<item>	Recomendado
Descripción Indica cuándo se modificó por última vez la referencia del archivo de vídeo en <dfpvideo:ingestUrl>. Si este valor se actualiza alguna vez en el feed, el valor lastModifiedDate del contenido también debe actualizarse. Todas las marcas de tiempo deben cumplir con la especificación RFC 822 o seguir el formato de la norma ISO 8601. Si la zona horaria no está incluida en la cadena de la marca de tiempo, el valor predeterminado es la hora estándar del Pacífico (PST). Ejemplos <dfpvideo:lastMediaModifiedDate>2006-02-19T04:22:39+05:00</dfpvideo:lastMediaModifiedDate> <dfpvideo:lastMediaModifiedDate>Sun, 19 Feb 2006 09:22:39 +0000</dfpvideo:lastMediaModifiedDate> Consultar ejemplos de cada formato de fecha Ejemplos RFC 822 Wed, 31 Oct 2016 08:00:00 EST Wed, 31 Oct 2016 13:00:00 GMT Wed, 31 Oct 2016 15:00:00 +0200 ISO 8601 20161031 2016-10-31 2016-10-31T08:00:00+01:00

Elemento	Elemento secundario de	Requisito
<dfpvideo:closedCaptionUrl>	<item>	Varía*
Descripción * Solo se requiere si ha activado los subtítulos en la interfaz. Es un nodo en el que se especifica la URL que dirige al archivo de subtítulos. Todos los archivos de subtítulos disponibles deben proporcionarse en el feed en varios elementos closedCaptionUrl, con un archivo de subtítulos por idioma. Subtítulos del archivo de manifiesto HLS de vídeo bajo demanda Si este elemento del feed está presente, solo se ingerirán los subtítulos del feed y se ignorarán los subtítulos especificados en el archivo de manifiesto HLS. Los subtítulos del archivo de manifiesto HLS solo se ingieren si no hay elementos de subtítulos en el feed. Los formatos compatibles son TTML/DXFP (application/ttaf+xml) y WebVTT (text/vtt). Atributo "language": es obligatorio (no puede estar vacío) y su valor debe ser el idioma del archivo de subtítulos. Debe cumplir con el RFC5646 y no puede contener la cadena "$$$$$". Este atributo se utiliza de forma similar al atributo xml:lang que figura en el XML. Atributo "name": no puede contener la cadena "$$$$$". Atributo "type": debe ser el tipo de MIME de los archivos de subtítulos. Atributo "characteristics": puede definirse con uno de los valores siguientes o dejarse en blanco:** "public.accessibility.transcribes-spoken-dialog" "public.accessibility.describes-music-and-sound" "public.easy-to-read" ** Si el valor "characteristics" no está definido, se muestra una advertencia, pero aun así seguirá funcionando. En el caso de las fuentes de contenido únicas, la combinación de language y name debe ser distinta en cada archivo de subtítulos. Por ejemplo, [language="en", name="English"] y [language="en", name="English (CC)"]. Ejemplos <dfpvideo:closedCaptionUrl language="en" name="English" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl> <dfpvideo:closedCaptionUrl language="en" name="English (CC)" characteristics="public.accessibility.describes-music-and-sound" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl

Elemento	Elemento secundario de	Requisito
<dfpvideo:fw_caid>	<item>	Varía*
Descripción * Solo se requiere para los usuarios de FreeWheel. Es un nodo que sirve para especificar el ID de recurso personalizado de FreeWheel que se ha utilizado en la segmentación de anuncios. Ejemplo <dfpvideo:fw_caid>621160003648<dfpvideo:fw-caid>

Si tiene algún problema relacionado con la solución de problemas o las interrupciones de la inserción dinámica de anuncios, póngase en contacto con el equipo de Asistencia para editores.