Bixby completes an action or presents information that delivers on the user’s goal in a Result Moment. It can be in the form of a list of results, a single result, or the receipt of a transaction.
Prior to a Result Moment, Bixby gathers all the information your service needs to fulfill on a user’s intention (See Input Moment), and it has confirmed with the user if necessary (See Confirmation Moment). As an assistant, Bixby’s goal is always to accelerate the conversation leading up to results.
Here are some options
These destinations look nice
Your tour has been scheduled
The conversation does not have to end after a Result Moment. Users can choose to move forward in one of the following ways:
Take action on the result. For instance saying, "Call Liholiho Yacht Club" or “Make a reservation at Liholiho Yacht Club” on restaurant results.
Follow-up with a related request. For instance asking, "When does Liholiho Yacht Club open?" on restaurant results.
Refine by adding or changing inputs. This will represent a new set of results, for instance saying, "Find me some cheaper options".
Result moments are equally applicable while discovering choices, as they are while completing actions. Depending on where the user is in a conversation with Bixby, you may choose one of the following representations of the Result Moment in order to:
Provide Choices when there are multiple results that match a user’s intention or request.
Provide Details when you can confidently narrow down to a single result that matches a user’s intention or request.
Provide a Receipt when the user’s request is complete.
Here are some design considerations to keep in mind when including a result moment in a conversation:
When providing choices, limit the number of distinct data points being shown on every summary to a maximum of four. This goes a long way in making the list scannable and readable.
Also, when providing choices, it’s important that the user understands what information is used to learn their preferences. These need to be shown to users on the summary.
When providing details, give a good overview of the different facets of information, limiting the amount of information. Users can ask if they need more information.
Do not recreate the whole application or service interface by including all the available information. We don't recommend that you change the information hierarchy based on the user’s request. Therefore, it’s best to consider what is really important to a user when deciding between choices for all use cases.
A simple list is the most basic form of a list where content is presented as a flat list of choices to the user.
In the case of images, you can use a grid view which arranges your image content in a 2- or 3-column layout.
Show only the most relevant information a user would need in order to make a choice. Since assistance is not a search experience ideally, it’s best to limit to 25 results.
If your service has curated content, a simple list is the best way to provide these choices to a user.
You can choose from a few different component options that best serves your content. This component is simply repeated in a scrollable list and it will only ever be one type of component.
While providing choices, we recommend you assist the user by highlighting some results. This can make it easier and faster for the user to make a decision.
The platform will display a maximum of 3 Highlights in a list. Also, these highlights will only be visible if there are more than 3 results. And once Highlights are applied, users have the option of seeing additional results.
Additional results are items are grouped with a "More Results" label, and are shown right after the Highlights.
You should keep Highlights visually distinct from regular results. This can be achieved by using more prominent components for the Highlights compared to other results.
Highlights come with a user-facing descriptive label that provides the reason for the Highlight and differentiates it from other results. You should combine multiple criteria when highlighting something. For instance, when looking for flights most users are looking for the lowest prices with the least duration, so highlighting "Cheap and Convenient" instead of just “Cheap Tickets” would make for a more useful highlight.
Since Highlights are predetermined, the developer should exclude all of the Highlights that operate over any of the inputs in a user’s request. For instance, it’s unnecessary to have a "Highly rated" highlight when a user requested “Top Italian restaurants nearby”. All choices should have good ratings.
Superlatives should not be used on Highlight labels. For instance, use "Highly Rated" instead of “Highest Rated”.
Bixby may also often have a highlight "Based on your preferences". This is provided by the preference learning algorithms from the Bixby platform.
Often when there is a hierarchical relationship within results-for instance, events by an artist, or rooms in a hotel—it helps to group these results under their parent result as a header. The parent component, as a header, is usually followed by a set of results presented in a simple list.
The nested items should use tappable components.
There can not be more than one level of nesting.
Use less prominent components for the nested items compared to the parent header component.
The result moment is also applied when providing more details on a single result. In all cases, the user arrives at a single result, either specifically asking for it or navigating to it from a list of choices.
Details should always be in the form of sectioned content. Sectioning helps provide a quick overview of important information.
You should not display all the available information in every section, but instead snippets or examples that provide a flavor for every section. The user can ask for more detail if needed. Do not replicate an application or service.
Since the details have a lot of diverse information, it’s key to maintain a good information hierarchy by keeping important information at the very top.
The range of components that can be used in single result moment is diverse.
Details cannot contain any input components or buttons.
Any actions should be in the Action Zone at the bottom, as a primary action button or conversation drivers. In fact, it is encouraged to provide a primary action in the action zone that invites the user to take an action. For instance, in a hotel-booking scenario, the details of a hotel should have "Book hotel" as the primary action.
A receipt is a type of Result Moment that is used to provide an endorsement that Bixby has successfully completed an action or transaction.
For monetary transactions, we recommend showing a detailed breakdown of the transaction amount.
The receipt should carry the summary of the transaction, consistent with the information from the Confirmation Moment. For more information, see After Commit Action Types in Transactional Workflows.
A receipt can also be leveraged when providing updates on an activity. For more information, see What Is Displayed in an Activity Card
Bixby’s dialog in the Result Moment should be leveraged to provide a summary or commentary on the results shown in the content zone. For more information on how to write dialog, see the writing guidelines.
For more information on when to use these various components, see Designing With Bixby Views and Components and Layout Pattens. You can read more about these components in the Result View section on the Building Bixby Views page of the Developers' Guide or the reference pages linked below.
Use these components while providing choices:
Use these components while providing details:
If a component needs a link in the detail view, use a Compound Card.
Use these components while providing a receipt:
Since there are multiple choices being provided, the action zone should be leveraged to let the user quickly refine the results that are being shown. For example, on a generic request for flowers, you might want to have drivers like "Birthday" or "Anniversary" or "Under $50". Often, refinement options don’t make sense, so conversation drivers are not necessary.
The intention of the action zone in this case is to let the user quickly take action on the result being detailed. For instance, on a Hotel detail page, you might want to have conversation drivers to "Book Hotel", "Call the hotel" or "Get Directions". You could also include conversation drivers that let the user follow up with a related request for example, "Does it have a swimming pool?"
The intention of the action zone in this case is to let the user do something that they would logically do next. For example, when playing a song on Spotify when you are on the receipt, it would be good to specify "Previous song" or "Next song" as a driver.