Journal d'hameçonnage par courriel

Ce rapport est un journal d’hameçonnage au niveau des événements : une ligne par interaction de simulation observée (date, action, courriel du destinataire, objet, expéditeur, difficulté). Il reste en format long : il ne regroupe pas l’historique d’une personne en un seul résultat. La requête intègre les 12 derniers mois civils dans occurred_after (minuit UTC le même jour du mois, il y a douze mois — et non une durée de 365 jours). La configuration, les identifiants, la pagination et la reprise en cas de limitation de débit sont identiques à ceux du guide de connectivité Power BI / Excel. Ajoutez d’abord la requête partagée Fn_FetchAll; ce rapport l’appelle par son nom.

​

Portées de clé requises

Une clé disposant uniquement de simulation:read ne peut pas appeler le point de terminaison des événements de rapport (l’API renvoie 403). Consultez choisir la bonne granularité.

​

Points de terminaison sources

Filtres autorisés sur la liste des événements (tout autre filtre renvoie 400) : limit, page_token, simulation, entity, event_type, occurred_after. Cette famille de rapports est un jeu de données en préversion. Consultez le schéma du jeu de données et les politiques de données à GET /v1/reporting/datasets et GET /v1/reporting/datasets/simulation_events.

​

Granularité

Une ligne par événement de simulation de rapport. Une personne qui a ouvert puis cliqué sur le même message produit deux lignes. Les événements dont entity_id est nul (aucun acteur, destinataire ou participant cible) apparaissent quand même : email est nul. La fenêtre de l’API est élargie d’une minute; la borne exacte occurred_at >= WindowStart est réappliquée localement afin que la dernière année ne dépende pas du fait que le serveur traite occurred_after comme inclusif ou exclusif. Budget de requêtes : un parcours paginé des événements dans la fenêtre, plus un parcours des entités. Définissez toujours limit = "500".

​

Correspondance des colonnes

Les noms de colonnes hérités proviennent de l’exportation de votre fournisseur précédent. Les champs /v1 sont les noms de l’API publique; la requête en renomme certains pour le rapport.

​

Jetons d’action

action est le jeton fermé du rapport. L’ancien « Email Sent » correspond à simulation.delivered (delivered est le verbe public; le jeton transmis est simulation.delivered). Champs supplémentaires conservés parce que l’API les fournit : sender_domain, full_name, event_id, entity_id, simulation_id, occurred_at, ainsi que entity_type et entity_status provenant de la jointure d’entités.

​

Différences par rapport à l’exportation héritée

• L’adresse IP brute n’est jamais disponible. /v1 n’expose pas l’adresse IP brute du client : il s’agit d’une protection de la vie privée dès la conception, et non d’une correspondance en attente. La requête n’ajoute pas de colonne IP fictive.
• Le type d’appareil est dérivé, et non brut. device_type est une classe d’appareil dérivée pour les événements de clic, de soumission et de signalement. Les jetons observés comprennent desktop, mobile, tablet et unknown, mais l’émetteur stocke une chaîne libre : traitez-la comme du texte ouvert, et non comme une énumération fermée. Elle est nulle lorsque l’événement n’a pas de classe dérivée, et la chaîne brute user_agent reste privée.
• « Email Sent » correspond à simulation.delivered. Utilisez ce jeton lorsque vous filtrez ou comptez les envois. Ne cherchez pas de chaîne email_sent héritée.
• Le courriel du destinataire est obtenu par jointure, et non par un champ de l’événement. L’événement de rapport omet le courriel; la requête parcourt /entities pour le renseigner.
• 12 derniers mois civils, et non une durée de 365 jours, ni l’historique complet.
• Format long, sans regroupement. Une ligne par interaction, et non un résultat par personne.

​

Prochaines étapes