
ビデオ品質を監視するための高度なインサイトの統合
所要時間:1 分
ヘルスケア教育。コラボレーション。オンライン・ビデオ会議でのコミュニケーションが頻繁に行われていることでしょう。Vonage Video APIの顧客が使用した分数は、2月から3月だけで232%増加しました。ヘルスケア業界では、ビデオ会議の利用時間は727%増加しました。
このような負荷の増加に伴い、顧客にどのような質の高いサービスを提供しているかを知ることは、これまで以上に重要になっています。ペイツ氏の生徒たちは、授業をはっきり見聞きできているだろうか?サンチェス医師は、患者が必要とする質の高い治療を提供できているだろうか?彼らが問題を経験した場合、あなたは答えを持っていたい。
そのためVonageは インサイトおよびアドバンスドインサイトAPI.これらの GraphQL API は、エンドユーザーのためのスケーラブルで信頼性の高いソリューションの構築に役立ちますが、どのようなデータが提供され、いつ利用可能で、どのくらいの期間アクセス可能かを知ることが重要です。
インサイトAPI
Insights APIを使用すると、プロジェクトレベルでセッションのメタデータを調べることができます。このメタデータには次のようなメトリクスが含まれます:
使用状況:ストリーム公開分数、ストリーム購読分数、アーカイブ使用量、ブロードキャスト使用量、SIP使用量に関する情報
品質ビデオの画質に関する情報
エラー:セッションへの接続、公開、購読の失敗率
Example GraphQL code used with the Insights API
このAPIでは、SDKの種類、SDKのバージョン、国、地域、ブラウザ、ブラウザのバージョンによってデータをフィルタリングし、グループ化することができ、さらに、日次、週次、月次の間隔でデータをセグメント化することができます。
データ保持
インサイトのデータは、プロジェクト・レベルで毎日集計される。そのため、リアルタイムでは利用できません。 インサイトのAPIデータは、36~48時間の待ち時間でご利用いただけます。
Timeline displaying retention spans of the Insights API
インサイトのデータは、60日間は日次集計でご利用いただけます。その後、最長12ヶ月間は月次集計でご利用いただけます。12ヶ月を過ぎると、インサイトAPIはデータを保持しません。
アドバンスド・インサイトAPI
Advanced Insights APIは、セッションとストリームレベルでデータを提供します。セッションはミーティングに分割され、各セッションは多数のミーティングから構成されます。新しいミーティングは、誰かがセッションに参加し、過去10分間参加者がいなかった場合に作成されます。
セッションデータは以下の通り:
メタデータ:メディアモード、公開分、購読分
ミーティング:このセッションで指定された時間枠の間に発生した会議の配列。以下を含む:
コネクション:会議中にセッションに参加した各クライアントを定義する接続の配列。使用したSDK、使用したブラウザ、パブリッシャー/購読者に関する情報などが含まれます。
メタデータ:公開された議事録、購読された議事録、会議の作成日と破棄日
出版社ミーティングに参加したパブリッシャーの一覧。ストリーム、購読者、ストリーム統計に関するデータが含まれる。
加入者:会議中に存在したサブスクライバの配列。サブスクライバのストリームおよびストリーム統計に関する情報が含まれます。
Example GraphQL query for the Advanced Insights API
ストリーム統計
Advanced Insightsの威力は、インストリーム統計にあります。このデータには、オーディオおよびビデオのレイテンシー、ビットレート、パケットロス率、コーデックの30秒スナップショットが含まれます。また、ビデオの解像度情報や、スナップショット時にストリームにオーディオおよび/またはビデオが含まれていたかどうかも含まれます。
この情報を使用して、ストリームの品質という観点からユーザーのエクスペリエンス全体をレビューし、SDK、ブラウザ、時間帯などのメトリクス間でデータを比較することができます。このレベルの洞察力を使用することで、プラットフォーム間でアプリケーションを最適化し、顧客が可能な限り最高のエクスペリエンスを得られるようにすることができます。
データ保持
Advanced Insights のデータは 21 日間利用可能です。保存期間は、セッション内の会議の作成時刻に基づいています。 データの利用可能な待ち時間は、会議終了から5分です。
Timeline displaying retention spans of the Advanced Insights API
定期的なデータベースメンテナンスの期間中は、Advanced Insights のデータにアクセスできない場合があります。すべてのデータは、指定されたメンテナンス期間の直後に埋め戻されます。
| Day | Time | Data Available By | |
|---|---|---|---|
| Daily database maintenance | Monday - Sunday | 9pm - 11pm PT | 11:30pm PT |
| Weekly database maintenance | Sunday | 4am - 7am PT | 8am PT |
アドバンスド・インサイトの統合
多くの場合、InsightsとAdvanced Insightsのデータへのアクセスは、当社の保持ポリシーで規定されているよりも長く保持する必要があります。サーバーレス関数またはスケジュールされたタスクのいずれを使用する場合でも、定期的にAPIエンドポイントにクエリを実行してデータを取得し、データベースにロードします。このデータをご希望のデータベースに長期保存することで、チームやクライアントにシームレスにインサイトを提供し、より大きな時間スケールで指標を比較することができます。
どちらのAPIもデータは太平洋標準時で集計されるため、クエリーを実行する時間帯を決定する際には、タイムゾーンのオフセットを含めることをお忘れなく。
インサイトAPIクエリ頻度
Insights APIは毎日集計されるため、毎日1回以上問い合わせるべきではありません。毎日、あるいは数日おきにこのデータを照会して保存すれば十分だろう。
アドバンスド・インサイトAPIのクエリ頻度
会議の Advanced Insights データは、会議が終了してから 5 分後に利用可能になります。このデータを照会する適切な時間は、ほぼリアルタイムのデータを必要とするアプリケーションによって異なります。 上記の Advanced Insights データベースのメンテナンス期間を必ず考慮してください。
まとめ
InsightsとAdvanced Insightsのデータを活用すれば、クライアント・プラットフォームやブラウザの傾向を把握し、パケットロス、ユーザー・ビットレート、遅延の問題を数分で特定することができます。インサイトおよびアドバンスド・インサイトのAPIと、それらがどのように、より多くの情報に基づいた意思決定を可能にするかについての詳細は、以下のリンクをご覧ください: