发布前核对清单 (Dialogflow)

在提交 Action 以供审批之前,请查看这些发布前核对清单,了解最佳实践。这些核对清单有助于您找出我们在审批流程中遇到的许多问题,从而提高项目的获批几率。

Google 助理目录

以下核对清单重点列出了您可以采取哪些措施来使用 Google 助理目录的功能改善用户体验。

Google 助理目录
撰写优质的广告内容描述

请确保 Google 助理目录说明使用文字和图片来宣传您的 Action 的实用性、优势和最佳功能。

如果 Google 助理向用户推荐您的 Action,并且对方要求提供更多详细信息,Google 助理将会向用户读出您的 Action 说明。 请确保您的说明在这种情境下听起来可以接受,从而给人留下良好的第一印象。

使用 Google 助理目录网页链接

使用目录网页链接推广您的 Action。您可以在自己的网站和其他营销材料中提供此链接,吸引用户访问您的 Actions 目录页面。

使用 Google 助理链接

创建 Google 助理链接并将其分发给用户,以宣传您的 Action。用户在兼容设备上点击您的链接后,会直接跳转到与您的 Action 对应的对话。

调用和发现

以下核对清单包含一些建议,可让您的 Action 更易于用户调用和发现。

显示名
避免使用包含多个发音的字词

用户和 Google 助理应该能够轻松一致地读出您的显示名。例如,避免在显示名称中使用“Envelope”一词,因为用户和 Google 助理不知道该说“en-vel-ope”还是“ahn-vel-ope”。其他示例包括“撕裂”“蝴蝶结”和“低音”。

确保 Google 能识别您的显示名称
  • 在 Actions 控制台的 Develop 标签页 Invocation 设置中测试你的显示名称。检查文本输出是否与列出的显示名称一致。
  • 在声控音响设备上测试您的 Action。预览您的显示名称并尝试调用它们,以确保它们在此类设备上正常运行。
  • 让不同性别和口音的人进行测试。您应确保无论谁说出您的显示名称,它都能被识别。
  • .
  • 如果用户的显示名称发音无法保持一致,请使用 Actions 控制台的显示名称控件来提供发音。
选择一个简单但唯一的名称

用户应该能够轻松调用您的 Action。如果他们必须难以说出名称或者不容易记住名称,继续使用您的 Action 的可能性会大大降低。

遵循我们的命名政策

如需详细了解显示名称的准则和限制,请参阅命名政策

如果贵商家需要一个不被 Google 助理良好识别或违反了我们的某项政策的显示名,请与支持团队联系以申请豁免。

调用短语
针对 Actions 用例进行设计

围绕您的特定任务和实际用例设计项目的深层链接。避免使用过于笼统且未具体描述 Action 用途的短语。

指定明确的动词-对象对

创建由动词-对象对组成的深层链接,例如“说故事”或“开始冥想”。这些短语更便于用户记住,并且与大多数用户查询非常契合。

使用具有相关同义词的实体

类型对于调用短语非常有用,因为它们可以将多个用户输入与单个短语匹配。确保您添加到调用短语中的所有类型仅包含与短语和您的 Action 用例相关的同义词。

提供一系列高质量的示例调用;

确保无论用户选择怎样的字词,您的 Action 都可以调用。尝试为每个 Action 提供至少 10 个不同的调用短语。您可以在 Actions 控制台中依次点击 Develop > Directory information > Sample invocations 来修改此设置。

查看正确和错误调用短语的示例

调用短语对于通过隐式调用自然发现 Action 来说至关重要,因此您应该花些时间确保它们的设计良好。如需了解详情,请查看我们有关编写有用的调用短语的建议。

界面

以下核对清单重点介绍了您可以采取哪些常见操作,以确保您的响应正确显示在用户体验您的 Action 的界面上。

卡片和选项
使用卡片和选项

卡片和选项可让您以更丰富、更可自定义的格式显示信息。

  • 基本卡片:如果您需要向用户显示大量文本,请使用基本卡片。一张卡片最多可显示 15 行文字,并链接到某个网站以供进一步阅读。与聊天气泡不同,此类卡片支持文本格式。您还可以添加图片以及列表或轮播界面来显示选项。
  • 列表:如果您要求用户从选项列表中进行选择,不妨考虑使用列表,而不是在聊天气泡中写出列表。
  • 轮播界面:如果您希望用户从侧重于较大的图片的选项列表中进行选择,请使用最多包含 8 个项的轮播界面。
建议内容信息条
在大多数回合后使用建议内容信息卡

使用建议内容信息卡可以显著提高您的 Action 在带屏幕的设备上的可用性。实现此类函数后,除了使用语音或键盘之外,用户还可以快速点按屏幕进行响应。例如,对于是或否问题,您可以使用显示的建议内容信息卡。

在选项较少的情况下使用条状标签

向用户提供少量选项(8 个或更少)时,您可以为每个选项添加建议。请按照响应中的相同顺序显示,并使用相同的术语。

在有多种选择的情况下使用条状标签

如果您提出的问题有多种可能的答案,请提出几个最常见的答案。

返回媒体响应时使用条状标签

添加带有媒体响应的建议内容信息卡,以帮助想要转变对话内容的用户。

聊天气泡
正确的大小写和标点符号

请检查您回答的大小写和标点符号是否正确。

修正拼音

如果您在回复中使用 SSML 拼音拼出某些内容以帮助发音,该拼音拼写错误将显示在聊天气泡中。在带屏幕的设备上,使用不同的显示文本来确保聊天气泡的拼写正确无误。

避免截断

聊天气泡不得超过 640 个字符,超出该限制后会被截断(但是,作为一般设计准则,我们建议大约 300 个字符)。如果您有超过 10 个层级,可以执行以下操作:

  • 使用第二个聊天气泡:每轮最多可以使用 2 个聊天气泡,因此请找到自然断点并创建第二个聊天气泡。
  • 不显示所有内容:如果您的语音回复内容较多,请考虑在回复的文本部分仅显示一部分内容,例如介绍性内容。
已录制的音频
从聊天气泡中移除了 <audio> 文本

如果您的 SSML <audio> 标记内包含文本,则这些文本会显示在相应的聊天气泡中。例如,如果您的 SSML 为:

<speak>
  Here's that song.
  <audio src="...">song audio</audio>
</speak>

聊天气泡文字会显示为“这是那首歌。歌曲音频”

请改为在 <audio> 元素内添加 <desc> 元素。系统会显示 <desc> 内的所有文本;如果无法加载音频源文件,<audio> 以外的所有文本都将用作替代文本。例如:

<speak>
  Here's that song.
  <audio src="bad_url"><desc></desc>song audio</audio>
</speak>

这会生成以下音频输出内容:“HERE's that song. audio audio” 和聊天气泡文字:This's that song.

或者,您也可以完全从 <audio> 标记中移除该文本,或使用 SSML <sub> 标记。

消除空的聊天气泡

确保每个对话框轮流至少有一个聊天气泡。如果你的 Action 有只包含语音回复的对话框,聊天气泡文字将缺失,并且你的回复会失败。在这些情况下,请在响应中添加匹配的文本。