앱 버전

마지막 업데이트: 2026년 9월 30일

주제:
Analysis Workspace

작성 대상:

개발자

이 페이지에서는 앱 버전 변수에 대한 데이터 수집을 다룹니다. 해당 보고 차원에 대한 앱 버전을 참조하세요.

style

shade-box

앱 버전 변수는 미디어 플레이어 애플리케이션의 버전을 식별합니다. SDK 초기화 중에 한 번 설정합니다. 이 값은 모든 후속 세션 시작 요청에 자동으로 포함됩니다. 응용 프로그램의 릴리스 주기(예: "2.1.0" 또는 "prod-YYYY-03-15")와 일치하는 버전 문자열을 사용합니다.

NOTE

이 필드는 Adobe의 SDK 라이브러리가 아닌 미디어 플레이어 응용 프로그램의 버전을 캡처합니다. Adobe의 자체 SDK 라이브러리 버전은 별도의 내부 필드로 자동으로 수집됩니다.

속성

값

XDM 컬렉션 필드

xdm.mediaCollection.sessionDetails.appVersion

미디어 컬렉션 API 매개 변수

media.sdkVersion

필수

아니요

전송 시점

세션 시작

권장 구현 유형

웹 SDK

configure을(를) 호출할 때 streamingMedia 구성 개체에 appVersion을(를) 설정합니다.

code language-javascript
`alloy("configure", { streamingMedia: { channel: "Sports Channel", playerName: "HTML5 Player", appVersion: "2.1.0", mainPingInterval: 10, adPingInterval: 10 } });`

iOS

미디어 추적기를 초기화하기 전에 앱 구성에서 edgeMedia.appVersion을(를) 설정합니다.

code language-swift

var config: [String: Any] = [:]
config["edgeMedia.channel"] = "sample_channel"
config["edgeMedia.playerName"] = "player_name"
config["edgeMedia.appVersion"] = "2.1.0"
MobileCore.updateConfiguration(config)

Android

미디어 추적기를 초기화하기 전에 앱 구성에서 edgeMedia.appVersion을(를) 설정합니다.

code language-kotlin
`val config: Map<String, Any> = mapOf( "edgeMedia.channel" to "sample_channel", "edgeMedia.playerName" to "player_name", "edgeMedia.appVersion" to "2.1.0" ) MobileCore.updateConfiguration(config)`

Roku Edge

ADB_CONSTANTS.CONFIGURATION.MEDIA_APP_VERSION을(를) 사용하여 SDK 구성에서 앱 버전을 설정합니다.

code language-brightscript

ADB_CONSTANTS = AdobeAEPSDKConstants()
configuration = {}
configuration[ADB_CONSTANTS.CONFIGURATION.EDGE_CONFIG_ID] = "<YOUR_CONFIG_ID>"
configuration[ADB_CONSTANTS.CONFIGURATION.MEDIA_CHANNEL] = "channel_name"
configuration[ADB_CONSTANTS.CONFIGURATION.MEDIA_PLAYER_NAME] = "player_name"
configuration[ADB_CONSTANTS.CONFIGURATION.MEDIA_APP_VERSION] = "2.1.0"
m.aepSdk.updateConfiguration(configuration)

미디어 Edge API

sessionStart 요청의 sessionDetails 개체에 appVersion 포함:

code language-json

{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 300,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports",
          "appVersion": "2.1.0"
        },
        "playhead": 0
      }
    }
  }]
}

이전 구현 유형(Analytics 전용)

Media SDK JS 3.x

ADB.Media.configure을(를) 호출하기 전에 MediaConfig 개체에 appVersion을(를) 설정합니다.

code language-javascript

var mediaConfig = new ADB.MediaConfig();
mediaConfig.playerName = "player_name";
mediaConfig.channel = "sample_channel";
mediaConfig.appVersion = "2.1.0";
ADB.Media.configure(mediaConfig, appMeasurement);

Chromecast

ADBMobile 구성의 mediaHeartbeat 섹션에서 sdkVersion을(를) 설정합니다. 이 필드는 Chromecast SDK 라이브러리 버전이 아닌 플레이어 애플리케이션 버전을 캡처합니다.

code language-javascript

var ADBMobileConfig = {
  "mediaHeartbeat": {
    "server": "obumobile5.hb-api.omtrdc.net",
    "publisher": "<YOUR_PUBLISHER_ID>@AdobeOrg",
    "channel": "sample-channel",
    "ssl": true,
    "playerName": "Chromecast Player",
    "sdkVersion": "2.1.0"
  }
};

Roku 2.x

ADBMobileConfig.json의 mediaHeartbeat 섹션에서 sdkVersion을(를) 설정합니다. 이 필드는 Roku 2.x SDK 라이브러리 버전이 아닌 플레이어 애플리케이션 버전을 캡처합니다.

code language-json
`"mediaHeartbeat": { "sdkVersion": "2.1.0" }`

미디어 컬렉션 API

sessionStart POST 요청의 params 개체에 media.sdkVersion 포함:

code language-json

{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.playerName": "sample-html5-api-player",
    "media.sdkVersion": "2.1.0",
    "media.channel": "sample-channel"
  }
}

전체 요청 구조에 대해서는 Media Collection API 세션 참조를 참조하십시오.

recommendation-more-help

media-analytics-help