Users can discover your apps for the Assistant via the app directory on the web and mobile devices, so be sure to promote and market your apps appropriately. The app directory lets users discover your apps easily and learn how to use them afterwards.
The app directory lets users:
- Browse and find capabilities that meet their needs. Users can explore the directory where apps are categorized into logical groups for easy lookup.
- Discover capabilities of the Assistant and apps for the Assistant that are relevant to them.
- Configure and customize their experience with the Assistant and apps on the Assistant.
The mobile app directory lets users browse apps for the Assistant via the Google app for Android and the Google Assistant app for iOS.
The following examples show a page for Fitbit Coach, a health & fitness app that walks users through a home workout:
The Actions console features analytics that show how your app has been rated in the mobile app directory. Navigate to Analytics > Directory for details about your app's rating over time.
The web app directory lets users browse apps for the Assistant via any web browser. Users can click the Share button on your page for a weblink that goes directly to your app in the web app directory. You can also find a weblink for your app's page in the Actions console on the Overview page.
The following example shows a page for Fitbit Coach, a health & fitness app that walks users through a home workout:
Building a good app directory listing
Your app 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 app. A good directory page should at least include the following:
- An icon and splash image - These should reflect your brand appropriately and differentiate your app from others
- App display name - Associates a name and brand with your app
- Description - A brief rundown of what the app can do and its features
- Example invocations - This teaches users how to invoke your apps after they discover them
Categorization helps users better understand your app's capabilities and create new avenues for your app to be discovered. Apps are grouped by vertical categories (e.g. food & drink) that you can select through the App Info section of the Actions Console.
Apps are also grouped by task-based subcategories, which are based on the actions you've defined for your app (e.g. find food recipes, order food, get nutrition facts). If your app 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 app is properly represented, make sure that your description and sample invocation accurately describe all of your app's use cases. If you have any issues with your app's page or feel your app 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.
- Click App information and then Edit underneath.
- You will be able to edit and change the following fields that show to users:
- Assistant app name
- Type your Assistant app's name. This name will be displayed to users in the Assistant Directory, and will be how users invoke your app textually
- Assistant app introduction
- Summarize what your app can do by completing the sentence in the above field. This phrase will be used by the Assistant to introduce your app to users.
- Short description
- A short, one line description of your app
- Full description
- A complete description of your app
- Large banner image
- A large banner image which will be shown at the top of your Assistant app'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 Assistant app is referenced
- Developer name
- The name of the company that is associated with your Assistant app
- An email account for users to reach out to you
- The category that best describes your Assistant app (e.g. "Food & Drink"). This will help users discover your Assistant app.
- Testing instructions
- Provide any additional information needed to test your app. If your app 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.
- Assistant app name
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.