Embeddare un Digital Asset in un sito o pagina web esterna – THRON Guide

Pubblica un video, un'immagine o un documento su un sito o una pagina web senza caricarne una copia altrove: il file resta uno solo, gestito in piattaforma. Quando lo sostituisci o ne aggiorni i dati, tutte le pagine che lo ospitano mostrano la versione nuova senza che tu debba intervenire.

Scegli come integrarlo in base a quanto controllo vuoi sulla resa grafica.

Cosa vuoi ottenere	Metodo
Mostrare il contenuto con il player THRON, con controlli di riproduzione e Content Experience	Condivisione EMBED
Integrare il file nel markup del tuo sito, ad esempio in un tag `img` o in un player di terze parti	URL di delivery
Usare l'immagine di copertina di un video, ad esempio come anteprima in una lista	URL di delivery della thumbnail

La condivisione di tipo Embed ti dà il codice pronto da incollare: porta con sé il player THRON e la Content Experience che hai configurato, quindi non devi scrivere markup.

Genera il codice embed

Individua l'asset, in vista lista o nel wall.
Apri il menu contestuale dell'asset tramite i tre puntini:
- in vista lista, clicca i tre puntini accanto alla thumbnail, nella riga corrispondente;
- nel wall, passa con il mouse sopra la thumbnail per far comparire i tre puntini, poi cliccali.
Nel menu contestuale, clicca su Condividi.
Nella finestra Tipo di condivisione, seleziona EMBED.
Clicca su Seleziona.
Configura le opzioni nel pannello Creazione EMBED (vedi sotto).
Clicca su Aggiorna e genera codice di EMBED.
Nella finestra Codice embed, clicca su Copia codice embed.
Incolla il codice nell'HTML della tua pagina, nel punto esatto in cui vuoi che compaia il contenuto.

Nota: puoi generare l'embed anche dal dettaglio dell'asset.

Nota: se devi pubblicare molti asset, non generare un embed per ognuno. Collega la cartella a una Custom Application e usa un'unica pKey per tutti i contenuti che contiene: i nuovi asset caricati nella cartella diventano automaticamente accessibili con la stessa chiave.

Personalizza il codice embed

Opzione	Cosa fa
Nome dell'embed	Identifica la condivisione nella tua Shareboard. Max 500 caratteri.
Player template	Sceglie lo stile della Content Experience con cui viene mostrato il player.
Player responsivo	Adatta automaticamente le dimensioni del player al contenitore della pagina. Se disattivato, puoi impostare Larghezza e Altezza in pixel.
Mostra controlli	Mostra i controlli di riproduzione nel player. Attivo di default.

Nota: per creare nuovi Player template, vai su Experience Manager nel menu delle impostazioni accanto al tuo avatar nella barra di navigazione superiore.

Opzioni per video e audio

Solo per asset di tipo video o audio:

Autoplay: avvia la riproduzione automaticamente all'apertura della pagina.
Loop: ripete la riproduzione al termine.
Muto: avvia il player senza audio.

Opzioni per le immagini

Se l'asset è un'immagine, hai invece a disposizione:

Ritaglio: Nessun ritaglio, Ritaglio centrato, Ritaglio automatico, Ritaglio prodotto oppure Ritaglio manuale (con coordinate personalizzate e possibilità di forzare lo stesso aspect ratio del player).
Impostazioni avanzate: regolazioni dell'immagine come contrasto e saturazione.

Configurazione consigliata

Per la maggior parte dei casi d'uso su sito web:

Player responsivo attivo, così il player si adatta a qualsiasi larghezza di colonna senza dover impostare pixel fissi.
Mostra controlli attivo, per lasciare il controllo della riproduzione a chi visita la pagina.
Autoplay disattivo, per rispettare l'esperienza di chi naviga. Se lo attivi, attiva anche Muto: senza audio disattivato i browser bloccano la riproduzione automatica.
Player template coerente con la Content Experience già usata nelle altre pagine del sito, per mantenere un'esperienza visiva uniforme.

Integra il contenuto senza player, tramite URL di delivery

Se gestisci tu il markup della pagina, non sei obbligato a usare il player: ogni asset è raggiungibile anche tramite un URL di delivery, che puoi inserire dove preferisci, ad esempio in un tag img, in un link di download o in un player di terze parti. Come per l'embed, il contenuto resta collegato alla piattaforma e si aggiorna insieme all'asset.

Ottieni l'URL di un asset

Apri il menu contestuale dell'asset tramite i tre puntini e clicca su Condividi.
Nella finestra Tipo di condivisione, seleziona URL.
Configura le opzioni disponibili, poi genera e copia l'URL.

La condivisione URL genera anche la pKey che autorizza la distribuzione del contenuto. Trovi tutte le condivisioni già create nella Shareboard dell'asset.

Recupera la copertina di un video

Il player mostra il video, non la sua immagine di copertina. Se ti serve la copertina come immagine autonoma, ad esempio come anteprima in una lista di contenuti, componi l'URL di delivery della thumbnail:

https://<clientId>-cdn.thron.com/api/v1/content-delivery/shares/<pkey>/contents/<contentId>/thumbnail?w=1280

Dove:

clientId: l'identificativo del tuo tenant THRON.
pkey: la chiave di autorizzazione. Usa quella generata da una condivisione URL dell'asset oppure quella della Custom Application collegata alla cartella.
contentId: l'identificativo dell'asset, che trovi nelle informazioni aggiuntive del dettaglio contenuto.
w: la larghezza in pixel dell'immagine restituita, parametro facoltativo.

Nota: la thumbnail viene consegnata sempre nel formato migliore per il browser e, se necessario, ritagliata al centro. Per controllare ritaglio, qualità e regolazioni dell'immagine usa l'URL di delivery di un'immagine, non quello della thumbnail.

Cosa succede se modifichi o elimini l'asset

Sostituire il file o aggiornarne i dati non richiede di rigenerare il codice embed né gli URL di delivery già pubblicati: restano validi e servono la versione aggiornata.

Attenzione: se elimini l'asset, l'embed smette di mostrare il contenuto su tutte le pagine dove è stato pubblicato. Prima di eliminare un asset condiviso via embed, verifica le pagine coinvolte.

Se l'embed non funziona sul tuo sito

Se il player non compare o restituisce un errore su un dominio specifico, la causa più comune è una restrizione dei domini abilitati alla condivisione, impostata a livello di account. Contatta il supporto THRON per verificare o aggiornare la configurazione.

## Articoli di approfondimento
- La pKey: cos'è e come gestirla
- Guida alla Creazione e Configurazione di una Custom Application
- Rimuovere ed eliminare Digital Asset
- THRON Player: nuova versione

Serve aiuto?

Per problemi tecnici, scrivi a support@thron.com.

Channel Activation