Exportação de dados pré-clínicos

Introdução

O Prenlytics é uma poderosa estrutura de exportação concebida para transmitir de forma segura dados estatísticos brutos enriquecidos em formato JSON para um ponto de extremidade de API externo. Este fluxo foi concebido para clientes que necessitam de integrar análises detalhadas baseadas em eventos diretamente nos seus próprios sistemas, oferecendo um formato de dados rico e flexível que é fácil de incorporar nas bases de dados ou noutras aplicações do cliente.

Também oferecemos a flexibilidade de converter e encaminhar os dados para formatos personalizados através de integrações backend-to-backend. Quer necessite de dados num formato específico ou que estes sejam enviados diretamente para um sistema de terceiros, esta solução pode ser adaptada às suas necessidades exactas.

Detalhes da implementação

Transferência de dados

Os clientes do Prenly Reader enviam dados estatísticos para um serviço backend dedicado do Prenlytics, concebido especificamente para lidar com a elevada carga e intensidade de tráfego associadas ao tratamento de dados estatísticos em grande escala. Este backend funciona de forma independente das APIs padrão do Prenly para garantir um desempenho sem problemas, mesmo em condições de tráfego intenso.

Documentação do esquema JSON

Todos os dados exportados obedecem a um esquema JSON que define a estrutura dos dados e fornece documentação textual básica. Isto garante que os dados exportados seguem consistentemente as regras do esquema, tornando a integração com sistemas externos estável e fiável.

Os pormenores sobre cada evento e as suas dimensões são documentados mais especificamente aqui.

Considerações técnicas

• No esquema JSON, a maioria dos campos não é definida como obrigatória, proporcionando flexibilidade para futuras actualizações. Esta conceção minimiza o risco de erros de validação quando são adicionados novos campos ou ocorrem actualizações do esquema.
• Para reduzir a quantidade de dados enviados, as propriedades sem valor (normalmente representadas como nulas) não serão incluídas - em vez disso, a propriedade é totalmente omitida do objeto JSON.
• Para além de documentar a estrutura de dados, o esquema também pode ser utilizado para validação técnica, o que pode simplificar os seus pipelines de processamento.

Controlo de versões e compatibilidade

Controlo de versões semântico

O Prenlytics segue o versionamento sem ântico para gerir as actualizações do esquema JSON. Esta abordagem garante que as actualizações são previsíveis e compatíveis com as versões anteriores, a menos que ocorra uma alteração importante da versão. O número da versão é estruturado como MAJOR.MINOR.PATCH (por exemplo, 1.17.4), onde:

• MAJOR aumenta quando são introduzidas alterações de rutura. Estas alterações não são compatíveis com as versões anteriores e podem exigir ajustes na sua integração. Notificaremos os clientes com bastante antecedência se estiver planeada uma atualização importante para garantir uma transição suave.
• MINOR aumenta quando são adicionadas novas propriedades de dados compatíveis com as versões anteriores, incluindo novas propriedades de eventos. As novas propriedades nunca serão necessárias no esquema JSON, garantindo que as integrações existentes não sejam afectadas.
• PATCH aumenta quando são efectuadas pequenas alterações, incluindo correcções de erros compatíveis com as versões anteriores e alterações textuais nas descrições.

Gerir várias versões do esquema

É importante notar que várias versões de esquema podem estar activas simultaneamente em diferentes plataformas:

Aplicações Web: As implementações Web podem adotar rapidamente novas versões do esquema assim que são lançadas. Quando a plataforma Web é actualizada, pode começar a enviar dados utilizando a versão mais recente do esquema.

Aplicações nativas: Para aplicações nativas (iOS e Android), as versões do esquema estão associadas à versão da aplicação instalada no dispositivo do utilizador. Uma vez que nem todos os utilizadores actualizam as suas aplicações imediatamente, as versões de esquemas mais antigas podem permanecer em utilização muito tempo após o lançamento de uma nova versão.

Para simplificar o suporte desta situação, fornecemos documentação completa das versões antigas, actuais e planeadas.

Versões e referências do esquema

Esta tabela apresenta as versões lançadas e as versões preliminares do formato de dados Prenlytics, bem como a data em que foram lançadas ou em que está previsto o seu lançamento.

Configuração

Configuração de uma exportação Prenlytics

A exportação Prenlytics está integrada em todos os clientes da aplicação Prenly (web, Android, iOS), pelo que a sua ativação não requer a criação de uma nova versão das aplicações nativas.

Se estiver interessado em recuperar dados no formato Prenlytics, contacte o nosso helpdesk.