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.问题排查
如果您在实施或调试结构化数据时遇到问题，请查看下面列出的一些实用资源。
- 如果您使用了内容管理系统 (CMS) 或其他人负责管理您的网站，请向其寻求帮助。请务必向其转发列明问题细节的任何 Search Console 消息。
- Google 不能保证使用结构化数据的功能一定会显示在搜索结果中。如需查看导致 Google 无法将您的内容显示为富媒体搜索结果的各种常见原因，请参阅结构化数据常规指南。
- 您的结构化数据可能存在错误。请参阅结构化数据错误列表。
- 如果您的网页受到结构化数据手动操作的影响，其中的结构化数据将会被忽略（但该网页仍可能会出现在 Google 搜索结果中）。如需修正结构化数据问题，请使用“人工处置措施”报告。
- 再次查看相关指南，确认您的内容是否未遵循指南。问题可能是因为出现垃圾内容或使用垃圾标记导致的。不过，问题可能不是语法问题，因此富媒体搜索结果测试无法识别这些问题。
- 针对富媒体搜索结果缺失/富媒体搜索结果总数下降进行问题排查。
- 请等待一段时间，以便 Google 重新抓取您的网页并重新将其编入索引。请注意，网页发布后，Google 可能需要几天时间才会找到和抓取该网页。有关抓取和索引编制的常见问题，请参阅 Google 搜索抓取和索引编制常见问题解答。
- 在 Google 搜索中心论坛中发帖提问。
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.