リリース前のチェックリスト（Dialogflow）

承認のためにアクションを提出する前に、以下のリリース前のチェックリストでベスト プラクティスを確認してください。このチェックリストを使用すると、承認プロセス中に見つかる多くの問題を検出できるため、プロジェクトが承認される可能性が高まります。

アシスタント ディレクトリ

次のチェックリストは、アシスタント ディレクトリの機能を使用する際のユーザー エクスペリエンスを向上させるための手順をまとめたものです。

アシスタント一覧
わかりやすい説明を記述する

アシスタント ディレクトリの説明では、テキストと画像を使って、アクションの有用性、メリット、優れた機能をアピールします。

Google アシスタントがユーザーにアクションを推奨し、ユーザーが詳細を求めると、アシスタントはアクションの説明をユーザーに読み上げます。このような状況で受け入れられる説明にし、良い第一印象を与えられるようにします。
アシスタント ディレクトリのウェブリンクを使用する

ディレクトリ ウェブリンクを使用してアクションを宣伝します。ウェブサイトやマーケティング資料にこのリンクを掲載して、アクションのディレクトリ ページにユーザーを呼び込むことができます。
アシスタント リンクを使用する

アシスタント リンクを作成してユーザーに配布することで、アクションを宣伝できます。対応デバイスでリンクをクリックしたユーザーは、アクションとの会話に直接移動します。

呼び出しと検出

次のチェックリストには、ユーザーがアクションを簡単に呼び出して検出できるようにするための推奨事項が記載されています。

表示名
複数の発音を持つ単語を避ける

ユーザーと Google アシスタントは、表示名を簡単かつ一貫して発音できる必要があります。たとえば、表示名に「エンベロープ」という単語は使用しないでください。ユーザーと Google アシスタントは「en-vel-ope」と「ahn-vel-ope」のどちらと言えばよいかわかりません。他の例としては、「tear」、「bow」、「bass」などがあります。
表示名を Google が認識できるようにする
  • Actions Console の [Develop] タブの [Invocation] 設定で、表示名をテストします。テキスト出力が、表示名に表示されているものと一致するかどうかを確認してください。
  • 音声認識スピーカーでアクションをテストします。表示名をプレビューし、試してみて、このタイプのデバイスで正しく機能することを確認します。
  • さまざまな性別やアクセントの異なるユーザーを対象にテストを実施します。誰が表示名を言っても、その表示名が認識されるようにする必要があります。
    • ​
  • ユーザーが表示名を一貫して発音できない場合は、Actions Console の [表示名] コントロールを使用して発音を指定します。
簡単で一意の名前を付けます。

ユーザーが簡単にアクションを呼び出せるようにします。アクションの名前を言うのが苦手な場合や、名前が簡単に思い出せない場合は、アクションの使用を継続する可能性がはるかに低くなります。
Google の命名規則を遵守する

表示名のガイドラインと制限について詳しくは、命名規則をご覧ください。

ビジネスの表示名が必要な場合に、Google アシスタントであまり知られていない場合や、Google のポリシーに違反している場合は、サポートに連絡して例外をリクエストできます。
呼び出しフレーズ
アクションのユースケースに合わせて設計する

特定のタスクや実際のユースケースを中心に、プロジェクトのディープリンクを設計します。一般的すぎたり、アクションの目的を具体的に説明していないフレーズは避けてください。
明確な動詞と目的語のペアを指定する

「物語を伝える」や「瞑想を始める」など、動詞とオブジェクトのペアで構成されるディープリンクを作成します。これらのフレーズは覚えやすく、ほとんどのユーザークエリとよく一致します。
適切な同義語を持つエンティティを使用する

型は、複数のユーザー入力を 1 つのフレーズに一致させられるため、呼び出しフレーズの便利なツールです。呼び出しフレーズに追加するすべてのタイプには、フレーズおよびアクションのユースケースに関連する類義語のみが含まれるようにしてください。
質の高いサンプル呼び出しを幅広く提供する。

ユーザーの言葉の選択にかかわらず、アクションを呼び出せるようにします。アクションごとに 10 種類以上の呼び出しフレーズを指定するようにしてください。この設定は、Actions Console の [Develop] > [Directory information] > [Sample invocations] で編集できます。
良い呼び出しフレーズと悪い呼び出しフレーズの例を確認する

呼び出しフレーズは、暗黙的な呼び出しを介してアクションが自然に検出されるためには欠かせないため、アクションがうまく機能するよう時間をかけて検討する必要があります。詳しくは、有用な呼び出しフレーズの記述に関する推奨事項をご覧ください。

ユーザー インターフェース

次のチェックリストでは、ユーザーがアクションを体験するサーフェスでレスポンスが適切に表示されるようにするために実行できる一般的な方法について説明します。

カードとオプション
カードとオプションを使用する

カードとオプションを使用すると、情報量が多くカスタマイズ可能な形式で情報を表示できます。

  • ベーシック カード: ユーザーに多くのテキストを表示する必要がある場合は、ベーシック カードを使用します。カードには最大 15 行のテキストを表示し、続きを読むためにウェブサイトへのリンクを設定できます。チャットのふきだしとは異なり、このカードではテキストの書式設定がサポートされています。画像と、リストまたはカルーセルを追加してオプションを表示することもできます。
  • リスト: ユーザーに選択肢のリストから選択するよう求める場合は、チャットふきだしにリストを記述する代わりに、リストの使用を検討してください。
  • カルーセル: 大きな画像に焦点を当てて選択肢のリストからユーザーに選択してもらう場合は、カルーセルを使用します（最大 8 項目）。
候補ワード
ほとんどのターン後に候補ワードを使用する

候補ワードを使用すると、画面のあるデバイスでのアクションのユーザビリティが大幅に向上します。実装すると、ユーザーは音声やキーボードに加えて、画面をすばやくタップして対応できるようになります。たとえば、「はい」または「いいえ」で答える「はい」または「いいえ」という候補ワードを使用できます。
選択肢が少ない場合にチップを使用する

ユーザーに少数の選択肢（8 つ以下）を提示する場合は、選択肢ごとに候補を追加できます。回答と同じ順序で提示し、同じ用語を使用してください。
選択肢が多数ある場合にチップを使用する

質問に多様な回答の選択肢がある場合は、よく寄せられる回答をいくつか提示します。
メディア レスポンスを返すときにチップを使用する

メディア レスポンスを含む候補ワードを組み込んで、会話を方向転換したいユーザーを支援します。
チャットのふきだし
大文字と小文字の区別と句読点を正しく使用する

大文字 / 小文字と句読点の誤りがないか、回答を確認してください。
発音記号の修正

レスポンスで SSML を使用して発音的にスペルミスした場合、発音を助けるスペルミスがチャットふきだしに表示されます。画面を備えたデバイスでは、チャットのふきだしに正しいスペルが使用されるように、異なる表示テキストを使用します。
文字切れの回避

チャットのふきだしは最大 640 文字で、640 文字を超えた後は切り捨てられます（ただし、一般的な設計ガイドラインとして 300 文字程度をおすすめします）。上限を超えている場合は、次のことが可能です。

  • 2 つ目のチャットふきだしを使用する: ターンごとに最大 2 つのチャットふきだしを設定できるため、自然な切れ目を見つけて 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 school. 他社の音楽です」という音声と、チャットのふきだしのテキスト「Here's that Music.」となります。

あるいは、<audio> タグからテキストを完全に削除するか、SSML <sub> タグを使用することもできます。
空のチャットのふきだしをなくす

すべてのダイアログターンに少なくとも 1 つのチャットふきだしがあることを確認します。アクションに音声レスポンスのみで構成されたダイアログがある場合、チャットのふきだしテキストは失われ、レスポンスは失敗します。そのような場合は、一致するテキストをレスポンスに追加します。