Update your Action
While you can no longer create a new Action with this template, you can still update an existing Personality Quiz 1 Action. The following sections describe how to update, test, and resubmit your existing Action.
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.
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.
Resubmit your Action
After you've edited your Action, you need to resubmit it. To do so, follow these steps:
- In the Actions console, navigate to Deploy > Release.
- Click Submit for production.
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.
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|
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, 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.
TroubleshootingIf 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
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:
- 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.
FAQWhat 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?
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.