Skip to main content
Este informe es un resumen de susceptibilidad por usuario de los últimos 12 meses: una fila por persona que recibió al menos una simulación en el último año, con recuentos y porcentajes de clics, credenciales y reportes, una racha actual de clics y una lista concatenada de los últimos 5 resultados. La ventana es de 12 meses naturales (medianoche UTC del mismo día del mes de hace doce meses), no una duración de 365 días.
Las interacciones de escáneres automáticos y bots se excluyen de los recuentos de clics y credenciales. Esta es una divergencia deliberada respecto a la exportación heredada. Consulte Divergencias respecto a la exportación heredada.
La configuración, las credenciales, la paginación y el reintento por límite de solicitudes son los mismos que en la guía de conectividad de Power BI y Excel. Agregue primero la consulta compartida Fn_FetchAll; este informe la invoca por su nombre.

Ámbitos de clave necesarios

Este informe utiliza la lista de resultados operativa por persona, no la familia de vista previa de informes. Una clave a la que solo se concedió reporting:read no puede llamar a GET /v1/simulation_results (la API devuelve 403). Consulte elegir la granularidad adecuada.

Endpoints de origen

Filtros permitidos en la lista de resultados: limit, page_token, simulation, entity. En esta lista no existe delivered_after / start_date, por lo que los últimos 12 meses se aplican en Power Query después de recorrer la lista completa. Campos utilizados en 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.

Granularidad

Una fila por entidad que tenga al menos un resultado con delivered_at en los últimos 12 meses naturales. Una persona a la que se dirigió una simulación pero que nunca la recibió no aparece. Varias simulaciones de la misma persona se consolidan aquí. Presupuesto de solicitudes: un recorrido paginado de todos los resultados de simulación de la organización, más un recorrido de las entidades. Establezca siempre limit = "500".

Precedencia de resultados (last_5_assessments)

Cada uno de los cinco resultados entregados más recientes (delivered_at en orden descendente) se resume como YYYY-MM-DD: <outcome>. Prevalece la primera marca de tiempo que coincida, de mayor a menor prioridad: Solo entregado es no action (el mensaje llegó; la persona no hizo nada). Una persona que hizo clic y después reportó es clicked: el reporte no tiene precedencia sobre una interacción de riesgo en esta lista. Las filas marcadas como bot siguen recibiendo una etiqueta de resultado a partir de las marcas de tiempo presentes; simplemente no incrementan los recuentos de clics ni de credenciales. Racha actual de clics: recorra esos mismos resultados entregados del más reciente al más antiguo y cuente las filas consecutivas en las que clicked_at no sea nulo y bot_activity_detected no sea true. Deténgase en la primera que no cumpla.

Asignación de columnas

Los nombres de columna heredados proceden de la exportación de su proveedor anterior. Los campos de /v1 son los nombres de la API pública; la consulta deriva los recuentos y porcentajes. Clave de unión conservada para un modelo de esquema en estrella: entity_id.

Divergencias respecto a la exportación heredada

  • La actividad de bots se excluye de los recuentos de clics y credenciales. La exportación de un proveedor anterior contaba las interacciones de escáneres automáticos y bots como clics y envíos de credenciales. Esta consulta no lo hace. Un resultado con bot_activity_detected = true sigue siendo una simulación entregada: se cuenta en total_received y en los agregados de reportes, pero se trata como un no clic y un no envío: se omite de clicks / credential_submissions e interrumpe una racha actual de clics. No “corrija” esto contando los bots para que coincida con la exportación heredada.
  • El reporte no tiene precedencia sobre un clic en last_5_assessments. Una persona que hizo clic y después reportó se etiqueta como clicked.
  • Los datos adicionales del directorio se omiten, no se rellenan con nulos. El departamento y campos similares no están en /v1.
  • Sin filtro de tiempo en el servidor. GET /v1/simulation_results no tiene delivered_after. La consulta recorre todos los resultados y luego conserva delivered_at de los últimos 12 meses naturales. Una organización con un gran historial puede consumir más del presupuesto de límite de solicitudes por clave que una lista filtrada.

Próximos pasos

Configuración de Power BI y Excel

Credenciales, paginación y carga de estas consultas en Power BI o Excel.

Registro de phishing por correo electrónico

Interacciones de phishing a nivel de evento de los últimos 12 meses.

Cumplimiento por persona

Inscripciones a Capacitación con granularidad de persona × asignación.

Claves de API

Conceda simulation:read y entity:read a la clave que actualiza este informe.