Generatore del codice di incorporamento YouTube
Incolla il link di un video, di uno Short o di una playlist, scegli le opzioni e copia un codice di incorporamento pulito, con inizio e fine, modalità privacy avanzata e dimensioni responsive. Funziona interamente nel tuo browser.
Questo generatore del codice di incorporamento YouTube costruisce l’HTML per inserire nel tuo sito un video, uno Short o una playlist di YouTube, con opzioni che il riquadro Condividi → Incorpora di YouTube non offre. Imposta inizio e fine, riproduzione automatica (compresa quella senza audio che i browser consentono), loop, sottotitoli, modalità privacy avanzata e una dimensione responsive adatta a ogni schermo, poi copia il codice e incollalo nella tua pagina. Un’anteprima dal vivo mostra il player mentre lavori. Tutto avviene nel tuo browser: a Marqly non viene inviato nulla, e ogni opzione corrisponde a un parametro documentato nel riferimento ufficiale del player di YouTube.
Come incorporare un video YouTube nel tuo sito
- Copia il link del video da YouTube: una pagina di visione, uno Short, una diretta, un link youtu.be o il link di una playlist che contiene
list=. - Incollalo qui sopra. Se il link include un timestamp come
?t=90, il tempo di inizio viene compilato. - Scegli le opzioni. Il codice e l’anteprima si aggiornano subito.
- Premi Copia il codice e incollalo nell’HTML della tua pagina: in WordPress usa un blocco HTML personalizzato; nella maggior parte dei costruttori di siti, un elemento Incorpora o HTML.
Ogni opzione e il parametro che c’è dietro
| Opzione | Parametro | Che cosa fa |
|---|---|---|
| Inizia a | start | Avvia la riproduzione dopo questo numero di secondi dall’inizio del video. Il player si posiziona sul fotogramma chiave più vicino, che può trovarsi fino a circa due secondi prima. |
| Termina a | end | Ferma la riproduzione a questo tempo, contato dall’inizio del video e non dal tuo tempo di inizio. |
| Riproduzione automatica | autoplay=1 | Avvia il video al caricamento del player. YouTube precisa che la raccolta dei dati di riproduzione avviene allora al caricamento della pagina. |
| Loop | loop=1 | Ripete una playlist; per un singolo video YouTube richiede anche playlist impostato sullo stesso ID del video, cosa che il generatore aggiunge. |
| Mostra i controlli del player | controls=0 se disattivato | Nasconde la barra dei controlli. |
| Pulsante schermo intero | fs=0 se disattivato | Nasconde il pulsante dello schermo intero. |
| Sottotitoli attivi di default | cc_load_policy=1 | Mostra i sottotitoli di default, se il video li ha. |
| Suggerimenti dello stesso canale | rel=0 | Limita al medesimo canale i video correlati mostrati alla fine. |
| Riproduci in linea su iPhone | playsinline=1 | Riproduce dentro la pagina su iOS invece di passare allo schermo intero. |
| Disattiva i comandi da tastiera | disablekb=1 | Disattiva scorciatoie come k per mettere in pausa e j/l per saltare di 10 secondi. |
| Barra di avanzamento bianca | color=white | Colora di bianco anziché di rosso la parte già guardata della barra di avanzamento. |
| Modalità privacy avanzata | youtube-nocookie.com | Usa il dominio di incorporamento con privacy avanzata di YouTube (vedi sotto). |
Tempi di inizio e di fine
Il player di YouTube accetta inizio e fine come secondi interi, quindi il generatore converte qualsiasi cosa tu scriva (90, 1:30, 1:02:03 o 1h2m3s) in secondi. Entrambi sono misurati dall’inizio assoluto del video: per riprodurre la clip da 1:30 a 2:00, inserisci inizio 1:30 e fine 2:00, non fine 0:30. Per condividere un momento come link anziché come incorporamento, usa il generatore di link YouTube con timestamp.
Perché i video incorporati non partono da soli, e come rimediare
Sono i browser a decidere se un video può partire da solo. La documentazione dell’API IFrame di YouTube elenca la riproduzione con audio senza interazione dell’utente tra i casi che i browser bloccano, quindiautoplay=1 da solo spesso non fa nulla. L’approccio affidabile è partire in muto: scegliAutoplay senza audio (API JavaScript) e il generatore produce un incorporamento più un breve script che carica l’API ufficiale IFrame Player di YouTube, silenzia il player quando è pronto e avvia la riproduzione. I visitatori possono riattivare l’audio con un clic.
Le regole di YouTube per i client dell’API aggiungono due condizioni da rispettare: un player non deve partire automaticamente finché più della metà non è visibile sullo schermo e una pagina non deve avere più di un player YouTube in riproduzione automatica contemporaneamente. Un video in evidenza in cima alla pagina va bene; un video con riproduzione automatica molto più in basso no.
Modalità privacy avanzata (youtube-nocookie.com)
La modalità privacy avanzata sostituisce www.youtube.com con www.youtube-nocookie.comnell’URL di incorporamento. Il centro assistenza di YouTube dice che impedisce alle visualizzazioni del video incorporato di influenzare l’esperienza di navigazione dello spettatore su YouTube, mostra annunci non personalizzati e impedisce che quelle visualizzazioni personalizzino gli annunci mostrati allo spettatore fuori dal tuo sito. Qui è attiva di default perché non costa nulla. Ciò che non è: una promessa che l’incorporamento non imposti cookie né faccia tracciamento, e di per sé non rende un incorporamento conforme a nessuna norma sulla privacy: cita comunque YouTube nell’informativa sulla privacy e nella gestione del consenso.
Incorporamenti YouTube responsive, compresi gli Short
L’iframe predefinito ha una dimensione fissa di 560 × 315 che sui telefoni esce dallo schermo. ConResponsive attivo, il codice imposta il player al 100% della larghezza del suo contenitore e usa la proprietà CSS aspect-ratio per mantenerne la forma, senza bisogno di un wrapper con padding-bottom in nessun browser attuale. Scegli 9:16 per gli Short, così il video verticale non ha bande nere; il campo della larghezza fissa allora fino a dove può crescere. YouTube richiede che i player incorporati misurino almeno 200 × 200 pixel e consiglia almeno 480 × 270 per i player 16:9, quindi il generatore non scende sotto i 200 pixel di larghezza.
Incorporamenti con caricamento al clic per pagine più veloci
Un iframe di YouTube carica il player completo appena si carica la pagina, il che pesa se la pagina ha un video che la maggior parte dei visitatori non riproduce mai. L’output Caricamento al clic mostra la miniatura del video con un pulsante di riproduzione e inserisce il player vero solo quando qualcuno ci clicca (o preme Invio), poi avvia la riproduzione. La pagina diventa più veloce e al player non viene richiesto nulla finché il visitatore non decide di guardare. Funziona per i singoli video; le playlist usano l’iframe standard.
Parametri che non funzionano più
modestbrandingè deprecato e non ha alcun effetto; YouTube ora decide il marchio in base alle dimensioni del player e ad altri segnali. I generatori che lo offrono ancora sono obsoleti.showinfoè stato deprecato nel 2018 e rimosso dalla documentazione.rel=0non può più disattivare i video correlati dal 25 settembre 2018: si limita a tenerli entro lo stesso canale.controls=2è deprecato; usa 0 o 1.
Risolvere un incorporamento che non funziona
- Errore 153 o player vuoto. YouTube richiede che gli incorporamenti identifichino il sito su cui si trovano tramite l’intestazione HTTP Referer e consiglia la policy sul referrer
strict-origin-when-cross-origin. Il codice generato imposta quella policy; se il tuo sito inviano-referrera livello globale, il player può non funzionare. - «Video non disponibile». Chi lo ha pubblicato può aver disattivato l’incorporamento per quel video, oppure è privato, eliminato o bloccato nel paese del visitatore. Solo il proprietario può cambiarlo.
- Il player è tagliato o minuscolo. Un elemento padre con altezza fissa o
overflow: hiddenlo sta ritagliando; con Responsive attivo, dai al contenitore una larghezza e lascia che l’altezza lo segua. - Il loop non si ripete. Per un singolo video l’URL deve includere
playlist=con lo stesso ID del video: copia il codice generato invece di aggiungereloop=1a mano.
Altri strumenti YouTube correlati
Trova il momento giusto da cui partire con lo strumento di trascrizione YouTube, aggiungi capitoli ai video lunghi con il generatore di capitoli, oppure scarica un’immagine di copertina personalizzata con loscaricatore di miniature. Incorpori un intero corso? Ilcalcolatore della durata delle playlist dice ai visitatori quanto dura.
Domande frequenti
Come incorporo un video YouTube che parte da un momento preciso?
Inserisci il tempo di inizio nel generatore (in secondi, M:SS, H:MM:SS o 1m30s) e copia il codice. Lo strumento aggiunge all’URL di incorporamento il parametro start, in secondi, che è il formato atteso dal player di YouTube. Se il link che incolli contiene già un timestamp t=, il tempo di inizio viene compilato per te.
Perché il mio video YouTube incorporato non parte da solo?
La maggior parte dei browser blocca i video con audio che partono prima che il visitatore interagisca con la pagina. La documentazione per sviluppatori di YouTube elenca la riproduzione con audio senza interazione dell’utente tra i casi bloccati dai browser. Usa l’output Autoplay senza audio (API JavaScript), che avvia il player in muto.
Come rendo responsive un incorporamento YouTube?
Lascia attivo Responsive. Il codice imposta il player alla larghezza piena del suo contenitore e usa la proprietà CSS aspect-ratio per mantenere il formato 16:9 (o 9:16 per gli Short), così si adatta a ogni schermo senza trucchi con wrapper aggiuntivi.
Che cosa fa la modalità privacy avanzata?
Porta l’incorporamento sul dominio youtube-nocookie.com. Secondo il centro assistenza di YouTube, le visualizzazioni del video incorporato non influenzano allora l’esperienza di navigazione dello spettatore su YouTube né personalizzano gli annunci mostrati fuori dal tuo sito. Non rende l’incorporamento privo di tracciamento, quindi tienilo presente nella tua informativa sulla privacy.
Come metto in loop un singolo video YouTube?
Spunta Loop. Per un singolo video YouTube richiede che il parametro playlist sia impostato sullo stesso ID del video, oltre a loop=1; il generatore aggiunge entrambi per te.
Posso nascondere i video correlati alla fine?
Non del tutto. Da settembre 2018 rel=0 non nasconde più i video correlati: li limita ai video dello stesso canale. L’opzione Solo suggerimenti dello stesso canale del generatore imposta proprio questo.
Posso incorporare una playlist?
Sì. Incolla il link di una playlist (contiene list=). Il generatore costruisce un incorporamento di playlist e, se il tuo link punta anche a un video specifico, il player parte da quello.
