Análises

GET/v1/books/{bookId}/analyticsescopo: analytics:read

Telemetria de leitores por capítulo de um livro publicado — total de visualizações de página, inícios de áudio, áudios concluídos e uma taxa de conclusão derivada. Retorna valores vazios até a página de leitura emitir eventos; a página de leitura chama o endpoint de eventos na visualização e no início/fim do áudio com um hash anônimo diário e genérico (sem dados pessoais).

{
  "data": {
    "bookViews": 412,
    "chapters": [
      {
        "chapterId": "ch_…",
        "order": 1,
        "title": "Across the Pyrenees",
        "views": 380,
        "listenStarts": 120,
        "listenCompletes": 71,
        "completionRate": 59.2
      }
    ]
  }
}

Use views e completionRate por capítulo para encontrar os pontos de abandono e decidir onde uma reescrita vale a pena.