Events リクエスト events-request

Last update: Mon Jul 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

ユーザー
管理者
開発者

POST https://{uri}/api/v1/sessions/{sid}/events

URI パラメーター

sid：セッションリクエストから返されたセッション ID。

リクエスト本文

リクエスト本文は、JSON である必要があり、このリクエスト本文の例と同じ構造である必要があります。

{
    "playerTime": {
        "playhead": 0,
        "ts": 1509045324153
    },
    "eventType": "{event-type}",
    "params": {},
    "qoeData": {},
    "customMetadata": {}
}

playerTime (必須)
- playhead - 秒単位で指定する必要があります。浮動小数点値を使用できます。
- ts - タイムスタンプ。ミリ秒単位で指定する必要があります。
eventType (必須)
params (オプション)
customMetadata（オプション。adStart および chapterStart イベントタイプでのみ送信）
qoeData (オプション)

このリリースで有効なイベントタイプの一覧については、イベントタイプと説明を参照してください。

IMPORTANT

広告トラッキング -adBreak 内の広告のみ追跡できます。

広告の前後に adBreakStart と adBreakComplete の「ブックエンド」がない場合、adStart および adComplete イベントは単に無視され、対応する広告期間がメインコンテンツ期間として追跡されます。これは、Adobe Analytics で使用できる集計データに大きな影響を与える可能性があります。

応答

HTTP/1.1 204 No Content
Server nginx/1.13.5
Date Thu, 26 Oct 2017 19:15:24 GMT
Connection keep-alive
Access-Control-Allow-Origin *
Access-Control-Allow-Methods OPTIONS,POST,PUT
Access-Control-Allow-Headers Content-Type
Access-Control-Expose-Headers Location

HTTP 応答コード

説明

クライアントのアクション項目

204

コンテンツがありません。

ハートビート呼び出しが成功しました。

該当なし

400

不正なリクエストです。

リクエストの形式が正しくありません。

リクエストタイプについては、JSON 検証スキーマを確認してください。

404

見つかりません。

メディアセッションのセッション ID がバックエンドサービスに見つかりませんでした。

クライアントアプリケーションでは Sessions リクエスト API を使用して、別のメディアセッションおよびそのセッションに対するレポートトラッキングを作成する必要があります。

410

なくなりました。

メディアセッションがバックエンドサービスに見つかりましたが、クライアントがそのセッションに関するアクティビティを報告できなくなっています。

500

サーバーエラー

該当なし

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb