Google에 레시피 가져오기

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

Google 검색 및 Google 이미지에 나타난 레시피

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

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

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 검색과 레시피 안내로 어시스턴트에 표시될 수 있는 페이지의 예입니다.

<html>
  <head>
    <title>Party Coffee Cake</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "name": "Party Coffee Cake",
      "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": "2018-03-10",
      "description": "This coffee cake is awesome and perfect for parties.",
      "prepTime": "PT20M",
      "cookTime": "PT30M",
      "totalTime": "PT50M",
      "keywords": "cake for a party, coffee",
      "recipeYield": "10",
      "recipeCategory": "Dessert",
      "recipeCuisine": "American",
      "nutrition": {
        "@type": "NutritionInformation",
        "calories": "270 calories"
      },
      "recipeIngredient": [
        "2 cups of flour",
        "3/4 cup white sugar",
        "2 teaspoons baking powder",
        "1/2 teaspoon salt",
        "1/2 cup butter",
        "2 eggs",
        "3/4 cup milk"
        ],
      "recipeInstructions": [
        {
          "@type": "HowToStep",
          "name": "Preheat",
          "text": "Preheat the oven to 350 degrees F. Grease and flour a 9x9 inch pan.",
          "url": "https://example.com/party-coffee-cake#step1",
          "image": "https://example.com/photos/party-coffee-cake/step1.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Mix dry ingredients",
          "text": "In a large bowl, combine flour, sugar, baking powder, and salt.",
          "url": "https://example.com/party-coffee-cake#step2",
          "image": "https://example.com/photos/party-coffee-cake/step2.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Add wet ingredients",
          "text": "Mix in the butter, eggs, and milk.",
          "url": "https://example.com/party-coffee-cake#step3",
          "image": "https://example.com/photos/party-coffee-cake/step3.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Spread into pan",
          "text": "Spread into the prepared pan.",
          "url": "https://example.com/party-coffee-cake#step4",
          "image": "https://example.com/photos/party-coffee-cake/step4.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Bake",
          "text": "Bake for 30 to 35 minutes, or until firm.",
          "url": "https://example.com/party-coffee-cake#step5",
          "image": "https://example.com/photos/party-coffee-cake/step5.jpg"
        },
        {
          "@type": "HowToStep",
          "name": "Enjoy",
          "text": "Allow to cool and enjoy.",
          "url": "https://example.com/party-coffee-cake#step6",
          "image": "https://example.com/photos/party-coffee-cake/step6.jpg"
        }
      ],
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": "5",
        "ratingCount": "18"
      },
      "video": {
        "@type": "VideoObject",
        "name": "How to make a Party Coffee Cake",
        "description": "This is how you make a 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": "http://www.example.com/video123.mp4",
        "embedUrl": "http://www.example.com/videoplayer?video=123",
        "uploadDate": "2018-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "http://schema.org/WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2019-02-05T08:00:00+08:00"
      }
    }
    </script>
  </head>
  <body>
  </body>
</html>

검색 전용 레시피

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

<html>
  <head>
    <title>Non-alcoholic Pina Colada</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Recipe",
      "name": "Non-alcoholic Pina 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": "2018-03-10",
      "description": "This non-alcoholic pina colada is everyone's favorite!",
      "recipeCuisine": "American",
      "prepTime": "PT1M",
      "cookTime": "PT2M",
      "totalTime": "PT3M",
      "keywords": "non-alcoholic",
      "recipeYield": "1 serving",
      "recipeCategory": "Drink",
      "nutrition": {
        "@type": "NutritionInformation",
        "calories": "120 calories"
      },
      "aggregateRating": {
        "@type": "AggregateRating",
        "ratingValue": "5",
        "ratingCount": "18"
      },
      "recipeIngredient": [
        "2 cups of pineapple juice",
        "5/8 cup cream of coconut",
        "ice"
      ],
      "recipeInstructions": [
        {
          "@type": "HowToStep",
          "text": "Blend 2 cups of pineapple juice and 5/8 cup cream of coconut until smooth."
        },
        {
          "@type": "HowToStep",
          "text": "Fill a glass with ice."
        },
        {
          "@type": "HowToStep",
          "text": "Pour the pineapple juice and coconut mixture over ice."
        }
      ],
      "video": {
        "@type": "VideoObject",
        "name": "How to make a Party Coffee Cake",
        "description": "This is how you make a 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": "http://www.example.com/video123.mp4",
        "embedUrl": "http://www.example.com/videoplayer?video=123",
        "uploadDate": "2018-02-05T08:00:00+08:00",
        "duration": "PT1M33S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "http://schema.org/WatchAction" },
          "userInteractionCount": 2347
        },
        "expires": "2019-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에서 확인할 수 있습니다.

필수 속성

image

URL 또는 ImageObject

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

추가 이미지 가이드라인

  • 모든 페이지에는 마크업 포함 여부와 관계없이 하나 이상의 이미지가 있어야 합니다. Google에서 가로세로 비율과 해상도를 기반으로 검색결과에 표시할 최적의 이미지를 선택합니다.
  • 이미지 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

레시피를 작성한 사람 또는 조직의 이름입니다.

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로 이 레시피의 단계를 지정합니다.
  • HowToSection(레시피의 섹션이 여러 개일 경우에만): 단계를 여러 가지 섹션으로 그룹화하는 데 사용합니다. 예를 보려면 HowToSection을 참조하세요.
  • 단일 또는 반복 텍스트 속성: 하나 이상의 단계를 포함하는 텍스트 블록입니다. Google에서는 모든 단계를 하나의 섹션에 있는 것처럼 처리합니다. 반복 속성값은 단일 텍스트 블록으로 연결됩니다. 그런 다음 Google에서 단일 텍스트 블록을 개별 단계로 자동 분리하도록 시도합니다. Google은 모든 섹션 이름, 단계 번호, 키워드, 레시피 단계 텍스트에 잘못 표시될 수 있는 다른 것들을 찾아서 삭제하려고 합니다. 최상의 결과를 얻으려면 HowToStep으로 단계를 명확하게 지정하는 것이 좋습니다.

추가 가이드라인

  • 다른 곳에 포함된 메타데이터를 포함하지 마세요. 특히 작성자에는 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

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


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

totalTime

Duration

요리를 준비하는 데 걸리는 총 시간입니다. ISO 8601 형식으로 나타냅니다. 하위 요소로 최솟값과 최댓값을 사용하여 시간 범위를 지정할 수 있습니다.

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

video

VideoObject

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

  • Video without clips
  • Video with clips: 동영상 세그먼트에 해당하는 클립이 포함된 동영상입니다. 단계와 같이 레시피의 다른 부분에서 video.hasPart로 정의된 클립을 참조할 수 있습니다.

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단계'와 같은 기타 텍스트는 포함하지 마세요. 이러한 구문은 마크업된 속성 외부에 지정하세요.
권장 속성

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를 사용하여 이러한 결과를 자동으로 가져오는 방법도 있습니다.

문제해결

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