DocumentaçãoAnalyticsGuia de serviços para mídia de streaming

ID do ativo

Última atualização: 29 de maio de 2026

Criado para:

  • Developer

Esta página aborda a coleta de dados para a variável ID do ativo. Consulte ID do ativo para a dimensão de relatório correspondente.

style
shade-box

A variável ID do ativo é o identificador exclusivo do ativo de mídia subjacente (por exemplo, uma ID de episódio, uma ID de filme ou uma ID de evento em tempo real). Normalmente obtidos de autoridades de metadados, como EIDR, TMS/Gracenote ou Rovi, mas IDs proprietárias ou internas também são aceitas. Use-a quando precisar comparar o envolvimento em plataformas de distribuição que podem atribuir IDs de conteúdo diferentes para o mesmo ativo subjacente.

NOTE
O campo de coleção XDM usa maiúsculas ID: assetID.
Propriedade
Valor
Variável de dados de contexto
a.media.asset
Campo da coleção XDM
xdm.mediaCollection.sessionDetails.assetID
Característica do Audience Manager
c_contextdata.a.media.asset
Obrigatório
Não
Enviado com
Início da sessão, fechamento da sessão

Tipos de implementação recomendados

Web SDK

Definir assetID dentro de xdm.mediaCollection.sessionDetails ao chamar sendEvent:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        assetID: "89745363"
      },
      playhead: 0
    }
  }
});
iOS

Passe a ID do ativo como uma chave de metadados no argumento HashMap para trackSessionStart. Use MediaConstants.VideoMetadataKeys.ASSET_ID.

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.VideoMetadataKeys.ASSET_ID] = "89745363"

tracker.trackSessionStart(info: mediaObject, metadata: metadata)
Android

Passe a ID do ativo como uma chave de metadados no argumento HashMap para trackSessionStart. Use MediaConstants.VideoMetadataKeys.ASSET_ID.

code language-kotlin 
val metadata = HashMap<String, String>()
metadata[MediaConstants.VideoMetadataKeys.ASSET_ID] = "89745363"

tracker.trackSessionStart(mediaInfo, metadata)
Roku

Use createMediaSession para definir assetID dentro de sessionDetails:

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "assetID": "89745363"
            },
            "playhead": 0
        }
    }
})
API do Media Edge

Chame o ponto de extremidade sessionStart com assetID dentro de xdm.mediaCollection.sessionDetails:

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

Tipos de implementação herdada (somente Analytics)

Media SDK JS 3.x

Passar a ID do ativo no objeto contextData usando ADB.Media.VideoMetadataKeys.AssetId:

code language-javascript 
var contextData = {};
contextData[ADB.Media.VideoMetadataKeys.AssetId] = "89745363";

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Use ADBMobile.media.VideoMetadataKeys.ASSET_ID para definir a ID do ativo na propriedade StandardMediaMetadata do objeto de mídia antes de chamar trackSessionStart:

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject("My Video", "video-123", 128,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video);
var standardMetadata = {};
standardMetadata[ADBMobile.media.VideoMetadataKeys.ASSET_ID] = "89745363";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);
API da coleção de mídia

Incluir media.assetId no objeto params:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.assetId": "89745363"
  }
}

Consulte a Referência de sessões da API Media Collection para obter a estrutura de solicitação completa.

recommendation-more-help
media-analytics-help