VideoObject 스키마 완전 가이드

VideoObject 스키마란

VideoObject 스키마는 페이지에 임베드된 동영상의 메타데이터를 구조화 데이터로 신고한다. YouTube 임베드 영상, 자체 호스팅 영상 모두 적용 가능하다. Google 검색에서 동영상 리치 리절트(썸네일·재생 시간·타임스탬프)로 표시되며, AI 답변 엔진이 동영상 콘텐츠를 인용할 때 참조한다.

TL;DR

VideoObject 필수 3종: name·thumbnailUrl·uploadDate. contentUrl 또는 embedUrl로 영상 위치 명시. transcript로 텍스트 전사본 추가 → AI 인용 가능성 상승. hasPart(Clip)로 키 모먼트 → Google 타임스탬프 활성화.

속성 정리

Google 공식 문서(2026년 6월 확인) 기준.

속성	필수 여부	타입	설명
name	필수	Text	동영상 제목 (고유해야 함)
thumbnailUrl	필수	URL[]	썸네일 이미지 URL (여러 개 가능)
uploadDate	필수	DateTime (ISO 8601)	최초 게시일시
description	권장	Text	동영상 설명 (고유해야 함)
contentUrl	권장	URL	실제 동영상 파일 URL
embedUrl	권장	URL	동영상 플레이어 임베드 URL
duration	권장	Duration (ISO 8601)	재생 시간 (예: PT5M30S)
hasPart	선택	Clip[]	키 모먼트 타임스탬프
transcript	선택	Text	텍스트 전사본
expires	선택	DateTime	만료 일시
interactionStatistic	선택	InteractionCounter	조회수 등 통계

contentUrl과 embedUrl 중 하나 이상을 포함하는 것이 권장된다. 자체 호스팅은 contentUrl, YouTube 등 외부 플레이어는 embedUrl을 사용한다.

최소 예시 (자체 호스팅)

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "AEO 기초: AI 답변에 인용되는 콘텐츠 만드는 법",
  "thumbnailUrl": "https://kroffle.com/videos/aeo-basics-thumb.jpg",
  "uploadDate": "2026-06-04T09:00:00+09:00",
  "contentUrl": "https://kroffle.com/videos/aeo-basics.mp4"
}

권장 예시 (YouTube 임베드 + 키 모먼트 + 전사본)

{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "AEO 기초: AI 답변에 인용되는 콘텐츠 만드는 법",
  "description": "ChatGPT·Perplexity 등 AI 답변 엔진에 콘텐츠가 인용되는 원리와 실전 최적화 방법을 단계별로 설명합니다.",
  "thumbnailUrl": [
    "https://img.youtube.com/vi/VIDEOID/maxresdefault.jpg",
    "https://img.youtube.com/vi/VIDEOID/hqdefault.jpg"
  ],
  "uploadDate": "2026-06-04T09:00:00+09:00",
  "duration": "PT12M30S",
  "embedUrl": "https://www.youtube.com/embed/VIDEOID",
  "transcript": "안녕하세요. 오늘은 AI 답변 엔진 최적화, AEO에 대해 알아보겠습니다...",
  "hasPart": [
    {
      "@type": "Clip",
      "name": "AEO란 무엇인가",
      "startOffset": 0,
      "endOffset": 120,
      "url": "https://www.youtube.com/watch?v=VIDEOID&t=0s"
    },
    {
      "@type": "Clip",
      "name": "AI 인용 메커니즘",
      "startOffset": 120,
      "endOffset": 420,
      "url": "https://www.youtube.com/watch?v=VIDEOID&t=120s"
    },
    {
      "@type": "Clip",
      "name": "실전 최적화 5단계",
      "startOffset": 420,
      "endOffset": 750,
      "url": "https://www.youtube.com/watch?v=VIDEOID&t=420s"
    }
  ],
  "inLanguage": "ko-KR",
  "interactionStatistic": {
    "@type": "InteractionCounter",
    "interactionType": "https://schema.org/WatchAction",
    "userInteractionCount": 3500
  }
}

transcript 속성 — AEO 관점의 핵심

transcript 속성은 동영상의 텍스트 전사본을 직접 스키마에 포함한다. AI 답변 엔진이 동영상 URL을 방문해 내용을 파악하기 어려운 상황에서, 스키마에 포함된 전사본은 콘텐츠를 직접 노출한다.

전사본이 길면 description에 요약, transcript에 전문을 분리해 넣을 수 있다.

contentUrl vs embedUrl 차이

속성	가리키는 것	사용 상황
contentUrl	실제 동영상 파일 (mp4 등)	자체 호스팅 영상
embedUrl	플레이어 iframe URL	YouTube·Vimeo 등 외부 플레이어

Google 공식 문서는 contentUrl이 "가장 효과적으로 동영상 파일을 가져오는 방법"이라고 명시한다. 두 속성을 함께 제공하는 것도 가능하다.

한국 시장 적응

inLanguage: "ko-KR"을 포함해 한국어 동영상임을 명시한다. uploadDate는 KST(+09:00)를 포함한다.

자주 하는 실수

잘못된 예시: embedUrl에 일반 유튜브 페이지 URL 사용

"embedUrl": "https://www.youtube.com/watch?v=VIDEOID"

올바른 예시: 임베드 전용 URL 사용

"embedUrl": "https://www.youtube.com/embed/VIDEOID"

잘못된 예시: duration을 분:초 형식으로

"duration": "12:30"

올바른 예시: ISO 8601 형식

"duration": "PT12M30S"

검증 방법

Google Rich Results Test: https://search.google.com/test/rich-results
Schema Markup Validator: https://validator.schema.org

자주 묻는 질문

Q. YouTube 동영상인데 VideoObject 스키마를 써야 하나요?
A. YouTube 자체 페이지는 YouTube가 스키마를 관리한다. 자신의 사이트에 YouTube 영상을 임베드한 경우, 해당 페이지에 VideoObject 스키마를 추가하는 것이 권장된다. embedUrl에 YouTube 임베드 URL을 사용한다.

Q. transcript가 없으면 안 되나요?
A. 필수는 아니다. 단, transcript가 있으면 AI 답변 엔진이 동영상 내용을 텍스트로 직접 파악할 수 있어 인용 가능성이 높아진다.

참고

Google 공식 VideoObject 문서: https://developers.google.com/search/docs/appearance/structured-data/video (2026년 6월 확인)
Schema.org VideoObject: https://schema.org/VideoObject