Dati strutturati per video didattici (LearningResource, VideoObject, Clip)
La Ricerca Google rappresenta un punto di accesso in cui studenti e insegnanti possono scoprire e guardare video didattici. Se fornisci in modo esplicito informazioni didattiche specifiche tramite i dati strutturati, ad esempio il livello di istruzione e le competenze e i concetti presentati nel video, Google può comprendere meglio i contenuti del tuo video e fornire un'esperienza migliore per aiutare gli utenti a trovare i contenuti giusti.
I dati strutturati per video didattici potrebbero anche abilitare chip di informazioni relativi al video didattico, come il livello di istruzione e il tipo di video (ad esempio, una panoramica o il video di una soluzione).
Disponibilità della funzionalità
Il risultato avanzato di un video didattico è disponibile in inglese in tutte le aree geografiche in cui è disponibile la Ricerca Google. La funzionalità è disponibile solo quando cerchi contenuti didattici accademici su desktop e mobile.
Esempi
Video didattico singolo
Ecco un esempio di un video didattico singolo.
<html>
<head>
<title>Learning video markup example</title>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": ["VideoObject", "LearningResource"],
"name": "An introduction to Genetics",
"description": "Explanation of the basics of Genetics for beginners.",
"learningResourceType": "Concept Overview",
"educationalLevel": "High school (US)",
"contentUrl": "https://www.example.com/video/123/file.mp4",
"thumbnailUrl": [
"https://example.com/photos/1x1/photo.jpg",
"https://example.com/photos/4x3/photo.jpg",
"https://example.com/photos/16x9/photo.jpg"
],
"uploadDate": "2024-03-31T08:00:00+08:00"
}
</script>
</head>
<body>
</body>
</html>
Video di apprendimento con più clip
Ecco un esempio di un video didattico con tre clip: due sono relative alla risoluzione del problema e una include una panoramica del concetto.
<html>
<head>
<title>Learning video and clips markup example</title>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": ["VideoObject", "LearningResource"],
"name": "An introduction to XYZ",
"description": "Solving equations using exponent properties",
"educationalLevel": "High school (US)",
"educationalAlignment": {
"@type": "AlignmentObject",
"educationalFramework": "Common Core",
"targetName": "HSA-SSE.B.3",
"targetUrl": "https://www.corestandards.org/Math/Content/HSA/SSE/#CCSS.Math.Content.HSA.SSE.B.3"
},
"contentUrl": "https://www.example.com/video/123/file.mp4",
"thumbnailUrl": [
"https://example.com/photos/1x1/photo.jpg",
"https://example.com/photos/4x3/photo.jpg",
"https://example.com/photos/16x9/photo.jpg"
],
"hasPart": [{
"@type": ["Clip", "LearningResource"],
"learningResourceType": "Concept Overview",
"name": "Understanding exponents",
"startOffset": 40,
"endOffset": 120,
"url": "https://www.example.com/example?t=501"
},{
"@type": ["Clip", "LearningResource"],
"learningResourceType": "Problem Walkthrough",
"name": "Example problem 1: suspended wires",
"text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire.",
"startOffset": 150,
"endOffset": 225,
"url": "https://www.example.com/example?t=30"
},{
"@type": ["Clip", "LearningResource"],
"learningResourceType": "Problem Walkthrough",
"name": "Example problem 2: exponents",
"text": "Consider a weight suspended from five wires as shown in Figure. Find the tension in one wire.",
"startOffset": 275,
"endOffset": 500,
"url": "https://www.example.com/example?t=201"
}],
"uploadDate": "2024-03-31T08:00:00+08:00"
}
</script>
</head>
<body>
</body>
</html>
Video con la procedura dettagliata per la risoluzione di un problema
Questo esempio mostra tutte le proprietà che devono essere aggiunte al markup dei video didattici per renderlo un video con la procedura dettagliata per la risoluzione di un problema.
<html>
<head>
<title>Problem Walkthrough Learning Video example</title>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": ["VideoObject", "LearningResource"],
"name": "Mechanics problem for Grade 10",
"description": "Video walks through solution for problems in mechanics.",
"learningResourceType": "Problem Walkthrough",
"text": "Three balls have a mass of 2kg, 4kg and 6kg each. Find the relative velocity after collision.",
"contentUrl": "https://www.example.com/video/123/file.mp4",
"thumbnailUrl": [
"https://example.com/photos/1x1/photo.jpg",
"https://example.com/photos/4x3/photo.jpg",
"https://example.com/photos/16x9/photo.jpg"
],
"uploadDate": "2024-03-31T08:00:00+08:00"
}
</script>
</head>
<body>
</body>
</html>
Clip multiple con la procedura dettagliata per la risoluzione di un problema
Ecco un esempio di pagina web che includono più clip con la procedura dettagliata per la risoluzione di un problema Questo esempio mostra tutte le proprietà che devono essere aggiunte al markup dei video didattici a livello di video e di clip per renderlo un clip con la procedura dettagliata per la risoluzione di un problema.
<html>
<head>
<title>Problem Walkthrough in clips in Learning Videos markup</title>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": ["VideoObject", "LearningResource"],
"name": "An introduction to XYZ",
"description": "Solving equations using exponent properties",
"learningResourceType": "Problem Walkthrough",
"contentUrl": "https://www.example.com/video/123/file.mp4",
"text": "Three balls have a mass of 2kg, 4kg and 6kg each. Find the relative velocity after collision.",
"thumbnailUrl": [
"https://example.com/photos/1x1/photo.jpg",
"https://example.com/photos/4x3/photo.jpg",
"https://example.com/photos/16x9/photo.jpg"
],
"hasPart": [{
"@type": ["Clip", "LearningResource"],
"learningResourceType": "Problem Walkthrough",
"name": "Example problem 1: suspended wires",
"text": "Consider a weight suspended from two wires. Find the tension in each wire.",
"startOffset": 150,
"endOffset": 225,
"url": "https://www.example.com/example?t=150"
},{
"@type": ["Clip", "LearningResource"],
"learningResourceType": "Problem Walkthrough",
"name": "Example problem 2: exponents",
"text": "Consider a weight suspended from five wires. Find the tension in one wire.",
"startOffset": 275,
"endOffset": 500,
"url": "https://www.example.com/example?t=275"
}],
"uploadDate": "2024-03-31T08:00:00+08:00"
}
</script>
</head>
<body>
</body>
</html>
Come aggiungere dati strutturati
I dati strutturati sono un formato standardizzato per fornire informazioni su una pagina e classificarne i contenuti. Se non li hai mai utilizzati, scopri di più su come funzionano i dati strutturati.
Ecco una panoramica su come creare, testare e rilasciare i dati strutturati. Per una guida passo per passo su come aggiungere dati strutturati a una pagina web, consulta il codelab sui dati strutturati.
- Aggiungi le proprietà obbligatorie. In base al formato che utilizzi, scopri dove inserire i dati strutturati nella pagina.
- Segui le linee guida.
- Convalida il codice utilizzando lo strumento di Test dei risultati avanzati e correggi eventuali errori critici. Prendi in considerazione anche la possibilità di correggere eventuali problemi non critici che potrebbero essere segnalati nello strumento, in quanto possono contribuire a migliorare la qualità dei tuoi dati strutturati (tuttavia, questo non è necessario per l'idoneità per i risultati avanzati).
- Implementa alcune pagine che includono dati strutturati e utilizza lo strumento Controllo URL per verificare come Google vede la pagina. Assicurati che la pagina sia accessibile per Google e che non venga bloccata da file robots.txt, tag
noindexo requisiti di accesso. Se la pagina non presenta problemi, puoi chiedere a Google di ripetere la scansione degli URL. - Per tenere Google informata delle future modifiche, ti consigliamo di inviare una Sitemap. Puoi automatizzare questa operazione con l'API Search Console Sitemap.
Linee guida
Affinché la tua pagina sia idonea per i risultati avanzati di video didattici, devi seguire queste linee guida:
- Linee guida generali sui dati strutturati
- Nozioni di base sulla Ricerca
- Best practice per i video
- Linee guida per le Sitemap per i video
- Linee guida tecniche
Linee guida tecniche
- Oltre al markup dei video didattici, devi aggiungere le proprietà
VideoObjectobbligatorie e consigliate. - Il video deve essere disponibile al pubblico e per guardarlo non deve essere necessario alcun abbonamento.
- La durata totale del video deve essere di almeno 30 secondi.
- Il markup dei video didattici deve essere aggiunto a una pagina in cui gli utenti possono guardare il video. Per l'utente, essere reindirizzato a una pagina in cui non può guardare il video costituisce un'esperienza negativa.
Definizioni dei tipi di dati strutturati
La definizione completa di VideoObject e LearningResource è disponibile
su schema.org
VideoObject
e
LearningResource.
Affinché i tuoi contenuti siano idonei per la visualizzazione come risultati avanzati di video didattici, devi includere le proprietà obbligatorie. Puoi anche includere le proprietà consigliate per aggiungere ulteriori informazioni sui contenuti e fornire così un'esperienza utente migliore.
Video didattico [VideoObject, LearningResource]
Il markup dei video didattici è pensato per dare maggiore visibilità ai contenuti didattici del video; può contenere informazioni sulle abilità e sui concetti illustrati nel video.
Utilizza il tipo [VideoObject, LearningResource] per i video didattici.
Oltre alle proprietà obbligatorie e consigliate di VideoObject,
aggiungi le seguenti proprietà per i video didattici.
| Proprietà obbligatorie | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
educationalAlignment
|
Il codice, il corso o l'esame standard ufficiale associato ai contenuti Utilizza questa proprietà solo se i tuoi contenuti sono conformi a uno standard o a un esame specifico. In caso contrario, utilizza solo la proprietà
Anche se puoi fornire più valori per Esempi:
"educationalAlignment":
{
"@type": "AlignmentObject",
"educationalFramework": "Common Core",
"targetName": "CCSS.MATH.CONTENT.7.SP.B.4",
"targetUrl": "https://www.corestandards.org/Math/Content/7/SP/B/4/"
}
"educationalAlignment":
{
"@type": "AlignmentObject",
"educationalFramework": "NCERT",
"targetUrl": "https://ncert.nic.in/"
}
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
educationalLevel |
Il livello di istruzione target per il video. Imposta il livello di istruzione di destinazione su un valore specifico per paese o generico. Valori specifici per paese:
Ogni paese ha il proprio sistema accademico. Imposta
Esempio: "educationalLevel": "10th Grade (AR)" Valori generici:
Solo uno di questi valori generici può essere specificato come
"educationalLevel": "Beginner" |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
learningResourceType |
Il tipo di contenuti nel video in base all'obiettivo desiderato. Questa proprietà può essere utilizzata a livello di video (se il video ha un solo tipo di contenuti) o a livello di clip (se il video ha più di un tipo di contenuti). Di seguito sono riportati alcuni esempi di valori accettabili; se il video non rientra in nessuno di questi valori, puoi crearne uno nuovo, dato che stiamo valutando nuovi valori da supportare. Tieni presente che se il valore non è impostato su uno dei seguenti, le informazioni potrebbero non essere utilizzate in alcune funzionalità di ricerca.
"learningResourceType": "Problem walkthrough" |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Proprietà consigliate | |
|---|---|
educationalAlignment.educationalFramework
|
Il nome dello standard ufficiale associato ai contenuti. "educationalFramework": "Common Core" |
educationalAlignment.targetName |
Il codice o nodo standard (ad esempio, CCSS.MATH.CONTENT.7.SP.B.4, AP Physics A, CCSS.MATH). "targetName": "CCSS.MATH.CONTENT.7.SP.B.4" |
educationalAlignment.targetUrl |
L'URL della descrizione dello standard. "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/" |
hasPart |
Un elenco di clip nel video; ogni clip deve concentrarsi su un argomento o un problema specifico. L'elenco di proprietà obbligatorie e consigliate per l'oggetto Ecco un esempio di clip con procedura dettagliata per la risoluzione di un problema:
{
"@type": ["Clip","LearningResource"],
"learningResourceType": "Problem Walkthrough",
"name": "Example 1",
"text": "Consider a weight suspended from five wires as shown in Figure. Find the tension in one wire.",
"startOffset": 201,
"url": "https://www.example.com/example?t=201"
}
Ecco un esempio di un clip che fornisce una panoramica di un concetto:
{
"@type": ["Clip","LearningResource"],
"learningResourceType": "Concept Overview",
"name": "ABC Law",
"startOffset": 501,
"url": "https://www.example.com/example?t=501"
}
|
text |
Il testo della domanda a cui viene fornita una risposta nel video; questa proprietà deve includere la domanda completa, non solo il titolo. Se il video risolve più di un problema, puoi utilizzare la stessa proprietà, ma a livello di "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
Clip didattico [Clip, LearningResource]
I clip didattici possono essere specificati come parte della proprietà hasPart in Video didattici. Ecco un elenco di proprietà consigliate per i clip.
Codifica i clip didattici con il tipo [Clip, LearningResource]. Oltre
alle proprietà Clip obbligatorie e consigliate,
aggiungi le seguenti proprietà per le clip didattiche.
| Proprietà consigliate | |
|---|---|
learningResourceType |
Il tipo di contenuti nel clip in base all'obiettivo desiderato. Se il clip include una soluzione passo passo di un problema, il valore può essere impostato su Di seguito sono riportati alcuni esempi di valori accettabili; se il clip non rientra in nessuno di questi valori, puoi crearne uno nuovo, dato che stiamo valutando nuovi valori da supportare. Tieni presente che se il valore non è impostato su uno dei seguenti, le informazioni potrebbero non essere utilizzate in alcune funzionalità di ricerca. Valori accettati:
"learningResourceType": "Problem walkthrough" |
Video con una procedura dettagliata per la risoluzione di un problema [VideoObject, LearningResource]
Il video con una procedura dettagliata per la risoluzione di un problema è un sottotipo di video didattico che fornisce una soluzione passo passo a un problema.
Utilizza il tipo [VideoObject, LearningResource] per i video con una procedura dettagliata.
Oltre alle
proprietà VideoObject
obbligatorie e consigliate, aggiungi le seguenti proprietà per
i video con una procedura dettagliata per la risoluzione di un problema.
| Proprietà obbligatorie | |
|---|---|
learningResourceType |
Il tipo di contenuti nel video in base all'obiettivo desiderato. Per i video con una procedura dettagliata per la risoluzione di un problema, questa opzione deve essere impostata su "Procedura dettagliata per la risoluzione di un problema". "learningResourceType": "Problem walkthrough" |
| Proprietà consigliate | |
|---|---|
hasPart |
Un elenco di clip nel video; ogni clip deve concentrarsi su un problema specifico. L'elenco di proprietà obbligatorie e consigliate per l'oggetto Ecco un esempio di un clip con una procedura dettagliata per la risoluzione di un problema:
[
{
"@type": ["Clip","LearningResource"],
"learningResourceType": "Problem Walkthrough",
"name": "Example 1",
"text": "Consider a weight suspended from five wires as shown in Figure. Find the tension in one wire.",
"startOffset": 201,
"url": "https://www.example.com/example?t=201"
},
{
"@type": ["Clip","LearningResource"],
"learningResourceType": "Problem Walkthrough",
"name": "Example 2",
"text": "Consider two weights suspended from five wires as shown in Figure. Find the tension in all wires.",
"startOffset": 501,
"url": "https://www.example.com/example?t=501"
}
]
|
text |
Il testo della domanda a cui viene fornita una risposta nel video; Se il video risolve più di un problema, puoi utilizzare la stessa proprietà nel livello "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
Clip con una procedura dettagliata per la risoluzione di un problema [Clip, LearningResource]
I clip con una procedura dettagliata per la risoluzione di un problema possono essere specificati come parte della proprietà hasPart nei video didattici. Il clip con una procedura dettagliata per la risoluzione di un problema è un sottotipo di clip didattico che contiene una soluzione passo passo di un problema. Di seguito è riportato un elenco di proprietà obbligatorie per i clip con una procedura dettagliata per la risoluzione di un problema.
Utilizza il tipo [Clip, LearningResource] per i clip didattici. Oltre alle
proprietà Clip obbligatorie e consigliate, aggiungi le seguenti proprietà per le clip con una procedura dettagliata per la risoluzione di un problema.
| Proprietà obbligatorie | |
|---|---|
learningResourceType |
Se il clip include una soluzione passo passo di un problema, il valore deve essere impostato su "learningResourceType": "Problem walkthrough" |
| Proprietà consigliate | |
|---|---|
text |
Il testo della domanda a cui viene fornita una risposta nel clip. "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
Monitorare i risultati avanzati con Search Console
Search Console è uno strumento che consente di monitorare il rendimento delle tue pagine in Ricerca Google. Registrarsi in Search Console non è obbligatorio per essere inclusi nei risultati di Ricerca Google, ma può aiutarti a capire e migliorare il modo in cui Google vede il tuo sito. Ti consigliamo di controllare Search Console nei seguenti casi:
- Dopo aver effettuato il deployment dei dati strutturati per la prima volta
- Dopo aver rilasciato nuovi modelli o aggiornato il codice
- Analisi periodica del traffico
Dopo aver effettuato il deployment dei dati strutturati per la prima volta
Dopo che Google ha indicizzato le tue pagine, cerca i problemi utilizzando il report sullo stato dei risultati avanzati pertinente. L'ideale sarebbe un aumento degli elementi validi e nessun aumento di quelli non validi. Se riscontri problemi nei dati strutturati:
- Correggi gli elementi non validi.
- Controlla un URL pubblicato per verificare se il problema persiste.
- Richiedi la convalida utilizzando il report sullo stato.
Dopo aver rilasciato nuovi modelli o aggiornato il codice
Quando apporti modifiche significative al tuo sito web, monitora l'aumento degli elementi non validi dei dati strutturati.- Se vedi un aumento di errori, forse hai reso disponibile un nuovo modello non funzionante oppure il tuo sito interagisce con il modello esistente in modo nuovo, ma non corretto.
- Se noti una diminuzione degli elementi validi (non associata a un aumento di quelli non validi), forse non stai più incorporando dati strutturati nelle tue pagine. Utilizza lo strumento Controllo URL per scoprire la causa del problema.
Analisi periodica del traffico
Analizza il traffico di Ricerca Google utilizzando il rapporto sul rendimento. I dati mostrano la frequenza con cui la pagina viene visualizzata nei risultati multimediali nella Ricerca, la frequenza con cui gli utenti fanno clic e qual è la posizione media che visualizzi nei risultati di ricerca. Puoi anche estrarre automaticamente questi risultati con l'API Search Console.Risoluzione dei problemi
Se hai difficoltà con l'implementazione o il debug dei dati strutturati, ecco alcune risorse che potrebbero esserti utili.
- Se utilizzi un sistema di gestione dei contenuti (CMS) o un'altra persona si sta occupando del tuo sito, chiedile di aiutarti. Assicurati di inoltrarle gli eventuali messaggi di Search Console che illustrano il problema.
- Google non garantisce che le funzionalità che utilizzano dati strutturati vengano visualizzate nei risultati di ricerca. Per un elenco delle cause comuni per cui i tuoi contenuti potrebbero non essere mostrati da Google in un risultato avanzato consulta le linee guida generali sui dati strutturati.
- I tuoi dati strutturati potrebbero contenere un errore. Consulta l'elenco degli errori nei dati strutturati e il report sui dati strutturati non analizzabili.
- Se i dati strutturati della tua pagina sono interessati da un'azione manuale, i dati strutturati sulla pagina verranno ignorati (sebbene la pagina possa ancora essere visualizzata nei risultati della Ricerca Google). Per risolvere i problemi relativi ai dati strutturati, utilizza il report Azioni manuali.
- Consulta nuovamente le linee guida per verificare se i tuoi contenuti non sono conformi. Il problema può essere causato dall'utilizzo di contenuti di spam o di markup di spam. Tuttavia, il problema potrebbe non riguardare la sintassi e perciò non essere identificato dal Test dei risultati avanzati.
- Risolvi i problemi relativi a risultati avanzati mancanti o a un calo del numero totale di risultati avanzati.
- Lascia del tempo per le nuove operazioni di scansione e indicizzazione. Ricorda che possono passare diversi giorni dopo la pubblicazione di una pagina prima che Google la rilevi e la sottoponga a scansione. Per domande generali sulla scansione e sull'indicizzazione, consulta le Domande frequenti (FAQ) relative alla scansione e all'indicizzazione della Ricerca Google.
- Pubblica una domanda nel forum di Google Search Central.
I contenuti non corrispondono ai dati strutturati
error Qual è stata la causa del problema: in una pagina sono presenti contenuti che non corrispondono ai dati strutturati nella pagina stessa. Ad esempio, il titolo di un video sulla
pagina non corrisponde al valore inserito per la proprietà name. Potrebbero anche essere presenti dei contenuti di spam, come titoli e descrizioni di tipo clickbait, oppure il markup non è rappresentativo del video effettivo. Potresti aver ricevuto questo messaggio di Search Console: "Violazione delle norme sui dati strutturati -
Nelle pagine sono stati rilevati contenuti diversi dai dati strutturati della relativa pagina".
done Risoluzione del problema
- Verifica che i dati strutturati corrispondano ai contenuti effettivi della pagina.
- Utilizza lo strumento Controllo URL per assicurarti che i contenuti siano visibili sulla pagina visualizzata, ovvero il modo in cui Google vede la tua pagina.
- Una volta risolto il problema, richiedi la riconsiderazione del sito.