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

Tipo de carregamento de anúncio

Última atualização: 4 de junho de 2026

Criado para:

  • Developer

Esta página aborda a coleta de dados para a variável Tipo de carregamento de anúncio. Consulte Carregamentos de anúncios para a dimensão de relatório correspondente.

style
shade-box

A variável de tipo de carregamento de anúncio identifica o tipo de anúncio carregado no início da sessão. Esse valor é definido pelo sistema interno de entrega de anúncios da organização e não está restrito a uma lista discriminada padrão. Você pode usar qualquer cadeia de caracteres significativa para sua implementação, como "linear", "dynamic" ou "programmatic".

Propriedade
Valor
Variável de dados de contexto
a.media.adLoad
Campo da coleção XDM
xdm.mediaCollection.sessionDetails.adLoad
Característica do Audience Manager
c_contextdata.a.media.adLoad
Obrigatório
Não
Enviado com
Início da sessão, fechamento da sessão

Tipos de implementação recomendados

Web SDK

Definir adLoad dentro de xdm.mediaCollection.sessionDetails ao chamar createMediaSession:

code language-javascript 
alloy("createMediaSession", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        friendlyName: "My Video",
        length: 300,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        adLoad: "linear"
      },
      playhead: 0
    }
  }
});
iOS

Passe o tipo de carregamento de anúncio como uma chave de metadados no argumento de dicionário para trackSessionStart. Use MediaConstants.VideoMetadataKeys.AD_LOAD.

code language-swift 
var videoMetadata: [String: String] = [:]
videoMetadata[MediaConstants.VideoMetadataKeys.AD_LOAD] = "linear"

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

Passe o tipo de carregamento de anúncio como uma chave de metadados no argumento HashMap para trackSessionStart. Use MediaConstants.VideoMetadataKeys.AD_LOAD.

code language-kotlin 
val videoMetadata = HashMap<String, String>()
videoMetadata[MediaConstants.VideoMetadataKeys.AD_LOAD] = "linear"

tracker.trackSessionStart(mediaInfo, videoMetadata)
Roku

Use createMediaSession para definir adLoad dentro de sessionDetails:

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

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

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

Tipos de implementação herdada (somente Analytics)

Media SDK JS 3.x

Passar o tipo de carregamento de anúncio no objeto contextData usando ADB.Media.VideoMetadataKeys.AdLoad:

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

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Use ADBMobile.media.VideoMetadataKeys.AD_LOAD para definir o tipo de carregamento de anúncio na propriedade StandardMediaMetadata do objeto de mídia antes de chamar trackSessionStart:

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

Inclua media.adLoad no objeto params de sua solicitação POST sessionStart:

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

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