DocumentaçãoAnalyticsGuia da Coleção de mídia de transmissão

Solicitação de eventos events-request

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

Criado para:

  • Usuário
  • Administrador
  • Desenvolvedor

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 para esta versão, consulte Tipos e descrições de 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
Sem conteúdo.

O Heartbeat foi salvo com sucesso.
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
Excluído.

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
c8eee520-cef5-4f8c-a38a-d4952cfae4eb