Connecter RudderStack comme source ou destination
Utilisez vos événements et traits RudderStack pour cibler vos enquêtes Screeb, et renvoyez les affichages et réponses vers RudderStack.
Screeb se connecte à RudderStack dans les deux sens. Comme source, RudderStack transmet à Screeb les événements et les traits de vos utilisateurs, pour que vous puissiez cibler vos enquêtes dessus. Comme destination, Screeb envoie un événement à RudderStack à chaque affichage ou réponse d’une enquête, pour que vos autres outils reçoivent les retours.
Avant de commencer
Section intitulée « Avant de commencer »- Les deux intégrations dépendent de votre offre. Si une carte affiche Changer d'offre pour installer, votre offre ne l’inclut pas.
- Vous êtes Admin du workspace Screeb : seuls les Admins installent et retirent des intégrations.
- Vous pouvez ajouter des sources et des destinations dans votre workspace RudderStack.
- Si votre organisation utilise une plateforme Screeb dédiée, la page de la source affiche “Contactez-nous pour connecter cette intégration à votre workspace.” : contactez-nous et nous la connectons pour vous.
Envoyer les données RudderStack vers Screeb (source)
Section intitulée « Envoyer les données RudderStack vers Screeb (source) »- Ouvrez Intégrations et, sur la carte Source RudderStack, cliquez sur Installer. L’intégration est créée et sa page affiche une URL du webhook et un En-tête.
- Dans RudderStack, ajoutez une destination Webhook et reliez-la à la source qui collecte les événements de vos utilisateurs.
- Dans ses paramètres, collez l’URL du webhook Screeb, gardez la méthode POST et ajoutez un en-tête : clé
Authorization, valeur le texteBearer ...de la page Screeb. Utilisez Copier pour copier chaque valeur. - De retour dans Screeb, activez Souhaitez-vous ignorer les événements des utilisateurs anonymes ? si vous ne voulez que les événements qui portent un
userId, et cliquez sur Enregistrer.


Réinitialiser à côté du jeton crée un nouveau jeton : l’ancien cesse aussitôt de fonctionner, mettez donc à jour l’en-tête dans RudderStack sans attendre. Quand le paramètre de workspace Ignorer les utilisateurs anonymes est activé, l’interrupteur des anonymes est bloqué sur activé.
Garder la même identité dans RudderStack et Screeb
Section intitulée « Garder la même identité dans RudderStack et Screeb »Screeb retrouve le répondant de chaque événement RudderStack à partir de son userId, ou de son anonymousId quand le visiteur n’est pas connecté. Pour garder un seul profil par personne, identifiez les utilisateurs avec le même identifiant dans RudderStack et Screeb, et donnez à Screeb l’identifiant anonyme RudderStack : voir Identité des utilisateurs entre outils.
Envoyer les données Screeb vers RudderStack (destination)
Section intitulée « Envoyer les données Screeb vers RudderStack (destination) »- Dans RudderStack, ajoutez une source Webhook. Ses paramètres affichent une URL de webhook qui se termine par
?writeKey=.... - Dans Screeb, ouvrez la page Destination RudderStack.
- Dans URL du webhook, collez l’URL sans sa partie
?writeKey=..., par exemplehttps://<your-dataplane-url>/v1/webhook. - Dans Clé d'écriture, collez la valeur qui suit
writeKey=. Screeb l’ajoute lui-même à l’URL. - Cliquez sur Installer.


Données échangées
Section intitulée « Données échangées »De RudderStack vers Screeb, dès que RudderStack livre chaque événement :
identify: les traits deviennent des propriétés utilisateur.track: l’événement et ses propriétés, listés dans Événements utilisateur, prêts pour le ciblage.screen: une vue d’écran.group: l’utilisateur rejoint ou quitte le groupe, avec ses traits.- Les traits envoyés dans le contexte de n’importe quel événement mettent aussi l’utilisateur à jour.
- Les appels
pageetaliassont ignorés.
Les nouveaux utilisateurs venus de RudderStack comptent dans les utilisateurs suivis par mois de votre offre, comme ceux du SDK.
De Screeb vers RudderStack, pour toutes les enquêtes du workspace (pas les messages), sous forme d’appels track :
Survey seenquand une enquête s’affiche.Survey question answeredà chaque réponse, avec toutes les réponses déjà données.
Le userId est l’identifiant que Screeb affiche pour le répondant : le premier de ses identifiants liés qui n’est pas un UUID (en général l’identifiant utilisateur que vous avez fourni), sinon son premier identifiant lié, sinon son identifiant Screeb. Un répondant anonyme connu par un anonymousId RudderStack est donc envoyé avec cet anonymousId comme userId, et seul un répondant sans identifiant lié est envoyé avec son identifiant Screeb. Le anonymousId est toujours vide. Les propriétés comprennent l’enquête, le canal, la réponse (identifiant, date, langue, tags, complétion), le nom, l’e-mail et les groupes du répondant, les questions et réponses, les propriétés du répondant au moment de la réponse, et des propriétés hidden_field_* et context_*.
Dépannage
Section intitulée « Dépannage »Aucun événement RudderStack dans Screeb. Vérifiez que la destination Webhook est activée, reliée à la bonne source, et envoie l’en-tête Authorization avec le jeton actuel. Si un paramètre d’anonymes est activé, seuls les événements avec un userId arrivent.
Aucun événement Screeb dans RudderStack. Vérifiez que l’URL saisie dans Screeb n’a pas de partie ?writeKey=, et que la clé d’écriture est celle de la source Webhook.
Déconnecter
Section intitulée « Déconnecter »Ouvrez la page de l’intégration et cliquez sur Plus en haut à droite, puis sur Supprimer, et confirmez avec Supprimer l'intégration. Sa configuration est supprimée. Retirez aussi la destination ou la source Webhook dans RudderStack, qui sinon continuerait à échouer.