Validación de solicitudes de eventos
Última actualización: 18 de julio de 2024
Creado para:
- Usuario
- Administrador
- Desarrollador
El cuerpo de la petición JSON para cada tipo de evento se valida en el servidor con esquemas JSON. En el cuerpo de la respuesta HTTP aparecerá un mensaje de error cuando la validación falle para una llamada de API.
Los esquemas de validación de JSON para cada tipo de evento son accesibles aquí: {uri}/api/v1/schemas/{eventType}
(por ejemplo, {uri}/api/v1/schemas/sessionEnd
). Estos esquemas de validación de JSON son la autoridad absoluta para determinar los parámetros de cuerpo de solicitud correctos para cada tipo de evento.
Por ejemplo, la respuesta a una solicitud del esquema de validación sessionStart
se parecerá a esta muestra (ligeramente formateado para mejorar la legibilidad):
HTTP/1.1 200 OK
Server: nginx/1.13.5
Date: Thu, 18 Jan 2018 15:44:50 GMT
Content-Type: application/json
Content-Length: 2716
Connection: keep-alive
{
"$schema":"https://json-schema.org/draft-04/schema#",
"id":"https://alpha.hb-api.omtrdc.net/api/v1/schemas/sessionStart",
"definitions":
{
"playerTime":
{
"type":"object","properties":
{
"playhead":
{"type":"number"},
"ts":
{"type":"integer"}
},
"required":["playhead","ts"],
"additionalProperties":false
},
"eventType":
{
"type":"string",
"enum":[
"sessionStart",
"play",
"ping",
"bufferStart",
"pauseStart",
"sessionComplete",
"bitrateChange",
"error",
"adBreakStart",
"adBreakComplete",
"adStart",
"adComplete",
"adSkip",
"sessionEnd"
]
},
"qoeData":
{
"type":"object","properties":
{
"media.qoe.bitrate":
{"type":"integer"},
"media.qoe.droppedFrames":
{"type":"integer"},
"media.qoe.framesPerSecond":
{"type":"integer"},
"media.qoe.timeToStart":
{"type":"integer"}
},
"required":[],
"additionalProperties":false
},
"customMetadata":
{
"type":"object",
"patternProperties":
{
"^[a-zA-Z0-9_\\.]+$":
{"type":"string"}
},
"additionalProperties":false
},
"sessionStart":
{
"properties":
{
"eventType":
{"type":"string","enum":["sessionStart"]},
"playerTime":
{"$ref":"#/definitions/playerTime"},
"params":
{"type":"object",
"properties":
{
"appInstallationId":
{"type":"string"},
"analytics.trackingServer":
{"type":"string"},
"analytics.reportSuite":
{"type":"string"},
<...>
"visitor.marketingCloudOrgId"],
"additionalProperties":false
},
"customMetadata":
{"$ref":"#/definitions/customMetadata"},
"qoeData":
{"$ref":"#/definitions/qoeData"}
},
"required":["eventType","playerTime","params"],
"additionalProperties":false
}
},
"type":"object","$ref":"#/definitions/sessionStart"
}
}
No es posible validar el nivel de sesión porque el contexto no está disponible en la capa de recopilación.
Página anteriorEsquemas de validación de JSON
Página siguienteEnvío de eventos ping
Analytics
- Guía de colección de medios de streaming
- Notas de la versión
- Introducción
- Implementación
- Información general sobre la implementación
- Implementaciones de Edge (recomendado)
- Implementaciones solo de Adobe Analytics
- Requisitos previos
- Media SDKs/extensión
- API de recopilación de medios: implementación
- Colección de medios
- Inicio rápido de API
- Solicitud de sesiones
- Solicitud de eventos
- Parámetros de solicitud
- Tipos de eventos y descripciones
- Implementación de la API
- Configuración del tipo de solicitud HTTP en el reproductor
- Obtención de un ID de sesión
- Implementación de una solicitud de eventos
- Esquemas de validación de JSON
- Validación de solicitudes de eventos
- Envío de eventos ping
- Envío de datos de QoE
- Compatibilidad con metadatos personalizados
- Condiciones de tiempo de espera
- Control del orden de los eventos
- Poner eventos en cola cuando la respuesta de las sesiones es lenta
- Variables
- Informes
- Casos de uso
- Casos de uso de Media SDK
- Seguimiento del estado de reproducción
- Seguimiento del contenido descargado
- Medios federados
- Administración de interrupciones de la aplicación durante la reproducción
- Atribución de flujo de transmisión de medios
- Reanudación de sesiones inactivas
- Seguimiento de Roku en SceneGraph
- Gestión de espacios entre anuncios
- Cronologías
- Uso de Analytics en aplicaciones OTT
- Seguimiento
- Información general
- Seguimiento de Core Streaming Media Playback
- Seguimiento del almacenamiento en búfer
- Seguimiento de llamada a otro punto del contenido
- Implementación de metadatos estándar
- Seguimiento de anuncios
- Seguimiento de capítulos y segmentos
- Seguimiento de la calidad de la experiencia
- Seguimiento de errores
- Privacidad y seguridad
- Implementaciones heredadas
- Heredado: información general
- Heredado: descargar SDK
- Heredado: Media SDK
- Acerca de la medición del ritmo cardíaco
- Adobe Primetime
- Habilitación de Adobe Audience Management
- Implementación de Vínculo personalizado
- Seguimiento de hitos heredado
- Validación
- Migración heredada: VHL 1.x a VHL 2.x
- Comparación del código de la v1.x y la v2.x
- API de seguimiento de 1x a 2x
- Heredado: introducción a AVA
- Ruta del lado del cliente
- Seguimiento heredado
- Seguimiento de reproducción principal en Android
- Seguimiento de reproducción principal en iOS
- Seguimiento de reproducción principal en JavaScript
- Seguimiento de reproducción principal en JavaScript 2.x
- Seguimiento del almacenamiento en búfer en Android
- Seguimiento del almacenamiento en búfer en iOS
- Seguimiento del almacenamiento en búfer en JavaScript
- Seguimiento de llamada a otro punto del contenido en Android
- Seguimiento de llamada a otro punto del contenido en iOS
- Seguimiento de llamada a otro punto del contenido en JavaScript
- Implementación de metadatos estándar en Android
- Implementación de metadatos estándar en iOS
- Claves de metadatos de iOS
- Implementación de metadatos estándar en JavaScript
- Seguimiento de anuncios
- Seguimiento de capítulos y segmentos
- Seguimiento de capítulos y segmentos en Android
- Seguimiento de capítulos y segmentos en iOS
- Seguimiento de capítulos y segmentos en JavaScript
- Seguimiento de la calidad de la experiencia en Android
- Seguimiento de la calidad de la experiencia en iOS
- Seguimiento de la calidad de la experiencia en JavaScript
- Seguimiento de errores
- Situaciones de seguimiento
- Reproducción de VOD sin anuncios
- Reproducción de VOD con anuncios previos a la emisión
- Reproducción de VOD con anuncios omitidos
- Reproducción de VOD con un capítulo
- Reproducción de VOD con un capítulo omitido
- Reproducción de VOD con llamada a otro punto del contenido principal
- Reproducción de VOD con almacenamiento en búfer
- Varios rastreadores de VOD en paralelo
- Un rastreador de VOD para varias sesiones
- Contenido principal en directo
- Contenido principal activo con seguimiento secuencial