Usuários mais suscetíveis

Este relatório é um consolidado de suscetibilidade por usuário dos últimos 12 meses: uma linha por pessoa que recebeu pelo 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 corridos (meia-noite UTC no mesmo dia do mês de doze meses atrás), e não uma duração de 365 dias. A configuração, as credenciais, a paginação e a nova tentativa 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, não a família de prévias de relatórios. Uma chave que tenha recebido apenas 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, portanto 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 pelo menos um resultado com delivered_at nos últimos 12 meses corridos. Uma pessoa alvo que nunca recebeu a simulação 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>. Vale o primeiro carimbo de data/hora correspondente, da maior para a menor prioridade: Somente entregue é no action (a mensagem chegou; a pessoa não fez nada). Uma pessoa que clicou e depois relatou é clicked — o relato não tem precedência sobre uma interação de risco nesta lista. Linhas sinalizadas como bot ainda recebem um rótulo de resultado a partir dos carimbos de data/hora presentes; apenas não incrementam as contagens de cliques / 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 vêm da exportação do seu provedor anterior. Os campos de /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 / bots como cliques e envios de credenciais. Esta consulta não conta. Um resultado com bot_activity_detected = true continua sendo uma simulação entregue — ele entra 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 a sequência atual de cliques. Não “corrija” isso contando os bots para corresponder à exportação legada.
• O relato não tem precedência sobre um clique em last_5_assessments. Uma pessoa que clicou e depois relatou 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 depois mantém delivered_at nos últimos 12 meses corridos. Uma organização grande com longo histórico pode consumir mais do orçamento de limite de taxa por chave do que uma lista filtrada.

​

Próximas etapas