開発者コンソール
ログイン
ログイン
開発者コンソール

統合を検証するためのテストケース

統合を検証するためのテストケース

UIの検証

ホーム画面でのタイトルの表示

アプリ内でビデオを視聴した後、[続きを観る] 行（CWR）にコンテンツタイルが表示されることを確認する

テスト手順

アプリ内でビデオを視聴した後、[続きを観る] 行（CWR）にコンテンツタイルが表示されることを確認します。

  1. Fire TVデバイスにアプリをインストールします（定期購入ベースの場合はログインします）。
  2. アプリを開きます。
  3. コンテンツの視聴を開始し、合計時間の2%以上の位置までスキップするか再生を進めます。
  4. アプリを終了し、[ホーム] タブに移動します。
  5. [ホーム] タブのCWRにコンテンツタイルが表示されることを確認します。
期待される結果
  • 視聴したコンテンツのタイルが、[ホーム] タブの最初の行であるCWRに表示されます。
  • [ホーム] タブから視聴したコンテンツのタイルを選択すると、ユーザーが再生を途中で終了した時点のタイムスタンプから再生が始まります。
視聴したコンテンツのタイルが、[ホーム] タブの最初の行であるCWRに表示されます。

複数のAmazonプロフィール間でのコンテンツの分離

あるAmazonプロフィールからアプリ内でビデオを視聴した後、同じデバイス上の別のAmazonプロフィールで、CWRに同じコンテンツのタイルが表示されないことを確認する

テスト手順

  1. Fire TVデバイスにアプリをインストールします（定期購入ベースの場合はログインします）。
  2. デバイスでAmazonプロフィール1に切り替えます。
  3. アプリを開きます。
  4. コンテンツの視聴を開始し、合計時間の2%以上の位置までスキップするか再生を進めます。
  5. アプリを終了し、[ホーム] タブに移動します。
  6. プロフィール1の [ホーム] タブのCWRに、コンテンツのタイルが表示されることを確認します。
  7. 同じデバイスでプロフィール2に切り替えます。
  8. プロフィール1のコンテンツが現在のプロフィールに表示されないことを確認します。
  9. プロフィール2からコンテンツを再生します。
  10. プロフィール2で再生したコンテンツが、[ホーム] タブのCWRに表示されることを確認します。
  11. 再びプロフィール1に切り替え、プロフィール1のCWRにプロフィール2のタイルが追加されていないことを確認します。
コンテンツタイルはプロフィール1にのみ表示されます。
コンテンツタイルはプロフィール2にのみ表示されます。

期待される結果

  • コンテンツタイルは、そのコンテンツを再生した元のAmazonプロフィールにのみ表示されます。

視聴アクティビティデータ

再生イベント

アプリがフォアグラウンドの場合にのみデータが送信され、バックグラウンドでは送信されないことを確認する

テスト手順

  1. Fire TVデバイスで、アプリをインストールして起動します（定期購入ベースの場合はサインインします）。
  2. コンテンツの視聴を開始し、合計時間の2%を超えて再生イベントがAmazonに送信されるまで視聴を続けます。
  3. 再生中にホームボタンを押して、アプリを終了します。
  4. 5分以上待ち、アプリの終了後にAmazonに再生イベントが送信されないことを確認します。

期待される結果

  • アプリがフォアグラウンドの場合にのみ、データがAmazonに送信されます。
  • SDKログをモニタリングすると、アプリがバックグラウンドのとき（アプリを終了してから5分以上経過後）にSDKで記録されるログはありません。

ユーザーがビデオを視聴しているときに、アプリから1分ごとに現在の再生位置で再生イベントが送信されることを確認する

テスト手順

  1. Fire TVデバイスで、アプリをインストールして起動します（定期購入ベースの場合はサインインします）。
  2. コンテンツの視聴を開始し、合計時間の2%を超えてから5分間視聴を続けます。
  3. 1分ごとに、現在の再生位置で再生イベントがAmazonに送信されることを確認します。

期待される結果

  • SDKログに再生イベントが5つ記録されます（1分ごとに1つのイベント）。
  • イベントログのplaybackPositionMs値は、現在の再生位置と正確に一致している必要があり、新しいイベントごとに値が大きくなります。
  • イベントログのcreditsPositionMs値は、合計時間よりも小さくなります。

アプリからライブリニアコンテンツの再生イベントが送信されることを確認する

テスト手順

  1. Fire TVデバイスで、アプリをインストールして起動します（定期購入ベースの場合はサインインします）。
  2. ライブリニアコンテンツを視聴します。
  3. 1分ごとに、現在の再生位置で再生イベントがAmazonに送信されることを確認します。

期待される結果

  • アプリから、1分ごとに現在の再生位置で再生イベントが送信されます。

ユーザーが再生を一時停止したときに、アプリから再生状態が「一時停止」の再生イベントが送信されることを確認する

テスト手順

  1. Fire TVデバイスで、アプリをインストールして起動します（定期購入ベースの場合はサインインします）。
  2. コンテンツの視聴を開始し、その後一時停止します。
  3. アプリから、現在の再生位置で再生状態が「一時停止」の再生イベントが送信されることを確認します。

期待される結果

  • アプリから、現在の再生位置で再生状態が「一時停止」の再生イベントが送信されます。

ユーザーがコンテンツを早送りまたは早戻ししたときに、アプリから再生状態が「再生中」の再生イベントが送信されることを確認する

テスト手順

  1. Fire TVデバイスで、アプリをインストールして起動します（定期購入ベースの場合はサインインします）。
  2. コンテンツの視聴を開始し、コンテンツを先へスキップしてから早戻しします。
  3. アプリから、現在の再生位置で再生状態が「再生中」の再生イベントが送信されることを確認します。

期待される結果

  • アプリから、現在の再生位置で再生状態が「再生中」の再生イベントが送信されます。

ユーザーがリモコンのホームボタンを押して再生を終了したときに、アプリから再生状態が「終了」の再生イベントが送信されることを確認する

テスト手順

  1. Fire TVデバイスで、アプリをインストールして起動します（定期購入ベースの場合はサインインします）。
  2. コンテンツの視聴を開始し、ホームボタンを使用して終了します。
  3. アプリから、現在の再生位置で再生状態が「終了」の再生イベントが送信されることを確認します。

期待される結果

  • アプリから、現在の再生位置で再生状態が「終了」の再生イベントが送信されます。

ユーザーがリモコンの戻るボタンを押して再生を終了したときに、アプリから再生状態が「終了」の再生イベントが送信されることを確認する

テスト手順

  1. Fire TVデバイスで、アプリをインストールして起動します（定期購入ベースの場合はサインインします）。
  2. コンテンツの視聴を開始し、戻るボタンを使用して終了します。
  3. アプリから、現在の再生位置で再生状態が「終了」の再生イベントが送信されることを確認します。

期待される結果

  • アプリから、現在の再生位置で再生状態が「終了」の再生イベントが送信されます。

広告やプレビューなどの再生中に、アプリから再生状態が「インタースティシャル」の再生イベントが送信されることを確認する

テスト手順

  1. Fire TVデバイスで、アプリをインストールして起動します（定期購入ベースの場合はサインインします）。
  2. プレビューや広告が表示される可能性のあるコンテンツの視聴を開始します。
  3. アプリから、現在の再生位置で再生状態が「インタースティシャル」の再生イベントが送信されることを確認します。

期待される結果

  • アプリから、現在の再生位置で再生状態が「インタースティシャル」の再生イベントが送信されます。

コンテンツパーソナライゼーションAPIの統合前にキャプチャされた再生イベントがCWRに表示されないことを確認する

テスト手順

  1. Fire TVデバイスで、アプリをインストールして起動します（定期購入ベースの場合はサインインします）。
  2. CWRに、統合（コンテンツパーソナライゼーションAPI）を有効にした後に行われた視聴アクティビティのコンテンツ（再生イベント）が表示されることを確認します。

期待される結果

  • CWRには、コンテンツパーソナライゼーションAPIの統合後にユーザーが視聴したコンテンツが表示されます。
  • コンテンツパーソナライゼーションAPIの統合前に視聴されたコンテンツは、CWRに表示されません。

アプリが子ども用プロフィール（アプリプロフィール）のデータを送信しないことを確認する

テスト手順

  1. Fire TVデバイスでAmazonアカウントにログインします。
  2. 大人用のAmazonプロフィールのアカウントを選択します。
  3. アプリを開いてサインインします。
  4. 子ども用プロフィールを選択します。
  5. ビデオを視聴し、データがAmazonに送信されないことを確認します。

期待される結果

  • 子ども用プロフィールからのデータは送信されません。

サポート対象外のFOS本番環境ビルドを使用して、コンテンツパーソナライゼーションAPIが統合されたアプリを検証する

テスト手順

  1. Amazon OTAプールに追加されていないデバイスを使用します。
  2. [設定] > [My Fire TV] > [バージョン情報] > [アップデートをチェック] に移動して、prodからすべてのアップデートをインストールします。
    1. 「Fire TVは最新です」というメッセージが表示されるまで繰り返します。
  3. コンテンツパーソナライゼーションAPIが統合されたアプリをインストールします。
  4. アプリを開き、ビデオを視聴します。
  5. インストール時、起動時、コンテンツの再生時、ウォッチリストへのコンテンツの追加時にアプリがクラッシュしないことを確認します。

期待される結果

  • インストール時、起動時、コンテンツの再生時、ウォッチリストへのコンテンツの追加時のいずれにも、アプリがクラッシュすることはありません。
  • adb logcat | grep -E "FTVIntegrationSDK"というコマンドを実行しても、表示されるログはありません。

ウォッチリスト、定期購入型アイテム、エンタイトルメントデータ

ウォッチリスト

アプリの起動時またはログイン時に、アプリからデータ（ウォッチリスト）が送信されることを確認する

テスト手順

コンテンツの視聴に登録を必要としない場合（無料アプリ）

  1. adb logcat | grep "FTVIntegrationSDK"というコマンドを使用してlogcatをモニタリングします。
  2. Fire TVデバイスで、アプリをインストールして起動します。

コンテンツの視聴に登録が必要な場合（定期購入ベースのアプリ）

  1. Fire TVデバイスで、アプリをインストールして起動します。
  2. adb logcat | grep "FTVIntegrationSDK"というコマンドを使用してlogcatをモニタリングします。
  3. アプリにログインします。

期待される結果

コンテンツの視聴に登録を必要としない場合（無料アプリ）

  • 起動時にデータがAmazonに送信されることを確認します。
  • ログを参照して、正しいデータが送信されていることを確認します。ユーザーにウォッチリストがある場合は、ログにウォッチリスト情報を示すエントリが記録されます。
  • アプリの起動時にsetCustomerListメソッドが呼び出されていることを示すログを確認します。

コンテンツの視聴に登録が必要な場合（定期購入ベースのアプリ）

  • ログイン時にデータがAmazonに送信されることを確認します。
  • ログを参照して、正しいデータが送信されていることを確認します。ユーザーにウォッチリストがある場合は、ログにウォッチリスト情報を示すエントリが記録されます。
  • アプリが定期購入なしでのアカウント作成をサポートしている場合は、空の定期購入型アイテムのリストが送信されることを確認します。
  • アプリの起動時にsetCustomerListメソッドが呼び出されていることを示すログを確認します。

ウォッチリストデータ

ウォッチリストへのコンテンツの追加を検証する

テスト手順
  1. テスト対象のアプリをインストールし、ログインします。
  2. 任意のコンテンツの詳細ページに移動するか、コンテンツをウォッチリストに追加するための同等のナビゲーションを行います。
  3. ユーザーのウォッチリストにコンテンツを追加します。
期待される結果
  1. SDKにより、ウォッチリストに追加されたコンテンツがログに記録されます。

例： SDKログに、以下の例のようなエントリが表示されます。

addCustomerListEntries invoked by package: com.starz.starzplay.firetv with data: List(AmazonCustomerListEntry(addedTimestampMs=1705432510548)) and AmazonCustomerListType: Watchlist.

ウォッチリストからのコンテンツの削除を検証する

テスト手順

  1. テスト対象のアプリをインストールし、ログインします。
  2. テスト前に、任意の特定のコンテンツをウォッチリストに追加しておきます。
  3. ユーザーのウォッチリストからコンテンツを削除します。

期待される結果

  • ウォッチリストからのコンテンツの削除を示すSDKログを確認します。

例： SDKログに、以下の例のようなエントリが表示されます。

removeCustomerListEntries invoked by package: com.starz.starzplay.firetv with data: List(AmazonCustomerListEntry(addedTimestampMs=-1)) and AmazonCustomerListType: Watchlist. ****

Last updated: 2025年4月1日