このページでは

コンテンツをLLM検索に確実に表示させる方法

AIシステムがユーザーが情報を発見する主な手段になるにつれて、明確で構造化されたコンテンツが不可欠となっています。ChatGPT、Claude、Perplexityなどの大規模言語モデル（LLM）は、構造、新鮮さ、信頼性を組み合わせて応答で参照すべきコンテンツを決定します。

このガイドでは、LLMがコンテンツを正確に理解し表現できるように、Amplitudeコンテンツを記述および整理する方法について概説しています。

明確さと意図をもって書く

LLMは、明確で直接的で、アルゴリズムのためではなく読者のために書かれたコンテンツを優先します。

コンテンツを作成する場合：

  • 短い文と明確な動詞を使用してください。
  • 各セクションの冒頭に具体的な目的を述べてください。
  • 理解に必要のない技術用語は避けてください。
  • そのトピックに慣れていない同僚に概念を説明しているかのように書きましょう。

すべての見出しや段落は、「Amplitudeでカスタムイベントを追跡する方法は？」など、誰かがAIアシスタントに入力しそうな質問に答える内容にする必要があります。

質問ベースの見出しを使用する

LLMは、見出しに質問が明示的に記載されている場合、より効率的にコンテンツを識別および抽出します。

例：| 悪い見出し | 改善後の見出し | {#}| アクティベーションメトリクス | Amplitudeでアクティベーションメトリクスを追跡するには？ | | ファネルの概要 | Amplitudeのファネルとは何？ | | リテンションガイド | ユーザーのリテンションを測定する方法は？|

可能な場合はいつでも、実際の検索クエリを反映した自然な表現を使用してください。

AIの読みやすさを確保するためのページの構造化

モデルは、長いテキストブロックよりも構造化された文書をよりよく理解します。 予測可能な階層構造と明確なセグメンテーションを使用してください。

次の構造チェックリストを使用して、階層構造を理解できるものにしてください。

  • 1ページにつき1つのH1タイトル。
  • 主要な概念を区別する、明確なH2およびH3の小見出し。
  • 短い段落（2〜4文）。
  • ステップと比較のための箇条書きまたは番号付きのリスト。
  • 例やパラメータを整理するための表。

また、適切に構造化されたページは、人間のユーザーやアクセシビリティツールにとっても読みやすさを向上させます。

コンテンツを最新かつ正確に保つ

LLMは最新かつ最新情報に更新されているコンテンツを重視しています。モデル生成の回答に古くなったページや失効済みページが表示されることはあまりありません。

以下の点に注意してください：

  • 既存のAmplitudeドキュメントまたはヘルプコンテンツの10～15%を毎月更新してください。
  • 各ページの上部または下部に「最終更新日」という行を含めます。
  • SDK、API、UIコンポーネントが変更された場合にサンプルを更新します。
  • 内部リンクを定期的に確認して、現在のリソースを指していることを確認してください。

イベント名の明確化や最近のユースケースの追加といった小さな編集でも、LLMに最新の情報であることを示すのに役立ちます。

一般的な質問に対するFAQセクションを追加する

LLMは、特にユーザーの表現と一致する場合、質問と回答形式のコンテンツをそのまま表示することがよくあります。

以下を含むFAQセクションを作成しましょう。

  • 「イベントトラッキングを設定する方法は？」など、実装に関する一般的な質問です。
  • 「Amplitude AnalyticsとGoogle Analyticsの違いは？」などの比較クエリ。
  • 「イベントがチャートに表示されないのはなぜ？」などのトラブルシューティングに関する質問。

それぞれの答えは短く（3文以下）、平易な言葉で書かれている必要があります。詳細を説明する関連ドキュメントへのリンクを含めてください。

引用と文脈を通じて信頼性を強化する

モデルは専門知識と信頼性を示すコンテンツを好みます。
リンク、アトリビューション、明確なソース設定を通じてコンテキストを提供してください。

以下の点に注意してください：

  • Amplitudeの公式ドキュメントとAPIリファレンスへのリンク。
  • 可能な場合は、導入事例や成功事例も記載してください。
  • 引用やデータポイントは信頼できるソースのものとして明示してください。
  • 主要なガイドやブログ投稿に著者の名前や役割を記載してください。

透明性の高いソーシングは、LLMが信頼できるコンテンツを特定するのに役立つだけでなく、ユーザーの信頼を高めることにもつながります。

公開時の見つけやすさを確保する

AIエージェントの回答にあなたのコンテンツを含めてもらいたい場合は、それらのエージェントがそのコンテンツにアクセスできる必要があります。

以下の点に注意してください：

  • robots.txtファイルで、主要なAIクローラーが公開ドキュメントをインデックス化できるように許可されていることを確認してください。
  • 公開されているAmplitudeコンテンツが認証やレート制限によってブロックされないようにしてください。
  • クローラーがコンテンツを読み取ることを妨げるような動的なテキスト読み込みを避けてください（たとえば、JavaScriptの実行後にのみキーテキストをレンダリングするなど）。

機密情報や内部情報は機密に保ちます。外部者にアクセスを許可する場合にのみ、ドキュメントを公開するようにしてください。

倫理的かつ責任ある表現を維持する

LLMの可視化は、決して正確性、公平性、プライバシーを犠牲にすることによって達成されるべきではありません。

以下の点に注意してください：

  • 記述内容は事実に基づいたもので中立的で最新のものであることを維持してください。
  • 競合他社やパフォーマンスに関する憶測的な主張は避けてください。
  • 隠れたキーワードや操作的な表現を使用しないでください。
  • すべての例において、データガバナンスとコンプライアンス基準を遵守してください。

責任ある透明性の高いコンテンツにより、人とAIシステムの両方がAmplitudeを正確に表現できます。

これは役に立ちましたか？