Recherche de site Web

Diffusez des données d'événement avec cet outil open source

Acheminez les événements en temps réel à partir de sources d'applications Web, mobiles et côté serveur pour vous aider à créer votre lac de données client sur votre entrepôt de données.

Dans mon article précédent, j'ai présenté RudderStack, un pipeline de données client open source axé sur l'entrepôt. Dans cet article, je démontre à quel point Rudderstack facilite la configuration et l'utilisation des flux d'événements.

Un flux d'événements est un pipeline entre une source que vous définissez et une destination de votre choix. Rudderstack vous fournit des SDK et des plugins pour vous aider à ingérer les données d'événements de votre site Web, de vos applications mobiles et de sources côté serveur — notamment JavaScript, Gatsby, Android, iOS, Unity, ReactNative, Node.js et bien d'autres. De même, le module Event Stream de Rudderstack propose plus de 80 intégrations de destinations et d'entrepôts,, notamment Firebase, Google Analytics, Salesforce, Zendesk, Snowflake, BigQuery, RedShift et bien d'autres, facilitant l'envoi de données d'événements à des outils en aval qui peut l'utiliser ainsi que créer un lac de données client sur un entrepôt de données pour des cas d'utilisation analytiques.

Ce didacticiel montre comment suivre et acheminer des événements à l'aide de RudderStack.

Comment configurer un flux d'événements

Avant de commencer, assurez-vous de bien comprendre les termes utilisés dans ce didacticiel :

  • Source : une source fait référence à un outil ou une plate-forme à partir de laquelle RudderStack ingère vos données d'événement. Votre site Web, votre application mobile ou votre serveur back-end sont des exemples courants de sources.
  • Destination : une destination fait référence à un outil qui reçoit vos données d'événement de RudderStack. Ces outils de destination peuvent ensuite utiliser ces données pour vos cas d'utilisation d'activation. Des outils tels que Google Analytics, Salesforce et HubSpot sont des exemples courants de destinations.

Les étapes de configuration d'un flux d'événements dans l'open source RudderStack sont :

  1. Instrumenter une source de flux d'événements
  2. Configuration d'une destination d'entrepôt
  3. Configuration d'une destination d'outil
  4. Envoi d'événements pour vérifier le flux d'événements

Étape 1 : Instrumenter une source de flux d'événements

Pour configurer une source de flux d'événements dans RudderStack :

  1. Connectez-vous à votre tableau de bord RudderStack. Si vous n'avez pas de compte RudderStack, veuillez vous inscrire. Vous pouvez utiliser le plan de contrôle open source RudderStack pour configurer vos flux d'événements.

    Le plan de contrôle hébergé de RudderStack est une option pour gérer vos configurations de flux d'événements. Il est entièrement gratuit, ne nécessite aucune configuration et possède des fonctionnalités plus avancées que le plan de contrôle open source.

  2. Une fois connecté à RudderStack, vous devriez voir le tableau de bord suivant :

    (Gavin Johnson, CC BY-SA 4.0)

    Remarque : Assurez-vous d'enregistrer l'URL du plan de données. Il est requis dans votre extrait de code SDK JavaScript RudderStack pour suivre les événements de votre site Web.

  3. Pour instrumenter la source, cliquez sur Ajouter une source. Vous pouvez également sélectionner l'option Répertoire dans la barre de navigation de gauche, puis sélectionner Flux d'événements sous Sources. Ce didacticiel configurera une source JavaScript simple qui vous permettra de suivre les événements de votre site Web.

    (Gavin Johnson, CC BY-SA 4.0)

  4. Attribuez un nom à votre source et cliquez sur Suivant.

    (Gavin Johnson, CC BY-SA 4.0)

  5. C'est ça! Votre source d'événement est maintenant configurée.

    (Gavin Johnson, CC BY-SA 4.0)

    Remarque : Enregistrez la Clé d'écriture source. Votre extrait du SDK JavaScript RudderStack en a besoin pour suivre les événements de votre site Web.

Vous devez maintenant installer le SDK JavaScript RudderStack sur votre site Web. Pour ce faire, vous devez placer la version minifiée ou non de l'extrait avec votre URL du plan de données et votre clé d'écriture source dans le . Consultez la documentation pour savoir comment installer et utiliser le SDK JavaScript RudderStack.

Étape 2 : Configurer une destination d'entrepôt

Important : Avant de configurer votre entrepôt de données comme destination dans RudderStack, vous devez configurer un nouveau projet dans votre entrepôt et créer un rôle utilisateur RudderStack avec les autorisations appropriées. Les documents fournissent des instructions détaillées, étape par étape, sur la façon de procéder pour l'entrepôt de votre choix.

Ce tutoriel configure une destination d'entrepôt Google BigQuery. Vous n'êtes pas obligé de configurer une destination d'entrepôt, mais je le recommande. La documentation fournit des instructions sur la configuration d'un projet Google BigQuery et d'un compte de service avec les autorisations requises.

Configurez ensuite BigQuery comme destination d'entrepôt dans RudderStack en suivant ces étapes :

  1. Dans la barre de navigation de gauche, cliquez sur Répertoire, puis cliquez sur Google BigQuery dans la liste des destinations :

    (Gavin Johnson, CC BY-SA 4.0)

  2. Attribuez un nom à votre destination et cliquez sur Suivant.

(Gavin Johnson, CC BY-SA 4.0)

  1. Choisissez la source que vous souhaitez utiliser pour envoyer les événements vers votre destination. Sélectionnez la source que vous avez créée dans la section précédente. Cliquez ensuite sur Suivant.

(Gavin Johnson, CC BY-SA 4.0)

  1. Spécifiez les informations d'identification de connexion requises. Pour cette destination, saisissez l'ID du projet BigQuery et le nom du bucket intermédiaire ; les informations sur la façon d'obtenir ces informations se trouvent dans la documentation.

(Gavin Johnson, CC BY-SA 4.0)

  1. Copiez le contenu du fichier JSON privé que vous avez créé, comme l'explique la documentation.

C'est ça! Vous avez configuré votre entrepôt BigQuery comme destination dans RudderStack. Une fois que vous commencez à envoyer des événements depuis votre source (un site Web dans ce cas), RudderStack les acheminera automatiquement vers votre BigQuery et y créera également votre graphique d'identité.

Étape 3 : Configurer une destination d'outil

Une fois que vous avez ajouté une source, suivez ces étapes pour configurer une destination dans le tableau de bord RudderStack :

  1. Pour ajouter une nouvelle destination, cliquez sur le bouton Ajouter une destination comme indiqué :

    (Gavin Johnson, CC BY-SA 4.0)

    Remarque : Si vous avez déjà configuré une destination, utilisez l'option Connecter les destinations pour la connecter à n'importe quelle source.

  2. RudderStack prend en charge plus de 80 destinations vers lesquelles vous pouvez envoyer vos données d'événement. Choisissez votre plateforme de destination préférée dans la liste. Cet exemple configure Google Analytics comme destination.

(Gavin Johnson, CC BY-SA 4.0)

  1. Ajoutez un nom à votre destination et cliquez sur Suivant.

(Gavin Johnson, CC BY-SA 4.0)

  1. Ensuite, choisissez la source préférée. Si vous suivez ce didacticiel, choisissez la source que vous avez configurée ci-dessus.

(Gavin Johnson, CC BY-SA 4.0)

  1. Dans cette étape, vous devez ajouter les Paramètres de connexion appropriés. Saisissez l'ID de suivi pour cette destination (Google Analytics). Vous pouvez également configurer d'autres paramètres facultatifs selon vos besoins. Une fois que vous avez ajouté les paramètres requis, cliquez sur Suivant.

    (Gavin Johnson, CC BY-SA 4.0)

    Remarque : RudderStack vous offre également la possibilité de transformer les événements avant de les envoyer à votre destination. En savoir plus sur les transformations utilisateur dans RudderStack dans la documentation.

  2. C'est ça! La destination est maintenant configurée. Vous devriez maintenant le voir connecté à votre source.

(Gavin Johnson, CC BY-SA 4.0)

Étape 4 : Envoyez des événements de test pour vérifier le flux d'événements

Ce didacticiel a configuré une source JavaScript pour suivre les événements de votre site Web. Une fois que vous avez placé l'extrait de code JavaScript dans la section <head> de votre site Web, RudderStack suivra et collectera automatiquement les événements utilisateur du site Web en temps réel.

Cependant, pour tester rapidement si votre flux d'événements est correctement configuré, vous pouvez envoyer des événements de test. Pour ce faire, procédez comme suit :

Remarque : Avant de commencer, vous devrez cloner le dépôt rudder-server et installer un serveur RudderStack dans votre environnement. Suivez ce tutoriel pour configurer un serveur RudderStack.

  1. Assurez-vous d'avoir configuré une source et une destination en suivant les étapes des sections précédentes et de disposer de votre URL du plan de données et de votre clé d'écriture source.

  2. Démarrez le serveur RudderStack.

  3. Le dépôt rudder-server inclut un script shell qui génère des événements de test. Récupérez la Write Key source de l'étape 2 et exécutez la commande suivante :

    ./scripts/generate-event <YOUR_WRITE_KEY> <YOUR_DATA_PLANE_URL>/v1/batch

(Gavin Johnson, CC BY-SA 4.0)

  1. Pour vérifier si les événements de test sont diffusés, accédez à votre tableau de bord Google Analytics, accédez à Temps réel sous Rapports, puis cliquez sur Événements.

    Remarque : Assurez-vous de vérifier les événements associés au même ID de suivi que vous avez fourni lors de l'instrumentation de la destination.

Vous devriez maintenant pouvoir voir l'événement test reçu dans Google Analytics et BigQuery.

(Gavin Johnson, CC BY-SA 4.0)

Si vous rencontrez des problèmes lors de l'installation ou de la configuration de l'open source RudderStack, rejoignez notre Slack et démarrez une conversation sur notre chaîne #open-source. Nous serons heureux de vous aider.

Si vous souhaitez essayer RudderStack mais ne souhaitez pas héberger le vôtre, inscrivez-vous à notre offre hébergée gratuite, RudderStack Cloud Free. Explorez nos dépôts open source sur GitHub, abonnez-vous à notre blog et suivez-nous sur nos réseaux sociaux : Twitter, LinkedIn, dev.to, Medium et YouTube.

Articles connexes: