createMediaSession
この createMediaSession コマンドは Web SDK の一部 streamingMedia コンポーネント。 このコンポーネントを使用すると、web サイト上のメディアセッションに関連するデータを収集できます。 を参照してください。 streamingMedia 詳細を見る を参照して、このコンポーネントの設定方法を確認してください。
収集されたデータには、メディアプレイバック、一時停止、完了およびその他の関連イベントに関する情報を含めることができます。 収集したら、このデータをに送信できます。 ストリーミングメディア用 Adobe Analytics：指標を集計します。 この機能は、web サイトでのメディア消費行動を追跡および把握するための包括的なソリューションを提供します。
Web SDK でメディアセッションを作成するには、次の 2 つの方法があります。
- 自動的にトラッキングされるメディアセッション web SDK で、へのメディア ping イベントのディスパッチを管理できるようにします ストリーミングメディア用 Adobe Analytics. これらの ping の頻度は、の設定によって決まります streamingMedia コンポーネント。
- 手動でトラッキングされるメディアセッション へのセッション ping イベントのディスパッチをより詳細に制御できます。 ストリーミングメディア用 Adobe Analytics. さらに、を保存できます
sessionID（メディアセッション用）。
自動的にトラッキングされるメディアセッションの作成 automatic
メディアセッションのトラッキングを自動的に開始するには、 createMediaSession メソッドと以下に説明するオプション。
alloy("createMediaSession", {
playerId: "movie-test",
getPlayerDetails: () => {
return {
playhead: document.getElementById("movie-test").currentTime,
qoeDataDetails: {
bitrate: 1000,
startupTime: 1000,
fps: 30,
droppedFrames: 10
}
};
},
xdm: {
eventType: "media.sessionStart",
mediaCollection: {
sessionDetails: {
...
}
}
}
});
プロパティ
タイプ
必須
説明
playerId文字列
○
プレーヤー ID。メディアセッションを表す一意の識別子です。
getPlayerDetails関数
○
プレーヤーの詳細を返す関数。 このコールバック関数は、のすべてのメディアイベントの前に Web SDK によって呼び出されます。
playerId 提供されます。xdm.eventTypeオブジェクト
×
メディアイベントタイプ。 指定しない場合、自動的に次のように設定されます。
media.sessionStart.xdm.mediaCollection.sessionDetailsオブジェクト
○
セッションの詳細オブジェクト。 この
sessionDetails オブジェクトには、セッションの詳細プロパティを含める必要があります。 を参照してください。 メディアコレクションスキーマ 詳しくは、ドキュメントを参照してください。手動でトラッキングされるメディアセッションの作成 manual
メディアセッションのトラッキングを手動で開始するには、 createMediaSession メソッドと以下に説明するオプション。
const sessionPromise = alloy("createMediaSession", {
xdm: {
eventType: "media.sessionStart",
mediaCollection: {
playhead: 0,
sessionDetails: {
...
},
qoeDataDetails: {
bitrate: 1000,
startupTime: 1000,
fps: 30,
droppedFrames: 10
}
}
}
});
プロパティ
タイプ
必須
説明
xdm.eventTypeオブジェクト
×
メディアイベントタイプ。 指定しない場合、自動的に次のように設定されます。
media.sessionStart.xdm.mediaCollection.sessionDetailsオブジェクト
○
セッションの詳細オブジェクト。 この
sessionDetails オブジェクトには、セッションの詳細プロパティを含める必要があります。 を参照してください。 メディアコレクションスキーマ 詳しくは、ドキュメントを参照してください。xdm.mediaCollection.playhead整数
○
現在の再生ヘッド。
xdm.mediaCollection.qoeDataDetailsオブジェクト
×
エクスペリエンスデータの品質の詳細。 を参照してください。 メディアコレクションスキーマ 詳しくは、ドキュメントを参照してください。
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636