Show Menu
トピック×

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
コンテンツがありません。
ハートビート呼び出しが成功しました。
該当なし
400
不正なリクエストです。
リクエストの形式が正しくありません。
リクエストタイプについては、 JSON 検証スキーマ を確認してください。
404
見つかりません。
メディアセッションのセッション ID がバックエンドサービスに見つかりませんでした。
クライアントアプリケーションでは Sessions リクエスト API を使用して、別のメディアセッションおよびそのセッションに対するレポートトラッキングを作成する必要があります。
410
なくなりました。
メディアセッションがバックエンドサービスに見つかりましたが、クライアントがそのセッションに関するアクティビティを報告できなくなっています。
クライアントアプリケーションでは Sessions リクエスト API を使用して、別のメディアセッションおよびそのセッションに対するレポートトラッキングを作成する必要があります。
500
サーバーエラー
該当なし