Código de inserción (embed code)

Tipos de código de inserción

Tipo	Qué aspecto tiene	Contenido habitual
Iframe	<iframe src="…">, que carga una página pequeña (un reproductor) dentro de un marco	Videos, mapas, formularios
Imagen alojada	<img src="…"> que apunta a una URL servida por el DAM o por un CDN, a menudo con srcset para varios anchos	Fotos de producto, banners
Script	<script src="…">, que construye un widget en la página	Galerías, visores interactivos

El elemento iframe está definido en el HTML Living Standard que mantiene el WHATWG. Los iframes son la forma más habitual para el video, porque el reproductor, sus controles y su lógica de transmisión se quedan en el servidor de origen. Un script puede hacer más, pero ejecuta código de otro sitio dentro de tu página, por lo que muchos CMS y equipos de seguridad lo restringen.

Códigos de inserción, enlaces permanentes y descargas

Un enlace permanente (permalink) es una URL pensada para no cambiar mientras exista el elemento. En un DAM suele apuntar a un recurso o a uno de sus tamaños, de modo que un sitio web o un CMS puede mostrar la imagen sin que nadie copie el archivo.

	Descarga	Enlace permanente	Código de inserción
Qué entregas	Un archivo	Una URL	Un fragmento de HTML
Dónde está el archivo	En el sistema del destinatario	Con el propietario	Con el propietario
Actualizaciones	Requieren una copia nueva	Posibles en el origen	Posibles en el origen
Retirada	Imposible una vez enviado	Desactivar el enlace	Desactivar la inserción

Cada copia descargada sale del control del propietario. Un enlace o una inserción mantiene el recurso en un único lugar, lo que permite hacer cumplir la caducidad de los derechos y la retirada.

Control de los sitios donde aparecen las inserciones

• Lista de dominios permitidos. El servidor de origen puede enviar la directiva frame-ancestors de la Content Security Policy (W3C), que indica al navegador en qué sitios puede mostrarse la página dentro de un marco. En cualquier otro sitio, el navegador muestra un marco bloqueado.
• Revocación. Cada inserción debería estar vinculada a algo que el propietario pueda desactivar, como un recurso compartido o un enlace de publicación.
• Derechos. Una inserción es una publicación. La licencia debe cubrir el uso en la web en los territorios pertinentes, y la inserción debe dejar de funcionar cuando termine la licencia.
• Accesibilidad. Da un title al iframe y añade subtítulos a los videos: el criterio de conformidad 1.2.2 de las WCAG 2.2 exige subtítulos para el video grabado con sonido.
• Reproducción automática. Los navegadores solo inician un video automáticamente cuando está silenciado.

Inserciones en el trabajo de marketing

• Un distribuidor muestra el video de producto en su propia página de producto mediante un iframe, y la inserción solo se reproduce en el dominio de ese distribuidor.
• El equipo de recursos humanos inserta un video de bienvenida en la intranet en lugar de adjuntar un archivo grande a cada correo electrónico de bienvenida.
• El equipo web usa enlaces de imágenes alojadas en el CMS, de modo que una foto con licencia desaparece del sitio cuando termina su licencia en lugar de seguir en línea.
• Una página de destino de una campaña carga imágenes con varios anchos desde el mismo enlace, y el navegador elige la adecuada.

Errores frecuentes: descargar un video y volver a subirlo a un sitio web, lo que crea una copia que nadie controla; usar la reproducción automática con sonido; y olvidar las inserciones que siguen activas cuando termina una licencia.

Códigos de inserción en Freedam

• Inserciones de video. El botón Insertar bajo el reproductor de un video da un fragmento de iframe. Eliges un tamaño (480×270, 640×360, 854×480 o personalizado), un momento de inicio y si se reproduce automáticamente, está silenciado, se repite en bucle y muestra los controles. Requiere el permiso Compartir públicamente, y la política de derechos del video debe permitir la publicación.
• Cada inserción se apoya en un recurso compartido público de solo visualización, válido durante un año y ampliado automáticamente mientras se usa. Revocar ese recurso compartido en Gestión de recursos compartidos detiene la inserción. El reproductor transmite el video de forma adaptable (HLS), muestra el póster del video y ofrece sus subtítulos.
• Los administradores pueden definir una lista de dominios de inserción permitidos por defecto para el espacio de trabajo y otra independiente para cada recurso compartido. Los navegadores solo reproducen la inserción en los sitios de la lista.
• Los códigos de inserción también pueden crearse, leerse y revocarse mediante la API REST y el SDK de TypeScript.
• Enlaces permanentes de imagen. Un canal de publicación de sitio web publica las imágenes que cumplen sus condiciones y cuyos derechos de uso permiten el uso y el territorio del canal. En la pestaña Publicación y usos de un recurso, Copiar enlace da un enlace que no caduca, con cualquier ancho hasta el tamaño máximo del canal, en AVIF, WebP o JPEG según el navegador, y utilizable en srcset. Los derechos se comprueban en cada solicitud, y el enlace deja de funcionar cuando la imagen sale del canal. La publicación forma parte de los planes Business y Tailored.

Detalles: la página para desarrolladores sobre inserciones, y Pósteres y subtítulos de video y Publicación en la documentación de Freedam.

Preguntas frecuentes

¿Cuál es la diferencia entre un código de inserción y un enlace?

Un enlace lleva al visitante a otra página. Un código de inserción muestra el contenido dentro de tu propia página. Ambos mantienen el archivo con su propietario, a diferencia de una descarga.

¿Cómo impido que un sitio web inserte mi video?

Restringe la inserción a una lista de dominios permitidos, que los navegadores hacen cumplir mediante frame-ancestors, o revoca el recurso compartido o el enlace en que se apoya la inserción. Al revocarlo se detiene en todas partes a la vez.

¿Qué es un enlace permanente (permalink)?

Un enlace permanente es una URL diseñada para no cambiar, de modo que pueda guardarse, citarse o colocarse en un CMS. En el caso de las imágenes, un enlace permanente es útil cuando el DAM sigue comprobando los derechos en cada solicitud, de modo que un enlace que no cambia no significa que la imagen siga en línea cuando su licencia ha terminado.