Vue d'ensemble des événements d'application (BÊTA)

• Créer un type d’événement
• Envoyer les données d’occurrence d’événement
• Consulter la documentation de référence relative aux événements d’application

​

Fonctionnement des événements d’application

• Définition du type d’événement : un schéma JSON qui définit la structure, les propriétés et les règles de validation de l’événement. Cela comprend le nom de l’événement, le libellé d’affichage, l’objet CRM cible et les propriétés de l’événement. Les types d’événements comprennent également des définitions des modèles d’affichage pour le rendu de la chronologie des fiches d’informations du CRM. Les types d’événements sont définis à l’aide de projets développeur.
• Occurrences d’événements : instances individuelles d’événements qui contiennent des données réelles, validées par rapport à votre schéma de type d’événement. Les données d’occurrence d’événement sont envoyées via l’API d’événements de l’application et incluent l’identifiant du type d’événement, les valeurs de propriété, les horodatages et les métadonnées supplémentaires, ainsi que les données de référence des objets du CRM pour l’association des fiches d’informations du CRM.

​

Objets et outils pris en charge

• Contacts
• Entreprises
• Transactions
• Tickets
• Objets personnalisés
• Objets de l’application

• Interface de gestion des événements : affichez et analysez les données des événements de l’application dans le tableau de bord des événements personnalisés en même temps que les données des événements personnalisé en accédant à Gestion des données > Événements personnalisés dans votre compte.
• Chronologies des fiches d’informations du CRM : affichez l’activité chronologique des événements de l’application sur la chronologie des fiches d’informations du CRM associées à leur occurrence.
• Outils de reporting : utilisez les données d’événements des applications pour créer des rapports personnalisés, des analyses du parcours client et des jeux de données pour l’analyse et la visualisation.
• Scores, listes et workflows des leads : segmentez votre base de données CRM à l’aide d’événements pour les listes dynamiques, le score des leads et le déclenchement des workflows.

​

Meilleures pratiques

• Utilisez des noms clairs et descriptifs pour les types d’événement et les propriétés, car ils apparaîtront sous forme de filtres dans les workflows, les listes, les rapports et le tableau de bord des événements personnalisés.
• Choisissez les types de propriétés appropriés (chaîne, nombre, date, heure, etc.) qui correspondent à vos données et permettent un filtrage et une analyse appropriés.
• Incluez les propriétés qui seront utiles pour la segmentation, le reporting et les déclencheurs d’automatisation (par exemple, les montants des transactions, les rôles d’utilisateur, les catégories d’actions).
• Concevez les types d’événements en tenant compte des cas d’utilisation des rapports et des workflows, en tenant compte de la manière dont les utilisateurs filtreront et regrouperont les données d’événement.
• Évitez d’apporter des modifications cassantes aux schémas de types d’événements existants, car cela peut perturber les workflows et rapports existants qui dépendent de la structure de l’événement.

• Examinez toutes les demandes de données d’occurrence d’événement programmatique pour vous assurer qu’elles seront correctement validées par rapport à votre schéma de type d’événement.
• Utilisez un formatage cohérent pour les valeurs des propriétés d’événement, en particulier pour les dates, les nombres et les données de catégories.
• Assurez-vous que les événements sont associés à des ID de fiches d’informations du CRM valides.
• Surveillez les taux de réussite des soumissions d’événements et les réponses aux erreurs.
• Examinez régulièrement les données d’événements sur les chronologies des fiches d’informations du CRM et dans le tableau de bord des événements personnalisés pour en vérifier l’exactitude.

• Regroupement par lots de plusieurs événements dans des demandes d’API uniques lorsque cela est possible (jusqu’à 500 événements par lot).
• Conserver des charges utiles d’occurrence d’événement légères en n’incluant que les données nécessaires sur les propriétés.
• Mettre en œuvre une logique de relance exponentielle pour les soumissions d’événements qui ont échoué.

​

Limites

​

Exigences relatives à la version

• Les événements d’application ne peuvent être créés que par le biais de la dernière version de la plateforme de projets de développement (2025.2).
• Pour les types d’événements existants, vous pouvez continuer d’utiliser les API d’événements de chronologie v1 et v3. Toutefois, vous ne pouvez pas créer de nouveaux types d’événement à l’aide des API v1 et v3.

​

Contraintes de type d’événement

• Les événements doivent être conformes au schéma de type d’événement défini, sinon ils seront rejetés.
• Certains champs de type d’événement ne peuvent pas être mis à jour après la création du type d’événement (par exemple, name et objectType).
• Les nouveaux types d’événements sont soumis à un processus d’évaluation avant de pouvoir être activés.

​

Limites des données

• Les propriétés individuelles sont limitées à 510 Ko et la taille totale de l’événement est limitée à 1 Mo.
• Les événements d’applications sont destinés aux fournisseurs du marketplace des applications et ne fonctionnent qu’avec des applications configurées pour utiliser l’authentification OAuth. Les systèmes internes devraient plutôt utiliser des événements personnalisés.

​

Pour commencer

• Créez un type d’événement pour définir la structure de vos données d’événement à l’aide d’un projet développeur.
• Envoyez des données d’occurrence d’événement à l’application à l’aide de l’API d’événements de l’application.
• Exploiter les données dans HubSpot en fonction des besoins à l’aide d’outils de reporting, d’automatisation ou d’analytics.