教學影片 (LearningResource
、VideoObject
、Clip
) 結構化資料
![教學影片複合式搜尋結果範例](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_example.png?authuser=19&hl=zh-tw)
Google 搜尋是學生和教師探索和觀看教育影片的絕佳入口。當您使用結構化資料明確提供專屬於教學的資訊時 (例如影片中提及的教育程度和概念與技能),Google 就能進一步瞭解影片內容,並提供更優質的體驗,協助學生找到適合的內容。
教學影片結構化資料也可能啟用教學影片的資訊方塊,如教育程度和影片類型 (例如總覽或解決方案影片)。
![資訊方塊如何在使用者輕觸教學影片前顯示在影片下方](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_pretap.png?authuser=19&hl=zh-tw)
![資訊方塊如何在使用者輕觸教學影片後顯示在影片上方](https://developers-dot-devsite-v2-prod.appspot.com/static/search/docs/images/learning_videos_posttap.png?authuser=19&hl=zh-tw)
功能適用情況
凡是提供 Google 搜尋服務的地區,都能以英文顯示教學影片複合式搜尋結果。不過,只有透過電腦和行動裝置搜尋學術教學內容時,才能使用這項功能。
範例
單一教學影片
以下是單一教學影片的範例。
<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>
含有多段短片的教學影片
以下範例是含有三個短片的學習影片:兩個短片用於逐步說明問題,一個短片是概念總覽。
<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>
問題逐步操作說明影片
以下範例顯示必須新增到教學影片標記的所有屬性,讓標記成為有效的問題逐步操作說明影片。
<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>
多部問題逐步操作說明短片
以下網頁範例包含多部問題逐步操作說明短片。這個範例顯示了必須加進影片和短片層級的「教學影片」標記的所有屬性,讓標記成為有效的「問題逐步操作說明」短片標記。
<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>
如何新增結構化資料
結構化資料是一種標準化格式,能夠提供網頁相關資訊並分類網頁內容。如果您是第一次使用結構化資料,請參閱這篇文章,進一步瞭解結構化資料的運作方式。
以下簡要說明如何建立、測試及發布結構化資料。
- 新增必要屬性。根據您使用的格式,瞭解要在網頁中的什麼位置插入結構化資料。
- 遵循指南規範。
- 使用複合式搜尋結果測試驗證程式碼,並修正所有重大錯誤。此外,我們也建議您修正工具中可能標記的任何非重大問題,因為這有助於改善結構化資料的品質 (但並非符合複合式搜尋結果的顯示條件)。
- 部署幾個包含結構化資料的網頁,並使用網址檢查工具測試 Google 轉譯網頁的情形。請確認 Google 可以存取您的網頁,且網頁並未遭到 robots.txt 檔案或
noindex
標記封鎖,也未設有登入規定。如果網頁看起來沒問題,您可以要求 Google 重新檢索您的網址。 - 為了讓 Google 掌握日後的異動內容,建議您提交 Sitemap。您可以使用 Search Console Sitemap API 自動執行這項操作。
指南規範
您必須遵守以下指南規範,才能讓網頁顯示教學影片複合式搜尋結果:
技術指南
- 除了教學影片標記之外,您還必須新增
VideoObject
必要屬性和建議屬性。 - 影片必須公開,讓使用者不需訂閱即可觀看。
- 影片總長度必須至少為 30 秒。
- 教學影片標記必須新增到使用者可以觀看影片的網頁中。如果將使用者導向無法觀看影片的網頁,會導致使用者體驗不佳。
結構化資料類型定義
VideoObject
和 LearningResource
的完整定義可以在 schema.org VideoObject
和 LearningResource
上取得。
您的內容必須包含必要的屬性,才能以教學影片複合式搜尋結果的形式呈現。您也可以加入建議的屬性,為內容增添更多相關資訊,提供更優質的使用者體驗。
教學影片 [VideoObject
, LearningResource
]
教學影片標記的目的在於提高影片教育內容的能見度。標記可以包含影片所教導的各種概念和技巧資訊。
針對教學影片使用 [VideoObject, LearningResource]
類型。
除了 VideoObject
必要屬性和建議屬性之外,請為教學影片新增下列屬性。
必要屬性 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
educationalAlignment
|
與內容相關的官方標準代碼、課程或測驗。只有在內容符合特定標準或測驗時,才需要使用這個屬性。如果不符合的話,請使用
雖然您可以提供多個 例如: "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 |
影片的目標教育程度。將目標教育程度設為國家/地區專屬或一般值。 國家/地區專屬值:
每個國家/地區都有自身專屬的學術系統。根據影片適用的國家/地區,將
範例: "educationalLevel": "10th Grade (AR)" 一般值: 只有下列其中一種一般值可以指定為
"educationalLevel": "Beginner" |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
learningResourceType |
影片中的內容類型取決於影片的目的。如果影片只含有一種內容類型,可以在影片層級使用這項屬性;如果影片含有多種內容類型,則在短片層級使用這項屬性。以下清單為可接受的值範例。如果影片不符合其中任何值,您可以建立新的值,因為我們正在考慮支援新的值。請注意,如果未設定下方所列的任一值,教學類型資訊就無法用於任何搜尋功能。
"learningResourceType": "Problem walkthrough" |
建議屬性 | |
---|---|
educationalAlignment.educationalFramework
|
與內容相關聯的官方標準名稱。 "educationalFramework": "Common Core" |
educationalAlignment.targetName |
標準代碼或節點 (例如 CCSS.MATH.CONTENT.7.SP.B.4、AP 物理 A、CCSS.MATH)。 "targetName": "CCSS.MATH.CONTENT.7.SP.B.4" |
educationalAlignment.targetUrl |
連往標準說明的網址。 "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/" |
hasPart |
影片中的短片清單。每個短片都必須聚焦於特定主題或問題。 教育類 以下是問題逐步操作說明短片範例: { "@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": "Concept Overview", "name": "ABC Law", "startOffset": 501, "url": "https://www.example.com/example?t=501" } |
text |
在影片中所要解決的問題文字。這個屬性必須包含完整問題,而不僅僅是問題的標題。 如果影片要解決的問題不只一個,可以在 "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
教學短片 [Clip, LearningResource]
您可以將教學短片指定為教學影片 hasPart
屬性的一部分。以下為建議的短片屬性清單。
為教學短片加上 [Clip, LearningResource]
類型標記。除了 Clip
必要屬性和建議屬性之外,請為教學短片新增下列屬性。
建議屬性 | |
---|---|
learningResourceType |
短片中的內容類型取決於短片的目的。如果短片提供逐步解題方法,您可以將這個值設為 以下清單為可接受的值範例。如果短片不符合其中任何值,您可以建立新的值,因為我們正在考慮支援新的值。請注意,如果未設定下方所列的任一值,資訊就無法用於任何搜尋功能。 可接受的值如下:
"learningResourceType": "Problem walkthrough" |
問題逐步操作說明影片 [VideoObject
, LearningResource
]
問題逐步操作說明影片是教學影片的一種子類型,可提供問題的逐步解決方法。
針對問題逐步操作說明影片使用 [VideoObject, LearningResource]
類型。
除了 VideoObject
必要屬性和建議屬性之外,請為問題逐步操作說明影片加入下列屬性。
必要屬性 | |
---|---|
learningResourceType |
影片中的內容類型取決於影片的目的。如果是問題逐步操作說明影片,這個欄位必須設為「Problem walkthrough」。 "learningResourceType": "Problem walkthrough" |
建議屬性 | |
---|---|
hasPart |
影片中的短片清單。每個短片都必須聚焦於特定問題。 教育類 含有問題逐步操作說明的短片範例: [ { "@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 |
在影片中所要解決的問題文字。 如果影片會解決多個問題,可以在 "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
問題逐步操作說明短片 [Clip, LearningResource]
您可以將問題逐步操作說明短片指定為教學影片 hasPart
屬性的一部分。問題逐步操作說明短片是教學短片的子類型,包含問題的逐步解決方法。以下是問題逐步操作說明短片的必要屬性清單。
為教學短片使用 [Clip, LearningResource]
類型。除了 Clip
必要屬性和建議屬性之外,請為問題逐步操作說明短片加入下列屬性。
必要屬性 | |
---|---|
learningResourceType |
如果短片提供逐步解題方法,您必須將這個值設為 "learningResourceType": "Problem walkthrough" |
建議屬性 | |
---|---|
text |
在短片中所要解決的問題文字。 "text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire." |
透過 Search Console 監控複合式搜尋結果
Search Console 這項工具能協助您監控網頁在 Google 搜尋中的成效。 Google 會主動將您的網頁納入搜尋結果,您無需為此申請使用 Search Console,但是您可以藉由這項服務瞭解並改善 Google 檢索您網站的方式。建議在下列情況查看 Search Console:
首次部署結構化資料後
在 Google 為網頁建立索引後,請透過相關的複合式搜尋結果狀態報告查看是否存在任何問題。理想情況下,有效項目會增加,但無效項目不會變多。如果您在結構化資料中發現問題,請依下列步驟操作:
發布新範本或更新程式碼後
當您對網站進行大幅變更時,請留意結構化資料中無效項目是否增加。- 如果無效項目增加,代表您推出的新範本可能無法正常運作,或者您的網站採用新方式與現有範本互動,但效果不佳。
- 如果有效項目減少,但錯誤並未隨之增加,代表您的網頁可能已不再內嵌結構化資料。請使用網址檢查工具找出問題的成因。
定期分析流量
透過成效報表分析您的 Google 搜尋流量。 這些資料會顯示您的網頁在 Google 搜尋中呈現為複合式搜尋結果的頻率、使用者點擊的頻率,以及您的搜尋結果平均排名。您也可以使用 Search Console API 自動提取這些結果。疑難排解
如果無法順利導入結構化資料,或是偵錯時遇到困難,請參考下列資源。
- 如果您使用內容管理系統 (CMS) 或者有他人代您處理網站事務,請向對方尋求協助。請務必將所有與問題相關的 Search Console 訊息都轉寄給對方,這些訊息會針對問題提供詳細說明。
- Google 不保證採用結構化資料的功能一定會顯示在搜尋結果中。如要瞭解為何 Google 無法將您的內容顯示為複合式搜尋結果,請參閱結構化資料通用指南裡的常見原因清單。
- 結構化資料可能含有錯誤。請查看結構化資料錯誤清單。
- 如果您的網頁遭到結構化資料專人介入處理處置,系統會忽略網頁上的結構化資料,但該網頁仍然會出現在 Google 搜尋結果中。請使用專人介入處理報告來修正結構化資料問題。
- 再次查看指南規範,確認您的內容是否符合規定。問題可能是因為垃圾內容或不當使用的標記所引起。不過,因為問題可能與語法無關,所以複合式搜尋結果測試無法找出問題所在。
- 疑難排解:未出現複合式搜尋結果/複合式搜尋結果總數減少。
- 請等待一段時間,讓系統執行重新檢索和重新建立索引作業。在發布網頁後,Google 可能需要幾天時間才會找到網頁並進行檢索。如有關於檢索和索引建立作業的一般問題,請參閱 Google 搜尋檢索和索引常見問題。
- 前往 Google 搜尋中心論壇發文提問。
內容與結構化資料不符
error 問題發生原因:網頁上的內容與網頁的結構化資料不相符。舉例來說,網頁上的影片標題與 name
屬性所列的值不相符。此外,也可能包含垃圾資訊內容 (例如誘騙點擊的標題和說明),或是標記與實際影片有所出入。您可能已收到 Search Console 寄來的郵件:「違反結構化資料政策 - 系統發現頁面上的內容與頁面的結構化資料不同」。
done 修正問題