구조화된 연습 문제(Quiz) 데이터

학생, 교사, 학부모가 온라인에서 내 교육 및 학습 자료를 더 쉽게 찾을 수 있도록 구조화된 데이터를 사용하여 연습 문제를 마크업할 수 있습니다. 이 가이드에서는 웹페이지에서 이 스키마를 구현하는 방법을 설명합니다. 구조화된 데이터를 추가하면 연습 문제가 Google 검색결과의 특별한 사용자 환경에 표시될 수 있습니다.

Google 검색의 연습 문제 리치 결과

구조화된 데이터를 추가하는 방법

구조화된 데이터는 페이지 정보를 제공하고 페이지 콘텐츠를 분류하기 위한 표준화된 형식입니다. 구조화된 데이터를 처음 사용한다면 구조화된 데이터의 작동 방식을 자세히 알아보세요.

다음은 구조화된 데이터를 빌드, 테스트 및 출시하는 방법의 개요입니다. 웹페이지에 구조화된 데이터를 추가하는 방법에 관한 단계별 안내는 구조화된 데이터 Codelab을 참고하세요.

  1. 필수 속성을 추가합니다. 사용 중인 형식에 따라 페이지에 구조화된 데이터를 삽입하는 위치를 알아보세요.
  2. 가이드라인을 따릅니다.
  3. 리치 결과 테스트를 사용하여 코드의 유효성을 검사하고 심각한 오류를 해결하세요. 또한 도구에서 신고될 수 있는 심각하지 않은 문제는 구조화된 데이터의 품질을 개선하는 데 도움이 될 수 있으므로 해결하는 것이 좋습니다. 그러나 리치 결과를 사용하기 위한 필수사항은 아닙니다.
  4. 구조화된 데이터를 포함하는 일부 페이지를 배포하고 URL 검사 도구를 사용하여 Google에서 페이지를 표시하는 방법을 테스트합니다. Google이 페이지에 액세스할 수 있으며 robots.txt 파일, noindex 태그 또는 로그인 요구사항에 의해 차단되지 않는지 확인합니다. 페이지가 정상적으로 표시되면 Google에 URL을 재크롤링하도록 요청할 수 있습니다.
  5. Google에 향후 변경사항을 계속 알리려면 사이트맵을 제출하는 것이 좋습니다. 이는 Search Console Sitemap API를 사용하여 자동화할 수 있습니다.

기능 제공 여부

연습 문제 기능은 Google 검색이 지원되는 모든 지역에서 영어로 사용할 수 있습니다. 이 기능은 데스크톱 및 휴대기기에서 지원되며, 수학 및 과학 주제의 객관식 및 체크박스 질문 유형에만 사용할 수 있습니다.

예

퀴즈(질문 1개)

다음은 연결된 질문이 1개 있는 퀴즈의 예입니다. 정답은 단 하나입니다. 

<html>
  <head>
    <title>Quiz about fractions</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Quiz",
      "name": "Quiz about fractions",
      "hasPart": {
        "@type": "Question",
        "typicalAgeRange": "7-12",
        "educationalAlignment": [
          {
            "@type": "AlignmentObject",
            "alignmentType": "educationalSubject",
            "targetName": "Mathematics"
          },
          {
            "@type": "AlignmentObject",
            "alignmentType": "educationalSubject",
            "targetName": "Algebra"
          },
          {
            "@type": "AlignmentObject",
            "alignmentType": "educationalLevel",
            "targetName": "Grade 5 » Number and Operations—Fractions » Apply and extend previous understandings of multiplication and division. » 3",
            "educationalFramework": "Common Core",
            "targetUrl": "https://www.corestandards.org/Math/Content/5/NF/B/3/"
          }
        ],
        "about": {
          "@type": "Thing",
          "name": "Fractions"
        },
        "educationalLevel": "intermediate",
        "eduQuestionType": "Multiple choice",
        "learningResourceType": "Practice problem",
        "assesses": "Multiplying fractions by whole numbers",
        "name": "Choose the model",
        "comment": {
          "@type": "Comment",
          "text": "This is a hint about the question."
        },
        "encodingFormat": "text/markdown",
        "text": "Which model represents the product $$2 * \\frac{2}{3}$$?",
        "suggestedAnswer": [
          {
            "@type": "Answer",
            "position": 0,
            "encodingFormat": "text/html",
            "text": "<img src=\"www.test.com/practice-problems-fractions/…image2.png\" alt=\"Answer 2\" />",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint about the answer."
            }
          }
        ],
        "acceptedAnswer": {
          "@type": "Answer",
          "position": 1,
          "encodingFormat": "text/html",
          "text": "<img src=\"www.test.com/practice-problems-fractions/…image1.png\" alt=\"Answer 1\" />",
          "comment": {
            "@type": "Comment",
            "text": "This is a hint about the answer."
          },
          "answerExplanation": {
            "@type": "Comment",
            "text": "This is a full explanation on how this answer was achieved."
          }
        }
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

퀴즈(체크박스 유형의 질문 1개)

다음은 연결된 질문이 1개 있는 퀴즈의 예입니다. 정답은 여러 개입니다. 

<html>
  <head>
    <title>Quiz about laws of Physics</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Quiz",
      "name": "Quiz about laws of physics",
      "about": {
        "@type": "Thing",
        "name": "Laws of Physics And Applications"
      },
      "educationalLevel": "intermediate",
      "assesses": "Laws of physics",
      "hasPart": {
        "@type": "Question",
        "eduQuestionType": "Checkbox",
        "learningResourceType": "Practice problem",
        "name": "Laws of Physics And Applications",
        "typicalAgeRange": "12-15",
        "text": "Identify laws of Physics. (Select all valid answers)",
        "suggestedAnswer": [
          {
            "@type": "Answer",
            "position": 0,
            "text": "Nevada's Law",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            }
          },
          {
            "@type": "Answer",
            "position": 2,
            "text": "EUA law",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            }
          }
        ],
        "acceptedAnswer": [
          {
            "@type": "Answer",
            "position": 1,
            "text": "Newton's law",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            },
            "answerExplanation": {
              "@type": "Comment",
              "text": "This is a full explanation on how this answer was achieved."
            }
          },
          {
            "@type": "Answer",
            "position": 3,
            "text": "Ohm's law",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            },
            "answerExplanation": {
              "@type": "Comment",
              "text": "This is a full explanation on how this answer was achieved."
            }
          }
        ]
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

퀴즈(질문 여러 개)

다음은 질문과 답 쌍이 여러 개인 퀴즈의 예입니다. 

<html>
  <head>
    <title>Quiz about displacement, velocity and time</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Quiz",
      "typicalAgeRange": "7-12",
      "educationalLevel": "intermediate",
      "assesses": "Velocity and speed",
      "educationalAlignment": [
        {
          "@type": "AlignmentObject",
          "alignmentType": "educationalSubject",
          "targetName": "Science"
        },
        {
          "@type": "AlignmentObject",
          "alignmentType": "educationalSubject",
          "targetName": "Physics"
        }
      ],
      "name": "Quiz about displacement, velocity and time",
      "about": {
        "@type": "Thing",
        "name": "Displacement, velocity, and time"
      },
      "hasPart": [
        {
          "@type": "Question",
          "eduQuestionType": "Multiple choice",
          "learningResourceType": "Practice problem",
          "name": "Average velocity and average speed from graphs",
          "text": "A bug crawls on a wall. What is the average velocity of the bug between the times $$t = 1s$$ and $$t = 10s$$?",
          "comment": {
            "@type": "Comment",
            "text": "This is a hint about the question."
          },
          "encodingFormat": "text/markdown",
          "suggestedAnswer": [
            {
              "@type": "Answer",
              "position": 0,
              "encodingFormat": "text/markdown",
              "text": "$$0.5 \\frac{m}{s}$$",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            },
            {
              "@type": "Answer",
              "position": 1,
              "encodingFormat": "text/markdown",
              "text": "$$-0.5 \\frac{m}{s}$$",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            },
            {
              "@type": "Answer",
              "position": 3,
              "encodingFormat": "text/markdown",
              "text": "$$1.5 \\frac{m}{s}$$",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            }
          ],
          "acceptedAnswer": {
            "@type": "Answer",
            "position": 2,
            "encodingFormat": "text/markdown",
            "text": "$$0 \\frac{m}{s}$$",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            }
          }
        },
        {
          "@type": "Question",
          "eduQuestionType": "Multiple choice",
          "learningResourceType": "Practice problem",
          "name": "Average velocity and average speed from graphs",
          "text": "A swimmer motion is shown on the following graph of position x vs. time t. What is the average speed?",
          "encodingFormat": "text/markdown",
          "comment": {
            "@type": "Comment",
            "text": "This is a hint about the question."
          },
          "suggestedAnswer": [
            {
              "@type": "Answer",
              "position": 0,
              "text": "1",
              "encodingFormat": "text/html",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            },
            {
              "@type": "Answer",
              "position": 2,
              "text": "3",
              "encodingFormat": "text/html",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            },
            {
              "@type": "Answer",
              "position": 3,
              "text": "4",
              "encodingFormat": "text/html",
              "comment": {
                "@type": "Comment",
                "text": "This is a hint"
              }
            }
          ],
          "acceptedAnswer": {
            "@type": "Answer",
            "position": 1,
            "text": "2",
            "encodingFormat": "text/html",
            "comment": {
              "@type": "Comment",
              "text": "This is a hint"
            },
            "answerExplanation": {
              "@type": "Comment",
              "text": "This is a full explanation on how this answer was achieved."
            }
          }
        }
      ]
    }
    </script>
  </head>
  <body>
  </body>
</html>

가이드라인

Google의 연습 문제 환경에 표시되려면 다음 가이드라인을 따라야 합니다.

기술 가이드라인

  • 가능하면 가장 상세한 리프 페이지에 구조화된 데이터를 배치합니다. 연습 문제가 없는 페이지에 구조화된 데이터를 추가하지 않습니다.
  • 출제하려는 각 연습 문제에 Quiz 속성을 추가합니다. 구조화된 데이터는 사용자가 웹페이지에서 상호작용할 수 있는 연습 문제와 동일한 페이지에 표시되어야 합니다.
  • 웹페이지에 필요한 구조화된 데이터 속성이 모두 포함되어 있어야 합니다.
  • 주제당 연습 문제를 최소 2개 마크업해야 합니다(예: '이차 방정식' 개념에 연습 문제 두 개). 연습 문제 리치 결과에 표시되기를 바라는 개념과 문제를 마크업하는 데 중점을 둡니다. 별도의 페이지에 있을 수도 있습니다.
  • 사이트의 연습 문제에 사용자가 액세스할 수 있어야 합니다. 즉, 데이터 파일이나 PDF에만 보관해서는 안 됩니다.
  • 호스트 로드 설정에서 빈번한 크롤링이 허용되어야 합니다.
  • 사이트에 있는 동일한 연습 문제의 여러 사본이 서로 다른 URL에 호스팅되어 있으면 페이지 사본마다 표준 URL을 사용합니다.
  • 텍스트만 포함된 연습 문제:
    • 질문은 최대 320자(영문 기준)로 제한됩니다.
    • 객관식 질문 답은 답당 최대 70자(영문 기준)로 제한됩니다.
  • 텍스트 및 이미지가 포함된 연습 문제:
    • 질문은 최대 160자(영문 기준)로 제한됩니다.
    • 이미지의 최대 높이는 200픽셀입니다.
  • 접근성: 로그인 또는 페이월 뒤에 숨겨진 연습 문제는 허용되지 않습니다. Google에서 해당 기능을 통해 사이트로 이동한 후 사용자가 연습 문제 콘텐츠에 액세스할 수 있어야 합니다. 추가 콘텐츠는 로그인 또는 페이월 뒤에 있을 수 있습니다.
  • 허위 진술: 사용자를 속이거나 오도하려는 의도가 있는 연습 문제는 허용되지 않습니다. 질문과 관련이 없는 주제를 잘못 마크업하는 것도 여기에 포함됩니다.

콘텐츠 가이드라인

이러한 연습 문제 콘텐츠 가이드라인은 사용자에게 관련성 있는 학습 리소스를 제공하기 위해 마련되었습니다. 이러한 정책을 위반하는 콘텐츠를 발견하면 Google에서는 직접 조치를 취하거나 Google의 연습 문제 환경에서 페이지를 삭제하는 등 적절하게 대응합니다.

욕설 및 저속한 표현

선정적이거나 모욕적이거나 불쾌감을 주는 표현이 포함된 연습 문제는 허용되지 않습니다.

연습 문제로 위장한 광고

제3자에서 게시한 콘텐츠(예: 제휴 프로그램)와 같이 연습 문제로 위장한 프로모션 콘텐츠는 허용되지 않습니다.

연습 문제의 콘텐츠가 법을 위반할 수 있다는 신고가 Google에 접수되면 콘텐츠는 Google 검색 정책에 따라 처리됩니다.

품질

  • 이 기능을 통한 연습 문제의 정확성과 품질에 대한 책임은 작성자에게 있습니다. Google의 품질 검토 절차에 따라 일정량의 데이터가 정확하지 않은 것으로 확인되면 심각도에 따라 문제가 해결될 때까지 문제 전체 또는 일부가 기능에서 삭제될 수 있습니다. 이는 다음 항목의 정확도에 적용됩니다.
    • 묻고 있는 질문과 관련되어 마크업된 개념
    • 질문, 답 선택지, 힌트, 답 설명의 형식 및 정확도
    • 정답 순서(예: 첫 번째 옵션으로 '해당 사항 없음'을 입력하지 마세요)
    • 질문과 관련된 이미지 또는 수식의 품질 및 정확도
    • 기호화된 수학 렌더링 및 구분 문자 구현

교육 표준 마크업

학습 표준은 학년마다 학생들이 알고 있어야 하는 내용과 할 수 있는 작업에 관한 학습 목표입니다. 학습 표준에는 콘텐츠 링크, 학습 진행 과정의 일부로 구성 등 여러 가지 사용 사례가 포함됩니다. 온라인 학습 자료와 관련된 표준(educationalAlignment 및 hasPart.educationalAlignment 필드 아래에 있음)을 마크업하면 Google에서 이러한 표준에 따라 학습 콘텐츠를 검색하는 사용자에게 가장 유용한 방식으로 정보를 표시하고 정리하는 데 도움이 됩니다. 다음은 스키마의 대략적인 개요입니다.

다음은 표준의 몇 가지 예입니다.

  • Common Core State Standards(CCSS)
  • Texas Essential Knowledge and Skills(TEKS)
  • Virginia Standards of Learning(SOL)
  • BC Performance Standards
  • Alberta Programs of Studies
  • The Australian Curriculum(ACARA)
  • The Victorian Curriculum(F-10)
  • UK National Curriculum

구조화된 데이터 유형 정의

리치 결과에 콘텐츠를 표시하려면 필수 속성이 있어야 합니다. 권장 속성을 통해 구조화된 데이터에 더 많은 정보를 추가하여 더욱 만족스러운 사용자 환경을 제공할 수도 있습니다.

Quiz

Quiz는 하나 이상의 연습 문제 그룹으로 일반적으로 동일한 개념이나 주제를 다룹니다.

Quiz의 전체 정의는 schema.org에서 확인하세요.

필수 속성
about Thing

Quiz에 담겨 있는 기본 개념에 관한 중첩 정보입니다. 질문에 hasPart.about 속성이 있으면 이 속성은 필요하지 않습니다. 

{
  "@type": "Quiz",
  "about": {
    "@type": "Thing"
  }
}
about.name Text

Quiz에 담겨 있는 기본 개념에 관한 중첩 정보입니다. 질문에 hasPart.about.name 속성이 있으면 이 속성은 필요하지 않습니다. 이 속성에는 여러 개의 항목이 허용됩니다. 

{
  "@type": "Quiz",
  "about": {
    "@type": "Thing",
    "name": "Fractions"
  }
}
hasPart Question

퀴즈의 특정 연습 문제에 대한 중첩 정보입니다. hasPart 속성 하나를 사용하여 하나의 연습 문제를 나타냅니다.

퀴즈 하나에 연습 문제를 여러 개 포함하려면 이 속성을 반복합니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question"
  }
}
hasPart.acceptedAnswer Answer

질문의 정답입니다. 하나의 질문에 정답이 여러 개 있는 경우 이 속성을 반복합니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer"
    }
  }
}
hasPart.eduQuestionType Text

연습 문제의 유형입니다. 이는 Google 검색이 정답과 오답을 확인하고 렌더링하는 데 중요합니다. 각 질문에 대해 Google은 최소 2개, 최대 6개의 답을 표시합니다.

지원되는 값 중 하나를 사용합니다.

  • Multiple choice: 정답은 단 하나입니다. 선택지는 라디오 버튼 모음으로 표시되며 사용자는 하나만 선택할 수 있습니다.
  • Checkbox: 정답이 2개 이상 있습니다. 선택지는 체크박스 모음으로 표시되며, 사용자가 해당하는 모든 항목을 선택할 수 있습니다.
{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "eduQuestionType": "Multiple choice"
  }
}
hasPart.learningResourceType Text

이 학습 리소스의 유형입니다. 고정값 Practice problem을 사용합니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "learningResourceType": "Practice problem"
  }
}
hasPart.suggestedAnswer Answer

이 질문의 다른 정답 또는 오답입니다. 여러 답을 지정하려면 이 속성과 중첩 속성을 반복합니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
    }
  }
}
hasPart.suggestedAnswer.text Text

답의 콘텐츠입니다. 마크다운 또는 HTML을 사용할 수 있습니다. HTML 또는 마크다운에서 연습 문제를 인코딩하는 방법을 알아보세요. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "text": "$$x = 1$$"
    }
  }
}
hasPart.text Text

질문의 콘텐츠입니다. 마크다운 또는 HTML을 사용할 수 있습니다. HTML 또는 마크다운에서 연습 문제를 인코딩하는 방법을 알아보세요. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "text": "Which diagram represents the product $$3 *\frac{2}{3}$$?"
  }
}
권장 속성
educationalAlignment AlignmentObject

퀴즈가 확립된 교육 프레임워크와 동일 선상에 있는 부분입니다. 이 속성을 반복하여 퀴즈를 학습 분야, 대상 학년 또는 교육 표준에 맞출 수 있습니다. Quiz에서 직접 교육 일치를 추가하거나 Question에서 더 구체적으로 지정할 수 있습니다. 

{
  "@type": "Quiz",
  "educationalAlignment": []
}
educationalAlignment.alignmentType Text

학습 리소스와 퀴즈의 프레임워크 노드 간의 일치 카테고리입니다. Google 검색은 LRMI 표준을 사용합니다.

alignmentType을 반복하여 학습 분야, 대상 학년 또는 교육 표준을 지정합니다.

  • 퀴즈의 학습 분야 또는 영역을 지정하려면 alignmentType을 educationalSubject로 설정합니다.
  • 퀴즈의 대상 학년 또는 교육 표준을 지정하려면 alignmentType을 educationalLevel로 설정합니다.

다른 영역인 및 하위 영역이 있는 경우에는 여러 객체를 삽입할 수 있습니다. 개념을 지정하려면 about 속성을 대신 사용합니다.

educationalSubject 및 educationalLevel을 모두 지정하는 방법은 다음과 같습니다. 

{
  "@type": "Quiz",
  "educationalAlignment": [
    {
      "@type": "AlignmentObject",
      "alignmentType": "educationalSubject",
      "targetName": "Mathematics"
    },
    {
      "@type": "AlignmentObject",
      "alignmentType": "educationalLevel",
      "targetName": "Fifth grade"
    }
  ]
}

'Common Core'와 같은 표준을 참조하려면 educationalAlignment.educationalFramework 및 educationalAlignment.targetUrl 속성을 사용합니다. 

{
  "@type": "Quiz",
  "educationalAlignment: [
  {
    "@type": "AlignmentObject",
    "alignmentType": "educationalLevel",
    "educationalFramework": "Common Core",
    "targetName": "Grade 8: Expressions and Equations",
    "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/"
    }
  ]
}
educationalAlignment.educationalFramework Text

퀴즈가 대상으로 하는 프레임워크입니다. 예를 들어 'Common Core'가 있습니다. 이 속성이 중요한 이유에 대한 자세한 내용은 교육 표준 마크업을 참고하세요. 이 속성에는 여러 개의 항목이 허용됩니다.

educationalAlignment.targetName Text

확립된 교육 프레임워크의 노드 이름입니다. 예를 들어 '8학년: 표현식 및 등식'이 있습니다. 

{
  "@type": "Quiz",
  "educationalAlignment: [
  {
    "@type": "AlignmentObject",
    "targetName": "Grade 8: Expressions and Equations"
    }
  ]
}
educationalAlignment.targetUrl URL

특정 교육 프레임워크의 URL입니다. 예를 들어 8학년 수학에 대한 Common Core 표준의 URL입니다. 

{
  "@type": "Quiz",
  "educationalAlignment: [
  {
    "@type": "AlignmentObject",
    "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/"
    }
  ]
}
educationalLevel Text

퀴즈의 난이도입니다. 다음은 사용할 수 있는 몇 가지 값의 예입니다.

  • beginner
  • intermediate
  • advanced
{
  "@type": "Quiz",
  "educationalLevel": "beginner"
}
hasPart.about Thing

질문에 담겨 있는 기본 개념에 관한 중첩 정보입니다. Quiz에 about 속성이 지정되지 않은 경우 hasPart.about이 필요합니다. 이 속성에는 여러 개의 항목이 허용됩니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "about": {
      "@type": "Thing"
    }
  }
}
hasPart.about.name Text

질문에 담겨 있는 기본 개념의 제목입니다. Quiz에 about.name 속성이 지정되지 않은 경우 hasPart.about.name이 필요합니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "about": {
      "@type": "Thing",
      "name": "Fractions"
    }
  }
}
hasPart.acceptedAnswer.answerExplanation Comment

이 답에 설명된 결과를 달성하는 방법에 관한 자세한 설명입니다. 이는 일반적으로 정답에만 사용됩니다. 설명 콘텐츠에는 hasPart.suggestedAnswer.comment.text 속성을 사용합니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer",
      "answerExplanation": {
        "@type": "Comment"
       }
    }
  }
}
hasPart.acceptedAnswer.answerExplanation.text Text

추천 답에 관한 설명 콘텐츠입니다. 콘텐츠 형식(HTML 또는 마크다운)을 변경하려면 encodingFormat을 사용합니다. HTML 또는 마크다운에서 연습 문제를 인코딩하는 방법을 알아보세요. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "answerExplanation": {
        "@type": "Comment",
        "text": "*In order to get to this result..*",
        "encodingFormat": "text/markdown"
       }
    }
  }
}
hasPart.acceptedAnswer.comment Comment

정답인 이유를 설명하는 데 사용될 수 있는 답에 관한 힌트 또는 제안입니다. 힌트 콘텐츠에는 hasPart.acceptedAnswer.comment.text 속성을 사용합니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer",
      "comment": {
        "@type": "Comment"
      }
    }
  }
}
hasPart.acceptedAnswer.comment.text Text

추천 답에 관한 힌트 또는 제안 콘텐츠입니다. 콘텐츠 형식(HTML 또는 마크다운)을 변경하려면 encodingFormat을 사용합니다. HTML 또는 마크다운에서 연습 문제를 인코딩하는 방법을 알아보세요. 


{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer",
      "comment": {
        "@type": "Comment",
        "text": "<p>This is a hint</p>"
      }
    }
  }
}
hasPart.acceptedAnswer.position Integer

사용자에게 표시되는 이 답의 위치입니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "acceptedAnswer": {
      "@type": "Answer",
      "position": "2"
    }
  }
}
hasPart.assesses DefinedTerm 또는 Text

문제를 푸는 데 필요한 기술입니다. 이를 채우면 검색 가능성을 높일 수 있습니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "assesses": "Multiplying fractions by whole numbers"
  }
}
hasPart.comment Comment

문제를 푸는 데 사용될 수 있는 질문의 힌트 또는 제안입니다. 힌트 콘텐츠에는 hasPart.comment.text 속성을 사용합니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "comment": {
      "@type": "Comment"
    }
  }
}
hasPart.comment.text Text

질문의 힌트 또는 제안 콘텐츠입니다. 콘텐츠 형식(HTML 또는 마크다운)을 변경하려면 encodingFormat을 사용합니다. HTML 또는 마크다운에서 연습 문제를 인코딩하는 방법을 알아보세요. 


{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "comment": {
      "@type": "Comment",
      "text": "<p>This is a hint</p>"
    }
  }
}
hasPart.educationalAlignment AlignmentObject

질문이 확립된 교육 프레임워크와 동일 선상에 있는 부분입니다. 이 속성은 Quiz 객체에 추가된 교육 일치를 재정의합니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalAlignment": []
}
hasPart.educationalAlignment.alignmentType Text

학습 리소스와 질문의 프레임워크 노드 간의 일치 카테고리입니다. Google 검색은 LRMI 표준을 사용합니다.

alignmentType을 반복하여 학습 분야, 대상 학년 또는 교육 표준을 지정합니다.

  • 질문의 학습 분야 또는 영역을 지정하려면 alignmentType을 educationalSubject로 설정합니다.
  • 질문의 대상 학년 또는 교육 표준을 지정하려면 alignmentType을 educationalLevel로 설정합니다.

다른 영역인 및 하위 영역이 있는 경우에는 여러 객체를 삽입할 수 있습니다. 개념을 지정하려면 hasPart.about 속성을 대신 사용합니다.

educationalSubject 및 educationalLevel을 모두 지정하는 방법은 다음과 같습니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalAlignment": [
      {
      "@type": "AlignmentObject",
      "alignmentType": "educationalSubject",
      "targetName": "Mathematics"
      },
      {
      "@type": "AlignmentObject",
      "alignmentType": "educationalLevel",
      "targetName": "Fifth grade"
      }
    ]
  }
}

'Common Core'와 같은 표준을 참조하려면 hasPart.educationalAlignment.educationalFramework 및 hasPart.educationalAlignment.targetUrl 속성을 사용합니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalAlignment: [
      {
      "@type": "AlignmentObject",
      "alignmentType": "educationalLevel",
      "educationalFramework": "Common Core",
      "targetName": "Grade 8: Expressions and Equations",
      "targetUrl": "https://www.corestandards.org/Math/Content/8/EE/A/2/"
      }
    ]
  }
}
hasPart.educationalAlignment.educationalFramework Text

질문이 대상으로 하는 프레임워크입니다. 예를 들어 'Common Core'가 있습니다. 이 속성이 중요한 이유에 대한 자세한 내용은 교육 표준 마크업을 참고하세요. 이 속성에는 여러 개의 항목이 허용됩니다.

hasPart.educationalAlignment.targetName Text

확립된 교육 프레임워크의 노드 이름입니다. 예를 들어 '8학년: 표현식 및 등식'이 있습니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalAlignment: [
      {
      "@type": "AlignmentObject",
      "alignmentType": "educationalLevel",
      "targetName": "Grade 8: Expressions and Equations"
      }
    ]
  }
}
hasPart.educationalAlignment.targetUrl URL

질문에 해당하는 특정 교육 프레임워크의 URL입니다. 예를 들어 8학년 수학에 대한 Common Core 표준의 URL입니다.

hasPart.educationalLevel Text

질문의 난이도(텍스트 형식)입니다. 다음은 사용할 수 있는 몇 가지 값의 예입니다.

  • beginner
  • intermediate
  • advanced
{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "educationalLevel": "beginner"
  }
}
hasPart.name Text

질문에 관한 대략적인 설명입니다. 질문의 전체 콘텐츠를 포함하지 마세요. 대신 hasPart.text를 사용합니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "name": "Question about fractions"
  }
}
hasPart.suggestedAnswer.comment Comment

정답이거나 오답인 이유를 설명하는 데 사용될 수 있는 답에 관한 힌트 또는 제안입니다. 힌트 콘텐츠에는 hasPart.suggestedAnswer.comment.text 속성을 사용합니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "comment": {
        "@type": "Comment"
      }
    }
  }
}
hasPart.suggestedAnswer.comment.text Text

추천 답에 관한 힌트 또는 제안 콘텐츠입니다. 콘텐츠 형식(HTML 또는 마크다운)을 변경하려면 encodingFormat을 사용합니다. HTML 또는 마크다운에서 연습 문제를 인코딩하는 방법을 알아보세요. 


{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "comment": {
        "@type": "Comment",
        "text": "<p>This is a hint</p>"
      }
    }
  }
}
hasPart.suggestedAnswer.encodingFormat Text

텍스트 속성을 인코딩하는 데 사용되는 MIME 형식입니다. encodingFormat을 지정하지 않으면 기본값은 text/html입니다. 다음 중 한 가지 값을 사용합니다.

  • text/markdown
  • text/html
{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "encodingFormat": "text/html"
    }
  }
}

HTML 또는 마크다운에서 연습 문제를 인코딩하는 방법을 알아보세요.

hasPart.suggestedAnswer.position Integer

사용자에게 표시되는 이 답의 위치입니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "suggestedAnswer": {
      "@type": "Answer",
      "position": "0"
    }
  }
}
hasPart.typicalAgeRange Text

질문의 대상 연령대입니다. 예를 들어 7-12 또는 18-입니다. 

{
  "@type": "Quiz",
  "hasPart": {
    "@type": "Question",
    "typicalAgeRange": "7-12"
  }
}
name Text

퀴즈의 제목입니다. 

{
  "@type": "Quiz",
  "name": "Negative exponents review"
}
typicalAgeRange Text

퀴즈의 대상 연령대입니다. 예를 들어 7-12 또는 18-입니다. 

{
  "@type": "Quiz",
  "typicalAgeRange": "7-12"
}

HTML 또는 마크다운 내 인코딩 연습 문제

Google 검색은 Question, Answer, Comment를 인코딩할 때 마크다운(CommonMark 버전) 및 HTML을 지원합니다. 다음에는 구조 집합을 제한합니다.

  • 헤더
  • 줄바꿈
  • 목록(정렬됨 및 정렬되지 않음)
  • 단락
  • 굵게
  • 기울임꼴
  • 이미지
  • LaTex의 수식

CSS 또는 자바스크립트는 무시됩니다. 지원되지 않는 HTML 태그가 있는 질문은 Google에서 표시하지 않습니다.

형식을 지정하는 방법

사용할 인코딩 형식을 지정하려면 encodingFormat 속성을 사용하고 값을 HTML의 경우 "text/html", 마크다운의 경우 "text/markdown"으로 설정합니다.

다음은 마크다운 형식으로 설정된 질문의 예입니다. 

{
  "@type": "Question",
  "name": "Average velocity and average speed from graphs",
  "text": "What is the average velocity [..] between the times $$t = 4s$$ and $$t = 10s$$?",
  "encodingFormat": "text/markdown"
  ..
  ..
}

encodingFormat을 지정하지 않으면 "text/html"로 간주됩니다.

수식

수식을 지정하려면 LaTex 형식을 사용합니다. 수식을 삽입하려면 이중 달러 기호($$)를 사용해야 합니다. 예: 

"<p>Please solve: $$2x^2 = 18$$</p>"

문제 해결

구조화된 데이터를 구현하거나 디버깅하는 데 문제가 있다면 다음 리소스를 참고하세요.

  • 콘텐츠 관리 시스템(CMS)을 사용하거나 다른 사람이 내 사이트를 관리한다면 도움을 요청하세요. 문제를 자세히 설명하는 모든 Search Console 메시지를 CMS나 관리자에게 전달해야 합니다.
  • Google은 구조화된 데이터를 사용하는 기능이라고 해서 검색결과에 표시된다고 보장하지 않습니다. Google에서 콘텐츠를 리치 결과로 표시할 수 없는 일반적인 이유 목록은 구조화된 데이터 일반 가이드라인을 참고하세요.
  • 구조화된 데이터에 오류가 있을 수 있습니다. 구조화된 데이터의 오류 목록을 확인하세요.
  • 페이지에 구조화된 데이터 직접 조치를 취하는 경우 페이지에 있는 구조화된 데이터는 무시됩니다. 하지만 페이지는 계속 Google 검색결과에 표시될 수 있습니다. 구조화된 데이터 문제를 해결하려면 직접 조치 보고서를 사용하세요.
  • 가이드라인을 다시 검토하여 콘텐츠가 가이드라인을 준수하지 않는지 확인합니다. 스팸성 콘텐츠 또는 스팸성 마크업의 사용으로 인해 문제가 발생할 수 있습니다. 하지만 해당 문제가 구문 문제가 아닐 수도 있고, 이 경우 리치 결과 테스트에서는 이 문제를 식별할 수 없습니다.
  • 누락된 리치 결과/총 리치 결과 수 감소 문제를 해결하세요.
  • 다시 크롤링이 이루어지고 색인이 생성될 때까지 기다리세요. 페이지가 게시된 후 Google에서 페이지를 찾고 크롤링하기까지 며칠 정도 걸릴 수 있습니다. 크롤링 및 색인 생성에 관한 일반적인 질문은 Google 검색 크롤링 및 색인 생성 FAQ를 참고하세요.
  • Google 검색 센터 포럼에 질문을 올려보세요.