DocumentaciónAnalyticsGuía de servicios de medios de streaming

Silenciar

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos del estado del reproductor Silenciar. Vea Transmisiones afectadas por silenciar, Recuentos de silenciar y Duración total de silenciar para las métricas de informes correspondientes.

style
shade-box

El estado del reproductor en silencio rastrea cuando el visualizador silencia y reactiva el audio. Active un evento de inicio de estado cuando el visor se silencie y un evento de fin de estado cuando el visor se reactive. El servidor calcula tres métricas a partir de estos eventos: flujos afectados, recuento de entradas de estado y tiempo total en el estado.

Propiedad
Valor
Variables de datos de contexto
a.media.states.mute.set, a.media.states.mute.count, a.media.states.mute.time
Campo de colección XDM
xdm.mediaCollection.statesStart[] y xdm.mediaCollection.statesEnd[] (entradas con name: "mute")
rasgos de Audience Manager
c_contextdata.a.media.states.mute.set, c_contextdata.a.media.states.mute.count, c_contextdata.a.media.states.mute.time
Requerido
No
Enviado con
Inicio de estado, fin de estado

Tipos de implementación recomendados

SDK web

Use sendEvent para enviar un evento media.statesUpdate con el estado agregado a statesStart:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.statesUpdate",
    mediaCollection: {
      statesStart: [{ name: "mute" }],
      sessionID: "{sid}",
      playhead: 60
    }
  }
});

Cuando el visor se reactive, envíe otro evento con el estado statesEnd:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.statesUpdate",
    mediaCollection: {
      statesEnd: [{ name: "mute" }],
      sessionID: "{sid}",
      playhead: 90
    }
  }
});
iOS

Use tracker.trackPlayerStateStart() y tracker.trackPlayerStateEnd() con la constante MediaConstants.PlayerState.MUTE.

code language-swift 
let stateObject = Media.createStateObjectWith(stateName: MediaConstants.PlayerState.MUTE)

tracker.trackPlayerStateStart(info: stateObject)
tracker.trackPlayerStateEnd(info: stateObject)
Android

Use tracker.trackPlayerStateStart() y tracker.trackPlayerStateEnd() con la constante MediaConstants.PlayerState.MUTE.

code language-kotlin 
val stateObject = Media.createStateObject(MediaConstants.PlayerState.MUTE)

tracker.trackPlayerStateStart(stateObject)
tracker.trackPlayerStateEnd(stateObject)
Roku Edge

Use sendMediaEvent para enviar un evento media.statesUpdate con el estado agregado a statesStart:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.statesUpdate",
        "mediaCollection": {
            "statesStart": [{ "name": "mute" }],
            "playhead": 60
        }
    }
})

Cuando el visor se reactive, envíe otro evento con el estado statesEnd:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.statesUpdate",
        "mediaCollection": {
            "statesEnd": [{ "name": "mute" }],
            "playhead": 90
        }
    }
})
API de Media Edge

Llame al extremo statesUpdate con mute en statesStart (o statesEnd cuando el visor se reactiva):

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.statesUpdate",
      "mediaCollection": {
        "statesStart": [{ "name": "mute" }],
        "sessionID": "{sid}",
        "playhead": 60
      }
    }
  }]
}

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Use ADB.Media.createStateObject y la constante ADB.Media.PlayerState.Mute:

code language-javascript 
var stateObject = ADB.Media.createStateObject(ADB.Media.PlayerState.Mute);

tracker.trackPlayerStateStart(stateObject);
tracker.trackPlayerStateEnd(stateObject);
Chromecast

Utilice ADBMobile.media.createStateObject con la cadena "mute" directamente, ya que Chromecast no tiene constantes PlayerState con nombre:

code language-javascript 
var stateObject = ADBMobile.media.createStateObject("mute");
ADBMobile.media.trackEvent(ADBMobile.media.Event.StateStart, stateObject);
// When the viewer unmutes:
ADBMobile.media.trackEvent(ADBMobile.media.Event.StateEnd, stateObject);
Roku 2.x
El seguimiento del estado del reproductor no está disponible en SDK Roku 2.x. Para rastrear estados de reproductor, usa Roku Edge SDK.
API de recopilación de medios

Envíe una solicitud POST de stateStart cuando el visor se silencie y una POST de stateEnd cuando se reactive:

code language-json 
{
  "playerTime": { "playhead": 60, "ts": 1699523820000 },
  "eventType": "stateStart",
  "params": {
    "media.state.name": "mute"
  }
}

Consulte la referencia de eventos de API de Media Collection para obtener la estructura de solicitudes completa.

recommendation-more-help
media-analytics-help