Events リクエスト

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

URI パラメーター

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

リクエスト本文

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

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

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

重要

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

広告の前後に adBreakStartadBreakComplete の「ブックエンド」がない場合、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 サーバーエラー 該当なし

このページ