Create a Personality Quiz Action using templates

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

Build your Action

To build your Action using a personality quiz template, do the following:

  1. Go to the Actions console.
  2. Click New project.
  3. Enter a name for your project and click CREATE PROJECT.
  4. Under More options near the bottom of the page, click Templates.
  5. Click on the Personality Quiz option.
  6. In the Personality section, the only personality available is selected by default. Click NEXT.
  7. In the Fill in your content section, click GET STARTED.
  8. In the prompt, click Personality Quiz Template, which opens a new tab.
  9. Click Make a copy.
  10. Update the Data and Outcomes tabs of your sheet copy with you own personality questions and possible outcomes. Review our guide on personality quiz content for more details.
  11. Update the Configuration tab of the sheet with the title of your quiz and the number of questions. For more information on configuration options, see the configuration parameters section.
  12. When you finish filling out the sheet, go back to the Actions Console and click NEXT.
  13. Copy and paste your Google Sheet's URL into the text field and click UPLOAD.
  14. Click CREATE APP. A notification that says Created will show after a minute or so.

Edit the content of your Action

If you want to change your Action's content, first make the changes you need to your Google Sheet, then navigate to Build > Actions and re-upload your updated sheet.

Configuration parameters

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

Key Description Value
Title To customize the title of the Quiz. Title text
QuestionsPerGame To customize the number of questions in a game.
The default is 5, but matching the number of questions
to the number of traits may yield the best results for users.
Number of questions

Test your Action

Click on Test in the top menu to test your Action via a web interface.

To invoke your Action, say or type Talk to my test app in the simulator. You can also test your Action via Google Assistant on your phone or voice-activated speaker if your device and Actions project are using the same Google account.

If your Action is set up for multiple languages, you can test each language by toggling the Language dropdown menu in the simulator.

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 title in the Configuration tab of your Google Sheet
    Go back to your content sheet, open the Configuration tab and change the name of the Action. In the Actions Console go to Develop < Action and connect the sheet again.
  • Unsupported Google Sheet Configuration tab key
    This error means one of the key-value pairs in the Configuration tab of the your content sheet is incorrect. Refer to 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

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 will mark 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 recommended way to design a personality quiz is to start by defining your outcomes and traits then working backwards to your questions.

Creating outcomes and traits

  1. List the possible outcomes for your quiz on the 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.

Creating questions

  1. List your questions on the Data sheet under the Question column.
  2. For each question:

    1. Add the corresponding trait under the Trait column.
    2. Add an answer that contributes to the trait's value under the Positive column.
    3. Add an answer that detracts from the trait's value under the Negative 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 during each quiz.
  • 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 "|" (no whitespace). For example: sriracha|sriracha sauce.

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 (like true or false).
  • 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 questions per round is 10 questions.
  • 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.

  • To test how the Assistant speaks a single question containing the abbreviations or symbols, update the sheet to contain that single question as the first question, set 'RandomizeQuestions' = 'No', and re-test it with the Actions simulator.

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.