Transmission des données via URL – Fastory

La transmission des données via URL vous permet de récupérer automatiquement certaines informations sur les participants à votre expérience, sans avoir à les leur demander dans le bot. Il vous suffit d'ajouter des attributs et des clés à la fin de l'URL de votre expérience.

À quoi ça sert ?

Cette fonctionnalité repose sur deux notions :

Les attributs correspondent aux données telles que le prénom, l'adresse email ou le numéro de téléphone. Ils forment les colonnes des données utilisateurs dans Audience.

Les clés correspondent aux valeurs que peuvent prendre les attributs. Elles viennent compléter les colonnes correspondantes dans Audience.

Concrètement, vous transmettez une information à Fastory directement via l'URL, par exemple : https://story.tl/xxxx?first_name=john&last_name=doe. Les données sont alors collectées automatiquement, ce qui vous permet de préserver l'immersion de l'utilisateur et, dans certains cas, d'éviter de reposer une question déjà connue.

Comment ça marche ?

Activez l'add-on de transmission des données sur votre expérience. Sans cette activation, la fonctionnalité ne fonctionnera pas.

Choisissez les attributs à récupérer : un attribut par défaut disponible dans Audience, ou votre propre attribut personnalisé.

Personnalisez votre URL en y ajoutant l'attribut et sa clé.

Retrouvez les valeurs collectées dans l'onglet Audience de votre workspace.

Les attributs que vous pouvez récupérer

Récupérer un attribut par défaut

Vous pouvez récupérer automatiquement les attributs par défaut que vous retrouvez dans Audience :

first_name

last_name

email

phone

date_of_birth

address

postal_code

region

country

age

username

company_job

company_size

company_website

Pour ces attributs par défaut (email, username, numéro de téléphone, etc.), vous n'avez pas besoin de paramétrer le bot. Les informations seront automatiquement récupérées et consultables dans l'onglet Audience de votre workspace. Il faut néanmoins que l'add-on soit activé et que l'URL soit personnalisée avec les attributs et les clés, sans quoi la fonctionnalité ne fonctionnera pas.

Créer votre propre attribut personnalisé

Vous pouvez aussi créer votre propre attribut directement dans le Bot. Ouvrez une question, puis cliquez sur le bouton + pour créer votre attribut. Renseignez le Label de l'attribut que vous souhaitez créer, ainsi que son format (texte, chiffre, date, vrai ou faux).

Par exemple, vous pouvez créer un attribut dotation au format texte.

Attention : ce nouvel attribut ne doit pas être utilisé dans une question du bot.

Imaginons une expérience où l'utilisateur choisit la dotation qu'il souhaite remporter, entre un appareil Samsung ou un appareil Apple. Vous pouvez mettre en place deux boutons de redirection avec deux URL partiellement différentes :

Pour le bouton Apple : https://story.tl/jeu-concours?dotation=apple

Pour le bouton Samsung : https://story.tl/jeu-concours?dotation=samsung

Les données des utilisateurs seront toutes récupérées normalement dans Audience, quel que soit le choix de la dotation. La colonne dotation du fichier .csv sera remplie avec apple ou samsung selon le choix de l'utilisateur.

Personnaliser l'URL

À la fin de l'URL, ajoutez l'attribut et la clé de cette façon : https://story.tl/xxxxxx?attribut=cle.

Par exemple : https://story.tl/jeu-concours?dotation=apple.

Vous pouvez également ajouter plusieurs attributs dans une même URL, en les séparant par des & :

Par exemple : https://story.tl/jeu-concours?dotation=apple&email=john.doe@gmail.com.

Retrouver les données collectées

Dans le fichier « données du bot » de l'onglet Audience, vous retrouverez les attributs ainsi que les clés insérées dans les URL.

Une fois le jeu clôturé, vous pouvez télécharger l'ensemble des informations dans un fichier CSV depuis la page Audience de votre workspace.

Bonnes pratiques

Activez toujours l'add-on avant de personnaliser vos URL, sans quoi aucune donnée ne sera récupérée.

N'utilisez jamais un attribut personnalisé dans une question du bot.

Choisissez des clés courtes et cohérentes (par exemple rh, marketing) pour faciliter la lecture du fichier CSV.

Pour transmettre plusieurs attributs dans une même URL, séparez-les avec le caractère &.

Vérifiez que les emails transmis sont valides, en particulier pour un Instant Gagnant.

Cas d'usage concrets

Si vous voulez récupérer les emails sans les demander dans le bot

Vous rendez votre expérience accessible depuis votre application ou votre site web, sur lesquels l'utilisateur se connecte avec son email et son mot de passe. L'équipe technique de votre application passe alors l'email de l'utilisateur dynamiquement dans l'URL, par exemple https://story.tl/jeu-in-app/?email=xxx@xxx.fr. Lorsque l'utilisateur accède à votre expérience après s'être connecté, son email est automatiquement transmis à Fastory et collecté dans la colonne « email » de votre Audience, sans qu'aucun bot ne soit ouvert.

Si vous voulez distinguer les participants selon la dotation choisie

Mettez en place deux boutons de redirection vers deux URL différenciées par la clé, par exemple ?dotation=apple et ?dotation=samsung. La colonne dotation indiquera ensuite le choix de chaque participant.

Si vous voulez segmenter un concours interne par service

Pour un concours interne à vos différents pôles (RH, marketing, comptabilité), ajoutez l'attribut service dans les paramètres de pré-remplissage du bot, puis distinguez les participations avec la clé :

https://story.tl/mon-jeu-interne?service=rh

https://story.tl/mon-jeu-interne?service=marketing

https://story.tl/mon-jeu-interne?service=comptabilite

Vous saurez ainsi de quel service provient chaque joueur, à retrouver dans le fichier CSV.

FAQ

La fonctionnalité fonctionne-t-elle sans activer l'add-on ?

Non. Pour que Fastory récupère les données, l'add-on doit être activé et votre URL personnalisée avec les attributs et les clés. Sans cela, aucune information n'est collectée.

Dois-je paramétrer le bot pour récupérer un attribut par défaut ?

Non. Pour les attributs par défaut (email, username, numéro de téléphone, etc.), aucune configuration du bot n'est nécessaire. Les informations sont automatiquement récupérées et consultables dans l'onglet Audience.

Puis-je transmettre plusieurs attributs dans une même URL ?

Oui. Séparez chaque attribut par le caractère &, par exemple ?dotation=apple&email=john.doe@gmail.com.

Un attribut personnalisé peut-il aussi être posé comme question dans le bot ?

Non. Un attribut personnalisé destiné à la transmission via URL ne doit jamais être utilisé dans une question du bot.

Où retrouver dans Fastory les données transmises via l'URL ?

Dans l'onglet Audience de votre workspace : les attributs et clés apparaissent dans le fichier « données du bot », et vous pouvez télécharger le fichier CSV complet une fois le jeu clôturé.

Un utilisateur peut-il participer à un Instant Gagnant grâce à l'email transmis ?

Oui. Si l'email transmis est valide, l'utilisateur peut participer directement sans avoir à le ressaisir dans le chatbot. Le système anti-triche de Fastory reste appliqué, et les emails blacklistés ne peuvent pas participer à l'Instant Gagnant.