Creating a Personality Quiz App using Templates

The Personality Quiz app template lets you create apps without writing a single line of code. The template lets you specify the questions, answers, and configuration for the app in a Google Sheet. Then, in a few minutes, you'll have a fully working app that you can test and submit for approval.

Building your app

To build your app using a personality quiz template:

  1. Go to the Actions Console and log in with your Google account.
  2. Click on Add/Import Project to create a new project. The Add project window appears.
  3. Give the project a name and click on Create Project. When your project is created, an Overview window appears with several different ways to create an app.

  4. Click on Build within the Personality Quiz card.

  5. In the Personality section, the personality is auto-selected. Click Next.

  6. In the content section, click on Bulk upload the content for your app using Google Sheets. You will see the following prompt:

  7. Click on the Make a copy of the pre-filled Google Sheet for editing link and click Make a Copy.

  8. Update the Data and Outcomes tabs of your sheet copy with your own personality questions and possible outcomes. Review our guide on personality quiz content for more details.

  9. 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.

  10. When you finish filling out the sheet, go back to the Actions Console and click Next to move on to the Connect Sheet step.

  11. Copy and paste your Google Sheet's URL into the Add your sheet's URL to upload your content field and click Upload:

  12. Click on Create App. The Overview page appears, showing you a notification that says Created. It might take a minute before the page refreshes and the notification appears.

Editing the content of your app

If you want to change your app's content, click on Actions > > Edit Actions.

Configuration parameters

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

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

Testing your app

Click on Simulator in the left column to test your app via a web interface. To invoke your app, say or type Talk to my test app in the simulator. You can also test your app via Google Assistant on your phone or Google Home if your device and app are using the same Google account.

Submitting your app

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

To submit your app:

  1. Go to the Overview page for your project in the Actions Console.
  2. Click on the App Information section, click Add and fill out the following information. Most of this information is public and appears in the Assistant Directory.

    1. Name: Enter your app's name. This is how your app appears in the Assistant Directory, as well as how users invoke your app. Use a microphone and say your app's name to help us understand the correct pronunciation.
    2. Details: Add your app's introduction, short description and full description, clearly explaining what the app is used for and what it does. Add sample invocations and select a category for the app. For personality quiz apps, choose Games and Fun.
    3. Images: Add two images, one for the banner and one for the logo.
    4. Testing Instructions: Add any specific testing instructions if required. These are only visible to our review team. Generally, for apps that you build with the personality quiz template, you can leave this blank.
    5. Contact details: Add an email contact. Our review team uses this email address to give feedback on your app. Users can also see this email address to contact you.
    6. Privacy and Consent: Add the URL to your app's privacy policy. The privacy policy explains how you handle user data and appears publicly.

    When you're done filling out your app's information, you will return to the Assistant App Draft page.

  3. Skip the Location Targeting section by clicking Next.

  4. In the Surface Capabilities section, leave the default values of No for both Audio Output and Screen Output. These capabilities are not mandatory for apps that you build with the personality quiz template.

Note: Template apps work on all surfaces supported by the Google Assistant.

  1. The Account Linking section is optional. You may skip this.

  2. Click Submit Draft for Review to submit your app. The review team responds within 48 hours.

Troubleshooting

  • Change the default title in the Configuration tab of your Google Sheet

    Go back to your content sheet and open the Configuration tab. Change the name of the app by using a new title instead of The Fun Trivia Game. Go to the Actions Console 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, 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 up, and to keep things moving, it's good to mix in some true or false 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 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.

FAQ

What does it cost to create a template app?

There is no cost, we host everything for you for free.