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:
- Go to the Actions Console and log in with your Google account.
- Click on Add/Import Project to create a new project. The Add project window appears.
Give the project a name and click on Create Project.
Under More options, pick Templates.
Click on the Personality Quiz option. You'll now be taken to an Overview page where you can enter information about your Action.
Click Build > Actions, followed by Add your first action.
In the Create Action window, you should see the Flash Cards option appear. Click Build.
In the Personality section, the personality is auto-selected. Click Next.
In the content section, click on Bulk upload the content for your Action using Google Sheets. You will see the following prompt:
Click on the Make a copy of the pre-filled Google Sheet for editing link and click Make a Copy.
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.
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.
When you finish filling out the sheet, go back to the Actions Console and click Next to move on to the Connect Sheet step.
Copy and paste your Google Sheet's URL into the Add your sheet's URL to upload your content field and click Upload:
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.
Edit the content of your Action
If you want to change your Action's content, click on Actions > > Edit Actions.
You can add the following keys in the Configuration tab of the Google Sheet to customize your Action:
|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 Simulator in the left column 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 Google Home 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:
Go to the Overview page for your project in the Actions Console.
Navigate to Setup > Invocation.
- Invocation name: Enter your Action's invocation name. This name is how users invoke your Action.
- Directory title: Enter your Action's name for the directory. This name is presented to users in the Assistant Directory.
- 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.
Navigate to Deploy > Directory information.
- Details: Add your Action's introduction, short description, and a full description that clearly explains what the Action is used for and what it does. You also need to add useful sample invocations,
- Images: Add two images, one for the banner and one for the logo.
- 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.
Category: Select the most appropriate category for your Action to live under in the Assistant Directory.
For Families: If you would like your Action to be targeted to kids and families, select Yes.
Alcohol and Tobacco: If your Action references alcohol or tobacco at all, select Yes.
Testing Instructions: 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.
Navigate to Deploy > Release.
If there are any error messages on the top, you should follow the instructions provided to address the issue. Otherwise, click Submit for production.
If your Action isn't working, see if you're running into one of the issues below and try following the recommended troubleshooting steps:
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 Action 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:
- Log out of all Google accounts and close all browsers.
- Reopen your browser and log back in with the account that you're using for your Actions Console project.
- 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
- List the possible outcomes for your quiz on the Outcomes sheet and column.
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
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.
- List your questions on the Data sheet under the Question column.
For each question:
- Add the corresponding trait under the Trait column.
- Add an answer that contributes to the trait's value under the Positive column.
- 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 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 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.
What does it cost to create a template Action?
There is no cost; we host everything for you for free.
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. You just need to submit your Action for the program, as described in the Submitting your Action section of the Actions for Families guide.