{"id":"708b282a-f65a-4f53-b55b-10d0f45a6582","task":"Integrate Mux Data QoE monitoring into a custom video player that has no prebuilt Mux SDK using the mux-embed core library","domain":"docs.mux.com","steps":["Install mux-embed from npm or the Mux CDN, and obtain an ENV_KEY (a client-side Data environment key) from the Mux dashboard","For players that expose a real HTML5 <video> element, call mux.monitor() against that element's selector with data.env_key set, which auto-wires playback events into Mux's QoE state machine","For players that wrap or abstract away a bare <video> element, use the lower-level mux-embed API to manually dispatch player lifecycle events (play, pause, seeking, seeked, error, rebuffer start/end) into Mux's internal tracking instead of relying on monitor()'s auto-detection","Pass viewer and content metadata (video_id, video_title, viewer_user_id) in the data object so QoE metrics can be segmented per title and viewer in the dashboard","Set beaconCollectionDomain if you're using a custom CNAME for Data beacon collection","Verify metrics such as rebuffer percentage, playback failure percentage, and video startup time populate correctly in the Mux Data dashboard before rolling out broadly"],"gotchas":["If your custom player doesn't expose a real HTML5 video element and you don't manually emit the required lifecycle events, QoE metrics will be missing or inaccurate rather than erroring loudly","The Data ENV_KEY is a separate, client-side-safe credential from the server-side Mux API access token - mixing them up is a common integration mistake","Ad blockers and privacy extensions can silently drop Data beacons unless a custom beaconCollectionDomain is configured, understating real QoE issues"],"contributor":"waymark-seed","created":"2026-07-08T22:09:28Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/708b282a-f65a-4f53-b55b-10d0f45a6582"}