`sendMediaEvent`

最終更新日： 2026年6月16日

トピック：
{"id":"e08599ea-8888-4294-ba74-3ba0a7762a46"}

作成対象：

{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

sendMediaEvent コマンドは、Web SDK streamingMedia コンポーネントの一部です。このコンポーネントを使用して、web サイトのメディアセッションに関連するデータを収集できます。このコンポーネントの設定方法については、streamingMedia ドキュメントを参照してください。

sendMediaEvent コマンドを使用して、メディアの再生、一時停止、完了、プレーヤーの状態の更新、およびその他の関連イベントを追跡します。

Web SDKは、メディアセッショントラッキングの種類に基づいてメディアイベントを処理できます。

自動的に追跡されるセッションのイベント処理。このモードでは、sessionIDをメディアイベントまたは再生ヘッドの値に渡す必要はありません。 Web SDKは、指定されたプレーヤーIDと、メディアセッションの開始時に指定されたgetPlayerDetails コールバック関数に基づいて、これを処理します。
手動で追跡されたセッションのイベント処理。このモードでは、再生ヘッドの値（整数値）と共にsessionIDをメディアイベントに渡す必要があります。必要に応じて、Quality of Experience データの詳細を渡すこともできます。

タイプ別のメディアイベントの処理 handle-by-type

以下のタブを選択して、各イベントタイプおよびセッショントラッキング方法（自動または手動）のイベントタイプ処理の例を確認します。

再生 play

media.play イベントタイプは、メディアの再生がいつ開始されるかを追跡するために使用されます。このイベントは、プレーヤーが状態を別の状態から「再生」に変更したときに送信する必要があります。プレーヤーが「再生」に移動するその他の状態には、「バッファリング」、「一時停止」から再開するユーザー、エラーから回復するプレーヤー、または自動再生が含まれます。

自動セッション追跡

code language-javascript
`alloy("sendMediaEvent", { playerId: "movie-test", xdm: { eventType: "media.play" } });`

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.play",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID
            }
        }
    });
});

一時停止 pause

media.pauseStart イベントタイプは、メディア再生が一時停止されたタイミングを追跡するために使用されます。このイベントは、ユーザーが 一時停止 を押したときに送信する必要があります。再開イベントタイプがありません。 media.pauseStartの後にmedia.play イベントを送信すると、履歴書が推測されます。

自動セッション追跡

code language-javascript
`alloy("sendMediaEvent", { playerId: "movie-test", xdm: { eventType: "media.pauseStart" } });`

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.pauseStart",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID
            }
        }
    });
});

エラー error

メディア再生中にエラーが発生した場合は、media.error イベントタイプを使用して追跡します。このイベントは、エラーが発生したときに送信する必要があります。

自動セッション追跡

code language-javascript
`alloy("sendMediaEvent", { playerId: "movie-test", xdm: { eventType: "media.error", mediaCollection: { errorDetails: { name: "network-error", source: "player" } } } });`

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.error",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID,
                errorDetails: {
                    name: "network-error",
                    source: "player"
                }
            }
        }
    });
});

広告休憩の開始 ad-break-start

media.adBreakStart イベントタイプは、広告ブレークの開始時間を追跡するために使用されます。このイベントは、広告枠が開始されたときに送信する必要があります。

自動セッション追跡

code language-javascript
`alloy("sendMediaEvent", { playerId: "movie-test", xdm: { eventType: "media.adBreakStart", mediaCollection: { advertisingPodDetails: { friendlyName: "Mid-roll", offset: 0, index: 1 } } } });`

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.adBreakStart",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID,
                advertisingPodDetails: {
                    friendlyName: "Mid-roll",
                    offset: 0,
                    index: 1
                }
            }
        }
    });
});

広告ブレーク完了 ad-break-complete

media.adBreakComplete イベントタイプは、広告ブレークが完了したときに追跡するために使用されます。このイベントは、広告ブレークが完了したときに送信する必要があります。

自動セッション追跡

code language-javascript
`alloy("sendMediaEvent", { playerId: "movie-test", xdm: { eventType: "media.adBreakComplete" } });`

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.adBreakComplete",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID
            }
        }
    });
});

広告の開始 ad-start

media.adStart イベントタイプは、広告の開始時間を追跡するために使用されます。このイベントは、広告の開始時に送信する必要があります。

自動セッション追跡

code language-javascript

alloy("sendMediaEvent", {
    playerId: "movie-test",
    xdm: {
        eventType: "media.adStart",
        mediaCollection: {
            advertisingDetails: {
                friendlyName: "Ad 1",
                name: "/uri-reference/001",
                length: 10,
                advertiser: "Adobe Marketing",
                campaignID: "Adobe Analytics",
                creativeID: "creativeID",
                creativeURL: "https://creativeurl.com",
                placementID: "placementID",
                siteID: "siteID",
                podPosition: 11,
                playerName: "HTML5 player"
            },
            customMetadata: [{
                    name: "myCustomValue3",
                    value: "c3"
                },
                {
                    name: "myCustomValue2",
                    value: "c2"
                },
                {
                    name: "myCustomValue1",
                    value: "c1"
                }
            ]
        }
    }
});

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
        eventType: "media.adStart",
        mediaCollection: {
            playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
            sessionID,
            advertisingDetails: {
              friendlyName: "Ad 1",
              name: "/uri-reference/001",
              length: 10,
              advertiser: "Adobe Marketing",
              campaignID: "Adobe Analytics",
              creativeID: "creativeID",
              creativeURL: "https://creativeurl.com",
              placementID: "placementID",
              siteID: "siteID",
              podPosition: 11,
              playerName: "HTML5 player"
            },
            customMetadata: [
              {
                name: "myCustomValue3",
                value: "c3"
              },
              {
                name: "myCustomValue2",
                value: "c2"
              },
              {
                name: "myCustomValue1",
                value: "c1"
              }]
        }
        }
    });
});

広告が完了 ad-complete

media.adComplete イベントタイプは、広告が完了したときに追跡するために使用されます。このイベントは、広告が完了したときに送信する必要があります。

自動セッション追跡

code language-javascript
`alloy("sendMediaEvent", { playerId: "movie-test", xdm: { eventType: "media.adComplete" } });`

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.adComplete",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID
            }
        }
    });
});

広告スキップ ad-skip

media.adSkip イベントタイプは、広告がスキップされたときに追跡するために使用されます。このイベントは、広告がスキップされたときに送信する必要があります。

自動セッション追跡

code language-javascript
`alloy("sendMediaEvent", { playerId: "movie-test", xdm: { eventType: "media.adSkip" } });`

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.adSkip",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID
            }
        }
    });
});

章の開始 chapter-start

media.chapterStart イベントタイプは、章の開始時間を追跡するために使用されます。このイベントは、章の開始時に送信する必要があります。

自動セッション追跡

code language-javascript

alloy("sendMediaEvent", {
    playerId: "movie-test",
    xdm: {
        eventType: "media.chapterStart",
        mediaCollection: {
            chapterDetails: {
                friendlyName: "Chapter 1",
                position: 1,
                length: 10,
                index: 1,
                offset: 0
            },
            customMetadata: [{
                    name: "myCustomValue3",
                    value: "c3"
                },
                {
                    name: "myCustomValue2",
                    value: "c2"
                },
                {
                    name: "myCustomValue1",
                    value: "c1"
                }
            ]
        }
    }
});

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.chapterStart",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID,
                chapterDetails: {
                    friendlyName: "Chapter 1",
                    position: 1,
                    length: 10,
                    index: 1,
                    offset: 0
                },
                customMetadata: [{
                        name: "myCustomValue3",
                        value: "c3"
                    },
                    {
                        name: "myCustomValue2",
                        value: "c2"
                    },
                    {
                        name: "myCustomValue1",
                        value: "c1"
                    }
                ]
            }
        }
    });
});

章完了 chapter-complete

media.chapterComplete イベントタイプは、章が完了したときに追跡するために使用されます。このイベントは、章が完了したときに送信する必要があります。

自動セッション追跡

code language-javascript
`alloy("sendMediaEvent", { playerId: "movie-test", xdm: { eventType: "media.chapterComplete" } });`

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.chapterComplete",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID
            }
        }
    });
});

章のスキップ chapter-skip

media.chapterSkip イベントタイプは、章がスキップされたときに追跡するために使用されます。このイベントは、章をスキップしたときに送信する必要があります。

自動セッション追跡

code language-javascript
`alloy("sendMediaEvent", { playerId: "movie-test", xdm: { eventType: "media.chapterSkip" } });`

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.chapterSkip",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID
            }
        }
    });
});

バッファー開始 buffer-start

media.bufferStart イベントタイプは、バッファリングの開始時を追跡するために使用されます。このイベントは、バッファリングの開始時に送信する必要があります。 bufferResume イベントタイプがありません。 bufferStartの後に再生イベントを送信すると、bufferResumeが推測されます。

自動セッション追跡

code language-javascript
`alloy("sendMediaEvent", { playerId: "movie-test", xdm: { eventType: "media.bufferStart" } });`

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.bufferStart",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID
            }
        }
    });
});

ビットレートの変更 bitrate-change

media.bitrateChange イベントタイプは、ビットレートの変更時を追跡するために使用されます。このイベントは、ビットレートが変更されたときに送信されます。

自動セッション追跡

code language-javascript

alloy("sendMediaEvent", {
    playerId: "movie-test",
    xdm: {
        eventType: "media.bitrateChange",
        mediaCollection: {
            qoeDataDetails: {
                framesPerSecond: 1,
                bitrate: 35000,
                droppedFrames: 30,
                timeToStart: 1364
            }
        }
    }
});

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.bitrateChange",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID,
                qoeDataDetails: {
                    bitrate: 35000,
                    droppedFrames: 30,
                    timeToStart: 1364
                }
            }
        }
    });
});

状態更新 state-updates

media.statesUpdate イベントタイプは、プレーヤーの状態が変更されたときに追跡するために使用されます。このイベントは、プレーヤーの状態が変更されたときに送信する必要があります。

自動セッション追跡

code language-javascript

alloy("sendMediaEvent", {
    playerId: "movie-test",
    xdm: {
        eventType: "media.statesUpdate",
        mediaCollection: {
            statesStart: [{
                    name: "mute"
                },
                {
                    name: "pictureInPicture"
                }
            ],
            statesEnd: [{
                name: "fullScreen"
            }]
        }
    }
});

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.stateUpdate",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID,
                statesStart: [{
                        name: "mute"
                    },
                    {
                        name: "pictureInPicture"
                    }
                ],
                statesEnd: [{
                    name: "fullScreen"
                }]
            }
        }
    });
});

セッション終了 session-end

media.sessionEnd イベントタイプは、ユーザーがコンテンツの表示を放棄し、戻る可能性が低い場合に、セッションを直ちに閉じるようにMedia Analytics バックエンドに通知するために使用されます。

sessionEnd イベントを送信しない場合、10分間イベントを受信しなかった後、または再生ヘッドの移動が30分間発生しなかった場合、放棄されたセッションはタイムアウトします。セッションは自動的に削除されます。

自動セッション追跡

code language-javascript
`alloy("sendMediaEvent", { playerId: "movie-test", xdm: { eventType: "media.sessionEnd" } });`

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.sessionEnd",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID
            }
        }
    });
});

セッション完了 session-complete

media.sessionComplete イベントタイプは、メディアセッションが完了したときに追跡するために使用されます。このイベントは、メインコンテンツの最後に達したときに送信する必要があります。

自動セッション追跡

code language-javascript
`alloy("sendMediaEvent", { playerId: "movie-test", xdm: { eventType: "media.sessionComplete" } });`

手動セッション追跡

code language-javascript

sessionPromise.then(sessionID => {
    alloy("sendMediaEvent", {
        xdm: {
            eventType: "media.sessionComplete",
            mediaCollection: {
                playhead: parseInt(document.getElementById("movie-test").currentTime, 10),
                sessionID
            }
        }
    });
});

Web SDK タグ拡張機能を使用したメディアイベントの送信

このコマンドと同等のWeb SDK タグ拡張機能は、Send media event アクションです。

recommendation-more-help

experience-platform-help-collection