開始時間

このページでは、開始時間​変数のデータ収集について説明します。 対応するレポートディメンションと指標については、開始までの時間を参照してください。

変数を開始するまでの時間は、再生を開始してから最初のフレームレンダリングまでの経過時間(ミリ秒単位)です。 セッション開始イベントが発生する前に、QoE オブジェクトに設定します。 Adobeは、値を数秒で保存およびレポートします。ミリ秒単位で渡すと、取り込み時にAdobeがコンバージョンします。

IMPORTANT
プレーヤーがコンテンツフレームのレンダリングを開始したら、timeToStartの更新を停止します。 この値は、最初のバッファリングまたは読み込みフェーズで増加する可能性がありますが、再生が開始された時点から固定として扱う必要があります。 最初のフレームレンダリング後に更新を続けると、膨張または不正確な開始時間指標が生成されます。
プロパティ
コンテキストデータ変数
a.media.qoe.timeToStart
XDM コレクションフィールド
xdm.mediaCollection.qoeDataDetails.timeToStart
Audience Manager特性
c_contextdata.a.media.qoe.timeToStart
必須
いいえ
様が​様と共に送信されました
​ セッション開始、セッション終了

推奨される実装タイプ

Web SDK

sendEventの呼び出し時にmedia.sessionStartxdm.mediaCollection.qoeDataDetails内にtimeToStartを設定:

code language-javascript
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        length: 128,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        streamType: "video"
      },
      qoeDataDetails: {
        timeToStart: 30000
      },
      playhead: 0
    }
  }
});
iOS

起動時間を2番目の引数(startupTime)としてcreateQoEObjectに渡します。

code language-swift
let qoeObject = Media.createQoEObjectWith(bitrate: 3200,
                                       startupTime: 30000,
                                               fps: 24,
                                     droppedFrames: 0)

tracker.updateQoEObject(qoe: qoeObject)
Android

起動時間を2番目の引数(startupTime)としてcreateQoEObjectに渡します。

code language-kotlin
val qoeObject = Media.createQoEObject(3200L,
                                      30000.0,
                                      24.0,
                                      0L)

tracker.updateQoEObject(qoeObject)
Roku

createMediaSessionの呼び出し時にmedia.sessionStartxdm.mediaCollection.qoeDataDetails内にtimeToStartを設定:

code language-brightscript
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "name": "video-123",
                "length": 128,
                "contentType": "vod",
                "playerName": "Roku Player",
                "channel": "Sports",
                "streamType": "video"
            },
            "qoeDataDetails": {
                "timeToStart": 30000
            },
            "playhead": 0
        }
    }
})
Media Edge API

xdm.mediaCollection.qoeDataDetails内のtimeToStartsessionStart エンドポイントを呼び出します:

code language-json
{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 128,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports"
        },
        "qoeDataDetails": {
          "timeToStart": 30000
        },
        "playhead": 0
      }
    }
  }]
}

従来の実装タイプ (Analyticsのみ)

Media SDK JS 3.x

2番目の引数として開始する時間をADB.Media.createQoEObjectに渡します:

code language-javascript
var qoeObject = ADB.Media.createQoEObject(3200, 30000, 24, 0);
tracker.updateQoEObject(qoeObject);
Chromecast

起動時間を2番目の引数(startupTime)としてADBMobile.media.createQoSObjectにミリ秒単位で渡し、トラッカーを更新します。

code language-javascript
var qosInfo = ADBMobile.media.createQoSObject(
  3200,   // bitrate
  0,      // startupTime (ms)
  24,     // fps
  0       // droppedFrames
);
ADBMobile.media.updateQoSObject(qosInfo);
Media Collection API

sessionStartparams オブジェクトにmedia.qoe.timeToStartを含めます:

code language-json
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.qoe.timeToStart": 30000
  }
}

完全なリクエスト構造については、Media Collection API セッションのリファレンス ​を参照してください。

recommendation-more-help
media-analytics-help