DocumentaçãoAnalyticsGuia de serviços para mídia de streaming

Solicitação de eventos events-request

Última atualização: 19 de maio de 2026

Criado para:

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

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

Parâmetro URI

sid: A ID da sessão retornada de uma Solicitação de sessões.

Corpo da solicitação

O corpo da solicitação deve ser JSON e deve ter a mesma estrutura que este exemplo de corpo da solicitação:

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

  • playerTime (Obrigatório)

    • playhead - Deve ser expresso em segundos, mas pode ser um float.
    • ts - carimbo de data e hora; deve estar em milissegundos.

  • eventType (Obrigatório)

  • params (Opcional)

  • customMetadata (Opcional; enviar somente com tipos de evento adStart e chapterStart)

  • qoeData (Opcional)

Para obter uma lista de tipos de eventos válidos e exemplos de implementação por SDK, consulte Visão geral dos eventos.

IMPORTANT
Rastreamento de anúncios - Você somente pode rastrear anúncios dentro de umadBreak.
Na ausência de adBreakStart e "finalizações" adBreakComplete nos anúncios, os eventos adStart e adComplete simplesmente serão ignorados e a duração do anúncio correspondente será rastreada como a duração do conteúdo principal. Isso pode ter um impacto significativo nos dados agregados que estarão disponíveis no Adobe Analytics.

Resposta

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 resposta HTTP

Código de resposta HTTP
Descrição
Itens de ação do cliente
204
Nenhum conteúdo.

A chamada do Heartbeat foi bem-sucedida.
N/D
400
Solicitação inválida.

Solicitação com formato inapropriado.
Verifique os esquemas de validação JSON para o tipo de solicitação.
404
Não encontrado.

A ID da sessão para a sessão de mídia não foi encontrada no serviço de back-end.
O aplicativo cliente deve usar a API Solicitação de sessões para criar outra sessão de mídia e o rastreamento de relatórios nela.
410
Não existe mais.

A sessão de mídia foi encontrada no serviço de back-end, mas o cliente não pode mais relatar atividade nela.
O aplicativo cliente deve usar a API Solicitação de sessões para criar outra sessão de mídia e o rastreamento de relatórios nela.
500
Erro do servidor
N/D
recommendation-more-help
media-analytics-help