Cos’è un codice di incorporamento?

Un codice di incorporamento è un breve frammento HTML che il proprietario di un sito incolla in una pagina affinché un video YouTube venga riprodotto lì, invece di essere raggiungibile solo tramite un link. YouTube lo genera come elemento <iframe> che punta a uno speciale URL /embed/ del video.

Cosa contiene un codice di incorporamento

Come minimo contiene un URL di origine con l’ID del video, una larghezza e un’altezza (oppure, in alternativa, un contenitore responsive) e un attributo title per l’accessibilità. Parametri opzionali controllano la riproduzione automatica, il tempo di inizio, la visibilità dei controlli e altro ancora.

Come ottenerne uno

Puoi copiare la versione di YouTube dal pannello Condividi sotto un video, oppure usare il generatore di codice di incorporamento di questo sito per aggiungere dimensionamento responsive, modalità privacy, tempi di inizio e altre opzioni che il pannello standard di YouTube non offre tutte insieme.

Come è costruito un codice di incorporamento

Un codice di incorporamento non è una stringa fissa, ma è composto da alcune parti intercambiabili. Il dominio (youtube.com o quello rispettoso della privacy youtube-nocookie.com) determina il comportamento dei cookie. Il percorso contiene un singolo ID video oppure, per una playlist, il percorso videoseries con un parametro list. I parametri di query come start, autoplay e controls si trovano dopo un punto interrogativo e modificano la riproduzione. Infine, il markup circostante, attributi width/height fissi oppure un div contenitore responsive, determina come viene dimensionato il player nella pagina. Comprendere queste parti separabili rende molto più facile leggere, e modificare a mano, un codice di incorporamento che non hai generato tu stesso.

Un esempio pratico

Supponi di voler mostrare un video dimostrativo di un prodotto su una landing page, rispettoso della privacy, che parta dopo 15 secondi per saltare un’introduzione, senza riproduzione automatica. Il codice di incorporamento risultante combina un dominio youtube-nocookie.com, un parametro start=15 e un contenitore responsive:

<div style="position:relative;width:100%;padding-bottom:56.25%;height:0;overflow:hidden;">
  <iframe src="https://www.youtube-nocookie.com/embed/VIDEO_ID?start=15" style="position:absolute;top:0;left:0;width:100%;height:100%;border:0;" title="Demo del prodotto" allowfullscreen loading="lazy"></iframe>
</div>

Ogni parte di questo frammento corrisponde a una scelta precisa: il dominio per la privacy, start=15 per saltare l’intro, e il contenitore per il dimensionamento responsive.

Codice di incorporamento contro un semplice link

Vale la pena chiarire cosa non è un codice di incorporamento. Un normale link YouTube (un URL watch o youtu.be) è pensato per essere condiviso e cliccato; incollato come testo semplice su una pagina, resta semplicemente un URL, oppure viene convertito automaticamente in un’incorporazione da piattaforme come WordPress che supportano oEmbed. Un codice di incorporamento, invece, è HTML esplicito che controlli direttamente, con opzioni di dimensione, privacy e riproduzione che un semplice link non offre. Concetti correlati da conoscere sono l’elemento iframe da cui dipende il codice e la distinzione tra URL di incorporamento e URL di visualizzazione.

Domande frequenti