Users can discover your Actions via the Assistant directory on the web and mobile devices, so be sure to promote and market your Actions appropriately. The Assistant directory lets users discover your Actions easily and learn how to use them afterwards.
The Assistant directory lets users:
- Browse and find capabilities that meet their needs. Users can explore the directory where Actions are categorized into logical groups for easy lookup.
- Discover capabilities of the Assistant by finding Actions that are relevant to them.
- Configure and customize their Assistant experience with Actions.
The following examples show a page for Fitbit Coach, a health & fitness Action that walks users through a home workout:
The Actions console features analytics that show how your Action has been rated in the mobile Assistant directory. Navigate to Analytics > Directory for details about your Action's rating over time.
The web Assistant directory lets users browse Actions via any web browser. Users can click the share button on the top of your page for a weblink. You can also find the weblink for your Action's page in the Actions console on the Overview page.
If users are signed in their Google accounts, they can review your Action as well.
The following example shows a page for Fitbit Coach, a health & fitness Action that walks users through a home workout:
Building a good Assistant directory listing
Your Actions project is featured on its own page, so it's important that you promote and highlight your capabilities and provide everything users need to know about your Action. A good directory page should at least include the following:
- An icon and splash image - These should reflect your brand appropriately and differentiate your Action from others
- Action display name - Associates a name and brand with your Action
- Description - A brief rundown of what the Action can do and its features
- Sample invocations - This teaches users how to invoke your Actions after they discover them
Categorization helps users better understand your Action's capabilities and create new avenues for your Action to be discovered. Actions are grouped by vertical categories (e.g. food & drink) that you can select through the Directory information section of the Actions Console.
Actions are also grouped by task-based subcategories, which are based on the actions you've defined for your Action (e.g. find food recipes, order food, get nutrition facts). If your Action accomplishes multiple different tasks for users, it may be listed under more than one task category. In this case, you may also want to consider categorizing it under more than one vertical category.
To make sure your Action is properly represented, make sure that your description and sample invocation accurately describe all of your Action's use cases. If you have any issues with your Action's page or feel your Action has been miscategorized, contact support.
Modifying your directory page
All actions will be automatically available in our directory. You are able to modify the page(s) representing your action, however, by following the instructions below.
- Go to your Actions on Google project by signing into the Actions
- If you don't have a project yet, you'll need to make sure you claim your page first, which you can do by clicking a link at the bottom of your page in the directory.
- Navigate to Deploy > Directory information
- You can edit and change the following fields that show to users:
- Short description
- A short, one line description of your Action
- Full description
- A complete description of your Action
- Large banner image
- A large banner image which will be shown at the top of your Action's page in the directory
- Small square logo
- A small logo which will be shown in the directory, as well as other places where your Action is referenced
- The category that best describes your Action (e.g. "Food & Drink"). This will help users discover your Action.
- Testing instructions
- Provide any additional information needed to test your Action. If your Action requires account linking or login information, you must provide a username and password for a test account. Please make sure that any provided accounts are not real user accounts. This information will only be used by the review team, and will not be visible to users.
- Short description
Submit your changes to the review team by selecting Submit for review. The team will review your changes to your directory page and approve shortly if there are no required corrections.