recommendation_reason ディメンションについて学びます。recommendation_reason ディメンションは、レコメンド動画を提示したアルゴリズム(related、trending、recent、featured)ごとに分析データを分類します。URL パラメータ
分析 API レポートでは、次の URL パラメータがサポートされています。
| パラメーター | 説明 | 必須 | 値 | デフォルト |
|---|---|---|---|---|
account |
報告したいアカウント | はい | 1 つ以上のアカウント ID をカンマで区切ったリスト | なし |
dimensions |
レポートするディメンション | はい | 1つ以上の次元をカンマで区切ったリスト (一部の組合せは無効です) | なし |
where |
レポートのフィルタを指定するために使用します | いいえ | {dimension} == {value} -セミコロンで区切られたリストとして1つ以上 | なし |
limit |
返品するアイテムの数 | いいえ | 正の整数 | 10 |
offset |
スキップする項目の数 | いいえ | 正の整数 | 0 |
sort |
アイテムを並べ替えるフィールド | いいえ | リクエストの有効なフィールド | video_view |
fields |
返すフィールド | いいえ | レポートしているディメンションによって異なります | video_view |
format |
結果を返す形式 | いいえ | json | csv | xlxs | json |
reconciled |
含まれている場合は、結果を履歴データまたはリアルタイムデータに制限します | いいえ | 真 | 偽 | true |
from |
リクエストの日付範囲の開始日 | いいえ | ISO 8601 日付(YYYY-MM-DD)、エポック時間(ミリ秒)、文字列 alltime、または相対日付(-1m)。エンゲージメントエンドポイントでは、過去 32 日以内の日付のみが許可されるか、または recalciled=false の場合も許可されます。 | 今までの30日前 |
to |
リクエストの日付範囲の終わり | いいえ | ISO 8601 日付 (YYYY-MM-DD)、エポック時間 (ミリ秒)、現在の文字列、または相対データ (+7d)。エンゲージメントエンドポイントでは、過去 32 日以内の日付のみが許可されるか、または recalciled = false の場合に許可されます。 | 今 |
使用可能なフィールド
ディメンションの次のフィールドを返すことができます。
recommendation_reason- レコメンド動画を提示したアルゴリズム:related、trending、recent、featuredrecommendation_view- レコメンドから発生した動画視聴の数recommendation_impression- 視聴者に表示されたレコメンド動画の数。レコメンドスレート内のレコメンド動画ごとに 1 インプレッションとしてカウントされるため、複数の動画を表示する 1 つのスレートは複数のインプレッションとしてカウントされますvideo_view- 動画再生が開始された合計回数
フィルタ値
フィルタとして使用すると、ディメンションを使用して結果を絞り込むことができます。
フィルタ値:related、trending、recent、featured(カンマ区切りで1つ以上)
寸法を組み合わせる
この組み合わせに使用できるディメンションと、その組み合わせで使用できるフィールドについては、ディメンションとフィールドを参照してください。
リクエスト例
ディメンションリクエスト
https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=recommendation_reason&fields=recommendation_view,recommendation_impression
フィルタ要求
https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=recommendation_reason&where=recommendation_reason==related,trending
応答
リクエストをテストすると、応答がここに表示されます