As apresentações CLM (Closed Loop Marketing) são os materiais que os representantes médicos mostram a um médico durante uma visita. O Proxima CRM é compatível com vários formatos de arquivo, e o formato escolhido determina o que o sistema pode fazer com a apresentação: se pode coletar estatísticas detalhadas, como ela se comporta na tela e quais são os requisitos do arquivo.
Este artigo descreve os formatos compatíveis e os requisitos para cada um deles.
Formatos compatíveis
| Formato | O que é | Estatísticas |
|---|---|---|
| ZIP (HTML) | Apresentação interativa criada em HTML e JavaScript. É compatível com animações, questionários e elementos interativos. | Completa: tempo gasto em cada slide, respostas, concordâncias |
| Documento com navegação slide a slide, zoom e um botão opcional para envio por e-mail. | Completa: tempo gasto em cada página | |
| MP4 | Vídeo reproduzido no player integrado. | Apenas o registro de que o arquivo foi aberto |
| PNG, JPG | Imagem única exibida como um slide. | Apenas o registro de que o arquivo foi aberto |
ℹ️ Como escolher: se você precisa saber quanto tempo um médico olhou para cada slide, use ZIP (HTML) ou PDF. Vídeos e imagens são adequados quando o material só precisa ser exibido, sem medir o engajamento.
Requisitos para apresentações interativas (ZIP)
Estrutura do arquivo
- Cada slide é um arquivo HTML separado, e todos os arquivos HTML são colocados na raiz do arquivo ZIP.
- As visualizações dos slides em JPG ou PNG são colocadas no mesmo nível que os slides.
- O arquivo deve conter um arquivo slides.json que descreve a estrutura da apresentação.
- Os nomes de arquivos e pastas podem conter apenas caracteres latinos.
- O tamanho máximo de uma apresentação é de 300 MB. Apresentações maiores devem ser acordadas separadamente com o gerente de projeto.
Arquivo de estrutura (slides.json)
Uma apresentação consiste em slides agrupados em cenários. Cada slide é descrito pelos seguintes campos:
| Campo | Descrição |
|---|---|
mapname | Nome do cenário ao qual o slide pertence |
name | Nome do slide exibido ao usuário no sistema |
filename | Caminho para o arquivo do slide, relativo à raiz do arquivo |
preview | Caminho para o arquivo de visualização do slide |
ishidden | 1 oculta o slide do usuário, 0 o exibe |
position | Ordem do slide dentro do cenário |
Exemplo:
{
"slides": [
{
"mapname": "crosscrm_api_docs",
"name": "add-slide-num-info",
"filename": "00-slide-add-slide-num.html",
"preview": "00-preview-add-slide-num.png",
"position": 0,
"ishidden": 0
}
]
}
⚠️ Importante: slides.json deve ser salvo
em UTF-8 sem BOM, e os nomes e caminhos dentro dele
devem corresponder exatamente aos nomes reais dos arquivos, incluindo
a diferenciação entre maiúsculas e minúsculas.
Por exemplo, Index.HTML e index.html são tratados
como arquivos diferentes, e a apresentação não será aberta.
Requisitos gráficos
- Android: a resolução do slide deve corresponder à resolução da tela do tablet. Se o tablet tiver os botões Home e Voltar na tela, subtraia a altura deles. O slide não deve ultrapassar a tela horizontalmente.
- iOS: a proporção do slide é 4:3 (exceto no iPad Pro 2018), e a resolução deve corresponder à resolução da tela do tablet.
- Visualização: 300 × 225. Em telas Retina, 1 ponto equivale a 2 pixels.
- Orientação: as apresentações interativas são sempre exibidas no modo paisagem, e a rotação da tela é bloqueada.
Requisitos para apresentações em PDF
- A navegação funciona por meio de links dentro do documento e deslizando entre as páginas, e um navegador de slides está disponível, assim como nas apresentações interativas.
- A visualização é gerada automaticamente quando o arquivo é carregado no CLM Manager.
- O zoom está sempre disponível e não pode ser desativado.
- A orientação não é bloqueada: o usuário pode girar a tela, e o documento se adapta a ela.
- Se a apresentação estiver configurada para isso, um representante pode enviar o PDF para o e-mail do médico diretamente durante a visita.
Arquivos grandes são compactados automaticamente durante o carregamento. Por padrão, as imagens são compactadas para 300 dpi, o que mantém a qualidade adequada para materiais detalhados, como tabelas e textos pequenos. Se um tamanho de arquivo menor for mais importante ou se o documento precisar manter sua qualidade original, peça ao gerente de projeto para alterar o nível de compactação.
Requisitos para vídeos e imagens
- O vídeo é reproduzido no player integrado e pode ser aberto em tela cheia.
- A orientação não é bloqueada, e as proporções são definidas pelo próprio arquivo. Se elas não corresponderem à tela, a área livre será preenchida com preto.
- As estatísticas slide a slide não são coletadas para esses formatos: o sistema registra apenas que o arquivo foi aberto.
O que o sistema registra
Durante uma apresentação, o Proxima CRM registra:
- o tempo gasto em cada slide, para apresentações interativas e PDF;
- curtidas atribuídas a slides individuais;
- respostas dadas nos slides e concordâncias com o médico, se a apresentação tiver sido criada para coletá-las;
- o registro de que um arquivo foi aberto, para todos os outros formatos.
⚠️ Importante: as estatísticas não são registradas enquanto o aplicativo está minimizado ou sendo executado em segundo plano.
Apresentações no aplicativo web
Arquivos PDF, MP4 e PNG são abertos diretamente no navegador. Se uma apresentação estiver configurada para download, os usuários também poderão salvar o arquivo no dispositivo.
ℹ️ Para desenvolvedores: as apresentações interativas podem trocar dados com o Proxima CRM por meio de um conjunto de métodos de API — por exemplo, para salvar respostas, ler dados salvos anteriormente, controlar a navegação ou registrar manualmente estatísticas de visualização. Esses métodos são descritos em um guia separado para desenvolvedores de CLM.