구조화된 레시피(Recipe, HowTo, ItemList) 데이터

구조화된 데이터로 Google에 레시피 정보를 제공하면 사용자가 레시피 콘텐츠를 검색하는 데 도움이 됩니다. 리뷰 작성자 평점, 조리 및 준비 시간, 영양 정보와 같은 정보를 제공하면 Google에서는 레시피를 더욱 효과적으로 파악하고 사용자에게 흥미로운 방식으로 표시할 수 있습니다. 레시피는 Google 검색결과와 Google 이미지에 표시될 수 있습니다.

Google 검색에서 레시피 리치 결과가 어떻게 표시되는지 보여주는 그림 자세한 레시피 조리 시간, 이미지, 리뷰 정보와 함께 다양한 웹사이트의 4가지 리치 결과를 포함합니다. Google 이미지에서 레시피가 어떻게 표시되는지 보여주는 그림. 다양한 음식을 보여주는 6개의 이미지 결과가 있으며, 그 중 3개의 결과에는 사용자에게 레시피를 표시하는 레시피 배지가 포함되어 있습니다

콘텐츠 마크업 방식에 따라 레시피에서 다음 개선사항을 사용할 수 있습니다.

레시피 개선사항
레시피 안내: 구조화된 Recipe 데이터를 추가하여 Google Home과 스마트 디스플레이에서 Google 어시스턴트가 사용자에게 레시피를 안내하도록 합니다. 몇 가지 추가 속성의 경우 레시피 안내에는 필수 속성이지만 Google 검색에는 권장 속성입니다. recipeIngredientrecipeInstructions를 추가하세요. video 속성을 추가하면 contentUrl 속성도 추가해야 합니다.

Google 어시스턴트에 표시된 레시피에 관한 자세한 내용은 웹 콘텐츠에서 작업을 빌드하는 방법을 참고하세요.

Google 어시스턴트를 통해 Google Home에서 레시피가 어떻게 표시되는지 보여주는 그림 Google 어시스턴트가 사용자의 요청에 응답하여 요리할 수 있는 레시피 목록을 표시합니다.
레시피 호스트 캐러셀: 구조화된 ItemList 데이터를 추가하여 사용자가 레시피 갤러리 페이지를 탐색할 수 있도록 합니다. Google 검색에서 레시피 호스트 캐러셀이 어떻게 표시되는지 보여주는 그림. 사용자가 특정 레시피를 살펴보고 선택할 수 있도록 동일한 웹사이트의 세 가지 레시피를 캐러셀 형식으로 표시

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

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

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

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

다음은 JSON-LD 코드를 사용하는 레시피의 몇 가지 예입니다.

레시피 안내

다음은 Google 검색과 레시피 안내로 어시스턴트에 표시될 수 있는 페이지의 예입니다.

Google 검색의 레시피

다음은 Google 검색에 표시될 수 있는 페이지의 예입니다.

<html>
  <head>
    <title>Non-Alcoholic Piña Colada</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "name": "Non-Alcoholic Piña Colada",
      "image": [
      "https://example.com/photos/1x1/photo.jpg",
      "https://example.com/photos/4x3/photo.jpg",
      "https://example.com/photos/16x9/photo.jpg"
      ],
      "author": {
        "@type": "Person",
        "name": "Mary Stone"
      },
      "datePublished": "2024-03-10",
      "description": "This non-alcoholic pina colada is everyone's favorite!",
      "recipeCuisine": "American",
      "prepTime": "PT1M",
      "cookTime": "PT2M",
      "totalTime": "PT3M",
      "keywords": "non-alcoholic",
      "recipeYield": "4 servings",
      "recipeCategory": "Drink",
      "nutrition": {
        "@type": "NutritionInformation",
        "calories": "120 calories"
      },
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": 5,
        "ratingCount": 18
      },
      "recipeIngredient": [
        "400ml of pineapple juice",
        "100ml cream of coconut",
        "ice"
      ],
      "recipeInstructions": [
        {
          "@type": "HowToStep",
          "name": "Blend",
          "text": "Blend 400ml of pineapple juice and 100ml cream of coconut until smooth.",
          "url": "https://example.com/non-alcoholic-pina-colada#step1",
          "image": "https://example.com/photos/non-alcoholic-pina-colada/step1.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Fill",
          "text": "Fill a glass with ice.",
          "url": "https://example.com/non-alcoholic-pina-colada#step2",
          "image": "https://example.com/photos/non-alcoholic-pina-colada/step2.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Pour",
          "text": "Pour the pineapple juice and coconut mixture over ice.",
          "url": "https://example.com/non-alcoholic-pina-colada#step3",
          "image": "https://example.com/photos/non-alcoholic-pina-colada/step3.jpg"
        }
      ],
      "video": {
        "@type": "VideoObject",
        "name": "How to Make a Non-Alcoholic Piña Colada",
        "description": "This is how you make a non-alcoholic piña colada.",
        "thumbnailUrl": [
          "https://example.com/photos/1x1/photo.jpg",
          "https://example.com/photos/4x3/photo.jpg",
          "https://example.com/photos/16x9/photo.jpg"
         ],
        "contentUrl": "https://www.example.com/video123.mp4",
        "embedUrl": "https://www.example.com/videoplayer?video=123",
        "uploadDate": "2024-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2024-02-05T08:00:00+08:00"
       }
    }
    </script>
  </head>
  <body>
  </body>
</html>

다음은 구조화된 itemList 데이터가 포함된 레시피 요약 페이지(레시피 목록이 있는 페이지)의 예입니다. 이러한 콘텐츠는 검색결과에서 그리드로 표시될 수 있습니다.

<html>
  <head>
    <title>Grandma's Best Pie Recipes</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org",
      "@type": "ItemList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "url": "https://example.com/apple-pie.html"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "url": "https://example.com/blueberry-pie.html"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "url": "https://example.com/cherry-pie.html"
        }]
    }
    </script>
  </head>
  <body>
  </body>
</html>

가이드라인

레시피를 검색결과에 표시하려면 구조화된 데이터 일반 가이드라인을 따라야 합니다. 레시피를 어시스턴트에 레시피 안내로 표시하려면 콘텐츠가 어시스턴트 콘텐츠 제한 정책을 따라야 합니다.

구조화된 Recipe 데이터에는 다음과 같은 가이드라인이 적용됩니다.

  • 특정 요리 준비에 관한 콘텐츠에는 구조화된 Recipe 데이터를 사용합니다. 예를 들어, '페이셜 스크럽', '파티 아이디어'는 올바른 요리 이름이 아닙니다.
  • 캐러셀 또는 그리드에 레시피를 표시하려면 다음과 같은 가이드라인을 따라야 합니다.
    • 목록에 레시피를 요약하려면 구조화된 ItemList 데이터를 제공합니다. 구조화된 레시피 데이터와 별도로 또는 함께 구조화된 ItemList 데이터를 제공할 수 있습니다.
    • 사이트에는 컬렉션의 모든 레시피를 나열하는 요약 페이지가 있어야 합니다. 예를 들어 사용자가 검색결과에서 요약 링크를 클릭하면 검색어와 관련된 레시피가 나열된 사이트 페이지로 올바르게 이동합니다.

구조화된 데이터 유형 정의

Google 검색에 콘텐츠를 리치 결과로 표시하려면 필수 속성이 있어야 합니다. 권장 속성을 통해 콘텐츠에 관한 정보를 추가하여 더욱 만족스러운 사용자 환경을 제공할 수 있습니다.

Recipe

다음의 schema.org Recipe 유형 속성으로 레시피 콘텐츠를 마크업하세요. Recipe의 전체 정의는 schema.org/Recipe에서 확인할 수 있습니다. Google에서 지원하는 속성은 다음과 같습니다.

필수 속성
image

URL 또는 ImageObject

완성된 요리의 이미지입니다.

추가 이미지 가이드라인

  • 모든 페이지에는 마크업 포함 여부와 관계없이 하나 이상의 이미지가 있어야 합니다. Google에서 가로세로 비율과 해상도를 기반으로 Google 검색결과에 표시할 최적의 이미지를 선택합니다.
  • 이미지 URL은 크롤링 및 색인 생성이 가능해야 합니다. Google에서 내 URL에 액세스할 수 있는지 확인하려면 URL 검사 도구를 사용하세요.
  • 이미지는 마크업된 콘텐츠를 나타내야 합니다.
  • 이미지는 Google 이미지에서 지원되는 파일 형식이어야 합니다.
  • 최상의 결과를 위해서는 가로세로 비율이 16x9, 4x3, 1x1인 여러 개의 고해상도 이미지(너비와 높이의 곱이 최소 50,000픽셀)를 제공하는 것이 좋습니다.

예:

"image": [
  "https://example.com/photos/1x1/photo.jpg",
  "https://example.com/photos/4x3/photo.jpg",
  "https://example.com/photos/16x9/photo.jpg"
]
name

Text

요리의 이름입니다.

권장 속성
aggregateRating

AggregateRating

항목에 지정된 평균 리뷰 점수의 주석입니다. 리뷰 스니펫 가이드라인과 필수 및 권장 AggregateRating 속성 목록을 따르세요.

구조화된 Recipe 데이터가 단일 리뷰를 포함하는 경우 리뷰 작성자의 이름은 유효한 개인 또는 조직이어야 합니다. 예를 들어 '재료 50% 할인'은 유효한 리뷰 작성자 이름이 아닙니다.

author

Person 또는 Organization

레시피를 작성한 사람 또는 조직의 이름입니다. Google에서 다양한 기능을 갖춘 작성자를 가장 잘 이해할 수 있도록 작성자 마크업 권장사항을 따르는 것이 좋습니다.

cookTime

Duration

실제 조리에 걸리는 시간입니다. ISO 8601 형식으로 나타냅니다.

항상 prepTime과 함께 사용하세요.

datePublished

Date

레시피가 게시된 날짜입니다. ISO 8601 형식으로 나타냅니다.

description

Text

요리에 관한 간단한 요약 설명입니다.

keywords

Text

계절('여름'), 휴일('핼러윈') 또는 기타 설명('빠른', '쉬운', '정통') 등 레시피에 관한 기타 용어입니다.

추가 가이드라인

  • 키워드 목록에서 쉼표로 여러 항목을 구분합니다.
  • 실제로 recipeCategory 또는 recipeCuisine인 태그는 사용하지 마세요.

    권장하지 않음:

    "keywords": "dessert, American"

    권장:

    "keywords": "winter apple pie, nutmeg crust"
nutrition.calories

Energy

이 레시피 1인분의 칼로리입니다. nutrition.calories가 정의되어 있으면 recipeYield는 분량에 따라 정의되어야 합니다.

prepTime

Duration

요리의 재료와 작업공간을 준비하는 데 걸리는 시간입니다. ISO 8601 형식으로 나타냅니다.

항상 cookTime과 함께 사용하세요.

recipeCategory

Text

레시피의 요리 또는 코스 유형입니다. 예: '저녁 식사', '메인 코스' 또는 '디저트', '간식'

recipeCuisine

Text

레시피와 관련된 지역입니다. 예: '프랑스', '지중해', '미국'

recipeIngredient

Text

레시피에 사용되는 재료입니다.

예:

"recipeIngredient": [
  "1 (15 ounce) package double crust ready-to-use pie crust",
  "6 cups thinly sliced, peeled apples (6 medium)",
  "3/4 cup sugar",
  "2 tablespoons all-purpose flour",
  "3/4 teaspoon ground cinnamon",
  "1/4 teaspoon salt",
  "1/8 teaspoon ground nutmeg",
  "1 tablespoon lemon juice"
]

추가 가이드라인

  • 레시피를 만드는 데 필요한 재료 텍스트만 포함하세요.
  • 재료의 정의와 같이 불필요한 정보는 포함하지 마세요.
recipeInstructions

HowToStep, HowToSection, Text

요리 단계입니다.

여러 가지 방법으로 recipeInstructions의 값을 설정할 수 있습니다. HowToStep을 사용하는 것이 좋습니다. 레시피에 섹션이 있을 경우 HowToSection을 사용하여 HowToStep을 그룹화할 수도 있습니다.

  • HowToStep: HowToStep으로 이 레시피의 단계를 지정합니다.
    "recipeInstructions": [
      {
        "@type": "HowToStep",
        "name": "Preheat",
        "text": "Heat oven to 425°F.",
        "url": "https://example.com/recipe#step1",
        "image": "https://example.com/photos/recipe/step1.jpg"
      }, {
        "@type": "HowToStep",
        "name": "Prepare crust",
        "text": "Place 1 pie crust in ungreased 9-inch glass pie plate, pressing firmly against side and bottom.",
        "url": "https://example.com/recipe#step2",
        "image": "https://example.com/photos/recipe/step2.jpg"
      }, {
        "@type": "HowToStep",
        "name": "Make filling",
        "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate.",
        "url": "https://example.com/recipe#step3",
        "image": "https://example.com/photos/recipe/step3.jpg"
      }, {
        "@type": "HowToStep",
        "name": "Cover",
        "text": "Top with second crust. Cut slits or shapes in several places in top crust.",
        "url": "https://example.com/recipe#step4",
        "image": "https://example.com/photos/recipe/step4.jpg"
      }, {
        "@type": "HowToStep",
        "name": "Bake",
        "text": "Bake 40 to 45 minutes. The pie is ready when the apples are tender and the crust is golden brown.",
        "url": "https://example.com/recipe#step5",
        "image": "https://example.com/photos/recipe/step5.jpg"
      }, {
        "@type": "HowToStep",
        "name": "Cool",
        "text": "Cool on cooling rack at least 2 hours before serving.",
        "url": "https://example.com/recipe#step6",
        "image": "https://example.com/photos/recipe/step6.jpg"
      }
    ]
  • HowToSection(레시피의 섹션이 여러 개일 경우에만): 단계를 여러 가지 섹션으로 그룹화하는 데 사용합니다. 예를 보려면 HowToSection을 참조하세요.
  • 단일 또는 반복 텍스트 속성: 하나 이상의 단계를 포함하는 텍스트 블록입니다. Google에서는 모든 단계를 하나의 섹션에 있는 것처럼 처리합니다. 반복 속성값은 단일 텍스트 블록으로 연결됩니다. 그런 다음 Google에서 단일 텍스트 블록을 개별 단계로 자동 분리하도록 시도합니다. Google은 모든 섹션 이름, 단계 번호, 키워드, 레시피 단계 텍스트에 잘못 표시될 수 있는 다른 것들을 찾아서 삭제하려고 합니다. 최상의 결과를 얻으려면 HowToStep으로 단계를 명확하게 지정하는 것이 좋습니다.
    "recipeInstructions": [
      "In large bowl, gently mix filling ingredients; spoon into crust-lined pie
    plate. Top with second crust. Cut slits or shapes in several places in top
    crust. Bake 40 to 45 minutes. The pie is ready when the or until apples are
    tender and the crust is golden brown. Cool on cooling rack at least 2 hours
    before serving."
    ]

추가 가이드라인

  • 다른 곳에 포함된 메타데이터를 포함하지 마세요. 특히 작성자에는 author 속성, 요리에는 recipeCuisine, 카테고리에는 recipeCategory, 다른 키워드에는 keywords를 사용하세요.
  • 요리를 만드는 방법에 관한 텍스트만 포함하고, '지침', '동영상 보기', '1단계'와 같은 기타 텍스트는 포함하지 마세요. 그러한 구문은 구조화된 데이터의 외부에 지정합니다.

    권장하지 않음:

    "recipeInstructions": [{
      "@type": "HowToStep",
      "text": "Step 1. Heat oven to 425°F."
    }]

    권장:

    "recipeInstructions": [{
      "@type": "HowToStep",
      "text": "Heat oven to 425°F."
    }]
recipeYield

Text 또는 Integer

레시피에서 만드는 양입니다. 숫자만 사용하여 이 레시피로 만들어지는 분량을 지정합니다. 만드는 요리의 개수와 같이 다른 단위를 사용하기 위해 수량을 추가로 포함할 수 있습니다. nutrition.calories와 같이 1인분 기준 영양 정보를 지정할 경우 필수 속성입니다.

"recipeYield": [
  "6",
  "24 cookies"
]
totalTime

Duration

요리를 준비하는 데 걸리는 총 시간입니다. ISO 8601 형식으로 나타냅니다.

totalTime을 사용하거나 cookTimeprepTime을 조합하여 사용하세요.

video VideoObject

요리하는 단계를 보여주는 동영상입니다. 필수 및 권장 동영상 속성 목록을 따르세요.

  • Video without clips
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "video": [
        {
          "@type": "VideoObject",
          "name": "Delicious PieParty Coffee Cake",
          "description": "How to make a delicious pie - quickly and easily!How to make Party Coffee Cake.",
          "thumbnailUrl": [
            "https://example.com/photos/1x1/photo.jpg",
            "https://example.com/photos/4x3/photo.jpg",
            "https://example.com/photos/16x9/photo.jpg"
          ],
          "contentUrl": "https://www.example.com/videos/123_600x400.mp4",
          "embedUrl": "https://www.example.com/videoplayer?id=123",
          "uploadDate": "2018-02-05T08:00:00+08:00"
        }
      ]
    }
    ]
  • Video with clips: 동영상 세그먼트에 상응하는 클립이 포함된 동영상입니다. 단계와 같이 레시피의 다른 부분에서 video.hasPart로 정의된 클립을 참고할 수 있습니다.
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "video": {
        "@type": "VideoObject",
        "name": "Make a pie",
        "description": "How to make a delicious pie - quickly and easily!",
        "thumbnailUrl": "https://example.com/photos/photo.jpg",
        "contentUrl": "https://www.example.com/videos/123_600x400.mp4",
        "embedUrl": "https://www.example.com/videoplayer?id=123",
        "uploadDate": "2018-02-05T08:00:00+08:00",
        "duration": "P1MT10S",
        "hasPart": [{
          "@type": "Clip",
          "@id": "Clip1",
          "name": "Preheat oven",
          "startOffset": 20,
          "endOffset": 29
          "url": "https://www.example.com/example?t=20"
         },
         {
           "@type": "Clip",
           "@id": "Clip2",
           "name": "Arrange pie crust",
           "startOffset": 29,
           "endOffset": 36
           "url": "https://www.example.com/example?t=29"
         },
         {
           "@type": "Clip",
           "@id": "Clip3",
           "name": "Make filling",
           "startOffset": 36,
           "endOffset": 45
           "url": "https://www.example.com/example?t=36"
         },
         {
           "@type": "Clip",
           "@id": "Clip4",
           "name": "Add filling",
           "startOffset": 45,
           "endOffset": 65
           "url": "https://www.example.com/example?t=45"
         },
         {
           "@type": "Clip",
           "@id": "Clip5",
           "name": "Bake",
           "startOffset": 65,
           "endOffset": 80
           "url": "https://www.example.com/example?t=65"
         },
         {
           "@type": "Clip",
           "@id": "Clip6",
           "name": "Let cool",
           "startOffset": 80,
           "endOffset": 90
           "url": "https://www.example.com/example?t=80"
        }]
      }
    }
video.contentUrl

URL

지원되는 인코딩 형식 중 하나로 된 실제 동영상 미디어 파일로 연결되는 URL입니다. 동영상이 있는 페이지로 링크하지 마세요. 동영상 미디어 파일 자체의 URL이어야 합니다.

"contentUrl": "https://www.example.com/video/123/file.mp4"

동영상 권장사항을 따라 주세요.

video.hasPart

Clip

전체 동영상의 일부인 동영상 클립입니다.

video.hasPart.endOffset

Number

동영상 시작 부분부터 초 단위로 표시된 클립의 종료 시간입니다.

video.hasPart.name

Text

클립 이름입니다. 예를 들어 이 크러스트를 파이 플레이트에 맞추고 누르는 방법을 보여주는 클립의 이름은 '파이 크러스트 맞추기'가 될 수 있습니다.

video.hasPart.startOffset

Number

동영상 시작 부분부터 초 단위로 표시된 클립의 시작 시간입니다.

video.hasPart.url

URL

클립의 시작으로 연결되는 링크입니다. 클립의 시작은 video.hasPart.startOffset에 설정된 값과 일치해야 합니다. 예:

"startOffset": 20,
"endOffset": 29,
"url": "https://www.example.com/example?t=20"

HowToSection

레시피 안내의 일부를 이루는 일련의 단계 또는 하위 섹션을 그룹화하려면 HowToSection을 사용합니다. recipeInstructions 속성의 정의 내에서 직접 또는 다른 HowToSectionitemListElementHowToSection을 지정합니다.

HowToSection 유형은 단일 레시피의 섹션을 정의하며 하나 또는 여러 개의 단계를 포함합니다. 동일한 요리를 위한 여러 레시피를 정의하는 데 HowToSection을 사용하지 마세요. 대신, 단일 레시피의 일부로 HowToSection을 사용하세요. 하나의 요리를 위한 여러 레시피를 나열하려면 여러 Recipe 객체를 사용하세요. 예를 들어 애플파이를 만드는 다양한 방법은 HowToSection 객체가 아닌 여러 Recipe 객체로 나열합니다.

HowToSection의 전체 정의는 schema.org/HowToSection에서 확인할 수 있습니다.

필수 속성
itemListElement HowToStep

섹션 또는 하위 섹션에 관한 자세한 단계의 목록입니다. 예를 들어 피자 레시피에는 크러스트 만들기 단계에 한 섹션, 토핑 만들기에 한 섹션, 합치고 굽는 데 한 섹션이 있을 수 있습니다. 레시피에 섹션이 있지만 HowToSections로 정의되지 않을 경우, 어시스턴트가 섹션 이름을 다른 단계로 잘못 표시할 수 있습니다(예: '크러스트 만들기' 단계 다음에 '밀가루와 이스트 섞기' 단계가 이어짐).

예:

{
  "@type": "HowToSection",
  "name": "Assemble the pie",
  "itemListElement": [
    {
      "@type": "HowToStep",
      "text": "In large bowl, gently mix filling ingredients; spoon into crust-lined pie plate."
    }, {
      "@type": "HowToStep",
      "text": "Top with second crust. Cut slits or shapes in several places in top crust."
    }
  ]
}
name Text

섹션의 이름입니다.

HowToStep

레시피의 일부로 방법을 설명하는 하나 이상의 문장을 그룹화하려면 HowToStep을 사용합니다. 문장으로 text 속성을 정의하거나 아니면 각 문장의 HowToDirection 또는 HowToTip으로 itemListElement를 정의합니다.

HowToStep 유형의 다음 속성으로 레시피 단계를 마크업합니다. recipeInstructions 속성의 정의 내에서 직접 또는 HowToSectionitemListElementHowToStep을 지정합니다.

HowToStep의 전체 정의는 schema.org/HowToStep에서 확인할 수 있습니다.

필수 속성
itemListElement HowToDirection 또는 HowToTip

지시나 팁을 포함한 자세한 하위 단계의 목록입니다.

text가 사용되는 경우 선택사항입니다.

text Text

이 단계의 전체 안내 텍스트입니다.

itemListElement가 사용되는 경우 선택사항입니다. 추가 가이드라인

  • 안내 텍스트만 포함하고 '지시', '동영상 보기', '1단계'와 같은 기타 텍스트는 포함하지 마세요. 마크업된 속성 외부의 구문을 지정하세요.

    권장하지 않음:

    {
      "@type": "HowToStep",
      "text": "Step 1. Heat oven to 425°F."
    }

    권장:

    {
      "@type": "HowToStep",
      "text": "Heat oven to 425°F."
    }
권장 속성
image ImageObject 또는 URL

단계에 대한 이미지입니다. 추가 이미지 가이드라인:

  • 이미지 URL은 크롤링 및 색인 생성이 가능해야 합니다.
  • 이미지는 마크업된 콘텐츠를 나타내야 합니다.
  • 이미지는 .jpg, .png 또는 .gif 형식이어야 합니다.
name Text

단계를 요약하는 단어나 짧은 구문입니다(예: '파이 크러스트 맞추기'). 설명이 아닌 텍스트(예: '1단계: [텍스트]')나 다른 형식의 단계 번호(예: '1. [텍스트]')는 사용하지 마세요.

url URL

단계에 직접 연결되는 URL(사용 가능한 경우). 예: 앵커 링크 조각

video VideoObject 또는 Clip

이 단계의 동영상 또는 동영상의 클립입니다.

VideoObject의 경우 필수 및 권장 동영상 또는 클립 속성 목록을 따르세요.

HowToDirectionHowToTip

HowToDirectionHowToTip을 사용하여 지침 또는 팁을 설명합니다. 이 둘은 필수 속성과 권장 속성이 동일합니다.

HowToDirectionHowToTip의 전체 정의는 schema.org/HowToDirectionschema.org/HowToTip에서 확인할 수 있습니다.

필수 속성
text Text

지시나 팁의 텍스트입니다.

ItemList

레시피 속성 외에 호스트 관련 목록에 다음 속성을 추가합니다. ItemList는 필수 속성은 아니지만 레시피가 호스트 캐러셀에 표시되도록 하려면 다음 속성을 추가해야 합니다. 호스트 캐러셀을 자세히 알아보려면 캐러셀을 참고하세요.

ItemList의 전체 정의는 schema.org/ItemList에서 확인할 수 있습니다.

필수 속성
itemListElement

ListItem

단일 항목 페이지의 주석입니다.

ListItem.position

Integer

목록에서 항목 페이지의 순서입니다. 예:


"itemListElement": [
  {
    "@type": "ListItem",
    "position": 1,
  }, {
    "@type": "ListItem",
    "position": 2,
  }
]
ListItem.url

URL

항목 페이지의 표준 URL. 모든 항목에 고유한 URL이 있어야 합니다.

Search Console로 리치 결과 모니터링하기

Search Console은 Google 검색에서의 페이지 실적을 모니터링하는 데 도움이 되는 도구입니다. Search Console에 가입해야만 페이지가 Google 검색결과에 포함되는 것은 아니지만, 가입하면 Google에서 사이트를 인식하는 방식을 이해하고 개선하는 데 도움이 될 수 있습니다. 다음과 같은 경우 Search Console을 확인하는 것이 좋습니다.

  1. 구조화된 데이터를 처음 배포한 후
  2. 새 템플릿을 출시하거나 코드를 업데이트한 후
  3. 주기적으로 트래픽 분석

구조화된 데이터를 처음 배포한 후

Google에서 페이지의 색인을 생성하고 나면 관련 리치 결과 상태 보고서를 사용하여 문제를 확인합니다. 유효한 항목 수가 증가하고 잘못된 항목 수는 증가하지 않는 것이 가장 좋습니다. 구조화된 데이터에 문제가 있는 경우 다음과 같이 해결하세요.

  1. 잘못된 항목을 수정하세요.
  2. 실제 URL을 검사하여 문제가 지속되는지 확인합니다.
  3. 상태 보고서를 사용하여 유효성 검사를 요청합니다.

새 템플릿을 출시하거나 코드를 업데이트한 후

웹사이트를 대폭 변경한 후 구조화된 데이터의 잘못된 항목이 증가하는지 모니터링하세요.
  • 잘못된 항목이 증가했다면 새로 출시한 템플릿이 제대로 작동하지 않거나 사이트가 기존의 템플릿과 좋지 않은 방식으로 상호작용하게 된 것일 수 있습니다.
  • 유효한 항목이 감소했다면(잘못된 항목 증가와 일치하지 않음) 페이지에 구조화된 데이터를 더 이상 삽입하지 않는 것일 수 있습니다. URL 검사 도구를 사용하여 문제를 일으키는 원인을 알아보세요.

주기적으로 트래픽 분석

실적 보고서를 사용하여 Google 검색 트래픽을 분석합니다. 데이터를 통해 페이지가 Google 검색의 리치 결과로 표시되는 빈도, 사용자가 검색결과를 클릭하는 빈도, 검색결과에 표시되는 평균 게재순위를 확인할 수 있습니다. Search Console API를 사용하여 이러한 결과를 자동으로 가져오는 방법도 있습니다.

문제 해결

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

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