学習用動画(LearningResourceVideoObjectClip)の構造化データ

学習用動画のリッチリザルトの例

Google 検索は、生徒と教師が教材となる動画を見つけて視聴するための入り口です。構造化データを使用して、教育に特化した情報(教育レベル、動画内で扱われる概念やスキルなど)を明示的に指定すると、Google が動画の内容を把握する助けとなり、学習者が見たいコンテンツを見つけやすくすることができます。

また、教育レベルや動画の種類(例: 概要動画、解答動画)など、学習用動画に関する情報チップも表示できるようになります。

ユーザーが動画をタップする前に、学習用動画の下に情報チップを表示する方法 ユーザーが動画をタップした後に、学習用動画の上に情報チップを表示する方法

機能の提供状況

学習用動画のリッチリザルトは、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>

複数のクリップを含む学習用動画

以下に、3 つのクリップを含む学習用動画の例を示します。問題のチュートリアルのクリップが 2 つ、コンセプトの概要を示すクリップが 1 つ含まれています。


<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>

構造化データを追加する方法

構造化データは、ページに関する情報を提供し、ページ コンテンツを分類するための標準化されたデータ形式です。構造化データを初めて使用する場合は、構造化データの仕組みについてをご覧ください。

構造化データの作成、テスト、リリースの概要は次のとおりです。

  1. 必須プロパティを追加します。使用している形式に基づいて、ページ上の構造化データを挿入する場所をご確認ください。
  2. ガイドラインに従います。
  3. リッチリザルト テストでコードを検証し、重大なエラーを修正します。ツールで報告される重大ではない問題の修正も検討してください。構造化データの品質向上に役立ちます(ただし、リッチリザルトの対象となるために必ずしも必要というわけではありません)。
  4. 構造化データが含まれているページを数ページ導入し、URL 検査ツールを使用して、Google でページがどのように表示されるかをテストします。Google がページにアクセスでき、robots.txt ファイル、noindex タグ、ログイン要件によってページがブロックされていないことを確認します。ページが正常に表示されたら、Google に URL の再クロールを依頼できます。
  5. 今後の変更について Google に継続して情報を提供するために、サイトマップを送信することをおすすめします。これは、Search Console Sitemap API で自動化できます。

ガイドライン

学習用動画のリッチリザルトとして表示されるようにするには、以下のガイドラインに準拠するページを作成する必要があります。

技術に関するガイドライン

  • 学習用動画のマークアップに加えて、VideoObject の必須プロパティと推奨プロパティを追加する必要があります。
  • 動画は、登録なしで視聴できるように一般公開されている必要があります。
  • 動画の合計再生時間は 30 秒以上にしてください。
  • 学習用動画のマークアップは、ユーザーが動画を視聴できるページに追加する必要があります。動画を視聴できないページに誘導するのは、ユーザーの利便性を損ねます。

構造化データタイプの定義

VideoObjectLearningResource の定義の全文は、schema.org の VideoObjectLearningResource で確認できます。

コンテンツが学習用動画のリッチリザルトとして表示されるようにするには、必須プロパティを設定する必要があります。また、推奨プロパティを使用することでコンテンツに関する詳細情報を追加できるため、ユーザー エクスペリエンスの向上につながります。

学習用動画 [VideoObject, LearningResource]

学習用動画のマークアップは、動画の教育内容をよりわかりやすく示すことを目的としています。マークアップには、動画内で学習できるさまざまな概念や技術についての情報を盛り込むことができます。

学習用動画には [VideoObject, LearningResource] タイプを使用します。VideoObject の必須プロパティと推奨プロパティに加えて、学習用動画に次のプロパティを追加します。

必須プロパティ
educationalAlignment

AlignmentObject

コンテンツに関連する公式の標準コード、クラス、または試験。このプロパティは、コンテンツが特定の標準または試験に即している場合にのみ使用してください。それ以外の場合は、educationalLevel プロパティのみを使用します。educationalAlignment プロパティを指定する場合は、次のプロパティを追加します(該当する場合)。

educationalAlignment の値は複数指定できますが、すべての値が学習用動画機能に使用されるとは限りません。学習用動画機能で 1 つの 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

Text

動画の対象教育レベル。対象教育レベルを国別の値または一般的な値に設定します。

国別の値:

国ごとに独自の学校システムが構築されています。動画の内容に該当する国に応じて、サポートされているレベルの値の一つに educationalLevel を設定します。

  • すべて表示
  • アルジェリア
  • アルゼンチン
  • オーストラリア
  • オーストリア
  • アゼルバイジャン
  • バーレーン
  • バングラデシュ
  • ベラルーシ
  • ベルギー
  • ボリビア
  • ボスニア ヘルツェゴビナ
  • ブラジル
  • ブルガリア
  • カナダ
  • チリ
  • コロンビア
  • コスタリカ
  • クロアチア
  • キプロス
  • チェコ
  • デンマーク
  • ドミニカ共和国
  • エクアドル
  • エジプト
  • エルサルバドル
  • イングランド
  • エストニア
  • フィンランド
  • フランス
  • ジョージア(グルジア)
  • ドイツ
  • ガーナ
  • ギリシャ
  • グアテマラ
  • ホンジュラス
  • 香港
  • ハンガリー
  • アイスランド
  • インド
  • インドネシア
  • イラク
  • アイルランド
  • イスラエル
  • イタリア
  • ジャマイカ
  • 日本
  • ジョーダン
  • カザフスタン
  • ケニア
  • クウェート
  • ラトビア
  • レバノン
  • リビア
  • リヒテンシュタイン
  • リトアニア
  • ルクセンブルク
  • マレーシア
  • マルタ
  • メキシコ
  • モンテネグロ
  • モロッコ
  • ネパール
  • オランダ
  • ニュージーランド
  • ニカラグア
  • ナイジェリア
  • 北マケドニア
  • 北アイルランド
  • ノルウェー
  • オマーン
  • パキスタン
  • パナマ
  • パプア ニューギニア
  • パラグアイ
  • ペルー
  • フィリピン
  • ポーランド
  • ポルトガル
  • プエルトリコ
  • カタール
  • ルーマニア
  • ロシア
  • サウジアラビア
  • スコットランド
  • セネガル
  • セルビア
  • シンガポール
  • スロバキア
  • スロベニア
  • 南アフリカ
  • 韓国
  • スペイン
  • スリランカ
  • スウェーデン
  • スイス
  • 台湾
  • タンザニア
  • タイ
  • チュニジア
  • トルコ
  • ウガンダ
  • ウクライナ
  • アラブ首長国連邦
  • 米国
  • ベネズエラ
  • ベトナム
  • ウェールズ
  • イエメン
  • ジンバブエ

サポートされている値
アルジェリア
  • Lower Secondary School (DZ)
  • Grade 8 (DZ)
  • Grade 9 (DZ)
  • Upper Secondary School (DZ)
  • Grade 10 (DZ)
  • Grade 11 (DZ)
  • Grade 12 (DZ)
  • Higher Education (DZ)

例:

"educationalLevel": "10th Grade (AR)"

一般的な値:

educationalLevel として、以下の一般的な値のうち一つのみ指定できます。

  • Beginner: コンテンツを理解するために事前の知識は必要ない
  • Intermediate: コンテンツを理解するためにある程度の知識が求められる可能性がある
  • Advanced: トピックに関してすでに知識がある上級学習者向けのコンテンツ
"educationalLevel": "Beginner"
learningResourceType

Text

動画の目的に基づく、動画のコンテンツ タイプ。このプロパティは、動画レベル(動画のコンテンツ タイプが 1 つのみの場合)またはクリップレベル(動画に複数のコンテンツ タイプが存在する場合)で使用できます。使用可能な値の例を次のリストに示します。動画がいずれの値にも適合しない場合は、新しい値を作成できます。Google は新しい値のサポートを検討しています。ただし、次のリストにない値が設定されている場合、学習タイプの情報はどの検索結果の機能にも表示されません。

    • Concept overview: トピックまたは概念について説明する動画。
    • Problem walkthrough: 数学や科学の文章問題など、学術的な問題の解法またはその具体的な手順を説明する動画。
    • Real life example: ある概念の現実世界での適用例、使用例を説明する動画。
    • Activity: インプロゲーム、概念マップ、査読、強制的なディベートなど、学習アクティビティの実際の例または応用方法を説明する動画。
    • Experiment: 実験の動画。
    • Lecture: 授業、講義、ウェブセミナーの動画。
    • How-to: なんらかの方法または一連の手順を紹介する動画。プロシージャルな STEM 問題の解法を紹介する場合は、Problem walkthrough タイプを使用する。
    • Tips: ヒントやコツを紹介する動画。
    "learningResourceType": "Problem walkthrough"
推奨プロパティ
educationalAlignment.educationalFramework

Text

コンテンツに関連付けられている公式の標準の名称。

"educationalFramework": "Common Core"
educationalAlignment.targetName

Text

標準コードまたはノード(例: CCSS.MATH.CONTENT.7.SP.B.4、AP physics A、CCSS.MATH)。

"targetName": "CCSS.MATH.CONTENT.7.SP.B.4"
educationalAlignment.targetUrl

Url

標準の説明の URL。

"targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/"
hasPart

Clip

動画に含まれるクリップのリスト。各クリップは、特定のトピックまたは問題を中心に構成されている必要があります。

教育向けの Clip オブジェクトの必須プロパティと推奨プロパティは、別の表にまとめられています。

以下に、問題のチュートリアル クリップの例を示します。

{
  "@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

動画内で解法が示されている問題のテキスト。このプロパティには、問題のタイトルだけでなく、問題全体が含まれている必要があります。

動画内で複数の問題を解く場合は、同じプロパティを Clip レベルに設定します。

"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

Text

クリップの目的に基づく、クリップのコンテンツ タイプ。問題の詳細な解答手順がクリップに含まれる場合は、値を "Problem walkthrough" に設定できます。なんらかの概念の説明がクリップに含まれる場合は、値を "Concept overview" に設定できます。

使用可能な値の例を次のリストに示します。クリップがいずれの値にも適合しない場合は、新しい値を作成できます。Google は新しい値のサポートを検討しています。ただし、次のリストにない値が設定されている場合、学習タイプの情報はどの検索結果の機能にも表示されません。

使用できる値:

  • Concept overview: トピックまたは概念について説明するクリップ。
  • Problem walkthrough: 数学や科学の文章問題など、学術的な問題の解法またはその具体的な手順を説明するクリップ。
  • Real life application: ある概念の現実世界での適用例、使用例を説明するクリップ。
  • Activity: インプロゲーム、概念マップ、査読、強制的なディベートなど、学習アクティビティの実際の例または応用方法を説明するクリップ。
  • Science experiment: 科学実験のクリップ。
  • Lecture: 授業、講義、ウェブセミナーのクリップ。
  • How-to: なんらかの方法または一連の手順を紹介するクリップ。プロシージャルな STEM 問題の解法を紹介する場合は、Problem walkthrough タイプを使用する。
  • Tips: ヒントやコツを紹介するクリップ。
"learningResourceType": "Problem walkthrough"

問題のチュートリアル動画 [VideoObject, LearningResource]

問題のチュートリアル動画は、学習用動画のサブタイプであり、問題の解答手順を説明する動画です。

問題のチュートリアル動画には、[VideoObject, LearningResource] タイプを使用します。VideoObject の必須プロパティと推奨プロパティに加えて、問題のチュートリアル動画に次のプロパティを追加します。

必須プロパティ
learningResourceType

Text

動画の目的に基づく、動画のコンテンツ タイプ。問題のチュートリアル動画の場合は「Problem walkthrough」に設定する必要があります。

"learningResourceType": "Problem walkthrough"
推奨プロパティ
hasPart

Clip

動画に含まれるクリップのリスト。各クリップは、特定のトピックまたは問題を中心に構成されている必要があります。

教育向けの Clip オブジェクトの必須プロパティと推奨プロパティは、別の表にまとめられています。

以下に、問題のチュートリアル クリップの例を示します。

[
  {
    "@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

動画内で解法が示されている問題のテキスト。

動画内で複数の問題を解く場合は、同じプロパティを Clip レベルで使用できます。

"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

Text

問題の詳細な解答手順がクリップに含まれる場合は、値を "Problem walkthrough" に設定する必要があります。

"learningResourceType": "Problem walkthrough"
推奨プロパティ
text

Text

クリップ内で解法が示されている問題のテキスト。

"text": "Consider a weight suspended from two wires as shown in Figure. Find the tension in each wire."

Search Console でリッチリザルトを監視する

Search Console は、Google 検索におけるページのパフォーマンスを監視できるツールです。Search Console に登録していなくても Google 検索結果に表示されますが、登録することにより、Google がサイトをどのように認識しているかを把握して改善できるようになります。次の場合は Search Console を確認することをおすすめします。

  1. 構造化データを初めてデプロイした後
  2. 新しいテンプレートをリリースした後やコードを更新した後
  3. トラフィックを定期的に分析する場合

構造化データを初めてデプロイした後

ページがインデックスに登録されたら、関連するリッチリザルトのステータス レポートを使用して、問題がないかどうかを確認します。有効な項目が増え、無効な項目が増えていない状態が理想的です。構造化データに問題が見つかった場合の手順は次のとおりです。

  1. 無効な項目を修正します
  2. 一般公開 URL の検査を行い、問題が解決したかどうかを確認します。
  3. ステータス レポートを使用して検証をリクエストします。

新しいテンプレートをリリースした後やコードを更新した後

ウェブサイトに大幅な変更を加えた場合は、構造化データの無効な項目が増加しないかどうか監視します。
  • 無効な項目が増加した場合は、新しく公開したテンプレートが正常に機能していないか、既存のテンプレートの新しい操作方法に問題があると考えられます。
  • 有効な項目が減少している(無効な項目の増加と一致しない)場合は、ページに構造化データが埋め込まれていない可能性があります。URL 検査ツールを使用して問題の原因を特定します。

トラフィックを定期的に分析する場合

パフォーマンス レポートを使用して Google 検索のトラフィックを分析します。このデータから、検索でページがリッチリザルトとして表示される頻度、ユーザーがページをクリックする頻度、検索結果におけるページの平均掲載順位がわかります。この結果は、Search Console API を使用して自動的に取得することもできます。

トラブルシューティング

構造化データの実装またはデバッグで問題が発生した場合は、以下のリソースが参考になります。

コンテンツが構造化データと一致しない

問題の原因: そのページの構造化データと一致しないコンテンツがページに含まれています。たとえば、ページ上での動画のタイトルが name プロパティで指定されている値と一致していない場合があります。クリックベイトのタイトルや説明文など、スパム行為が関連するコンテンツが含まれている可能性もあります。または、マークアップが実際の動画を表していないことが考えられます。このような場合、「構造化データのポリシー違反 - ページ上のコンテンツがページの構造化データと異なっています」という Search Console のメッセージが表示されることがあります。

問題の修正方法

  1. 構造化データがページ上の実際のコンテンツと一致していることを確認します。
  2. URL 検査ツールを使用して、レンダリングされたページにコンテンツが表示されていることを確認します(レンダリングされたページは Google から見えるページの状態です)。
  3. 問題を解決したら、再審査を受けるためにサイトを送信します。