fastory

Fastory Studio

Personalize your texts and CTAs with dynamic variables

Dynamic variables automatically display each visitor's information, such as their first name or email, in your experience's texts. They also let you pass this data to your external links. Every participant gets a personalized experience, with no effort on your part.

What is it for?

A dynamic variable is a keyword you insert into a text, between curly braces, for example {first_Name}. When the visitor sees the screen, the variable is replaced by their own value.

The information comes from what the visitor entered in the bot: first name, email, phone, or a custom attribute you created. You can thus greet each player by their first name, display a code that is unique to them, or recall an answer they gave.

Variables also let you hand over to your website: the collected data can be passed to an external link to continue the journey, for example to pre-fill a form or personalize a landing page.

Main features

Display a variable in a Text component

  1. Open your experience in the editor.
  1. Add or select a Text component on the desired screen.
  1. Write the variable name between curly braces, for example {first_name} or {email}.
  1. Publish your experience.

The variable name must match exactly the attribute collected in your bot. You can combine several variables and free text in a single component.

Example: the text Hello {first_name}, your email is {email} displays Hello John, your email is john@email.com for a visitor whose first name is John.

The replacement happens in real time, as soon as the visitor has entered the information. If the variable has no value for that visitor, it is simply removed from the text and nothing is displayed in its place.

Display the first name on the end screen

This is the most common use. Place a Text component on the end screen (outro) and write, for example, Thank you {first_name}. When the bot closes, a visitor who entered "Megane" sees "Thank you Megane", and one who entered "Meg R" sees "Thank you Meg R".

Pass the visitor's data to an external link

On a CTA or a link in the bot, as well as on a share button, the data collected from the visitor (email, phone, custom attributes) can be passed automatically to the destination address, in a secure form.

This option requires enabling external URL data transmission on your workspace. Contact your Fastory representative to enable it.

Once enabled, a secure parameter is added to your link. Reading this data on your website requires a small technical setup on your side: reach out to your developer or your partner.

Best practices

  • Check the exact spelling of the variable name: if it does not match the bot attribute, nothing is displayed.
  • Place the question that collects the information, the first name for example, before the screen that displays it.
  • Write a text that stays correct even if the variable is empty, because it then disappears from the message.
  • Test your experience in real conditions to check that the variable is replaced correctly.
  • Only enable external URL transmission once your destination page is ready to receive the data.

Concrete use cases

If you want to thank the player by their first name, personalize the end screen

Ask for the first name in the bot, then add Thank you {first_name} in a Text component on the end screen. Each player leaves with a message addressed to them personally.

If you want to display information specific to each visitor, combine variables

Display a code, a category, or an answer given in the bot by inserting the matching attribute between curly braces, in the middle of your text.

If you want to continue the journey on your website, pass the data to the link

Enable external URL transmission, then add a CTA to your website. The visitor's data is passed securely to welcome the person or pre-fill a form.

FAQ

How do I display a visitor's first name on the end screen of a Fastory experience?

Collect the first name in the bot, then add a Text component on the end screen with the variable {first_name}, for example Thank you {first_name}. When the bot closes, the first name entered by the visitor is automatically displayed in place of the variable.

Which dynamic variables can you use in a Fastory text?

You can use the information collected from the visitor: their first name, email, phone, and any custom attribute created in your bot. The variable name, between curly braces, must reuse the attribute name exactly.

How do I write a dynamic variable in a Text component?

Write the attribute name between curly braces, for example {first_name}. You can mix several variables and free text, such as Hello {first_name}. The variable is replaced by the visitor's value at display time.

What happens if the variable has no value for the visitor?

If the visitor has not entered the matching information, the variable is simply removed from the text and nothing is displayed in its place. So write a text that stays readable even without the value.

Why is my variable displayed as-is without being replaced?

Two possible reasons: the variable name does not exactly match the attribute collected in the bot, or the information has not been entered by the visitor yet. Check the spelling of the name and the order of your screens.

Can you pass a visitor's data to an external website from a CTA?

Yes. On a CTA, a bot link, or a share button, the collected data can be passed securely to the destination address. This option must be enabled on your workspace beforehand.

Do dynamic variables work with the bot's custom attributes?

Yes. In addition to the first name, email, and phone, you can display any custom attribute created in your bot, by reusing its exact name between curly braces.

Did this answer your question?
😞
😐
🤩