アプリケーションで ApsaraVideo Player SDK を使用して動画を再生する場合、再生品質モニタリングサービスを活用することで、再生品質および視聴者の動作を追跡できます。このサービスは、ApsaraVideo Player SDK から報告されるイベント追跡データに基づき、再生失敗率、初回フレーム表示までの時間（Time-to-First-Frame）、ストラッタリング率などのメトリックを算出します。
非推奨のお知らせ：ApsaraVideo VOD の安定性およびユーザーエクスペリエンス向上のため、Alibaba Cloud では従来の再生品質モニタリング機能を段階的に廃止し、新たにアップグレードされたバージョンを提供開始しました。新機能は包括的なスペックアップを実現しており、ストラッタリング率、ネットワーク遅延、再生成功確率など、多様なディメンションのメトリックをサポートするとともに、データ可視化機能も強化されています。これらの改善により、再生品質の分析精度が向上します。詳細については、「動画再生品質のモニタリング（新）」をご参照ください。
メトリックの説明
QoS メトリック
サービス品質（QoS）メトリックは、アプリケーションの再生品質を反映します。
メトリック | 算出方法 | 説明 |
動画再生回数（回） | 動画の再生回数の合計。プレーヤー SDK の再生呼び出しを 1 回ごとにカウントします。 | 動画再生回数は、アプリケーションが ApsaraVideo Player SDK の |
実際の再生回数（回） | 実際の再生回数 ＝ 総再生回数 − 総再生失敗回数 − バウンス回数 | バウンスは極めて稀に発生するため、本メトリックは無視しても構いません。 |
初回フレーム表示時間（ミリ秒） | ApsaraVideo Player SDK を使用してユーザーが再生を開始してから、初回フレームが表示されるまでの時間です。 | 再生が開始できなかった場合は、初回フレーム表示時間は記録されません。 |
QoE メトリック
体験品質（QoE）メトリックは、ユーザーが動画を視聴する様子を反映します。
メトリック | 算出方法 | 説明 |
訪問者 (ユーザー) | ユニークなユーザー識別子（ApsaraVideo Player SDK が生成する UUID）をカウントします。 | 選択した期間内に動画を視聴したユーザーの総数です。これは、ApsaraVideo Player SDK を呼び出したアクティブなユーザー数と等しくなります。モバイル端末では、ユーザーはデバイス ID で識別されます。 |
視聴者単位の平均動画再生回数（回） | 視聴者単位の平均動画再生回数 ＝ 総再生回数 ÷ 総訪問者数 | - |
平均動画再生時間（秒） | AVG（動画再生時間） | ユーザーが再生したすべての動画の再生時間の平均値です。 |
前提条件
再生品質モニタリングを利用する前に、以下の手順を完了してください：
ApsaraVideo Player SDK の以下のバージョンのいずれかを使用してください：Android／iOS SDK v5.4.9.2 以降、または Web SDK v2.16.0 以降。最新版 SDK のダウンロードについては、「プレーヤー SDK のダウンロード」をご参照ください。
Android、iOS、または Web 向けプレーヤー SDK の有効なライセンスを取得してください。詳細については、「ライセンスの取得」をご参照ください。
ApsaraVideo Player SDK のログ報告機能が有効になっていることを確認してください。デフォルトでは、この機能は有効になっています。
任意：プレーヤーを作成する際に traceId を渡します。その後、単一点トレーシング を使用して、特定のユーザーまたはデバイスを特定し、再生動作を分析し、再生に関する問題を迅速に特定できます。パススルー方法については、「ApsaraVideo Player SDK for Android の基本機能」「ApsaraVideo Player SDK for iOS の基本機能」「Web プレーヤー API リファレンス」をご参照ください。
制限事項
再生データの照会は、過去 3 日間分のみ可能です。また、1 回の照会で複数日を跨ぐことはできません。
操作手順
ApsaraVideo VOD コンソール にログインします。
左側のナビゲーションウィンドウで、データセンター > 再生品質モニタリング を選択し、再生品質モニタリングページを開きます。
ディメンションごとにメトリックを表示します。
以下のディメンションでデータをフィルターできます：
デバイスタイプ、システムタイプ、解像度、ネットワークタイプなどのディメンションで照会データをフィルターできます。
直近 1 時間から直近 3 日間までのカスタム時間範囲を指定できます。
新しいフィルター条件 をクリックして、SDK バージョン、動画フォーマット、ハードウェアデコーディング、ISP、ドメイン名、中国国内の都道府県などのフィルターを追加できます。頻繁に使用するフィルターは保存しておけば、後で素早く再利用できます。各フィルター条件の詳細は、以下の表をご覧ください。
条件内容
説明
SDK バージョン
アプリケーションに統合された ApsaraVideo Player SDK のバージョン番号です。
動画フォーマット
HLS や FLV などの動画ファイルで使用されるコーデックです。
ハードウェアデコーディング
動画デコード時にハードウェアデコーディングが有効かどうかを示します。
キャリア
ISP を基準に再生データをフィルターします。
ドメイン名
動画コンテンツをホストするサーバーのドメイン名です。
国
ユーザーの所在地に基づき、国ごとに再生データをフィルターします。
中国の省
再生データを特定の中国の省に絞り込みます。