구조화된 학습 동영상(LearningResource, VideoObject, Clip) 데이터
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>구조화된 데이터를 추가하는 방법
구조화된 데이터는 페이지 정보를 제공하고 페이지 콘텐츠를 분류하기 위한 표준화된 형식입니다. 구조화된 데이터를 처음 사용한다면 구조화된 데이터의 작동 방식을 자세히 알아보세요.
다음은 구조화된 데이터를 빌드, 테스트 및 출시하는 방법의 개요입니다. 웹페이지에 구조화된 데이터를 추가하는 방법에 관한 단계별 안내는 구조화된 데이터 Codelab을 참고하세요.
- 필수 속성을 추가합니다. 사용 중인 형식에 따라 페이지에 구조화된 데이터를 삽입하는 위치를 알아보세요.
- 가이드라인을 따릅니다.
- 리치 결과 테스트를 사용하여 코드의 유효성을 검사하고 심각한 오류를 해결하세요. 또한 도구에서 신고될 수 있는 심각하지 않은 문제는 구조화된 데이터의 품질을 개선하는 데 도움이 될 수 있으므로 해결하는 것이 좋습니다. 그러나 리치 결과를 사용하기 위한 필수사항은 아닙니다.
- 구조화된 데이터를 포함하는 일부 페이지를 배포하고 URL 검사 도구를 사용하여 Google에서 페이지를 표시하는 방법을 테스트합니다. Google이 페이지에 액세스할 수 있으며
robots.txt 파일,
noindex태그 또는 로그인 요구사항에 의해 차단되지 않는지 확인합니다. 페이지가 정상적으로 표시되면 Google에 URL을 재크롤링하도록 요청할 수 있습니다. - Google에 향후 변경사항을 계속 알리려면 사이트맵을 제출하는 것이 좋습니다. 이는 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 |
동영상에서 달성하고자 하는 목적에 따른 동영상 콘텐츠 유형입니다. 이 속성은 동영상 수준(동영상에 콘텐츠 유형이 하나만 있는 경우) 또는 클립 수준(동영상에 콘텐츠 유형이 두 개 이상인 경우)에서 사용할 수 있습니다. 아래 목록에서 허용되는 값의 예를 확인할 수 있습니다. 동영상이 위에 설명된 어떠한 값과도 맞지 않는 경우 새로운 값을 만들 수 있습니다. Search Console에서는 새로운 값을 지원하는 방안을 고려하고 있습니다. 값이 아래 명시된 값으로 설정되지 않은 경우 학습 유형 정보가 어떠한 검색결과 기능에서도 사용되지 않을 수 있습니다.
"learningResourceType": "Problem walkthrough" |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 권장 속성 | |
|---|---|
educationalAlignment.educationalFramework
|
콘텐츠와 관련된 공식적인 표준입니다. "educationalFramework": "Common Core" |
educationalAlignment.targetName |
표준 코드 또는 노드(예: CCSS.MATH.CONTENT.7.SP.B.4, AP physics A, CCSS.MATH)입니다. "targetName": "CCSS.MATH.CONTENT.7.SP.B.4" |
educationalAlignment.targetUrl |
표준을 설명하는 URL입니다. "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 |
동영상에서 풀이가 제공되는 문제의 텍스트입니다. 이 속성에는 문제 제목뿐 아니라 전체 문제가 포함되어야 합니다. 동영상에서 2개 이상의 문제 풀이가 제공되는 경우 "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 |
클립에서 달성하고자 하는 목적에 따른 클립 콘텐츠 유형입니다. 클립에서 문제의 단계별 해답을 다루는 경우 값을 아래 목록에서 허용되는 값의 예를 확인할 수 있습니다. 클립이 위에 설명된 어떠한 값과도 맞지 않는 경우 새로운 값을 만들 수 있습니다. Search Console에서는 새로운 값을 지원하는 방안을 고려하고 있습니다. 값이 아래 명시된 값으로 설정되지 않은 경우 이 정보가 어떠한 검색결과 기능에서도 사용되지 않을 수 있습니다. 사용 가능한 값은 다음과 같습니다.
"learningResourceType": "Problem walkthrough" |
문제 둘러보기 동영상 [VideoObject, LearningResource]
문제 둘러보기 동영상은 학습 동영상의 하위 유형으로, 문제에 대한 단계별 풀이를 제공합니다.
문제 둘러보기 동영상에는 [VideoObject, LearningResource] 유형을 사용하세요. 문제 둘러보기 동영상에는 VideoObject의 필수 속성 및 권장 속성 외에도 다음과 같은 속성을 추가해야 합니다.
| 필수 속성 | |
|---|---|
learningResourceType |
동영상에서 달성하고자 하는 목적에 따른 동영상 콘텐츠 유형입니다. 문제 둘러보기 동영상의 경우 '문제 둘러보기'로 설정해야 합니다. "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 |
동영상에서 풀이가 제공되는 문제의 텍스트입니다. 동영상에서 2개 이상의 문제 풀이가 제공되는 경우 "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 검색에서의 페이지 실적을 모니터링하는 데 도움이 되는 도구입니다. Search Console에 가입해야만 페이지가 Google 검색결과에 포함되는 것은 아니지만, 가입하면 Google에서 사이트를 인식하는 방식을 이해하고 개선하는 데 도움이 될 수 있습니다. 다음과 같은 경우 Search Console을 확인하는 것이 좋습니다.
구조화된 데이터를 처음 배포한 후
Google에서 페이지의 색인을 생성하고 나면 관련 리치 결과 상태 보고서를 사용하여 문제를 확인합니다. 유효한 항목 수가 증가하고 잘못된 항목 수는 증가하지 않는 것이 가장 좋습니다. 구조화된 데이터에 문제가 있는 경우 다음과 같이 해결하세요.
- 잘못된 항목을 수정하세요.
- 실제 URL을 검사하여 문제가 지속되는지 확인합니다.
- 상태 보고서를 사용하여 유효성 검사를 요청합니다.
새 템플릿을 출시하거나 코드를 업데이트한 후
웹사이트를 대폭 변경한 후 구조화된 데이터의 잘못된 항목이 증가하는지 모니터링하세요.- 잘못된 항목이 증가했다면 새로 출시한 템플릿이 제대로 작동하지 않거나 사이트가 기존의 템플릿과 좋지 않은 방식으로 상호작용하게 된 것일 수 있습니다.
- 유효한 항목이 감소했다면(잘못된 항목 증가와 일치하지 않음) 페이지에 구조화된 데이터를 더 이상 삽입하지 않는 것일 수 있습니다. URL 검사 도구를 사용하여 문제를 일으키는 원인을 알아보세요.
주기적으로 트래픽 분석
실적 보고서를 사용하여 Google 검색 트래픽을 분석합니다. 데이터를 통해 페이지가 Google 검색의 리치 결과로 표시되는 빈도, 사용자가 검색결과를 클릭하는 빈도, 검색결과에 표시되는 평균 게재순위를 확인할 수 있습니다. Search Console API를 사용하여 이러한 결과를 자동으로 가져오는 방법도 있습니다.문제 해결
구조화된 데이터를 구현하거나 디버깅하는 데 문제가 있다면 다음 리소스를 참고하세요.
- 콘텐츠 관리 시스템(CMS)을 사용하거나 다른 사람이 내 사이트를 관리한다면 도움을 요청하세요. 문제를 자세히 설명하는 모든 Search Console 메시지를 CMS나 관리자에게 전달해야 합니다.
- Google은 구조화된 데이터를 사용하는 기능이라고 해서 검색결과에 표시된다고 보장하지 않습니다. Google에서 콘텐츠를 리치 결과로 표시할 수 없는 일반적인 이유 목록은 구조화된 데이터 일반 가이드라인을 참고하세요.
- 구조화된 데이터에 오류가 있을 수 있습니다. 구조화된 데이터의 오류 목록을 확인하세요.
- 페이지에 구조화된 데이터 직접 조치를 취하는 경우 페이지에 있는 구조화된 데이터는 무시됩니다. 하지만 페이지는 계속 Google 검색결과에 표시될 수 있습니다. 구조화된 데이터 문제를 해결하려면 직접 조치 보고서를 사용하세요.
- 가이드라인을 다시 검토하여 콘텐츠가 가이드라인을 준수하지 않는지 확인합니다. 스팸성 콘텐츠 또는 스팸성 마크업의 사용으로 인해 문제가 발생할 수 있습니다. 하지만 해당 문제가 구문 문제가 아닐 수도 있고, 이 경우 리치 결과 테스트에서는 이 문제를 식별할 수 없습니다.
- 누락된 리치 결과/총 리치 결과 수 감소 문제를 해결하세요.
- 다시 크롤링이 이루어지고 색인이 생성될 때까지 기다리세요. 페이지가 게시된 후 Google에서 페이지를 찾고 크롤링하기까지 며칠 정도 걸릴 수 있습니다. 크롤링 및 색인 생성에 관한 일반적인 질문은 Google 검색 크롤링 및 색인 생성 FAQ를 참고하세요.
- Google 검색 센터 포럼에 질문을 올려보세요.
콘텐츠가 구조화된 데이터와 일치하지 않음
error 문제를 일으킨 원인: 페이지에 구조화된 데이터와 일치하지 않는 콘텐츠가 있습니다. 예를 들어 페이지의 동영상 제목이 name 속성에 등록된 값과 일치하지 않습니다. 또는 클릭을 유도하는 제목과 설명 같은 스팸성 콘텐츠가 있거나 마크업이 실제 동영상을 나타내지 않습니다. 다음의 Search Console 메시지가 표시될 수 있습니다. '구조화된 데이터 정책 위반 - 페이지의 콘텐츠가 페이지의 구조화된 데이터와 다른 것으로 확인되었습니다.'
done 문제 해결
- 구조화된 데이터가 페이지의 실제 콘텐츠와 일치하는지 확인합니다.
- URL 검사 도구를 사용하여 렌더링된 페이지에 콘텐츠가 표시되는지 확인합니다. 렌더링된 페이지는 Google이 보는 페이지입니다.
- 문제를 해결한 후에는 사이트 재검토 요청을 제출합니다.