Analytics web

Remarque : Cette API est actuellement en version bêta et est sujette à modification en fonction du test et des retours. En utilisant ces points de terminaison, vous acceptez de respecter les Conditions d'utilisation des outils destinés aux développeurs ainsi que les Conditions d'utilisation des outils bêta destinés aux développeurs. Par ailleurs, vous reconnaissez et comprenez le risque associé au test d'une API instable.

Vue d'ensemblePoints de terminaison

Utilisez l'API d'analytics web pour rechercher des événements associés à tout type de fiche d'informations de CRM. Cela inclut des événements standard, tels que les vues de page de site web et les ouvertures d'e-mails, ainsi que les événements comportementaux personnalisés.

Par exemple, utilisez cette API pour afficher une chronologie des interactions d'un contact avec votre contenu. Vous pouvez ensuite utiliser cette chronologie pour créer un ensemble de données pour des analytics personnalisés ou présenter une chronologie de contact dans une application externe.

Interroger les finalisations d'événements individuels

Cette API renvoie des événements pour une fiche d'informations de CRM à la fois. Vous pouvez sélectionner la fiche d'informations en précisant objectType et en incluant le paramètre de demande objectId ou objectProperty.

Sélection selon l'ID d'objet

Pour spécifier une fiche d'informations selon son identifiant, ajoutez le paramètre objectId. Par exemple, pour spécifier une fiche d'informations de contact avec l'ID 2832, vous pouvez effectuer la demande GET suivante : 

/events/v3/events/?objectType=contact&objectId=224834

Sélection selon une propriété d'objet

Pour spécifier une fiche d'informations selon une propriété unique plutôt que par l'ID de contact, ajoutez le paramètre objectProperty. Indiquez la propriété en incluant le nom de la propriété et la valeur du format suivant :

objectProperty.{propname}={propvalue}

Par exemple, pour spécifier un contact selon son adresse e-mail, vous pouvez effectuer la demande GET suivante : 

/events/v3/events/?objectType=contact&objectProperty.email=user12@dev.com

Types d'événement

Lors de la demande d'événements associés à un objet de CRM donné, la réponse comprendra tous les types d'événement, y compris les événements comportementaux personnalisés. Dans le cadre de la version bêta, certains types d'événement standard sont sujets à modification.

Pour que seuls les événements comportementaux personnalisés soient renvoyés, vous pouvez inclure un paramètre eventType, suivi du nom de l'événement comportemental personnalisé. Par exemple :

/events/v3/events/eventType={EVENT_NAME}&objectType=contact&objectId=224834


Cet article vous a-t-il été utile ?
Ce formulaire est destiné à recueillir les avis sur la documentation pour les développeurs. Si vous souhaitez faire part de votre avis sur les produits HubSpot, veuillez le partager sur le forum des idéesde la communauté.