DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Stummschaltung

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Auf dieser Seite wird die Datenerfassung für den Player Status „Stumm​behandelt. Siehe Von Stummschaltung betroffene Streams, Stummschaltungsanzahl und Stummschaltungsgesamtdauer für die entsprechenden Berichtsmetriken.

style
shade-box

Der Status des Stummschaltungs-Players verfolgt, wann der Viewer Audio stummschaltet und die Stummschaltung aufhebt. Lösen Sie ein Statusstartereignis aus, wenn der Viewer stumm geschaltet wird, und ein Statusendereignis, wenn die Stummschaltung des Viewers aufgehoben wird. Das Backend berechnet drei Metriken aus diesen Ereignissen: betroffene Streams, Anzahl der Statuseinträge und Gesamtzeit im Status.

Eigenschaft
Wert
Kontextdatenvariablen
a.media.states.mute.set, a.media.states.mute.count, a.media.states.mute.time
XDM-Sammlungsfeld
xdm.mediaCollection.statesStart[] und xdm.mediaCollection.statesEnd[] (Einträge mit name: "mute")
Audience Manager-Eigenschaften
c_contextdata.a.media.states.mute.set, c_contextdata.a.media.states.mute.count, c_contextdata.a.media.states.mute.time
Erforderlich
Nein
Gesendet mit
State start, state end

Empfohlene Implementierungsarten

Web SDK

Verwenden Sie sendEvent , um ein media.statesUpdate-Ereignis mit dem Status zu senden, der statesStart hinzugefügt wurde:

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

Wenn die Stummschaltung des Viewers aufgehoben wird, senden Sie ein weiteres Ereignis mit dem Status in statesEnd:

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

Verwenden Sie tracker.trackPlayerStateStart() und tracker.trackPlayerStateEnd() mit der MediaConstants.PlayerState.MUTE.

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

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

Verwenden Sie tracker.trackPlayerStateStart() und tracker.trackPlayerStateEnd() mit der MediaConstants.PlayerState.MUTE.

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

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

Verwenden Sie sendMediaEvent , um ein media.statesUpdate-Ereignis mit dem Status zu senden, der statesStart hinzugefügt wurde:

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

Wenn die Stummschaltung des Viewers aufgehoben wird, senden Sie ein weiteres Ereignis mit dem Status in statesEnd:

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

Rufen Sie den Endpunkt statesUpdate mit mute in statesStart auf (oder statesEnd, wenn die Stummschaltung des Viewers aufgehoben wird):

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

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Verwenden Sie ADB.Media.createStateObject und die ADB.Media.PlayerState.Mute Konstante:

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

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

Verwenden Sie ADBMobile.media.createStateObject direkt mit der "mute" Zeichenfolge, da Chromecast keine benannten PlayerState enthält:

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);
Media Collection API

Senden Sie eine stateStart POST-Anfrage, wenn der Viewer stummgeschaltet wird, und eine stateEnd POST, wenn die Stummschaltung aufgehoben wird:

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

Die vollständige Anfragestruktur ​ Sie in der ​ zur Mediensammlungs-API-Ereignisreferenz .

recommendation-more-help
media-analytics-help