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

Nome do player do anúncio

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

Criado para:

  • Developer

Esta página aborda a coleta de dados para a variável Nome do player do anúncio. Consulte Nome do player do anúncio para a dimensão de relatório correspondente.

style
shade-box

A variável de nome do player de anúncio identifica qual player renderizou cada anúncio (por exemplo, "Freewheel", "Google IMA"). O reprodutor de anúncios pode diferir do reprodutor de conteúdo principal quando os anúncios são compilados por um serviço de inserção de anúncios do lado do servidor. Use essa variável para comparar a qualidade e a conclusão entre pilhas de veiculação de anúncios.

Propriedade
Valor
Variável de dados de contexto
a.media.ad.playerName
Campo da coleção XDM
xdm.mediaCollection.advertisingDetails.playerName
Característica do Audience Manager
c_contextdata.a.media.ad.playerName
Obrigatório
Sim
Enviado com
Início do anúncio e fechamento

Tipos de implementação recomendados

Web SDK

Definir playerName dentro de xdm.mediaCollection.advertisingDetails ao chamar sendEvent:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.adStart",
    mediaCollection: {
      advertisingDetails: {
        name: "ad-2125",
        playerName: "Freewheel"
      },
      sessionID: "{sid}",
      playhead: 0
    }
  }
});
iOS

Passe o nome do player de anúncio como a chave MediaConstants.AdMetadataKeys.AD_PLAYER no argumento HashMap de metadados para trackEvent(AdStart).

code language-swift 
var metadata: [String: String] = [:]
metadata[MediaConstants.AdMetadataKeys.AD_PLAYER] = "Freewheel"

tracker.trackEvent(event: MediaEvent.AdStart, info: adObject, metadata: metadata)
Android

Passe o nome do player de anúncio como a chave MediaConstants.AdMetadataKeys.AD_PLAYER no argumento HashMap de metadados para trackEvent(AdStart).

code language-kotlin 
val metadata = HashMap<String, String>()
metadata[MediaConstants.AdMetadataKeys.AD_PLAYER] = "Freewheel"

tracker.trackEvent(Media.Event.AdStart, adObject, metadata)
Roku

Definir playerName dentro de xdm.mediaCollection.advertisingDetails ao chamar sendMediaEvent para media.adStart:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.adStart",
        "mediaCollection": {
            "advertisingDetails": {
                "name": "ad-2125",
                "playerName": "Freewheel",
                "length": 15,
                "podPosition": 0
            },
            "playhead": 0
        }
    }
})
API do Media Edge

Chame o ponto de extremidade adStart com playerName dentro de xdm.mediaCollection.advertisingDetails:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.adStart",
      "mediaCollection": {
        "advertisingDetails": {
          "name": "ad-2125",
          "length": 15,
          "playerName": "Freewheel",
          "podPosition": 0
        },
        "sessionID": "{sid}",
        "playhead": 0
      }
    }
  }]
}

Tipos de implementação herdada (somente Analytics)

Media SDK JS 3.x

Passar o nome do player de anúncio no objeto contextData usando ADB.Media.AdMetadataKeys.AdPlayer:

code language-javascript 
var contextData = {};
contextData[ADB.Media.AdMetadataKeys.AdPlayer] = "Freewheel";

tracker.trackEvent(ADB.Media.Event.AdStart, adInfo, contextData);
Chromecast

Passe o nome do reprodutor de anúncios no objeto de metadados de contexto ao rastrear o evento de início do anúncio:

code language-javascript 
var adInfo = ADBMobile.media.createAdObject("Ford F-150", "ad-2125", 1, 30);
var metadata = { "a.media.ad.playerName": "Chromecast Player" };
ADBMobile.media.trackEvent(ADBMobile.media.Event.AdStart, adInfo, metadata);
API da coleção de mídia

Inclua media.ad.playerName no objeto params de sua solicitação POST adStart:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "adStart",
  "params": {
    "media.ad.playerName": "Freewheel"
  }
}

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

recommendation-more-help
media-analytics-help