Usuários mais suscetíveis

Este relatório é um resumo consolidado de suscetibilidade por usuário ao longo de 12 meses: uma linha por pessoa que recebeu ao menos uma simulação no último ano, com contagens e taxas de cliques, credenciais e relatos, uma sequência atual de cliques e uma lista concatenada dos últimos 5 resultados. A janela é de 12 meses do calendário (meia-noite UTC no mesmo dia do mês doze meses atrás), e não uma duração de 365 dias. A configuração, as credenciais, a paginação e a repetição em caso de limite de taxa são as mesmas do guia de conectividade com Power BI / Excel. Adicione primeiro a consulta compartilhada Fn_FetchAll; este relatório a chama pelo nome.

​

Escopos de chave necessários

Este relatório usa a lista operacional de resultados por pessoa, e não a família de visualização prévia de relatórios. Uma chave que recebeu somente reporting:read não pode chamar GET /v1/simulation_results (a API retorna 403). Consulte escolha a granularidade correta.

​

Endpoints de origem

Filtros permitidos na lista de resultados: limit, page_token, simulation, entity. Não há delivered_after / start_date nesta lista; por isso, os últimos 12 meses são aplicados no Power Query após a leitura completa. Campos usados em cada resultado: id, simulation, entity, status, targeted_at, delivered_at, bounced_at, opened_at, clicked_at, attachment_opened_at, credential_submitted_at, reported_at, reported_before_interaction, bot_activity_detected, email_subject, sender_email, difficulty_level, created_at, updated_at.

​

Granularidade

Uma linha por entidade que tenha ao menos um resultado com delivered_at nos últimos 12 meses do calendário. Uma pessoa que foi selecionada, mas nunca recebeu a entrega, não aparece. Várias simulações para a mesma pessoa são consolidadas aqui. Orçamento de requisições: uma leitura paginada de todos os resultados de simulação da organização, mais uma leitura das entidades. Defina sempre limit = "500".

​

Precedência de resultados (last_5_assessments)

Cada um dos cinco resultados entregues mais recentes (delivered_at decrescente) é resumido como YYYY-MM-DD: <outcome>. Vence o primeiro carimbo de data/hora correspondente, da prioridade mais alta para a mais baixa: Somente entregue é no action (a mensagem chegou; a pessoa não fez nada). Uma pessoa que clicou e depois reportou é clicked — o relato não prevalece sobre uma interação de risco nesta lista. As linhas sinalizadas como bot ainda recebem um rótulo de resultado a partir dos carimbos de data/hora presentes; elas apenas não incrementam as contagens de cliques e credenciais. Sequência atual de cliques: percorra esses mesmos resultados entregues do mais recente para o mais antigo e conte as linhas consecutivas em que clicked_at não é nulo e bot_activity_detected não é true. Pare na primeira que não atender.

​

Mapeamento de colunas

Os nomes das colunas legadas são da exportação do seu provedor anterior. Os campos /v1 são os nomes da API pública; a consulta deriva as contagens e as taxas. Chave de junção mantida para um modelo em estrela: entity_id.

​

Divergências em relação à exportação legada

• A atividade de bots é excluída das contagens de cliques e credenciais. A exportação de um provedor anterior contava interações de scanners automatizados e bots como cliques e envios de credenciais. Esta consulta não faz isso. Um resultado com bot_activity_detected = true continua sendo uma simulação entregue — ele é contado em total_received e nos agregados de relatos — mas é tratado como não clique e não envio: é omitido de clicks / credential_submissions e interrompe uma sequência atual de cliques. Não “corrija” isso contando os bots para coincidir com a exportação legada.
• O relato não prevalece sobre um clique em last_5_assessments. Uma pessoa que clicou e depois reportou recebe o rótulo clicked.
• Os extras do diretório são omitidos, não preenchidos com nulo. Departamento e campos semelhantes não estão em /v1.
• Sem filtro de tempo no servidor. GET /v1/simulation_results não tem delivered_after. A consulta percorre todos os resultados e, em seguida, mantém delivered_at nos últimos 12 meses do calendário. Uma organização grande com muito histórico pode consumir mais do orçamento de taxa por chave do que uma lista filtrada.

​

Próximas etapas