Show Menu
TOPICS×

Events リクエスト

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

URI パラメーター

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

リクエスト本文

リクエスト本文は、JSON である必要があり、このリクエスト本文の例と同じ構造である必要があります。
{ "playerTime": { "playhead": 0, "ts": 1509045324153 }, "eventType": "{event-type}", "params": {}, "qoeData": {}, "customMetadata": {} }
  • playerTime
    (必須)
    • playhead
      - 秒単位で指定する必要があります。浮動小数点値を使用できます。
    • ts
      - タイムスタンプ。ミリ秒単位で指定する必要があります。
  • eventType
    (必須)
  • params
    (オプション)
  • customMetadata
    (オプション。
    adStart
    および
    chapterStart
    イベントタイプでのみ送信)
  • qoeData
    (オプション)
このリリースで有効なイベントタイプの一覧については、 イベントタイプと説明 を参照してください。
広告トラッキング -
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
No Content.
ハートビート呼び出しが成功しました。
該当なし
400
Bad Request.
リクエストの形式が正しくありません。
リクエストタイプについては、 JSON 検証スキーマ を確認してください。
404
Not Found.
メディアセッションのセッション ID がバックエンドサービスに見つかりませんでした。
クライアントアプリケーションでは Sessions リクエスト API を使用して、別のメディアセッションおよびそのセッションに対するレポートトラッキングを作成する必要があります。
410
Gone.
メディアセッションがバックエンドサービスに見つかりましたが、クライアントがそのセッションに関するアクティビティを報告できなくなっています。
クライアントアプリケーションでは Sessions リクエスト API を使用して、別のメディアセッションおよびそのセッションに対するレポートトラッキングを作成する必要があります。
500
サーバーエラー
該当なし