createMediaSession
createMediaSession コマンドは、Web SDK streamingMedia コンポーネントの一部です。 このコンポーネントを使用すると、web サイト上のメディアセッションに関連するデータを収集できます。 このコンポーネントの設定方法については、streamingMedia ドキュメント を参照してください。
収集されたデータには、メディアプレイバック、一時停止、完了およびその他の関連イベントに関する情報を含めることができます。 収集したら、このデータを Adobe Analytics for Streaming Media に送信して、指標を集計できます。 この機能は、web サイトでのメディア消費行動を追跡および把握するための包括的なソリューションを提供します。
Web SDKでは、次の 2 つの方法でメディアセッションを作成できます。
- 自動トラッキングされるメディアセッション により、Web SDKで Adobe Analytics for Streaming Media へのメディア ping イベントのディスパッチを管理できます。 これらの ping の頻度は、streamingMedia コンポーネントの設定によって決まります。
- 手動でトラッキングされるメディアセッション を使用すると、Adobe Analytics for Streaming Media へのセッション Ping イベントのディスパッチをより詳細に制御できます。 さらに、メディアセッション用の
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関数
○
プレーヤーの詳細を返す関数。 このコールバック関数は、指定された
playerId の各メディアイベントの前に、Web SDKによって呼び出されます。xdm.eventTypeオブジェクト
×
メディアイベントタイプ。 指定しない場合、このフィールドは自動的に
media.sessionStart に設定されます。xdm.mediaCollection.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オブジェクト
○
セッションの詳細プロパティが含まれます。 詳しくは、 メディアコレクションのスキーマ を参照してください。
xdm.mediaCollection.playhead整数
○
現在の再生ヘッド。
xdm.mediaCollection.qoeDataDetailsオブジェクト
×
エクスペリエンスデータの品質の詳細。 詳しくは、 メディアコレクションのスキーマ ドキュメントを参照してください。
Web SDK タグ拡張機能を使用したメディアセッションの作成
このコマンドと同等の Web SDK タグ拡張機能は、'Session start' アクション内の Send media event イベントタイプです。
recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1