The Trivia Action template lets you create Actions without writing a single line of code. The template lets you specify 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 trivia template, do the following:
- Go to the Actions console.
- Click New project.
- Enter a name for your project and click CREATE PROJECT.
- Under More options near the bottom of the page, click Templates.
- Click on the Trivia option.
- In the prompt, click Trivia Template, which opens a new tab.
- Click Make a copy.
- Update the Questions & Answers tab of your sheet copy with your own questions, answers, and hints. Try adding fun follow-ups that give users extra facts about the answer.
- Update the Configuration tab of the sheet with the name of your Action. You can further customize your game by optionally assigning a difficulty and/or category to each question, and provide custom sounds via audio URLs. For more information on custom configuration options, see the configuration parameters section.
- When you finish filling out the sheet, go back to the Actions Console and click NEXT.
- Copy and paste your Google Sheet's URL into the text field and click UPLOAD.
Add question difficulty and/or category
You can optionally configure your trivia Action's questions to be grouped by up to three difficulty levels, custom categories, or both. When users invoke your Action, they will be prompted to select the difficulty and/or category level at the start of each game. On a device with a screen, the user is presented with suggestion chips to select the category or difficulty level.
You can use this example trivia game sheet with both question difficulties and categories to get started.
The following sections describe how to add difficulty levels and/or categories to your quiz:
Difficulty levels - To add difficulty levels to your questions, add a column to your sheet's Questions & Answers tab titled "Difficulty/Grade Level", then add a difficulty or grade level to each question in your sheet. You can denote up to three different difficulty levels, e.g. "Easy," "Medium," and "Hard."
- You may also want to set some custom configuration parameters, namely DifficultyOrGradeLevelPrompt, DefaultDifficultyOrGradeLevel, and DifficultyOrGradeLevelSuggestionChip1/2/3.
Categories - To add categories to your questions, add a column to your sheet's Questions & Answers tab titled "Category/Topic, then add a category or topic to each question in your sheet. You can denote up to three different categories, e.g. "Science," "Math," and "General Knowledge."
- You may also want to set some custom configuration parameters, namely CategoryOrTopicPrompt, DefaultCategoryOrTopic, and CategoryOrTopicSuggestionChip1/2/3.
Difficulty levels and categories - To add both difficulty levels and categories to your questions, follow the instructions above to create and populate both the "Difficulty/Grade Level" and "Category/Topic" columns.
- In addition to the configuration parameters above, you may also want to set FirstChoice and SecondChoice.
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.
Add additional languages to your Action
Once you've successfully uploaded a Google Sheet for your first language, you can add additional languages by uploading additional sheets for each new language.
On the Overview page, click Modify languages to add a new language, then navigate to Develop > Actions and select the new language you want to work on
You can customize your Action with categories, difficulty and grade levels, or even custom audio files to build your own personality. To configure a custom option, type the key and value in the Configuration tab of your sheet.
You can add the following optional keys in the Configuration tab of the Google Sheet to further customize your Action:
||The "ding" sound that is played after each question to prompt the user for their response.||Audio URL|
||The intro music played when the game starts.||Audio URL|
||The music played at the end of the game.||Audio URL|
||The music played when the user gives a correct answer.||Audio URL|
||The music played when the user gives an incorrect answer.||Audio URL|
||The music played when the round ends.||Audio URL|
||The music played while the game calculates the score.||Audio URL|
||When value is set to 'no', the questions are serially asked in the given category/difficulty or grade level. Useful for testing the pronunciation, grammar, and time-length of the question. This parameter only works when the total number of questions is less than 50. This parameter should only be used for testing purposes.||Yes / no|
||To record analytics associated with the Action using Google Analytics. Note that you can also use the Actions Console to track analytics for your Action.||Add the Google Analytics tracking id|
||To customize the exit message used when the Action exits.||TTS message|
||To customize the prompt presented to the user about the difficulty selection.||A string, e.g. “Which difficulty do you want to start with?”|
||To customize the default difficulty level.||A string, e.g. “Easy”|
||To customize the first selection chip displayed to the user for the game's difficulty.||A string, e.g. “Easy”|
||To customize the second selection chip displayed to the user for the game's difficulty.||A string, e.g. “Medium”|
||To customize the third selection chip displayed to the user for the game's difficulty.||A string, e.g. “Hard”|
||To customize the prompt presented to the user about the category selection.||A string, e.g. “Which topic do you want to work on?”|
||To specify which category (difficulty/grade level or category/topic) the user is asked about first.||A string, e.g. "Difficulty/Grade Level" or "Category/Topic"|
||To specify which category (difficulty/grade level or category/topic) the user is asked about second. You have to
||A string, e.g. "Difficulty/Grade Level" or "Category/Topic"|
||To customize the default category.||A string, e.g. “Science”|
||To customize the first selection chip displayed to the user for the game's category.||A string, e.g. “Science”|
||To customize the second selection chip displayed to the user for the game's category.||A string, e.g. “Math”|
||To customize the third selection chip displayed to the user for the game's category.||A string, e.g. “General Knowledge”|
Add a personality
Beeps the Robot is the default persona, but you can choose another personality for your Action. Use the players below to hear audio samples of each personality:
|Beeps the Robot|
Each personality has different spoken prompts and sound effects that users hear as they play the game.
To add a new personality to your Action, follow these steps:
- Navigate to your spreadsheet and click the Configuration tab.
- Add the key
- Add a corresponding value for the personality you want. If you'd like
to add the Regal Queen's personality, type
queen. For Mr. Montgomery, type
teacher. For Beeps the Robot, type
- Navigate to Build > Actions and reupload your 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.
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.
- Under Quick setup, click Decide how your Action is invoked.
Set the following options and click Save.
- Display name: 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 and enter information for the following sections:
- Description: Add your Action's short description and a full description that clearly explains what the Action is used for and what it does.
- Sample invocations: Add additional sample invocations users might say to talk to your Action.
- 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.
- 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.
- 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.
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.
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.
- Ordinal answers like first one, 3rd, and second option are understood by the Assistant as valid responses to multiple-choice questions, so your users can respond however feels the most natural to them.
- 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.
- You can add up to 1000 questions per Action. If you have more than 1000 questions, you can replace the content periodically, or create multiple Actions and categorize the questions accordingly.
- In the absence of a follow-up statement, leave the cell empty. Do not add programming characters such as
Refrain from using questions with multi-word answers that have overlapping words. For example:
- Question: What are the necessary ingredients for XYZ?
sunlight, carbon dioxide, and water
sunlight, carbon dioxide and oxygen
sunlight, oxygen and water
Be cautious while using multi-word, non-overlapping answers, because it might be difficult for users to repeat back the whole answer. For example:
- Question: What are the necessary ingredients for XYZ?
sunlight, water, carbon dioxide
oxygen, nitrogen, selenium
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.
FAQWhat does it cost to create a template Action?
There is no cost at this time; we host everything for you for free.Do you support categories?
Yes, a trivia game can have up to 9 categories.How do I add custom audio to my Action?
Use the Configuration Parameters tab to provide audio URLs as key-value pairs. Ensure your URLs use HTTPS links and your audio files are in one of the supported formats listed in SSML audio.Can I update the personality for my Action?
Yes. To update the personality for your Action, follow the instructions in the Add a personality section. Then, resubmit your Action.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.