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.
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 condelivered_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 = truesigue siendo una simulación entregada: se cuenta entotal_receivedy en los agregados de reportes, pero se trata como un no clic y un no envío: se omite declicks/credential_submissionse 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 comoclicked. - 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_resultsno tienedelivered_after. La consulta recorre todos los resultados y luego conservadelivered_atde 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.
