フィードを作成する

メディア フィードは、カタログ内のメディア コンテンツ(テレビシリーズ、映画、曲、アルバムなど)を表すエンティティのコレクションを含む JSON オブジェクトです。オンボーディング プロセスの最初のステップは、フィードの開発を開始することです。ファイルの準備ができたら、Google が定期的に取得できるように、サポートされているホスティング方法のいずれかを使用してフィードをホストする必要があります。

フィード ファイル形式の要件

フィード ファイルの要件は次のとおりです。

  • フィード ファイルのファイル拡張子は .json でなければなりません。
  • フィード ファイルは暗号化しません。
  • フィード ファイルを UTF-8 でエンコードします(ファイル エディタの設定を確認してください)。

    alt_text

  • フィード ファイルが(未圧縮で)1 GB より大きい場合は、ファイルを複数のファイルに分割します。

  • エンティティ タイプ(tvseries.json、tvseasons.json、tvepisodes.json、movies.json など)ごとにファイルを作成することをおすすめします。

    • これらのファイルのいずれかが 1 GB を超える場合は、エンティティを複数のファイル(tvepisodes_01.json、tvepisodes_02.json など)に分割します。
    • ファイルサイズが 1 GB 未満である限り、1 つのファイルに含めることができるエンティティの数に制限はありません。
  • JSON 仕様に従って、ファイルが BOM なしでエンコードされていることを確認します。Linux OS で確認するには、アドレス 0x00 で hexdump file.json | head -n 1 が BBEF で始まっていない必要があります。

フィードのタイプ

本番環境フィード

  • これは、Google で公開するカタログ全体を表す JSON フィード ファイルのセットです。フィードの作成方法については、以下のセクションをご覧ください。
  • Google と初めて統合する場合は、このフィードのみが必要です。
  • このフィードが Google に送信されると、広範な分析が行われ、数回にわたって反復処理されます。これは、最終的に取り込まれてリリースされる前に、取得される情報の量と正確性に関して、より高い品質基準を達成するためです。

ステージング フィード

  • 本番環境の商品フィードの拡張が必要となるユースケースがあります。このようなシナリオの例を次に示します。
    • フィードを拡張して、以前にリリースされていない新しいエンティティ タイプを含めます。
    • 新しい地域でリリースするために、膨大な数の新しいエンティティ / メタデータを含むようにフィードを拡張。
    • フィードを新しいプラットフォーム タイプに拡張。たとえば、本番環境フィードが Google 検索でのみリリースされていて、リリースを Google TV に拡大する場合です。
  • このような場合は、ステージング フィードが必要です。このフィードは、新しいプラットフォームのディープリンクや新しい言語 / 地域のメタデータなど、追加のメタデータが含まれている点を除いて、本番環境フィードのコピーです。
  • 本番環境フィードと同様に、このフィードは広範に分析され、数回繰り返されて、キャプチャされる情報の量とその正確性に関して、より高い品質基準を達成します。品質基準をクリアすると、このフィードが現在の本番環境フィードに置き換わり、新しい本番環境フィードになります。
  • このフィードを使用すると、最初のリリースと追加のリリースを分離し、本番環境フィードに影響を与えることなく、必要なすべてのテストを実行できます。これにより、エンドユーザー エクスペリエンスが中断されることはありません。

上記についてご不明な点がございましたら、Google の担当者にお問い合わせください。

フィード ファイルを作成する

フィードを作成する際は、次のベスト プラクティスに従ってください。

  1. 少数のエンティティを使用してサンプル フィードを作成する

    カタログ内のすべてのコンテンツを含むフィードを作成する前に、少数のエンティティのみを含むサンプル フィードを作成することをおすすめします。フィードの作成中に問題が発生することがあります。エンティティ セットのサイズを制限することで、これらのエラーや警告をより簡単にデバッグできるようになります。

  2. サンプル フィードを検証する

    フィードが仕様に準拠していることを確認するためのツールが用意されています。これらのツールを使用して、サンプル フィードで見つかったすべてのエラーと警告を解決することをおすすめします。

  3. 商品フィードを作成する

    少数のエンティティの構造が適切であることを確認したら、カタログ全体のフィードを作成します。

サンプル フィードを作成する

  1. カタログから代表的なエンティティを 1 つ選択します。適度に複雑な構造を持ち、カタログ内のエンティティとして一般的なエンティティを選択します。
  2. JSON スキーマ検証ツールを使用して、構文エラーや必須プロパティの欠落がないか確認します。(詳しくは次のセクションをご覧ください)。

    1 つの 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 のカタログ プロパティを確認して、検証エラーがないことを確認します。フィード内のエンティティ数とカタログ内のアイテム数を比較して、フィードにカタログ内のすべてのエンティティが含まれていることを確認します。