Create a Personality Quiz 2 Action using Templates

The Personality Quiz 2 Action template lets you create Actions without writing code. This template lets you specify questions, answers, and outcomes for the Action in a Google Sheet. Then, after completing these steps, you'll have a fully working Action that you can test and submit for approval.

Actions built with the Personality Quiz 2 template use Interactive Canvas. Interactive Canvas allows for full-screen animation on Smart Displays, Google Nest Hubs, and Android mobile devices, and provides a visually rich, immersive experience for your users.

Personality Quiz 2 uses traits to map the user to an outcome depending on their answers to a series of questions. The game asks one question for each trait, and the user’s response determines whether that trait is marked as positive or negative. When the quiz is over, the final values of all traits build a profile for the user that is mapped to the closest matching outcome.

To see how Personality Quiz 2 works, check out the Actions Call Santa and Do You Love Me, which were built with the Personality Quiz 2 template.

Figure 1. An image from the Do You Love Me Action.

Build your Action

To build your Action using the Personality Quiz 2 template, do the following:

  1. Go to the Actions Console and log in with your Google account.

  2. Click on New/Import Project to create a new project.

  3. Enter a name for the project and click Create project.

  4. Under More options near the bottom of the page, pick Templates.

  5. Click on the Personality Quiz 2 option.

  6. Click on the Overview tab in the top navigation.

  7. Click Build your Action. Then, click Add Action(s).

  8. In the window, click Get Started to create content for your Action.

  9. Click Personality Quiz 2 Template to create a copy of the pre-filled sheet. Alternatively, you can create a new sheet from scratch. (If you’re creating your own sheet from scratch, follow the recommended content format so your app works correctly.)

  10. Click Make a Copy.

  11. Update the Quiz Intro, Quiz Q&A, and Quiz Outcomes tabs of the copied sheet with your own content (introduction, questions, and possible outcomes). Review our guide on personality quiz content to understand the Personality Quiz 2 sheet.

  12. Update the Quiz Settings tab of the sheet with the title of your quiz and the number of questions. For more information on settings, see the configuration parameters section.

  13. When you finish filling out the sheet, go back to the Actions Console and click Next.

  14. Copy and paste your Google Sheet's URL into the Google Sheet URL field and click Upload:

  15. Click on Go to simulator to test your Personality Quiz Action.

Edit the content of your Action

If you want to change your Action's content, do the following:

  1. Update the sheet.
  2. In the Actions Console, click Actions in the left navigation. Then, click Develop in the top navigation.
  3. Click Get Started under Fill in your content. Then, click Upload.

Configuration parameters

You can add the following keys in the Quiz Settings tab of the Google Sheet to customize your Action:

Key Description Value
Intro Title The title of the quiz. Text
Intro Subtitle The subtitle of the quiz. Text
Number of Questions Per Quiz The number of questions in a game. The default is 3, but matching the number of questions to the number of traits may yield the best results for users. Number
Play Intro Confirmation The quiz introduction. If you want your quiz to ask the user’s permission before starting, select Yes. Otherwise, select No. Yes/No
Intro Title Text Color The introduction title color if your quiz uses the intro title. Color
Intro Subtitle Text Color The intro subtitle color if your quiz uses the intro subtitle. Color
Text Color The text color in your quiz. Color
Button Text Color The color of the UI elements (like Button and Progress Bar) in your quiz. Color
Button Background Color The background color of buttons. Color
Selected Button Text Color The color of button text when a button is selected. Color
Selected Button Background Color The background button color when the button is selected. Color
Progress Bar Background Color The background color of the progress bar. Color
Progress Bar Fill Color The color of the progress bar. Color
Font The font. By default, Google Sans font is used to display text in your quiz. Font
Start Button Text The text on the button displayed on the intro screen. Text
Restart Button Text The text on the button displayed on the final screen for users to play the game again. Text

Test your Action

Click Go to Simulator after uploading your sheet or Test in the top navigation to test your Action via a web interface. To invoke your Action in the simulator, say or type Talk to my test app. You can also test your Action via the Google Assistant on your phone, Google Home, Google Home Hub or other smart display if your device and Actions project are using the same Google account.

Submit your Action

When the Actions section is complete and you have tested your Action, you may submit your Action to Google for review. If your Action is approved, it will be available to Assistant users.

To submit your Action, do the following:

  1. Go to the Overview page for your project in the Actions Console.
  2. Under Quick setup, click Decide how your Action is invoked.

    Set the following options and click Save.

    1. Display name: Enter your Action's name for the directory. This name is presented to users in the Assistant Directory.
    2. Google Assistant voice: Pick which voice you would like your Action to use. You can hear audio samples of each voice on the Languages and Locales page.
  3. Navigate to Deploy > Directory information and enter information for the following sections:
    1. Description: Add your Action's short description and a full description that clearly explains what the Action is used for and what it does.
    2. Sample invocations: Add additional sample invocations users might say to talk to your Action.
    3. Images: Add two images, one for the banner and one for the logo.
    4. Contact details: Add an email contact. Our review team uses this email address to give feedback on your Action. Users can also see this email address to contact you.
    5. Privacy and Consent: Add the URL to your Action's privacy policy. The privacy policy explains how you handle user data and appears publicly.
    6. Additional information:
      • Category: Select the most appropriate category for your Action to live under in the Assistant Directory.
      • For Families: If your Action targets children as its primary audience or one of its audiences, select Yes.
      • Alcohol and Tobacco: If your Action references alcohol or tobacco at all, select Yes.
      • Testing Instructions (optional): Add any specific testing instructions if required. These are only visible to our review team. Generally, for Actions that you build with the trivia template, you can leave this blank.
      • Transaction: Template Actions don't perform Transactions, so you can leave this blank.
      • Mic Policy: Template Actions don't leave the mic open without prompting, so you can leave this blank.
  4. Navigate to Deploy > Release.
  5. If there are any error messages on the top, you should follow the instructions provided to address the issue. Otherwise, click Submit for production.

Troubleshooting

If your Action isn't working and you’re running into one of the issues below, try the following troubleshooting steps:

  • Change the default Intro Title in the Quiz Settings tab of your Google Sheet.

    Go back to your content sheet and open the Quiz Settings tab. Change the name of the Action with a new title. Go to the Actions Console and upload the sheet again.

  • Unsupported Google Sheet Configuration tab key.

    This error means one of the key-value pairs in the Quiz Settings tab of your content sheet is incorrect. Refer to the list of Configuration Parameters and make sure your keys are all spelled correctly.

  • Failed to get conversion.

    If you see this error, refresh the web page and try again.

  • Request Access Error.

    You might see a screen requesting access permission when you try to access the pre-filled template content sheet. If this occurs:

    1. Log out of all Google accounts and close all browsers.
    2. Reopen your browser and log back in with the account that you're using for your Actions Console project.
    3. If the error message persists, try using Incognito mode in Chrome.
  • Simulator Not Responding. If the simulator doesn't show the Test or Authorize button, refresh the web page and try again.

Personality Quiz Content

The Personality Quiz 2 sheet has 6 tabs: Read Me, Quiz Intro, Quiz Q&A, Quiz Outcomes, Quiz Settings, and General Prompts. Each of the sheet’s tabs have columns that are green, yellow, or grey.

  • Green columns: You must edit the values (mandatory values) in these columns.
  • Yellow columns: You can optionally edit the values in these columns.
  • Grey columns: You must not edit the values in these columns.

The recommended way to design a personality quiz is to first define your outcomes and traits, and then work backwards to figure out your questions. The following sections go over how to fill out the tabs in the spreadsheet to design your personality quiz.

Quiz Intro

The Quiz Intro tab has one required column (in green) and four optional, hidden columns (in yellow).

  • Displayed Introduction (required): The introduction that is shown on screen devices at the start of the quiz.
  • Spoken Introduction (optional): Allows you to customize the introduction for speech-enabled devices by providing simple text or Speech Synthesis Markup Language (SSML). If you leave this cell blank, what you entered in the Displayed Introduction cell is spoken when the quiz starts.
  • Quiz Intro Background Landscape Image and Quiz Intro Background Portrait Image (optional): Allows you to add customized background images for the quiz introduction for display-enabled devices.

Quiz Q&A

In general, a personality quiz uses traits to map a user to a possible outcome. A quiz game will ask one question for each trait, and the response marks that trait as either positive or negative. When the quiz is over, the final values of all traits build a profile that is mapped to the closest matching outcome.

The Quiz Q&A tab of Personality Quiz 2 has four required columns: Personality Trait, Displayed Question, Positive Response Answers, and Negative Response Answers. These columns allow you to specify questions that bring out a personality trait of the player, as well as specify the positive and negative responses to that question.

Quiz Q&A has nine optional columns:

  • Spoken Question: In addition to the Displayed Question (required column), you can specify either text or SSML that will be spoken along with the displayed question for speech-enabled devices. If this is not provided, the spoken text is taken from the Displayed Question column.
  • Positive Response Displayed Followup & Negative Response Displayed Followup: The follow up text that is displayed on display-enabled devices when the player responds positively or negatively, respectively, to the corresponding question.
  • Positive Response Spoken Followup & Negative Response Spoken Followup: The follow up text that is spoken on speech-enabled devices when the player responds positively or negatively, respectively, to the corresponding question. If the Displayed Followup is supplied and the Spoken Followup is omitted, the Displayed Followup is spoken during quiz play.
  • Quiz Question Background Landscape Image & Quiz Question Background Portrait Image: These columns allow you to add a custom background image for the corresponding question for display-enabled devices.
  • Positive Suggested Answer Image & Negative Suggested Answer Image: These columns allow you to display a different image for positive and negative answers for display-enabled devices. As a rule of thumb, specify the image for both the positive and negative answer, or for neither.

Creating outcomes and traits

  1. List the possible outcomes for your quiz on the Quiz Outcomes sheet and column.
  2. Come up with a set of traits that differentiate each outcome. For example, the following traits could be useful for a superhero personality quiz:
    • Speed
    • Supernatural
    • Flight
    • Stealth
    • Alien
    • Strength
  3. For each outcome, categorize each trait under Positive Traits or Negative Traits. Traits that could be used to describe a given outcome should be classified as positive, while the remaining irrelevant traits should be classified as negative. For example, an outcome for a superhero who is strong but slow should have Strength in its Positive Traits column and Speed in its Negative Traits column.

Keep the following guidelines in mind when building your outcomes and traits:

  • Each outcome should have every trait listed between the Positive Traits and Negative Traits columns.
  • Use & to separate multiple traits in the same cell.
  • Make sure that no two outcomes have the exact same set of positive and negative traits.
  • You do not need to provide outcomes for every possible combination of positive and negative traits. For example, in the Action "Do You Love Me", different sets of questions can give the result "Cat & Cardboard Box" because the user's answers are mapped to the closest outcome.

Creating questions

  1. List your questions on the Quiz Q&A sheet under the Displayed Question column.
  2. For each question:
    • Add the corresponding trait under the Personality Trait column.
    • Add an answer that contributes to the trait's value under the Positive Response Answers column.
    • Add an answer that detracts from the trait's value under the Negative Response Answers column.

Keep the following guidelines in mind when designing your questions:

  • Make sure you have at least one question associated with each trait.

    • If you have more than one question associated with a trait, the question for that trait will be randomly selected each time the quiz is played.
  • Each question can only have two possible answers: Custom answers or yes/no.

    • For questions with custom answers, the two possible answers will be enumerated after the question. For example: "How do you get to the bus stop when you're late? Run or Walk?"
    • For yes/no questions, "yes" and "no" will not be enumerated after the question (e.g. "Do you like taking timed tests?").
  • If an answer has multiple phrasing options, separate each option with a vertical bar character. For example: sriracha|sriracha sauce.

Quiz Outcomes

The Quiz Outcomes tab has three required columns and six hidden columns.

  • Displayed Quiz Outcome (required): This column specifies the outcome of the quiz in text format for display-enabled devices.
  • Positive Outcome Matching Traits & Negative Outcome Matching Traits (required): These columns allow you to specify multiple traits that match an outcome (positive or negative). Each of these traits must be separated by an ampersand (“&”).
  • Spoken Quiz Outcome (optional): This column allows you to specify the quiz outcome in text or SSML for speech-enabled devices. It’s spoken when the player completes the quiz. If omitted, the text in Displayed Quiz Outcome is spoken.
  • Horizontal Outcome Image & Vertical Outcome Image (optional): These columns allow you to add a custom outcome image for horizontal and vertical layouts for the corresponding outcome for display-enabled devices. As a general rule, you should specify the image either for all outcomes or for none.
  • Outcome Background Landscape Image & Outcome Background Portrait Image (optional): These columns allow you to add a customized background image for the corresponding outcome for display-enabled devices.
  • Outcome Title (optional): This column allows you to specify the title text for the outcome image to show on display-enabled devices.

General Prompts

The General Prompts tab includes all prompts that are spoken during game play. You can change the prompts that are included, but do not add or remove rows from that sheet.

The General Prompts tab has one required column and one optional (hidden) column.

  • Displayed Flow (required): Allows you to customize displayed transitions for display-enabled devices. These transitions are displayed when the quiz moves from one question to another after the player has provided the answer. These transitions are not used if there is an error or an issue with the flow of the quiz.
  • Spoken Flow (optional): Allows you to specify normal text or SSML to transition between questions for speech-enabled devices. If you don't provide Spoken Flow, spoken transitions are taken from the Displayed Flow column.

As a rule of thumb, the user must not add/remove rows from the General Prompts tab.

Content Best Practices

  • Question Format:
    • Keep questions clear and short. Don't force the user to hold a lot of words in their heads.
    • Keep the answers even shorter. One or two-word answers work best.
    • Make sure your questions are actually asking the user a question.
      • Try to start with question words such as who, _what, _or when. Guide users to the kind of answer they should give.
    • Since users can't interrupt a question, it's helpful to introduce a list of answers with "Which of these options…" Users might try to answer a question before they hear them all, so let them know that more are coming.
  • Synonyms: If you think there are multiple correct ways to answer a question, you can set multiple synonyms by using the "|" key as a separator. For example, if a question's answer is set to "United States|USA|US", a user could say any of these synonyms to correctly answer the question.
  • Engagement: To vary the questions and keep things moving, try to mix in different types of questions.
  • Cultural Reach: To engage the maximum number of users, try to offer questions that many people can relate to, regardless of their ethnic or class background. Remember that not everyone has been exposed to the same classical and cultural references.
  • Understandability: Answers work best when they require three or fewer words. If the user has to give a lengthy response, the voice-detection error gap widens.
  • Efficiency: It's best to use contractions wherever possible ("I'm" instead of "I am") to speed up TTS playback.
  • Age Appropriateness: Determine your target audience before you create your questions and answers. We recommend targeting your content for age appropriateness.
  • Gender Diversity: For maximum user engagement, remember that you're targeting diverse genders. Try to use pronouns, examples, and subject matter that a maximum number of users can relate to.

General Guidelines and Restrictions

  • The maximum question length is 200 characters.
  • Try not to include complicated or very long words that may be hard for the computer speech to pronounce or users to understand. For example, mechanoreceptors or proprioceptors.
  • Do not ask two questions such as "How many x are there? What are they?" as a part of one single question.
  • The maximum answer length is 25 characters.
  • The maximum number of questions per round is 10 questions. We recommend that you keep the number of questions small (3-4 is ideal) to keep the quiz interesting for users.
  • Do not include special characters such as "^", ":" , "(" , ")"
  • You may include "&", "$", "#", "@" in your questions and answers. If you do, please test them on a device to ensure they are spoken correctly and the answers are speech-recognized correctly.
  • If you have abbreviations or mathematical symbols as a part of the question or answer, make sure you test each phrase to hear how the Assistant speaks it and if the speech recognition works. For example, "O2" (for oxygen), "NAACP," and "a+b=c+d" may not be spoken or speech-recognized as you expect.
  • Personality Quiz 2 uses reserved intents, which you must not use as as expected answer:

    • Neither
    • None
    • Both
    • Either
    • Any one
    • Wrong
    • No
    • Nah
    • Nope
    • False
    • Incorrect
    • Negative
    • Last
    • Last one
    • 2nd
    • Second
    • First one
    • Yep
    • True
    • Right
    • Yeah
    • Absolutely
    • Yes
    • I do
    • Positive
    • Correct

FAQ

What does it cost to create a template Action?

There is no cost at this time; we host everything for you for free.

How do I track analytics associated with the Action? Can I customize the metrics?

You can use the Actions Console to track analytics for your Action. You can also use Google Analytics by specifying the Google Analytics ID in the Configuration tab of your sheet.

Can I submit my Action to the Actions for Families program?

Depending on your Action's content, template Actions can comply with the Actions for Families Program Requirements. Learn more about how to submit your Action for the Actions for Families program here.If your Action targets children as its primary audience or as one of its audiences, it must participate in the Actions for Families program.