アカウントをセットアップする
手順4: Amazonからカタログの承認を受ける
ステージング環境にカタログを送信してテストしたら、Amazonの担当者に連絡して、カタログの承認を受ける準備ができたことを伝えます。Amazonはカタログを審査して、品質と統合の基準を満たしていることを確認します。この手順は、開発者とAmazonの間で繰り返されるプロセスです。
カタログ承認依頼書の提出
開発者は、ビデオ録画を含むテストケースの結果をAmazonに提出する必要があります。このセクションから入手できるスプレッドシートテンプレートを使用して、テスト結果を記録します。
テスト結果を提出するには
- 依頼書のテンプレート (Fire TV Catalog Acceptance Intake Template)をダウンロードします。
- カタログのコンテンツタイプに適用されるセクションにのみ入力します。適用されないセクションでは、そのテストケースの [Pass/Fail] 列に「N/A」と入力します。
- カタログに適用されるすべてのテストシナリオに合格することを確認します。Amazonからカタログの承認を受ける前に、適用されるすべてのシナリオに合格する必要があります。
- 完成したスプレッドシートを、ビデオ録画と一緒にAmazonアカウント担当者に提出します。
ビデオ録画の作成方法の詳細については、ビデオ録画の要件を参照してください。
ビデオ録画の要件
開発者は、適用されるすべてのテストシナリオが想定どおりに動作することを示すビデオ録画を、Amazonアカウント担当者に提出する必要があります。
ビデオ録画に関するベストプラクティス
ビデオ録画を作成するときは、以下のガイドラインに従ってください。
推奨事項
- 一度に1つずつシナリオをテストする。 各テストケースを順番に完了します。録画の中で各テストを分けて、テスト間に短いポーズを挿入します。
- リモコンが見えるようにする。 Fire TVリモコンを常にフレーム内に収め、ボタンを押すようすが見えるように配置します。小さいボタンを押すときは、必要に応じてズームインします。
- TV画面全体を収録する。 画面全体をフレーム内にキャプチャし、UI要素が判読できることを確認します。適切な照明を使用して画面の反射や白飛びを防ぎます。
- 操作をナレーションで説明する。 何をテストするかを口頭で説明し、スプレッドシートのテストIDを述べ、ユーザーの視聴権限ステータスとコンテンツタイプをアナウンスします。たとえば、「VOD-01のテスト: 視聴権限のあるユーザー、<タイトル>の音声検索」のようにアナウンスします。
- 成功をはっきりと示す。 各手順が完了するようすを映し、重要な成功基準をはっきりと示します。検索結果、詳細ページ、再生などの重要な画面で一時停止します。ページ全体が読み込まれるまで待ってから次に進みます。
- 適用されるすべてのテストを含める。 コンテンツタイプに対応するテストケースをすべて録画し、必須のシナリオをスキップしないようにします。コンテンツタイプごとに、視聴権限のあるユーザーと視聴権限のないユーザーの両方をテストします。
禁止事項
- 各テストケースを性急に進めない。
- 必須のシナリオをスキップしない。
- 不安定または不明瞭なカメラアングルを使用しない。
- はっきりとした区切りを入れずに複数のシナリオを同時にテストしない。
- 録画の一部だけを提出しない。
- 操作をナレーションで説明することを忘れない。
- リモコンを画面から外さない。
推奨される録画構成
ビデオ録画は、以下のセクションに従って構成してください。
前置き(最初の30秒)
- 会社名を述べます。
- テストするコンテンツタイプを述べます。
- Fire TVデバイスとリモコンを見せます。
- テストの日付を述べます。
オープニングの台本の例:
「これは、<会社名>のカタログ統合のテストステップ3です。テストの日付: <日付>。VODコンテンツとライブイベントコンテンツのテスト。このカタログにはリニアコンテンツはありません。デバイス: Fire TV Stick 4K、Fire OSバージョン<X.X.X>。」
個々のテストケース
- テストID(「VOD-01」など)をアナウンスします。
- ユーザーの視聴権限ステータス(視聴権限があるかないか)を述べます。
- テストシナリオ(音声検索、詳細ページ、ディープリンク)を述べます。
- リモコンを見せます。
- 操作を実行します。
- 想定される結果を示します。
- 合格か不合格かを確認します。
- 次のテストに進む前に、2~3秒間一時停止します。
テストケースの台本の例:
「VOD-01のテスト: 視聴権限のあるユーザー、音声検索。マイクのボタンを長押ししながら、『The Great Adventureを検索して』と言います。 タイトルが、正しいサムネイルとロゴと一緒に検索結果に表示されます。テストに合格しました。VOD-02に進みます」
まとめ
- 実行したテストの合計数を述べます。
- 全体の合格率を述べます。
- 発生した問題があれば言及します。
技術仕様
ビデオ録画は、次の技術要件を満たしている必要があります。
- ビデオ形式: MP4、MOV、AVIのいずれか。
- 解像度: 最小720p、1080pを推奨。
- 録画時間: 適用されるテストに応じて通常は10~20分。
- ファイルサイズ: 特に制限なし。ただし、500MBを超える場合は圧縮してください。
- オーディオ: ナレーションがクリアなオーディオであること。
- 照明: 画面を視認できること。反射や白飛びを防いでください。
カタログ承認の申請チェックリスト
Amazonアカウント担当者に提出する前に、以下のアイテムが揃っていることを確認してください。
- 入力済みのテストケーススプレッドシート
- 適用されるすべてのセクションが入力されている。
- 適用されないセクションは「N/A」としてマークされている。
- すべてのテスト結果が文書化されている。
- ビデオのタイムスタンプが含まれている。
- 確認された動作が記述されている。
- ビデオ録画
- 適用されるすべてのテストシナリオが示されている。
- 最初から最後までリモコンが見えている。
- テストごとにクリアなナレーションが挿入されている。
- すべての成功基準が示されている。
- ファイル形式と画質が適切である。
- テスト環境の情報
- Fire TVデバイスのモデル。
- Fire OSのバージョン。
- テストの日付。
- テストアカウントの情報(パスワードを除く)。
- ネットワーク構成(該当する場合)。
Amazonによるカタログの審査
カタログがステージング環境に正常に統合されると、Amazonはマッチングとテストのプロセスを実行してカタログを検証します。この審査には以下の確認が含まれます。
- コンテンツのマッチング - 外部IDとメタデータフィールドを使用して、コンテンツが既存のカタログエントリと一致することを確認します。
- メタデータの品質 - タイトル、説明、画像、その他のメタデータが品質要件を満たしていることを確認します。
- オファーとエンタイトルメントの正確性 - オファーがユーザーに表示されるように正しく構成されていることを確認します。
- 統合の完全性 - 各番組に対応するオファーがあること、参照が正しく解決されること、必須のリレーションシップ(TV番組の階層など)が設定されていることを検証します。
対処が必要な問題がある場合は、Amazonの担当者からフィードバックが提供されます。
フィードバックの解決と再提出
審査中にAmazonによって問題が特定された場合は、次の手順に従います。
- Amazonの担当者から提供されたフィードバックを確認します。
- カタログファイル内で特定された問題を修正します。
- 修正されたエンティティのバージョン番号を増やします。
- 修正したカタログと新しいマニフェストをステージング環境に再アップロードします。
- Amazonは、更新されたカタログでマッチングとテストのプロセスを再実行します。
カタログがAmazonの承認基準を満たすまで、このサイクルが繰り返されます。
よくあるフィードバックの領域
- コンテンツのマッチングに影響する外部IDが存在しないか正しくない。
- 画像の品質やアクセスに問題がある(URLが一般に公開されていない)。
- TV番組の階層が完全でない(シーズン/シリーズのリレーションシップが設定されていない)。
- エンタイトルメントや地理的制限の構成が正しくない。
- 番組に対応するオファーが検出されない。
問題の例
次の例では、必須のTitles要素が存在していません。
<!-- 修正前(エラー:Titlesがない) -->
<Movie id="MOVIE_123" version="1">
<Descriptions>
<Description language="en" default="true">A great movie.</Description>
</Descriptions>
</Movie>
修正例
修正されたバージョンにはTitles要素が含まれています。
<!-- 修正後(修正+バージョン増加) -->
<Movie id="MOVIE_123" version="2">
<Titles>
<Title language="en" default="true">My Great Movie</Title>
</Titles>
<Descriptions>
<Description language="en" default="true">A great movie.</Description>
</Descriptions>
</Movie>
Last updated: 2026年5月27日

