DocumentaciónAnalyticsGuía de colección de medios de streaming

Solicitud de eventos events-request

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Usuario
  • Administrador
  • Desarrollador

POST https://{uri}/api/v1/sessions/{sid}/events

Parámetro URI

sid: ID de sesión devuelto desde una Solicitud de sesiones.

Cuerpo de la solicitud

El cuerpo de la solicitud debe ser JSON y tener la misma estructura que este cuerpo de solicitud de muestra:

{
    "playerTime": {
        "playhead": 0,
        "ts": 1509045324153
    },
    "eventType": "{event-type}",
    "params": {},
    "qoeData": {},
    "customMetadata": {}
}

  • playerTime (Obligatorio)

    • playhead: debe estar en segundos, pero puede ser float.
    • ts: marca de tiempo; debe estar en milisegundos.

  • eventType (Obligatorio)

  • params (Opcional)

  • customMetadata (Opcional; enviar solo con tipos de eventos adStart y chapterStart)

  • qoeData (Opcional)

Para obtener una lista de tipos de eventos válidos para esta versión, consulte Tipos de eventos y descripciones.

IMPORTANT
Seguimiento de publicidad:  Solo puede rastrear las publicidades dentro de unadBreak.
En ausencia de los "bookends" adBreakStart y adBreakComplete alrededor de los anuncios, los eventos adStart y adComplete se omitirán simplemente, y la duración de la publicidad correspondiente se rastreará como la duración del contenido principal. Esto podría tener un impacto considerable en los datos agregados que estarán disponibles en Adobe Analytics.

Respuesta

HTTP/1.1 204 No Content
Server nginx/1.13.5
Date Thu, 26 Oct 2017 19:15:24 GMT
Connection keep-alive
Access-Control-Allow-Origin *
Access-Control-Allow-Methods OPTIONS,POST,PUT
Access-Control-Allow-Headers Content-Type
Access-Control-Expose-Headers Location

Códigos de respuesta HTTP

Código de respuesta HTTP
Descripción
Elementos de acción del cliente
204
Sin contenido.

La llamada de Heartbeat se ha realizado correctamente.
N/D
400
Solicitud incorrecta.

El formato de la solicitud es incorrecto.
Compruebe los esquemas JSON de validación para el tipo de solicitud.
404
No encontrado.

No se ha encontrado el ID de la sesión de contenido en el servicio back-end.
La aplicación del cliente debe utilizar la API de solicitud de sesiones para crear otra sesión de medios y realizar el seguimiento de informes.
410
Se ha marchado.

Se ha encontrado la sesión de contenido en el servicio back-end, pero el cliente ya no puede informar de la actividad en ella.
La aplicación del cliente debe utilizar la API de solicitud de sesiones para crear otra sesión de medios y realizar el seguimiento de informes.
500
Error del servidor
N/D
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb