ドキュメントAnalyticsメディア解析ガイド

Events リクエスト events-request

Last update: Mon Jan 23 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • User
  • Admin
  • Developer

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 応答コード

HTTP 応答コード
説明
クライアントのアクション項目
204
コンテンツがありません。

ハートビート呼び出しが成功しました。
該当なし
400
不正なリクエストです。

リクエストの形式が正しくありません。
リクエストタイプについては、JSON 検証スキーマを確認してください。
404
見つかりません。

メディアセッションのセッション ID がバックエンドサービスに見つかりませんでした。
クライアントアプリケーションでは Sessions リクエスト API を使用して、別のメディアセッションおよびそのセッションに対するレポートトラッキングを作成する必要があります。
410
なくなりました。

メディアセッションがバックエンドサービスに見つかりましたが、クライアントがそのセッションに関するアクティビティを報告できなくなっています。
クライアントアプリケーションでは Sessions リクエスト API を使用して、別のメディアセッションおよびそのセッションに対するレポートトラッキングを作成する必要があります。
500
サーバーエラー
該当なし
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb