Medición
Seguimiento de video
Un clip original de ocho segundos, más un embed opcional de YouTube tras el consentimiento. Los hitos, el tiempo visto y el dataLayer se quedan en esta página.
Entender el laboratorioCómo usarlo y por qué querrías hacerlo
Por qué querrías hacerlo
Un clip de ocho segundos emite inicio, hito, completo y engagement por el dataLayer, y los segundos de reanudación se guardan en localStorage solo después de Aceptar. El laboratorio no llama a Adobe.
Cómo usarlo
- Reproduce el clip. video_start se envía una vez.
- Un hito se dispara una vez. Un salto se clasifica en la página.
- La atención se puntúa en local.
- Un segundo de reanudación se guarda solo después de Aceptar.
Simulación. El clip se generó para este laboratorio. Los eventos van al dataLayer solo con consentimiento de medición, y aparecen en el inspector flotante. Sin un servicio de pago nuevo.
HTML5
Este clip
- Arranque: ausente
- En vista: ausente
- Almacenando: no
- Tasa de bits: ausente. Este archivo tiene una sola versión.
- Atención: ausente
- Revisto: aún ninguno
- Saltado: aún ninguno
- Siguiente capítulo: ausente hasta un salto
- Corte: ausente hasta que la reproducción pase 25% o 50%
Aún no hay un evento del reproductor.
¿Por qué veo esto? Reproducir, pausar, buscar, fin y los hitos 10/25/50/75/90/100 vienen del elemento media. El tiempo visto cuenta solo mientras se reproduce. La posición es currentTime. Una pestaña oculta pausa la reproducción. La tasa de bits está ausente porque este archivo expone una sola versión.
YouTube
Incrustación opcional
idle
¿Por qué veo esto? La API IFrame se carga solo tras este botón y solo con consentimiento de medición. El host es youtube-nocookie.com. La película es Big Buck Bunny de la Blender Foundation, Creative Commons Attribution. Vimeo no se incrusta: sus eventos de player.js son parecidos, pero el iframe es un tercero salvo un embed de privacidad, y esta página no llama a Vimeo.
RecorridoCómo lo hicimosMostrarOcultar
El ajuste de proveedor de ejemplo está marcado abajo. Los números de eVar y de event son ejemplos. Este laboratorio no llama a Adobe.
El laboratorio de video observa un clip de ocho segundos, emite eventos de inicio, hito, fin y participación a través del dataLayer, y guarda los segundos de reanudación en localStorage después de Aceptar. El laboratorio no llama a Adobe.
Enviar video_start una vez
La primera reproducción llama a trackVideoEvent para video_start con el título, el proveedor html5, la ruta del clip, la duración y el tiempo actual. También llama a trackLab para lab_interaction con la etiqueta html5-start.
Emitir un hito una vez
onTime suma el tiempo transcurrido solo cuando el delta está entre 0 y 1,2 segundos, y luego freshMilestones emite video_progress para 10, 25, 50, 75, 90 y 100 la primera vez que el porcentaje cruza cada marca.
Clasificar un seek y puntuar la atención en local
classifySeek nombra los capítulos que se saltaron o se volvieron a ver. attentionScore multiplica los segundos vistos sobre la duración por el porcentaje visible. Esos números se dibujan en la página.
Guardar un segundo de reanudación solo después de Aceptar
Mientras el consentimiento está concedido, onTime escribe el tiempo actual redondeado hacia abajo en site.video.resume.v1. readResume devuelve null salvo que esa misma clave de consentimiento esté granted. El embed de YouTube carga solo después de Aceptar.
Encolar también una vista del laboratorio
useLabView encola lab_interaction con lab_id video-tracking, action view y label page, una vez, después de Aceptar. pushEvent vuelve antes de cualquier evento de video cuando el consentimiento está apagado.
Del código
El porcentaje, el filtro de hitos y el clasificador de seek. Los capítulos son tres cortes fijos.
export function playbackPercent(current: number, duration: number) {
if (!Number.isFinite(duration) || duration <= 0 || !Number.isFinite(current)) return null
return Math.min(100, Math.max(0, (current / duration) * 100))
}
export function freshMilestones(seen: readonly number[], percent: number | null) {
if (percent === null) return []
return VIDEO_MILESTONES.filter((mark) => percent >= mark && !seen.includes(mark))
}
export function classifySeek(from: number, to: number) {
const skipped = VIDEO_CHAPTERS.filter((chapter) => from <= chapter.start && to >= chapter.end).map((chapter) => chapter.id)
const rewatched = VIDEO_CHAPTERS.filter((chapter) => to < from && to >= chapter.start && to < chapter.end).map((chapter) => chapter.id)
return { skipped, rewatched }
}La primera reproducción encola video_start. El primer frame en reproducción encola una participación de arranque.
}
function onPlay() {
const video = videoRef.current
if (!video) return
playStarted.current = performance.now()
if (!started.current) {
started.current = true
emit("video_start", base(video))
note("video_start")
trackLab(LAB, "html5-start")
}
}
function onPlaying() {
setBuffering(false)
if (playStarted.current === null || startupMs !== null) return
const ms = Math.round(performance.now() - playStarted.current)Google y Adobe
Google encola video_start después de Aceptar. Adobe es un ejemplo de los mismos campos.
Después de Aceptar, la primera reproducción encola video_start. Una reproducción posterior puede encolar video_progress, video_complete y video_engagement. Abrir el laboratorio también encola lab_interaction con lab_id video-tracking, action view y label page. trackVideoEvent pasa por pushEvent, que no hace nada hasta que se concede el consentimiento. Esto se encola solo después de Aceptar. Este sitio no llama a Adobe.
Forma simplificada del objeto encolado después de Aceptar. Registra cualquier parámetro nuevo como dimensión personalizada con alcance de evento. Este sitio no llama a gtag('set').
dataLayer.push({
event: "video_start",
video_title: "Lab clip",
video_provider: "html5",
video_current_time: 0,
})Implementación de ejemplo. Este sitio no llama a Adobe. eVar113, prop113 y event113 son números de variable de ejemplo. En Launch, un elemento de datos lee el valor y una regla lo envía cuando el valor cambia. En el report suite, habilita eVar113 con asignación Most Recent y haz que expire en el hit. Una processing rule no hace falta si el elemento de datos se mapea directo a esa eVar.
Payload de alloy de ejemplo. _example es un esquema de relleno, no un inquilino real.
alloy("sendEvent", {
xdm: {
eventType: "web.webinteraction.linkClicks",
_example: {
videoTitle: "Lab clip",
},
},
})Hit de ejemplo. eVar113 tiene alcance de hit en este ejemplo. prop113 muere en el mismo hit.
s.eVar113 = "Lab clip"
s.prop113 = "Lab clip"
s.events = "event113"
s.linkTrackVars = "eVar113,prop113,events"
s.linkTrackEvents = "event113"
s.tl(true, "o", "video_start")Traducción
Cada campo del laboratorio, el nombre en GA4 y la variable de Adobe de ejemplo. El alcance es la parte que suele perderse en la traducción.
Título
GA4. Parámetro video_title en video_start, video_progress y video_complete.
Adobe. eVar113 de ejemplo, expira en el hit.
Alcance. Evento. Una propiedad de usuario conservaría el título de este clip en la visita siguiente.
Proveedor
GA4. Parámetro video_provider. El clip envía html5. El embed opcional envía youtube.
Adobe. prop113 de ejemplo, que muere en el hit.
Alcance. Evento en el hit. No es una propiedad de la visita.
Hito
GA4. Parámetro video_percent en video_progress. Las marcas son 10, 25, 50, 75, 90 y 100.
Adobe. eVar113 de ejemplo para un porcentaje. No es un progreso guardado en el usuario.
Alcance. Evento. Cada marca es su propio hit.
Puntuación de atención
GA4. No se envía. attentionScore se dibuja en la página.
Adobe. prop113 de ejemplo. No escribas la puntuación en una prop. No se envía.
Alcance. Un cálculo local. No es un evento ni una propiedad de usuario.
Recomendado a continuación
Por qué estas propuestasLeyendo las transiciones de recorrido…