Il mio lettore ha bisogno di un account Podhoc per riprodurre l’embed?

No. L’embed serve la superficie pubblica di Scopri — i lettori anonimi ascoltano un'anteprima gratuita di 30 secondi senza registrarsi. Per ascoltare l'episodio completo devono premere il CTA "Ascolta su Podhoc" nel lettore, che apre la pagina sorgente dove possono accedere e applicare i crediti. L'anteprima è sempre gratis per l'ascoltatore.

Le riproduzioni dall’embed consumano i MIEI crediti?

No. Le riproduzioni di anteprima sul tuo embed vengono assorbite da Podhoc — il tuo saldo crediti non si tocca, ascolti un lettore o mille. Il limite di 100 plays/giorno/host (più sotto) è una protezione contro l’hot-linking abusivo, non una quota per podcast.

Posso incorporare più podcast nella stessa pagina?

Sì. Ogni iframe è indipendente — mettine quanti vuoi. Condividono lo stesso codice di lettore leggero, quindi il secondo embed e i successivi aggiungono solo i metadati del podcast (~2 KB l’uno), non i 50 KB completi.

In v1, nessuna lato embed. Le riproduzioni sono contate a livello di Scopri (una classifica dei tracks più riprodotti per l’autore pubblicante è in roadmap). La tua piattaforma di analytics (GA4, Plausible, Fathom) può tracciare clic e visibilità sul contenitore dell’iframe.

Come tolgo un embed se cambio idea?

Due opzioni. O elimini l’iframe dalla pagina — il lettore sparisce all’istante — o spubblichi il podcast da Scopri di Podhoc. Un podcast spubblicato mostra un placeholder di "non disponibile" negli embed già esistenti invece di restituire 404, così i lettori vedono un messaggio elegante.

È supportato l’autoplay?

No. I browser bloccano l’autoplay sugli iframe cross-origin per impostazione predefinita, e Podhoc lo rispetta. I lettori devono premere play. L’embed onora il resto dei controlli standard del lettore: scrub, velocità, toggle della trascrizione.

Qual è la dimensione predefinita dell’iframe e posso personalizzarla?

Il frammento predefinito è 100% di larghezza × 240 px di altezza — sottile per sidebar, abbastanza largo per corpo di blog. Larghezza, altezza e un tema futuro (chiaro / scuro / auto) sono in roadmap; in v1 il frammento è responsive di default ma visivamente fisso.

Posso personalizzare i colori per abbinarli al mio brand?

Non ancora. I controlli di tema (chiaro / scuro / auto, colore d’accento) sono documentati nella sezione "Opzioni di personalizzazione" come "In arrivo". L’embed v1 usa la palette di brand Podhoc per mantenere chiara l’attribuzione di paternità.

Incorpora podcast Podhoc nel tuo sito — Documentazione del widget iframe

2026-05-13 · Aggiornato 2026-05-23

Incorpora qualsiasi podcast pubblico Podhoc sul tuo blog, nella tua redazione o nella pagina di un corso con un solo iframe. 50 KB gzip, caricamento lazy, le riproduzioni non consumano i tuoi crediti. Gratis per i lettori, senza account.

Incorpora il tuo podcast Podhoc su qualsiasi sito in pochi secondi

Pubblichi un podcast in Podhoc. Lo vuoi sul tuo blog, in un modulo di corso, in un articolo di redazione o nel wiki del tuo team. L’embed di Podhoc è un singolo iframe — lo incolli, il lettore preme play e l’audio viene riprodotto da podhoc.com senza uscire dalla tua pagina.

I permessi di incorporamento sono solo per l’autore. Solo l’autore del podcast può generare uno snippet di incorporamento per quel podcast — il pulsante Embed è controllato lato server contro l’owner_id del podcast ed è nascosto sulle schede di Scopri di podcast di cui non sei l’autore. Questo mantiene l’attribuzione pulita e dà il controllo del takedown al legittimo autore.

Per l’ascoltatore non serve alcun account. I lettori anonimi ascoltano un’anteprima gratuita di 30 secondi senza registrarsi; premendo “Ascolta su Podhoc” si apre la pagina sorgente dove possono accedere per ascoltare l’episodio completo (i crediti vengono applicati secondo la matrice di crediti del Scopri). Le riproduzioni di anteprima vengono assorbite da Podhoc — non consumano il tuo saldo crediti. Il lettore pesa 50 KB gzip, si carica in lazy all’ingresso nel viewport e mostra un placeholder di “non disponibile” invece di un frame rotto se spubblichi il podcast sorgente.

Come ottenere il tuo codice embed

1. Apri IL TUO podcast in Scopri di Podhoc

Vai su app.podhoc.com/discover e apri uno dei tuoi podcast pubblicati. Il pulsante Embed compare solo sui podcast di cui sei l’autore, perché i permessi di incorporamento sono legati all’autore; nelle schede di Scopri di podcast di cui non sei l’autore, il pulsante Embed è nascosto.

2. Clicca su Embed e copia l’iframe

Nella scheda del podcast clicca Embed. Una modale mostra l’HTML dell’iframe già compilato con lo slug canonico e l’identificativo univoco del permesso di incorporamento. Copia l’intero frammento. L’identificativo del permesso è ciò che Podhoc usa per attribuire le riproduzioni di embed al tuo account e per gestire i takedown; non rimuoverlo dal frammento.

3. Incolla l’iframe nel tuo sito

Posa il frammento in un blocco HTML qualsiasi — un widget HTML personalizzato di WordPress, una card embed di Ghost, un /embed di Notion, una pagina MDX di Docusaurus o <iframe> puro su un sito statico. Il lettore esegue lo streaming da podhoc.com, si carica in lazy all’ingresso nel viewport e aggiunge 50 KB gzip al peso della pagina.

Esempio: embed dal vivo

Ecco il frammento canonico, puntato a un podcast d’esempio da Scopri. Sostituisci lo slug ?podcast=example con quello del tuo podcast dopo lo step 2.

<iframe
  src="https://app.podhoc.com/embed?podcast=example"
  width="100%"
  height="240"
  loading="lazy"
  frameborder="0"
  allow="autoplay; clipboard-write; encrypted-media; picture-in-picture"
  title="Lettore Podhoc"
></iframe>

L’attributo loading="lazy" non è negoziabile — tiene l’embed fuori dal percorso critico di rete fino a quando il lettore lo porta nel viewport, ed è ciò che protegge i tuoi punteggi di page-speed.

Opzioni di personalizzazione

In v1 l’iframe è consegnata visivamente fissa a 100% di larghezza × 240 px di altezza con la palette di brand Podhoc. Le leve seguenti sono in roadmap e saranno documentate qui appena arrivano:

In arrivo: width — un query param ?w= per sovrascrivere la larghezza predefinita.
In arrivo: height — un query param ?h= per layout compatti / espansi.
In arrivo: theme — ?theme=light|dark|auto per accordarsi al tuo sito.

Finché non atterrano, l’embed è volutamente semplice — un frammento, nessuna messa a punto, uguale ovunque.

Prestazioni

Dimensione del bundle: 50 KB gzip per il primo embed su una pagina. Gli embed successivi nella stessa pagina aggiungono solo i metadati del podcast (~2 KB l’uno), non l’intero codice del lettore.
Caricamento lazy: l’iframe imposta loading="lazy" di default. Il browser ritarda la richiesta di rete finché il lettore non porta il player nel viewport — un embed sotto la piega costa quindi zero byte finché non serve.
Streaming: l’audio è servito dalla stessa distribuzione CloudFront che alimenta app.podhoc.com, con richieste byte-range per uno scrubbing immediato.
Impatto sul page-speed: nei nostri audit Lighthouse interni, una pagina con un embed Podhoc resta entro 1 punto di distanza dalla stessa pagina senza embed quando il frammento sta sotto la piega.

Anti-abuso — 100 riproduzioni / giorno / host

Per mantenere sostenibile lo streaming pubblico di Scopri senza fatturarlo a chi incorpora, Podhoc applica un limite morbido di 100 riproduzioni al giorno per host. Il limite è per dominio che incorpora, non per podcast — se ospiti dieci embed su ilmioblog.example, l’intero dominio condivide il budget di 100 riproduzioni quotidiane.

In pratica:

Le prime 100 riproduzioni della giornata vengono servite normalmente.
Oltre, il lettore continua a caricarsi e a mostrare i metadati del podcast, ma presenta un messaggio gentile: “Limite giornaliero raggiunto — riprova domani o apri in Podhoc”.
Il contatore si azzera a mezzanotte UTC.

Se hai un’esigenza legittima per un limite più alto (una redazione molto visitata, una piattaforma di corsi ad alto traffico), scrivici dalla pagina di supporto — manteniamo una allowlist per gli integratori di fiducia.

Domande frequenti

Il blocco FAQ qui sotto rispecchia la lista faqs: nel front-matter della pagina, che è ciò che Hugo emette come dati strutturati per i motori di ricerca e i riassunti AI.

Correlati

Prezzi — pacchetti di crediti e abbonamenti (le riproduzioni dell’embed non consumano i tuoi crediti).
Privacy — cosa registriamo quando un lettore preme play su un embed.
Termini — regole d’uso accettabile del widget embed.
Scopri — naviga i podcast pubblici e prendi i codici embed.

Apri Scopri e prendi un codice embed →

Domande frequenti

Posso incorporare qualsiasi podcast Podhoc sul mio sito?: No — puoi incorporare solo podcast di cui sei l’autore. Il pulsante Embed è controllato lato server contro l’owner_id del podcast; nelle schede di Scopri di podcast di cui non sei l’autore, il pulsante Embed è nascosto. In questo modo il permesso di incorporamento resta legato all’autore per analitiche, takedown e attribuzione di ricavi.
Il mio lettore ha bisogno di un account Podhoc per riprodurre l’embed?: No. L’embed serve la superficie pubblica di Scopri — i lettori anonimi ascoltano un’anteprima gratuita di 30 secondi senza registrarsi. Per ascoltare l’episodio completo devono premere il CTA “Ascolta su Podhoc” nel lettore, che apre la pagina sorgente dove possono accedere e applicare i crediti. L’anteprima è sempre gratis per l’ascoltatore.
Le riproduzioni dall’embed consumano i MIEI crediti?: No. Le riproduzioni di anteprima sul tuo embed vengono assorbite da Podhoc — il tuo saldo crediti non si tocca, ascolti un lettore o mille. Il limite di 100 plays/giorno/host (più sotto) è una protezione contro l’hot-linking abusivo, non una quota per podcast.
Posso incorporare più podcast nella stessa pagina?: Sì. Ogni iframe è indipendente — mettine quanti vuoi. Condividono lo stesso codice di lettore leggero, quindi il secondo embed e i successivi aggiungono solo i metadati del podcast (~2 KB l’uno), non i 50 KB completi.
Che analytics ho?: In v1, nessuna lato embed. Le riproduzioni sono contate a livello di Scopri (una classifica dei tracks più riprodotti per l’autore pubblicante è in roadmap). La tua piattaforma di analytics (GA4, Plausible, Fathom) può tracciare clic e visibilità sul contenitore dell’iframe.
Come tolgo un embed se cambio idea?: Due opzioni. O elimini l’iframe dalla pagina — il lettore sparisce all’istante — o spubblichi il podcast da Scopri di Podhoc. Un podcast spubblicato mostra un placeholder di “non disponibile” negli embed già esistenti invece di restituire 404, così i lettori vedono un messaggio elegante.
È supportato l’autoplay?: No. I browser bloccano l’autoplay sugli iframe cross-origin per impostazione predefinita, e Podhoc lo rispetta. I lettori devono premere play. L’embed onora il resto dei controlli standard del lettore: scrub, velocità, toggle della trascrizione.
Qual è la dimensione predefinita dell’iframe e posso personalizzarla?: Il frammento predefinito è 100% di larghezza × 240 px di altezza — sottile per sidebar, abbastanza largo per corpo di blog. Larghezza, altezza e un tema futuro (chiaro / scuro / auto) sono in roadmap; in v1 il frammento è responsive di default ma visivamente fisso.
Posso personalizzare i colori per abbinarli al mio brand?: Non ancora. I controlli di tema (chiaro / scuro / auto, colore d’accento) sono documentati nella sezione “Opzioni di personalizzazione” come “In arrivo”. L’embed v1 usa la palette di brand Podhoc per mantenere chiara l’attribuzione di paternità.