피드 만들기

미디어 피드는 카탈로그의 미디어 콘텐츠를 나타내는 항목 모음(예: TV 시리즈, 영화, 노래, 앨범 등)이 포함된 JSON 객체입니다. 온보딩 프로세스의 첫 번째 단계는 피드 개발을 시작하는 것입니다. 파일이 준비되면 Google에서 정기적으로 가져올 수 있도록 지원되는 호스팅 방법 중 하나를 사용하여 피드를 호스팅해야 합니다.

피드 파일 형식 요구사항

피드 파일의 요구사항은 다음과 같습니다.

  • 피드 파일의 파일 이름 확장자는 .json여야 합니다.
  • 피드 파일을 암호화하지 않습니다.

  • 피드 파일을 UTF-8로 인코딩합니다(파일 편집기 설정 확인).

    alt_text

  • 피드 파일이 1GB(압축되지 않음)보다 큰 경우 파일을 여러 파일로 분할합니다.

  • 항목 유형(예: tvseries.json, tvseasons.json, tvepisodes.json, movies.json 등)별로 파일을 만드는 것이 좋습니다.

    • 이러한 파일이 1GB를 초과하는 경우 항목을 여러 파일로 분할합니다(예: tvepisodes_01.json, tvepisodes_02.json 등).
    • 파일 크기가 1GB 미만인 경우 단일 파일에 포함할 수 있는 항목 수에는 제한이 없습니다.

  • JSON 사양에 따라 파일이 BOM 없이 인코딩되었는지 확인합니다. Linux OS에서 확인하려면 hexdump file.json | head -n 1가 주소 0x00에서 BBEF로 시작하지 않아야 합니다.

피드의 유형

제품 피드

  • 이는 Google에서 출시하려는 전체 카탈로그를 나타내는 JSON 피드 파일 집합을 나타냅니다. 아래 섹션에서 피드를 만드는 방법을 알아볼 수 있습니다.
  • Google과 처음 통합하는 경우 이 피드만 필요합니다.
  • 이 피드가 Google에 제출되면 수집되는 정보의 양과 정확성 측면에서 더 높은 품질 기준을 달성하기 위해 광범위하게 분석되고 여러 번 반복된 후 최종적으로 처리되고 실행됩니다.

스테이징 피드

  • 제품 피드를 확장해야 하는 특정 사용 사례가 있습니다. 이러한 시나리오의 몇 가지 예시는 다음과 같습니다.
    • 이전에 출시되지 않은 새로운 항목 유형을 포함하도록 피드를 확장합니다.
    • 새로운 언어로 출시하기 위해 수많은 새로운 항목/메타데이터를 포함하도록 피드를 확장합니다.
    • 새로운 플랫폼 유형으로 피드 확장 예를 들어 프로덕션 피드가 Google 검색에만 출시되었는데 이제 Google TV로 출시를 확대하려는 경우입니다.
  • 이 경우 스테이징 피드가 필요합니다. 이 피드는 새 플랫폼의 딥 링크, 새 언어의 메타데이터 등 추가 메타데이터가 있다는 점을 제외하고 프로덕션 피드의 사본입니다.
  • 제품 피드와 마찬가지로, 이 피드는 수집되는 정보의 양과 정확성 측면에서 더 높은 품질 기준을 달성하기 위해 광범위하게 분석되고 여러 번 반복됩니다. 품질 기준이 충족되면 이 피드가 현재 프로덕션 피드를 대체하여 새 프로덕션 피드가 됩니다.
  • 이 피드를 사용하면 프로덕션 피드에 영향을 주지 않고 초기 출시를 추가 출시와 분리하고 필요한 모든 테스트를 수행할 수 있습니다. 이렇게 하면 최종 사용자 환경이 중단되지 않습니다.

위 사항에 관해 궁금한 점이 있으면 Google 담당자에게 문의하세요.

피드 파일 만들기

피드를 만들 때 다음 권장사항을 따르세요.

  1. 소수의 항목을 사용하여 샘플 피드 만들기

    카탈로그의 모든 콘텐츠가 포함된 피드를 빌드하기 전에 소수의 항목만 포함된 샘플 피드를 만드는 것이 좋습니다. 피드를 작업하는 동안 문제가 발생할 수 있습니다. 항목 집합의 크기를 제한하면 이러한 오류와 경고를 더 쉽게 디버깅할 수 있습니다.

  2. 샘플 피드 검사

    Google은 피드가 사양을 준수하는지 확인할 수 있는 도구를 제공합니다. 이러한 도구를 사용하여 샘플 피드에서 발견된 모든 오류와 경고를 해결하는 것이 좋습니다.

  3. 제품 피드 만들기

    소규모 항목 집합에 적합한 구조가 있는지 확인한 후 전체 카탈로그의 피드를 개발합니다.

샘플 피드 만들기

  1. 카탈로그에서 대표 항목을 하나 선택합니다. 구조가 적당히 복잡하지만 카탈로그의 항목에 일반적인 항목을 선택합니다.
  2. JSON 스키마 검증 도구를 사용하여 문법 오류와 누락된 필수 속성을 확인합니다. (자세한 내용은 다음 섹션을 참고하세요.)

    단일 Movie 항목이 있는 피드의 예

    {
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Movie",
      "@id": "http://www.example.com/my_favorite_movie",
      "url": "http://www.example.com/my_favorite_movie",
      "name": "My Favorite Movie",
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
          "inLanguage": "en",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "actionAccessibilityRequirement": {
          "@type": "ActionAccessSpecification",
          "category": "subscription",
          "requiresSubscription": {
            "@type": "MediaSubscription",
            "name": "Example Package",
            "commonTier": true,
            "@id": "[partner determined string]"
          },
          "availabilityStarts": "2018-07-21T10:35:29Z",
          "availabilityEnds": "2019-10-21T10:35:29Z",
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            },
            {
              "@type": "Country",
              "name": "CA"
            }
          ]
        }
      },
      "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
      "releasedEvent": {
        "@type": "PublicationEvent",
        "startDate": "2008-01-20",
        "location": {
          "@type": "Country",
          "name": "US"
        }
      },
      "description": "This is my favorite movie.",
      "actor": [
        {
          "@type": "Person",
          "name": "John Doe",
          "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
        },
        {
          "@type": "Person",
          "name": "Jane Doe",
          "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
        }
      ],
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "IMDB_ID",
          "value":  "tt0123456"
        }
      ]
    }
  ]
}

샘플 피드 검사

다음 도구를 사용하면 미디어 피드의 Google 구조화된 데이터 사양에 따라 샘플 피드의 유효성을 검사할 수 있습니다.

  • JSON 스키마 검증 도구

    JSON 스키마 검증 도구는 업로드하기 전에 피드의 모든 파일을 로컬에서 검증합니다. 피드를 개발하는 동안 이 도구를 사용하여 일반적인 구조 및 유형 오류를 방지하세요. 도구에 대한 자세한 내용은 여기를 참고하세요.

  • Search Console의 카탈로그 속성

    Google 담당자가 Search Console 카탈로그 속성을 사용 설정하고 샘플 또는 스테이징 피드가 처리되면 Search Console의 카탈로그 속성을 사용하여 항목 수준 유효성 검사 오류, 경고, 처리 진단을 검사합니다.

제품 피드 만들기

  1. 샘플 피드의 모든 구조적 오류와 경고가 해결되면 피드를 확장하여 카탈로그의 모든 항목을 포함합니다.
  2. 확장된 피드 파일에서 JSON 스키마 검증 도구를 실행하고 업로드 후 Search Console의 카탈로그 속성을 검토하여 검증 오류가 없는지 확인합니다. 피드의 항목 수와 카탈로그의 항목 수를 비교하여 피드에 카탈로그의 모든 항목이 포함되어 있는지 확인합니다.
이전
가격 확인
다음
피드 호스팅