Play ゲームのアクション
概要
このドキュメントでは、ビデオゲーム向けの Google Play ゲーム アクションについて説明し、スキーマ要件を一覧表示し、この機能でリリースするためのオンボーディング プロセスについて詳しく説明します。
Play ゲーム アクションの概要
ビデオゲームのゲームアクションを使用すると、パソコンやモバイルの検索結果ページ（SRP）から直接ゲームをプレイできます。ユーザーが、1 つ以上の Play ゲーム アクションが関連付けられているゲームを検索すると、整理された検索結果ページ（OSRP）の [概要] タブまたはナレッジパネルに Play ゲーム アクションが表示されます。これは、無料、サブスクリプション、アラカルト購入で利用でき、デスクトップまたはモバイルのクラウドからストリーミングできる、またはデスクトップまたはコンソールのローカル クライアント アプリからダウンロードできるゲームのデモ版またはフルバージョンで機能します。
Play ゲーム アクションは、ゲーム カタログの詳細を含むフィードを使用します。フィードは、エンティティのコレクションを含む JSON オブジェクトです。エンティティは、カタログ内のゲームと、ゲーム（デモ版、インスタント トライアル版、フルバージョン）をストリーミングするための関連ディープリンクを表す schema.org オブジェクトです。
Google がフィードを取得できるように、フィードをファイルに保存し、Google がアクセスできる場所にファイルをホストする必要があります。コンテンツを常に最新の状態にしておくため、Google はホストからフィード ファイルを定期的に取得します。
以降のセクションでは、これらの各要件について詳しく説明します。
始める
前のセクションで説明したように、プロバイダの責任には次のものがあります。
- フィードの作成に必要な情報、その情報源と可用性、フィードに情報が取り込まれる仕組みを理解します。
- カタログ内の各ゲーム エンティティの必要な詳細情報を含むフィードを作成します。
- フィードをサーバーまたはクラウド ストレージ サービスでホストし、Google が定期的にフィードを取得できるようにします。
- Google から指摘された問題に対応し、修正します。品質に関連する問題や、JSON ファイル自体の構造に関連する問題が考えられます。
- カタログが変化するたびにフィードを最新の状態に維持します。
- リリース後もフィードの品質が維持されるようにします。
これらを詳しく見ていきましょう。
始める前に
フィードの作成を開始する前に、Google Play ゲーム アクションのメタデータの要件を理解し、必要な情報をすべて 1 か所にまとめておくことをおすすめします。フィードの作成を開始する前に、次のことを行うことをおすすめします。
VideoGameエンティティのメタデータ要件を確認します。- メタデータを収集します。
- 必須プロパティと強く推奨されるプロパティをよくご確認ください。Google ではこれらのプロパティを使用して、フィードのコンテンツを Google のデータベース内のコンテンツと一致させます。コンテンツに使用するメタデータの量が多いほど、Google がより適切にコンテンツを一致させられるようになります。
このドキュメントでの Works と Editions の使用について
- 作品: 抽象的な概念としてのビデオゲーム。具体的には、タイトル、デベロッパー、ゲームの説明、パブリッシャーなどの作品に帰属するメタデータを指します。
- エディション: ビデオゲームの具体的なバージョン。具体的には、出版年、プラットフォーム名、ディープリンクなどの刊行物に帰属するメタデータを指します。
たとえば、「シャドー オブ ザ トゥームレイダー」は作品ですが、出版された各種のバージョンはエディションです。この場合、作品としての「シャドー オブ ザ トゥームレイダー」には、Stadia 版、PlayStation 版、Stadia の早期アクセス版などのエディションがあります。
この区別は、フィード内ではすぐに見分けられない場合があるため、特に重要です。VideoGame エンティティは 2 つあります。
- VideoGame（Work）は「最上位レベル」の VideoGame エンティティです。
exampleOfWorkは VideoGame（Work）のプロパティであり、VideoGame（Edition）のインスタンスを 1 つ以上指定します。- VideoGame（ワーク）ごとに少なくとも 1 つの
exampleOfWorkVideoGame（エディション）が必要です。 - VideoGame（Edition）は「下位レベル」の VideoGame エンティティです。
1 つの作品に複数のエディションが存在する場合があることを覚えておくと便利です。エディションはできる限りグループ化することをおすすめします。そうすれば、Google のシステムがゲームに関するすべての関連情報を利用し、それを検索結果に表示できます。
2 つの重要なプロパティとその要件を理解します。次のステップであるフィードの作成に進む前に、これらの設定を正しく行うことが重要です。
正規 URL（url）
正規 URL（url）は、Google がカタログ内のコンテンツを Google のデータベース内のコンテンツと正確に一致させるのに役立ちます。
「正規 URL とは、サイトにある一連の重複したページの中で、Google が最も代表的と考えるページの URL です。たとえば、同じページに複数の URL がある場合（例: example.com?dress=1234 と example.com/dresses/1234）、Google はそのうちの 1 つを正規 URL として選択します。」（出典: 重複した URL を統合する）
正規 URL の要件は次のとおりです。
urlはグローバルに一意である必要があります。urlには Google がクロールすることが可能な機能する正規 URL を含める必要があります。
識別子（@id）
ID（@id）は次の要件を満たす必要があります。
- カタログ全体でグローバルに一意:
- たとえば、2 つの異なるゲームに同じ
@idを使用しないでください。
- たとえば、2 つの異なるゲームに同じ
- 静的:
@idは後で変更できません。
- Unified Resource Identifier（URI）の形式:
- コンテンツのローカル識別子（ID）が URI 形式でない場合は、ID の先頭にドメインを追加してこの要件を満たします。たとえば、コンテンツの ID が
1234abcでドメインがhttps://example.comの場合、@idはhttps://example.com/1234abcとなります。 @idが有効な URL である必要はなく、単に URI 形式にする必要があります。@id（たとえばhttps://example.com）で使用するドメインは、自分の組織が所有するドメインでなければなりません。
- コンテンツのローカル識別子（ID）が URI 形式でない場合は、ID の先頭にドメインを追加してこの要件を満たします。たとえば、コンテンツの ID が
エンティティの url は識別子としてのすべての要件（グローバルに一意、静的、URI 形式）を満たしているため、エンティティの url を @id として使用することをおすすめします。
ディープリンクの要件を理解して特定する
ユーザーがコンテンツの Play ゲーム アクションを開始すると、コンテンツのディープリンクに基づいてアプリまたはプラットフォームのコンテンツに直接誘導されます。次の点にご注意ください。
- ディープリンクは、指定されたすべてのプラットフォームで対象のコンテンツを開く必要があります。プラットフォームごとに異なるディープリンクを設定できます。たとえば、パソコンのウェブで機能するディープリンクとモバイルのウェブで機能するディープリンクは異なる場合があります。ゲームごとに、そのディープリンクがプラットフォームによって異なるかどうかを確認します。
- ディープリンクには、パラメータ（&）またはアンカータグ（#）を含めることができます。
- Google の複数のプラットフォーム（検索、アシスタント、Android TV）でコンテンツを確実に利用できるようにするには、ディープリンクが必要です。
エンティティの url は識別子としてのすべての要件（グローバルに一意、静的、URI 形式）を満たしているため、エンティティの url を @id として使用することをおすすめします。
| プラットフォーム | 説明 |
|---|---|
| http://schema.org/DesktopWebPlatform | デスクトップ ウェブブラウザの検索プラットフォーム。 |
| http://schema.org/MobileWebPlatform | モバイル ウェブブラウザの検索プラットフォーム。 |
| http://schema.org/AndroidPlatform | Android アプリの検索プラットフォーム。 |
| http://schema.org/AndroidTVPlatform | Android TV アプリの Android TV プラットフォーム。 |
| http://schema.org/IOSPlatform | iOS アプリの検索プラットフォーム。 |
カタログ内のゲームのアクセス要件を特定します。次の質問に答え、フィードのメタデータで回答を特定する方法があることを確認します。
- ユーザーがコンテンツにアクセスするには、アプリやプラットフォームにログインする必要があるか。
- 有料会員登録は必要か。
- ゲームをプレイするために購入が必要ですか？
- アクセス要件は時間とともに変化するか。
- アクセス要件はデバイスの地域によって異なるか。
ユーザーが購入できる定期購入パッケージを複数提供している場合は、commonTier と、それが Google との統合にどのように適用されるかを理解してください。
ペイウォールの種類
現在、Play Game Actions でサポートされているペイウォール タイプは次のとおりです。
| カテゴリの値 | ペイウォールの種類 |
|---|---|
nologinrequired |
購入やログインは必要ありません。 |
free |
ユーザーはログインする必要がありますが、有料会員登録は不要です。 |
subscription
|
お客様は有効な定期購入を利用している必要があります。アクセスはサブスクリプション ティアとは無関係です。 |
subscription
|
お客様は有効な定期購入を利用している必要があります。アクセスはサブスクリプション ティアとは無関係です。 |
purchase |
コンテンツは購入後、無期限に利用できます。 |
rental |
コンテンツは購入後、一定期間利用できます。 |
これらのカテゴリ値は、後でフィードを作成するときに使用されます。また、上記の表の rental カテゴリは現時点では完全に省略可能ですが、今後のプロダクトの機能強化でサポートされる可能性があります。現在、フィードの商品で活用されるカテゴリ値は free、nologinrequired、subscription、purchase のみです。
最後に、サンプル フィードを簡単に確認して、最終的にどのような結果を得たいのかを把握します。
上記を理解し、回答（これらの質問に対する）を表すメタデータがフィード作成段階に進むのに十分であることを確認します。
フィードを作成する
Play ゲーム アクション フィードは、カタログ内のビデオゲームを表すエンティティのコレクションを含む JSON オブジェクトです。Google で定期的に取得するには、フィードを 1 つまたは複数のファイルとして提供し、それをサーバーまたはクラウド ストレージ サービス上でホストする必要があります。
フィード ファイルのサイズ、量、形式の要件を守る
次の要件を遵守する必要があります。
- すべてのフィード ファイルのファイル拡張子は
.jsonでなければなりません。 - ファイル名にスペースが含まれていないことを確認します。
- フィード ファイルは暗号化しません。
- フィード ファイルを UTF-8 でエンコードします（ファイル エディタの設定を確認してください）。
- フィード ファイルが（未圧縮で）1 GB より大きい場合は、ファイルを複数のファイルに分割します。
- ファイルサイズが 1 GB 未満である限り、1 つのファイルに含めることができるエンティティの数や、フィードの送信の一部として Google に送信するファイルの数に制限はありません。
- JSON 仕様に従って、ファイルが BOM なしでエンコードされていることを確認します。Linux OS でこれを検証するには、
hexdump file.json | head -n 1がアドレス0x00のBBEFで始まってはなりません。
フィード コンテンツの要件に従う
次のコンテンツ要件を遵守する必要があります。
- フィードに最新でないエンティティを含めてはなりません。最新ではないエンティティとは、ディープリンクの
availabilityEndsが過去の日付に設定されているエンティティ、またはサイトで参照できなくなったエンティティです。 - フィード内のすべてのディープリンク（
urlTemplateなど）とすべての URL（urlなど）は本番環境の URL でなければなりません。QA 環境、開発環境、またはその他の本番以外の環境の URL は使用しないでください。 - 前のセクションで説明したように、すべての URL（
urlなど）は正規 URL でなければなりません。 - フィード内の各エンティティでは、次のプロパティを指定する必要があります。
- 一意の ID:
@id - 一意の URL:
url - 一意のディープリンク:
urlTemplate
- 一意の ID:
フィードを作成する際は、次の点に注意してください。
- フィードの構造を詳しく理解します。
- サンプル フィードから始めます。
- カタログから最大 5 つの代表的なエンティティを選択します。構造が適度に複雑で、カタログ内のエンティティとして一般的なエンティティを選択し、そのエンティティのフィードを作成します。
- 割り当てられた Google 担当者に送信して、迅速な検証を依頼します。
- サンプル フィードのすべてのエラーを解決したら、カタログ内のすべてのエンティティを含むようにフィードを拡張します。
- フィードにカタログ内のすべてのエンティティが含まれていることを確認するには、フィード内のエンティティ数とカタログ内のアイテム数を比較します。
フィードをホストする
フィード ファイルの準備ができたら、それを安全な場所でホストします。そうすれば、Google は、定期的にフィードを取得して、コンテンツが最新のものであることを確認します。次のホスティング方法がサポートされています。
| ホスティング方法 | 認証サポート |
|---|---|
| Google Cloud Storage | 088794101-100000002-account@partnercontent.gserviceaccount.com にストレージ オブジェクト閲覧者の権限を付与する |
| HTTPS | ユーザー名 + パスワードまたは HTTP クライアント証明書を共有する必要があります。 |
| SFTP | パスワード、キー + フレーズ、またはその両方を共有する必要があります。 |
| AWS S3 | AWS S3 バケットのキー ID とアクセスキーを共有する必要があります。 |
フィード ファイルをホストシステムにアップロードしたら、Play ゲーム アクション チームに連絡してフィード ファイルの確認を依頼します。
審査を受けるためにフィードを送信する
フィード ファイルをホストしたら、割り当てられた Play ゲーム アクションの担当者に連絡して、フィードの審査プロセスを開始します。この連絡で、以下の情報を必ず共有してください。
- 概要/説明: サンプル フィードと本番環境の完全なフィードのどちらを共有するかをお知らせください。サンプル フィードを共有する場合は、可能な限り、本番環境フィードの ETA をお知らせください。
- ホストの場所: フィード ファイルの URL。
- ホスト認証: 必要に応じて、Google がホストからフィード ファイルを取得できるように、認証資格情報を提供します。詳しくは、フィードをホストするをご覧ください。
- テスト アカウント: Play ゲーム アクション チームがアプリまたはプラットフォーム上のディープリンクにアクセスしてテストを実施するための、テスト用アカウント。複数のプラットフォーム上にエンティティを持つフィードの場合は、プラットフォームごとにテスト アカウントを提供します。
- Icons: 次の 5 つのアイコンを送信します。これらのアイコンは、検索の Google Play ゲーム アクションの横で使用されます。
| カテゴリ | サイズ（ピクセル） | ファイルサイズ | ガイドライン |
|---|---|---|---|
| 検索、キャスト、その他の場所でゲーム アクションを再生する | |||
| 16x16 | 112x112 ピクセルを除くすべてのアイコンのファイルサイズは、1 KB 以下とする必要があります。 112x112 ピクセルのアイコンのファイルサイズは、3 KB 以下とする必要があります。 |
5 つのアイコンのサイズはすべて必須です。 画像は次の要件を満たしている必要があります。
|
|
| 20×20 | |||
| 40x40 | |||
| 44x44 | |||
| 112x112 |
サンプル
フィードの検証の仕組み
フィードの検証には次の 2 つの段階があります。
- 構造の検証:
- これは検証チェックの最初のフェーズです。
- Google は、JSON ファイルの構造に関するフィードバックを提供します。JSON の形式は正しいですか？フィードにすべての必須プロパティと強く推奨されるプロパティが含まれているか。ディープリンクは、フィード要件に沿って提供され、アノテーションが付けられていますか？
- このフェーズでは、Google との間で何度かやり取りを行い、すべてのフィードバックに対応するまで続けます。
- メタデータの調整:
- このプロセスは、フィードが構造検証フェーズを通過した後にのみ開始されます。この時点で、Google は Google のナレッジグラフとの調整プロセスを開始します。
- このフェーズでは、フィードに含まれるメタデータに関するフィードバックを提供します。リリースを成功させるには、すべての問題に対処する必要があります。たとえば、このフェーズのフィードバックでは、ゲームのタイトルやリリース日の修正が求められることがあります。
- このフェーズでは、Google とのやり取りが複数回必要となり、すべてのフィードバックに対応するまで続きます。
フィードの承認基準
すべてのブロックの問題が解決され、Google がメタデータの品質がリリース基準に達していることを認定した場合、フィードはリリース可能と見なされます。
必要に応じてフィードを更新する
書籍の目録を変更する頻度にもよりますが、フィードは毎日更新することをおすすめします。以下の条件とヒントを参考にしてください。
- Google 検索はリアルタイムでの更新をサポートしていません。
- Google 検索は 1 日に 1 回フィードを取得し、通常 2 日以内にコンテンツをインデックスに登録します（リリース時）。
- ディープリンクを提供できる時期に変更が見込まれる場合は、
availabilityStartsとavailabilityEndsを使用して正確な日付を設定します。 - エンティティがカタログで利用できなくなった場合は、フィードからエンティティを完全に削除します。
リファレンス
フィードの構造の概要
Play Game Actions フィードの構造は次のとおりです。
データフィード エンベロープ
データフィード エンベロープは、Google Play ゲーム アクション フィードの最上位オブジェクトです。このオブジェクトには、カタログ内のすべてのゲームを表すコンテンツ マークアップ オブジェクト（VideoGame（Work）エンティティ）の配列が含まれます。
| プロパティ | タイプ | 説明 |
|---|---|---|
@context |
URL | 必須。http://schema.org に設定 |
@type |
テキスト | 必須。DataFeed に設定します。 |
dateModified |
DateTime | 必須。フィードの最終更新日時。ISO 8601 形式で指定します（タイムゾーンを含む）。 |
dataFeedElement |
Thing | 必須。ゲーム カタログのエンティティ。 |
テンプレート
{ "@context": "http://schema.org", "@type": "DataFeed", "dateModified": "2018-07-20T00:44:51Z", "dataFeedElement": [ {}, { }, { }, ... ] }
コンテンツ マークアップ オブジェクト
コンテンツ マークアップ オブジェクトは、カタログ内の単一のエンティティ（VideoGame（Work））を表します。このオブジェクトにはコンテンツの識別子と正規 URL が含まれており、メタデータによってコンテンツの補足情報を付けることができます。VideoGame（Work）のコンテンツ マークアップ オブジェクトには、VideoGame（Edition）オブジェクトにリンクするための exampleOfWork というプロパティがあります。この VideoGame（Edition）には、アクション マークアップ オブジェクトの配列を含めることができます。これにより、コンテンツを複数のアクション マークアップ オブジェクトに関連付けることができます。たとえば、地域ごとに異なるアクション マークアップ オブジェクトを指定できます。
アクション マークアップ オブジェクト
アクション マークアップ オブジェクトには、ユーザーをゲームに誘導するディープリンクと、ゲームに必要なアクセスレベルを記述します。このオブジェクトは、コンテンツ マークアップ オブジェクトのプロパティ（potentialAction）です。ゲーム アクションの場合は、アクション アクセス指定オブジェクトを使用してアクセス制限を指定します。
| プロパティ | タイプ | 説明 |
|---|---|---|
@type |
テキスト | 必須。常に PlayGameAction に設定。 |
gameAvailabilityType |
GameAvailabilityEnumeration または Text | 必須。このアクションに関連付けられているゲーム コンテンツの利用可能タイプ（フルバージョンかデモかなど）を示します。指定できる値は DEMO と FULL です。 |
additionalType |
テキスト | 必須。このゲームに関連付けられた再生アクションのタイプを示します。指定できる値は次のとおりです。
|
target |
EntryPoint | 必須。ディープリンクをさまざまな Google プラットフォームにマッピングするためのターゲット オブジェクト。 |
target.@type |
テキスト | 必須。常に EntryPoint に設定。 |
target.urlTemplate |
URL | 必須。アプリやプラットフォームにユーザーを誘導し、ゲームの再生を開始するためのディープリンク。 |
target.inLanguage |
テキスト | （省略可）シリーズの元の言語（BCP 47 形式）。 |
target.actionPlatform |
テキスト | 必須。urlTemplate にマッピングされるプラットフォーム。Play Game Actions は次の値をサポートしています。
要件については、プラットフォーム タイプをご覧ください。 |
actionAccessibilityRequirement |
ActionAccessSpecification | 必須。コンテンツのアクセス要件を説明するアクション アクセス指定オブジェクト。詳細については、アクション アクセス指定オブジェクトをご覧ください。 |
テンプレート
"potentialAction": { "@type": "PlayGameAction", "target": [ {}, { } ], "actionAccessibilityRequirement": [ { }, { } ] }
ターゲット
ターゲット オブジェクトは、各種 Google プラットフォームへのディープリンクのマッピングを提供します。このオブジェクトは、アクション マークアップ オブジェクトのプロパティ（target）です。urlTemplate プロパティはディープリンクを取得し、actionPlatform はディープリンクをサポートするプラットフォームを取得します。
例
"target": [ { "@type": "EntryPoint", "urlTemplate": "http://www.example.com/game007?autoplay=true", "actionPlatform": [ "http://schema.org/DesktopWebPlatform", "http://schema.org/AndroidPlatform", "http://schema.org/AndroidTVPlatform", "http://schema.org/IOSPlatform" ] }, { "@type": "EntryPoint", "urlTemplate": "http://www.example.com/mobile/game007?autoplay=true", "actionPlatform": [ "http://schema.org/MobileWebPlatform" ] } ]
アクション アクセス指定
アクション アクセス指定オブジェクトには、地域と期間に基づくコンテンツのアクセス要件を記述します。このオブジェクトは、アクション マークアップ オブジェクトのプロパティ actionAccessibilityRequirement です。
2 つのディープリンクを持つターゲットの例
"target": [ { "@type": "EntryPoint", "urlTemplate": "http://www.example.com/game007?autoplay=true", "actionPlatform": [ "http://schema.org/DesktopWebPlatform", "http://schema.org/AndroidPlatform", "http://schema.org/AndroidTVPlatform", "http://schema.org/IOSPlatform" ] }, { "@type": "EntryPoint", "urlTemplate": "http://www.example.com/mobile/game007?autoplay=true", "actionPlatform": [ "http://schema.org/MobileWebPlatform" ] } ]
アクション アクセス指定
アクション アクセス指定オブジェクトには、地域と期間に基づくコンテンツのアクセス要件を記述します。このオブジェクトは、アクション マークアップ オブジェクトのプロパティ actionAccessibilityRequirement です。
| プロパティ | タイプ | 説明 | |||
|---|---|---|---|---|---|
actionAccessibilityRequirement.@type |
テキスト | 必須。常に ActionAccessSpecification に設定。 |
|||
actionAccessibilityRequirement.category |
テキスト | 必須。コンテンツのアクセス要件。使用できる値と詳細については、ペイウォール タイプをご覧ください。 一群のコンテンツを表すエンティティの場合は、最も制限の緩やかなコンテンツ アクセス要件をカテゴリに設定する必要があります。たとえば、ゲームが |
|||
actionAccessibilityRequirement.availabilityStarts |
日付 | 必須。アクションが使用可能になる ISO 8601 形式（タイムゾーンを含む）の日付。将来の日付も設定できます。
対応するエンティティは、 |
|||
actionAccessibilityRequirement.availabilityEnds |
日付 | 必須。アクションが使用不可になる ISO 8601 形式（タイムゾーンを含む）の日付。将来の日付も設定できます。
|
|||
actionAccessibilityRequirement.eligibleRegion |
Country、City、State、GeoShape、または Text | 必須。コンテンツが利用可能な地域。コンテンツがグローバルに利用可能な場合は、特殊文字列 EARTH を使用します。必要な内容については、GeoShape プロパティをご覧ください。 |
|||
actionAccessibilityRequirement.ineligibleRegion |
Country、City、State、GeoShape、または Text | 該当する場合は必須。コンテンツが制限されている地域。eligibleRegion 内のどこでもコンテンツが利用可能である場合は、このプロパティは不要です。必要な内容については、GeoShape プロパティをご覧ください。 |
|||
actionAccessibilityRequirement.requiresSubscription |
MediaSubscription | 該当する場合は必須。コンテンツにアクセスするためにユーザーに必要となる有料会員登録の詳細。詳しくは、メディアの有料会員登録プロパティをご覧ください。
|
|||
actionAccessibilityRequirement.expectsAcceptanceOf |
特典 | コンテンツの購入が必要な場合は必須。コンテンツに関連付けられた特典の詳細。以下の場合の価格情報を指定します。
価格が 0.00 の場合は、Offer オブジェクトを完全に削除し、 |
|||
メディア サブスクリプションの仕様
メディア サブスクリプション オブジェクトには、コンテンツに必要なサブスクリプションの詳細を記述します。このオブジェクトは、アクション アクセス指定オブジェクトのプロパティ requiresSubscription です。
actionAccessibilityRequirement.category が subscription で、定期購入プランに複数のパッケージや階層が含まれている場合、またはアドオンのサポートがある場合は、この設定が必要です。サブスクリプションが 1 つの階層で、カタログ内のすべてのコンテンツにアクセスできる場合は、このフィールドを省略します。| プロパティ | タイプ | 説明 | |||
|---|---|---|---|---|---|
requiresSubscription.@type |
テキスト | 必須。常に MediaSubscription に設定。 |
|||
requiresSubscription.@id |
URL | 必須。定期購入の一意の ID。異なる複数の有料会員登録からアクセス可能なコンテンツの場合は、個々の有料会員登録に一意の ID が必要です。 | |||
requiresSubscription.name |
テキスト | 必須。サブスクリプションの名前。 次の点に注意してください。
|
|||
requiresSubscription.sameAs |
URL | （省略可）有料会員登録を説明するページ。 | |||
requiresSubscription.identifier |
テキスト | category が subscription で、commonTier が false の場合は必須です。メディア カタログにあるコンテンツ グループへのアクセス権を表す、この定期購入に固有の文字列。
|
|||
requiresSubscription.commonTier |
ブール値 | カテゴリが定期購入に設定されている場合は必須。commonTier の詳細については、共通の階層要件のドキュメントをご覧ください。 |
|||
特典のプロパティ
オファー オブジェクトには、コンテンツに関連付けられた価格を記述します。このオブジェクトは、アクション アクセス指定オブジェクトのプロパティ（expectsAcceptanceOf）です。次の 2 つの目的で使用できます。
- ゲームの購入の詳細を提供するため。このユースケースでは、
actionAccessibilityRequirement.categoryをpurchaseに設定する必要があります。 - ゲームがセール中の場合に、ゲームの購入詳細を提供します。このユースケースでは
actionAccessibilityRequirement.categoryをpurchaseに設定し、アクションごとに 2 つのオファー（1 つは正規価格の詳細を提供するためのもの、もう 1 つはセール価格の詳細を提供するためのもの）を指定する必要があります。
| プロパティ | タイプ | 説明 |
|---|---|---|
expectsAcceptanceOf.@type |
テキスト | 必須 - 常に Offer に設定します。 |
expectsAcceptanceOf.name |
テキスト | 省略可 - オファーの名前。 |
expectsAcceptanceOf.priceSpecification |
PriceSpecification | 必須 - ゲームに関連付けられた料金の詳細。 |
expectsAcceptanceOf.priceSpecification.@type |
テキスト | 必須 - 常に UnitPriceSpecification に設定します。 |
expectsAcceptanceOf.priceSpecification.price |
数値 | 必須 - コンテンツの購入価格。価格は 0 以外の正の値にする必要があります。価格が 0.00 のゲームの場合は、actionAccessibilityRequirement.category を `free` に設定してください。 |
expectsAcceptanceOf.priceSpecification.priceCurrency |
テキスト | 必須 - 価格の通貨（3 文字の ISO 4217 形式）。 |
expectsAcceptanceOf.priceSpecification.priceType |
PriceTypeEnumeration または Text | 該当する場合は必須 - 特典で提供される価格のタイプ。actionAccessibilityRequirement.category
が purchase に設定されている場合、これは必須プロパティであり、
セール価格の詳細を指定する場合は、 https://schema.org/ListPrice と https://schema.org/SalePrice の両方が必要です。 |
expectsAcceptanceOf.seller |
組織 | コンテンツの購入を提供する組織。 |
expectsAcceptanceOf.seller.@type |
テキスト | 常に Organization に設定します。 |
expectsAcceptanceOf.seller.name |
テキスト | 販売者の名前。 |
expectsAcceptanceOf.seller.sameAs |
URL | 販売者を識別するウェブページの URL（販売者のホームページなど）。 |
サポートされているペイウォール タイプごとに、以下の例で actionAccessibilityObject の作成方法を確認できます。
無料（ログイン不要）
{ "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "nologinrequired", "availabilityStarts": "2015-01-01T00:00Z", "availabilityEnds": "2015-12-31T00:00Z", "eligibleRegion": { "@type": "Country", "name": "US" } } }
無料（ログイン不要、1 時間のトライアルのみ）
{ "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "nologinrequired", "availabilityStarts": "2015-01-01T00:00Z", "availabilityEnds": "2015-12-31T00:00Z", "eligibleRegion": { "@type": "Country", "name": "US" } "expectsAcceptanceOf": { "@type": "Offer", "eligibleDuration": 60 } } }
無料（ログインが必要）
{ "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "free", "availabilityStarts": "2015-01-01T00:00Z", "availabilityEnds": "2015-12-31T00:00Z", "eligibleRegion": { "@type": "Country", "name": "US" } } }
セール中の 1 回限りの購入
{ "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "purchase", "availabilityStarts": "2015-01-01T00:00Z", "availabilityEnds": "2015-12-31T00:00Z", "eligibleRegion": { "@type": "Country", "name": "US" }, "expectsAcceptanceOf": [ { "@type": "Offer", "name": "Original Price", "priceSpecification": { "@type": "UnitPriceSpecification", "price": 7.99 "priceCurrency": "USD" "priceType": "https://schema.org/ListPrice" }, "seller": { "@type": "Organization", "name": "Example", "sameAs": "http://www.example.com/" } }, { "@type": "Offer", "name": "Sale Price", "priceSpecification": { "@type": "UnitPriceSpecification", "price": 4.99 "priceCurrency": "USD" "priceType": "https://schema.org/SalePrice" }, "seller": { "@type": "Organization", "name": "Example", "sameAs": "http://www.example.com/" } } ] } }
1 回だけの購入
{ "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "purchase", "availabilityStarts": "2015-01-01T00:00Z", "availabilityEnds": "2015-12-31T00:00Z", "eligibleRegion": { "@type": "Country", "name": "US" }, "expectsAcceptanceOf": { "@type": "Offer", "price": 7.99, "priceCurrency": "USD", "seller": { "@type": "Organization", "name": "Example", "sameAs": "http://www.example.com/" } } } }
単一レベル/複数レベル/アドオンの定期購入
{ "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "subscription", "availabilityStarts": "2015-01-01T00:00Z", "availabilityEnds": "2015-12-31T00:00Z", "requiresSubscription": { "@type": "MediaSubscription", "name": "Example Package", "commonTier": true, "@id": "http://www.example.com/example_package" }, "eligibleRegion": { "@type": "Country", "name": "US" } } }
階層型定期購入とアドオン
以下に、階層型定期購入とアドオンの適用方法について説明します。
- 単一階層のサブスクリプション モデルでは、サービス プロバイダが 1 つのサブスクリプション階層を用意します。サブスクリプション パッケージに関係なく、すべての定期購入者が同じコンテンツにアクセスできます。
- 階層型サブスクリプション モデルでは、サービス プロバイダが複数のサブスクリプション階層（ゴールド、シルバー、ブロンズなど）を用意します。上位階層のサブスクリプションを持つユーザーは、その下位階層のすべてのコンテンツにアクセスできます。ただし、下位階層のサブスクリプションを持つユーザーは、上位階層のコンテンツにアクセスできません。
- アドオンのサブスクリプション モデルでは、ユーザーが利用資格を拡張して基本サブスクリプションにコンテンツを追加できる仕組みをサービス プロバイダが用意します。ユーザーはコンテンツを必要なだけ追加できます。
エンティティの全体的なテンプレート
エンティティの全体的なテンプレートの例を次に示します。
テンプレート
{ "@context": "http://schema.org", "@type": "DataFeed", "dateModified": "2018-07-20T00:44:51Z", "dataFeedElement": [ {}, { "@context": ["http://schema.org", {"@language": "en"}], "@type": "VideoGame", "@id": "http://www.example.com/game007", "url": "http://www.example.com/game007", "name": "Games Bond 007", "exampleOfWork": [ { }, { "@type": "VideoGame", "@id": "http://www.example.com/game007Stadia", "url": "http://www.example.com/game007Stadia", "name": "Games Bond 007", // Other properties "potentialAction": [ { }, { "@type": "PlayGameAction", "target": [ { }, { } ], "actionAccessibilityRequirement": [ { }, { } ] } ], ... } ] }
構造化データタイプの定義
このセクションでは、VideoGame エンティティ タイプのコンテンツ マークアップ プロパティについて詳しく説明します。コンテンツが検索結果に表示されるようにするには、下記の一覧に示す必須プロパティを含める必要があります。また、推奨プロパティを使用すると、コンテンツについてさらに詳しい情報を追加できるため、ユーザー エクスペリエンスの向上につながり、Google のナレッジグラフとのエンティティの照合にも役立ちます。
VideoGame（Work）の仕様表
| プロパティ | タイプ | 説明 | |||
|---|---|---|---|---|---|
@context |
テキスト | 必須。常に ["http://schema.org", {"@language": "xx"}] に設定します。
|
|||
@type |
テキスト | 必須。常に VideoGame に設定。 |
|||
@id |
URL | 必須。URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc.
@id は次の要件を満たす必要があります。
エンティティの |
|||
url |
URL | 必須。Google がフィード内のコンテンツを Google のデータベース内のコンテンツと照合するために使用するコンテンツの正規 URL。url は、次の要件を満たしている必要があります。
再生のディープリンクについては、代わりに、ターゲット オブジェクトの |
|||
name |
テキスト | ゲームの名前。
|
|||
description |
テキスト | 強く推奨します。ゲームのあらすじ。300 文字以内。
|
|||
genre |
テキスト | 関連するすべてのジャンルの順序付きリスト。例: ["Action", "Role playing"] |
|||
image |
ImageObject | 強く推奨します。ゲームに関連する画像。image に含める必須プロパティと省略可能なプロパティの詳細については、画像のプロパティをご覧ください。 |
|||
applicationCategory |
テキスト | 省略可。ソフトウェア アプリケーションの種類。値を Game に設定します。 |
|||
exampleOfWork |
VideoGame | 必須 VideoGame のエディション。この VideoGame（エディション）エンティティには、ディープリンクの詳細も含まれます。詳しくは、VideoGame（Edition）の仕様表をご覧ください。 |
|||
playMode |
Text または GamePlayMode | （省略可）このゲームがマルチプレーヤー、協力プレイ、シングル プレーヤーのいずれであるかを示します。ゲームは、マルチプレーヤー、協力プレイ、シングル プレーヤーとして同時にマークできます。次の値を受け入れます。
|
|||
VideoGame（Edition）の仕様表
| プロパティ | タイプ | 説明 | |||
|---|---|---|---|---|---|
@type |
テキスト | 必須。常に VideoGame に設定。 |
|||
@id |
URL | 必須。URI 形式のコンテンツの識別子。たとえば、https://example.com/1234abc.@id は次の要件を満たす必要があります。
エンティティの |
|||
url |
URL | 必須。Google がフィード内のコンテンツを Google のデータベース内のコンテンツと照合するために使用するコンテンツの正規 URL。url は、次の要件を満たしている必要があります。
再生のディープリンクについては、代わりに、ターゲット オブジェクトの |
|||
name |
テキスト | ゲームの名前。
|
|||
description |
テキスト | 強く推奨します。ゲームのあらすじ。300 文字以内。
|
|||
genre |
テキスト | 関連するすべてのジャンルの順序付きリスト。例: ["Action", "Role playing"] |
|||
image |
ImageObject | 強く推奨します。ゲームに関連する画像。image に含める必須プロパティと省略可能なプロパティの詳細については、画像のプロパティをご覧ください。 |
|||
applicationCategory |
テキスト | 省略可。ソフトウェア アプリケーションの種類。値を Game に設定します。 |
|||
playMode |
Text または GamePlayMode | （省略可）このゲームがマルチプレーヤー、協力プレイ、シングル プレーヤーのいずれであるかを示します。ゲームは、マルチプレーヤー、協力プレイ、シングル プレーヤーとして同時にマークできます。次の値を受け入れます。
|
|||
potentialAction |
PlayGameAction |
該当する場合は必須。アクションの詳細を提供するアクション マークアップ オブジェクト。 配列を使用して、複数の地域の異なるディープリンクを指定します。詳細については、複数の地域と言語の例をご覧ください。 |
|||
gameEdition |
テキスト |
必須。このゲームのエディション。 たとえば、人気ゲーム「シャドウ オブ ザ トゥームレイダー」には、「クロフト エディション」、「スタンダード エディション」、「デジタル デラックス エディション」、「アルティメット エディション」の 4 つのエディションがあります。 |
|||
gamePlatform |
テキスト | 必須。ビデオゲームのプレイに使用されるプラットフォームまたは電子システム。 | |||
releasedEvent |
PublicationEvent | 強く推奨します。PublicationEvent は、パブリッシャーによるコンテンツのオリジナル（グローバルまたはローカル）リリースを指定するために使用されます。 |
|||
releasedEvent.@type |
テキスト | 必須。このプロパティは常に PublicationEvent に設定してください。 |
|||
releasedEvent.Location |
国 | 必須。このリリース イベントに関連付けられている地域。 国には ISO 3166 コードを使用します。世界中のすべての場所を示すには、 |
|||
releasedEvent.startDate |
Date または Time | （推奨）ExclusiveEvent では必須です。エンティティの公開開始日。 |
|||
releasedEvent.endDate |
Date または Time | （省略可）これは、コンテンツの権利が期限切れになる日付を表します。 | |||
releasedEvent.publishedBy |
Organization または Person | （省略可）このエンティティを公開した組織または個人。 | |||
contentRating |
テキスト | 成人向けゲームでは必須、それ以外では強く推奨。コンテンツの総合的なレーティング。
コンテンツのレーティングがテキスト文字列の形式で提供された場合は、次の 2 つのバリエーションが認められます。
|
|||
publisher |
Organization または Person | （省略可）このエンティティを公開した組織または個人。 | |||
contributor |
Organization または Person | （省略可）このエンティティの副投稿者。 | |||
画像の仕様表
Play Game Actions の再利用では、Media Actions スキーマを使用して画像要件をキャプチャします。詳細については、画像スキーマの仕様をご覧ください。
注意が必要なその他の要件を以下に示します。
アスペクト比と contentAttributes |
最小解像度（ピクセル単位） |
|---|---|
| 16:9、象徴的なポスター | 3840×2160 |
| 2:3、象徴的なポスター | 1000x1500 |
| 4:3、象徴的なポスター | 800Ｘ600 |
| 1:1、象徴的なポスター | 600x600 |
| 3:4、象徴的なポスター | 600x800 |
| 16:9、象徴的な背景 [推奨] または sceneStill | 3840×2160 |
| 2:3、象徴的な背景 [推奨] または sceneStill | 1000x1500 |
| 3:4、象徴的な背景 [推奨]、または sceneStill | 600x800 |
形式の要件
画像サイズや品質などに関するフォーマットの要件は次のとおりです。
- ゲームの最高解像度のポスターと
sceneStillsを含めます。 - 画像は JPG、PNG、WebP のいずれかの形式にする必要があります。
- 画像の URL は、クロール可能でインデックス登録できる必要があります。
- ファイルサイズは 20 MB を超えないようにしてください。
smallFormatとlargeFormatの両方で機能する画像が望ましいです。-
次のような画像は使用できません。
- ぼやけた画像、モザイクのかかった画像、回転した画像、低品質の画像。
- 使用許可を受けていない画像、またはストックフォト。
- ヌード。
- 不正なコンテンツ。
- 上記の表に記載されているサイズ以外にも、画像サイズを含めることができます。
例
以降のセクションでは、さまざまなシナリオのサンプル フィードの例を紹介します。
VideoGame エンティティが 1 つ含まれるフィードの例
「Space Wars Made Up Game」ゲームを表す VideoGame エンティティの例を次に示します。このエンティティは、Google に表示されるように、JSON ファイルのデータフィード エンベロープで囲む必要があります。
{ "@context": ["http://schema.org", {"@language": "en"}], "@type":"DataFeed", "dateModified":"2021-07-20T00:44:51Z", "dataFeedElement":[ { "@context": ["http://schema.org", {"@language": "en"}], "@id":"https://www.examplegame.com/VideoGame007", "@type":"VideoGame", "url":"https://www.examplegame.com/games/VideoGame007", "name":"Space Wars Made Up Game", "description":"Space Wars offers an immersive RPG experience coupled with realistic gameplay.", "genre":[ "Role playing" ], "applicationCategory":"Game", "publisher":{ "name":"Made Up Media", "@id":"https://www.examplegame.com/uniuqe-id-org", "@type":"Organization" }, "contributor":[ { "roleName":"developer", "name":"Alpha Labs Man Made Studio", "@id":"https://www.studionice.com/uniuqe-id-alpha", "@type":"Organization" } ], "playMode":[ "SINGLE_PLAYER", "LOCAL_MULTI_PLAYER", "ONLINE_MULTI_PLAYER", "LOCAL_COOP", "ONLINE_COOP" ], "image":[ { "@context":"http://schema.org", "@type":"ImageObject", "name":"keyart_1X1_3X", "contentUrl":"https://lh3.googleusercontent.com/ept4", "copyrightHolder":{ "@type":"Organization", "name":"Studio Nice" }, "additionalProperty":[ { "@type":"PropertyValue", "name":"contentAttributes", "value":[ "SMALLFORMAT", "LARGEFORMAT", "SCENESTILL", "CENTERED", "NOTITLE", "NOLOGO" ] } ] } ], "exampleOfWork":{ "@id":"https://www.examplegame.com/VideoGame007/version/v3", "name":"Space Wars Made Up Game", "description":"Space Wars offers an immersive RPG experience coupled with realistic gameplay.", "gameEdition":"Early Access", "url":"https://www.examplegame.com/VideoGame007/version/v3/stream", "contentRating":[ "Entertainment Software Rating Board Mature", "Pan European Game Information 12", "Unterhaltungssoftware Selbstkontrolle Video Game Rating System USK 12" ], "applicationCategory":"Game", "releasedEvent":[ { "@type":"PublicationEvent", "startDate":"2020-11-30", "location":{ "@type":"Country", "name":"US" } } ], "potentialAction":{ "@type":"PlayGameAction", "gameAvailabilityType":"DEMO", "target":[ { "@type":"EntryPoint", "urlTemplate":"https://www.examplegame.com/VideoGame007/play", "actionPlatform":[ "http://schema.org/DesktopWebPlatform", "http://schema.org/MobileWebPlatform", "http://schema.org/AndroidPlatform", "http://schema.org/AndroidTVPlatform", "http://schema.org/IOSPlatform" ] } ], "actionAccessibilityRequirement":[ { "@type":"ActionAccessSpecification", "availabilityStarts": "2015-01-01T00:00Z", "availabilityEnds": "2015-12-31T00:00Z", "eligibleRegion":{ "@type":"Country", "name":[ "US" ] }, "category":"subscription", "requiresSubscription":{ "@type":"MediaSubscription", "name":"", "@id":"" } } ], }, "gamePlatform": "Google Stadia", "publisher":{ "name":"Made Up Media", "@id":"https://www.examplegame.com/uniuqe-id-org", "@type":"Organization" }, "contributor":[ { "roleName":"developer", "name":"Alpha Labs Man Made Studio", "@id":"https://www.studionice.com/uniuqe-id-alpha", "@type":"Organization" } ] } } ] }
2 人のゲーム キャラクターが描かれたサンプル画像を表す
{ "@context": [ "http://schema.org", { "@language": "en" } ], "@type": "VideoGame", "@id": "http://www.examplegame.com/videoGame1", "url": "http://www.examplegame.com/videoGame1", ..., "image": { "@context": "http://schema.org", "@type": "ImageObject", "name": "Mauren and Lord Wingflap!", "Keywords": "Mauren, Lord Wingflap the Destroyer", "contentUrl": "http://example.com/images/mountain-view.jpg", "character": [ { "@type": "Person", "name": "Mauren" }, { "@type": "Person", "name": "Lord Wingflap the Destoyer" } ], "copyrightHolder": { "@type": "Organization", "name": " ExampleOrganization Studios, Inc." }, "inLanguage": "en-US", "audience": { "@type": "Audience", "geographicArea": [{"@type": "Country", "name": "US"}, {"@type": "Country", "name": "GB"}] }, "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": [ "iconic", "background", "rightCentered", "noTitle", "noLogo", "noCopyright", "noMatte", "smallFormat", "largeFormat"] } ] } }
複数の地域と言語への対応（国際化）
VideoGame エンティティは、複数の地域と言語で利用できます。
{ "@context": ["http://schema.org", {"@language": "en"}], "@type": "VideoGame", "@id": "http://www.example.com/my_favorite_game", "url": "http://www.example.com/my_favorite_game", "name": [ { "@language": "en-us", "@value": "My Favorite Game" }, { "@language": "es-mx", "@value": "mi juego favorito" }, { "@language": "ja-jp", "@value": "私のfavourite game" } ], "description": [ { "@language": "en-us", "@value": "Jenny meets Paul." }, { "@language": "es-mx", "@value": "Jenny conoce a paul." }, { "@language": "ja-jp", "@value": "PaulとJennyが会う。" } ], "potentialAction": [ { "@type": "PlayGameAction", "gameAvailabilityType": "DEMO", "additionalType": "DownloadPlayAction", "target": { "@type": "EntryPoint", "urlTemplate": "http://www.example.com/my_favorite_game?autoplay=true", "actionPlatform": [ "http://schema.org/DesktopWebPlatform", "http://schema.org/MobileWebPlatform" ] } "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "purchase", "availabilityStarts": "2021-06-24T11:00:00Z", "availabilityEnds": "2041-06-24T11:00:00Z", "eligibleRegion": [ { "@type": "Country", "name": "US" }, { "@type": "Country", "name": "MX" } ] }, "additionalProperty": [ { "@type": "PropertyValue", "name": "contentLanguage", "value": [ "en", "es" ] } ], "expectsAcceptanceOf": { "@type": "Offer", "priceSpecification": [ { "@type": "UnitPriceSpecification", "price": 19.99, "priceCurrency": "USD", "priceType": "https://schema.org/ListPrice" }, { "@type": "UnitPriceSpecification", "price": 360.00, "priceCurrency": "MXN", "priceType": "https://schema.org/ListPrice" } ], "seller": { "@type": "Organization", "name": "My Favorite Game Publisher" } } }, { "@type": "PlayGameAction", "gameAvailabilityType": "DEMO", "additionalType": "DownloadPlayAction", "target": { "@type": "EntryPoint", "urlTemplate": "http://www.example.com/jp/my_favorite_game?autoplay=true", "actionPlatform": [ "http://schema.org/DesktopWebPlatform", "http://schema.org/MobileWebPlatform" ] } "actionAccessibilityRequirement": { "@type": "ActionAccessSpecification", "category": "purchase", "availabilityStarts": "2021-07-24T11:00:00Z", "availabilityEnds": "2041-07-24T11:00:00Z", "eligibleRegion": [ { "@type": "Country", "name": "JP" } ] }, "additionalProperty": [ { "@type": "PropertyValue", "name": "contentLanguage", "value": [ "ja" ] } ], "expectsAcceptanceOf": { "@type": "Offer", "priceSpecification": [ { "@type": "UnitPriceSpecification", "price": 2189, "priceCurrency": "JPY", "priceType": "https://schema.org/ListPrice" } ], "seller": { "@type": "Organization", "name": "My Favorite Game Publisher" } } } ], // Other properties... }