ハウツーガイド：構造、手順、スキーマ

ハウツーガイドとは、読者を既知の開始状態から検証済みの結果へ導く順序立てられた手順です。「このタスクを完了するにはどうすればよいか？」という問いに答え、読者が不足しているステップを自分で考え出す必要をなくします。

すべてのステップには、命令形のタイトル、その理由、アクション、観察可能な成功状態、および回復経路が必要です。クリックのみの指示は、読者のアカウント、アクセス権、データ、インターフェースがたまたま作成者の想定と一致する場合にのみ機能します。

読者の疑問を解決します：「何が必要か、何を順番に行うか、うまくいったかどうかをどう確認するか、うまくいかなかった場合にどう回復するか。」

これが答える質問

ハウツーガイドは情報意図 に応えるもので、読者が製品リストを評価するのではなく、タスクを学習または完了しようとしていることを意味します。クエリは多くの場合「方法（how to）」で始まりますが、文言だけでは十分ではありません。意図された結果は、読者が実行して確認できるものでなければなりません。

人々が実際に手順に持ち込む質問に合わせて執筆してください：

• 「必要なプラン、アクセス権、ツール、時間は十分か？」
• 「どのアクションを順番に実行する必要があり、各アクションの後に何が表示されるべきか？」
• 「これによって上書き、公開、課金、削除、または公開されるものはあるか？」
• 「異なる結果からどのように回復し、タスク全体が機能したことを確認するか？」

直接的な回答は、最初の長い説明の前に、結果、開始条件、予想時間、難易度を述べるべきです。「約20分で、アカウント管理者がSearch Consoleを接続し、最初の成功したインポートを確認できます」は有用です。「このガイドでは統合のベストプラクティスを探求します」はそうではありません。

この投稿タイプを使用するタイミング

手順は前提条件の境界で失敗します。作成者はどのアクセス、遅延、設定が重要かを知っていますが、読者は知りません。このフォーマットは、隠れた依存関係、状態の変化、回復の判断を順番に可視化します。

順序が重要な場合にのみハウツーを選択してください。独立したチェックを任意の順序で実行できる場合は、チェックリストを公開してください。トピックが複数の異なる目標を含むほど広範囲である場合は、アルティメットガイド をマップとして使用し、個別のハウツーガイドを手順ごとに作成してください。読者が主にコンセプトの意味を尋ねる場合は、what-is-Xページ を使用してください。

これらのビジネスタイプに最適

ランキングは、モデルが読者による反復可能なプロセスの完了にどれだけ依存するかを反映しており、ビジネスにとってのコンテンツの全体的な価値を示すものではありません。

1. SaaS 。 セットアップ、設定、移行、および定期的なワークフローは、ユーザーが価値に到達できるかどうかを決定します。プランの制限、ロール、インターフェースの状態、および破壊的な変更を区別します。
2. Eコマース 。 購入者には、組み立て、サイズ選び、設置、使用、およびケアの手順が必要です。言葉だけでは安全に伝えられない場合、物理的な向きを図示します。
3. ローカルサービス 。 準備ガイドは、顧客が入力情報を収集し、予約を理解するのに役立ちます。安全な顧客作業と、資格のある専門家に委ねるべき作業を分離します。
4. マーケットプレイス 。 売り手、買い手、プロバイダー、管理者は異なるワークフローに従う場合があります。前提条件の前に、対象者とロールを明記します。
5. B2Bサービス 。 オンボーディング、承認、引き継ぎ、レビューガイドは、所有権を明確にし、完了した作業の姿を示します。
6. メディアパブリッシャーとアフィリエイト 。 専門家のチュートリアルはタスク主導の需要に応えることができますが、パブリッシャーは手順をテストし、ベンダーのドキュメントを書き直すのではなくキャプチャを維持する必要があります。

検索意図

検索意図 とは、人がクエリから期待する結果です。手続き的意図の場合、期待される回答の形状は、即時の実現可能性チェックに続いて実行可能なルート（結果、時間、難易度、前提条件、順序付けられたアクション、検証、トラブルシューティング、次のステップ）です。

タスク結果は、動画、ステップの抜粋、製品ドキュメント、コミュニティの回答、チュートリアルを混在させることができます。AI回答は、多くの場合、ルートをソース付きの番号付きシーケンスに圧縮します。抽出された各ステップは、その対象、条件、期待される結果を保持する必要があります。警告はリスクの高いアクションの前に配置する必要があります。

両方の例を同じ日にキャプチャし、クエリ、場所、デバイス、ログイン状態、インターフェースを記録します。結果は変化します。デザインの教訓は、特定のプロバイダーが常に特定の機能を表示するという主張ではなく、回答の形状から得られるべきです。

ページ構造

ワード範囲は強調を制御するものであり、割り当て量ではありません。読者が単独で行わなければならない判断を排除する場合にのみ、言葉を追加してください。

必須要素

ステップリスト が手順の契約を担います。前提条件はその開始状態を保護し、クロージングチェックは約束された結果を証明します。どちらも専用の要素ページを持たないため、発明された要素ではなく、名前付きの構造セクションとして残ります。

スクリーンショットが必須の場合

テキストだけでは正しいコントロール、場所、状態、向き、結果を確実に識別できない場合、スクリーンショットは必須です。類似したコントロール、隠れた設定、ラベルのない視覚状態、または混同される可能性のある物理的な部品に使用します。判断領域にトリミングし、向きのコンテキストを保持し、対象をマークし、テキストで説明します。

「保存を選択」を繰り返したり、1つの明白なコントロールのために画面全体を表示したり、テキストを置き換えたりする場合、スクリーンショットはノイズになります。コマンド、警告、値、成功基準の唯一の情報源として画像を使用しないでください。

フロントマター

フロントマター は、可視ページと同様に正確に手順を記述する必要があります。

スキーママークアップ は、可視コンテンツに関する機械可読データです。実装が忠実である場合にのみ、HowToをJSON-LD として公開してください。前提条件をステップとしてマークしたり、可視のステップをマージしたり、隠し指示を追加したり、間違った画像を添付したりしないでください。正確な対応関係を維持できない場合は、Articleを使用してください。

完全な例

このコピーペースト可能なスケルトンは、実際のタスクを使用しています。括弧内の制作プロンプトは、ライターが挿入すべきエビデンスを指定します。

# Google Search ConsoleをNorthstar Analyticsに接続する方法

確認済みのSearch ConsoleプロパティをNorthstar Analyticsに接続し、最初のクエリレポートをインポートできるようにします。アカウント管理者は約15分でセットアップを完了できます。インポートには最大30分追加でかかる場合があります。難易度：初心者。

## 開始する前に

- AdministratorロールのNorthstar Analyticsアカウント
- 接続するSearch Consoleプロパティの所有者アクセス権
- サイトの正規ホストと一致する正確なHTTPSプロパティ
- Search ConsoleのパフォーマンスデータをNorthstar Analyticsと共有する許可

テストプロパティや異なるホストでは続行しないでください。接続は技術的に成功しても、間違ったサイトのデータをインポートする可能性があります。

## クイック概要

サイトを選択し、アクセスを承認し、一致するプロパティを選択し、インポートを開始し、日付入りのクエリ行がNorthstar Analyticsに表示されることを確認します。

## 1. サイトとプロパティの一致を確認する

**このステップの目的：** Search Consoleには、類似した名前のドメインプロパティとURLプレフィックスプロパティが含まれる場合があります。間違ったものを選択すると、無関係または不完全なデータでの有効な接続が生成されます。

**実行すること：** Northstar Analyticsでサイトの設定ページを開き、その正規ホストをコピーします。Search Consoleで、目的のプロパティにそのホストとプロトコルが含まれていることを確認します。

**うまくいった場合：** 両方の製品に表示されるホストが、`www`とHTTPSを含めて完全に一致します。

**うまくいかなかった場合：** プロパティ所有者に、どのプロパティが本番環境を表しているかを確認してください。表示名から推測しないでください。

## 2. Search Console接続を開始する

**このステップの目的：** 選択したサイトから開始することで、承認が正しいNorthstar Analyticsワークスペースにバインドされます。

**実行すること：** **設定 → 統合 → Google Search Console** を開き、**接続** を選択します。

**うまくいった場合：** Googleの承認ウィンドウにNorthstar Analyticsの名前が表示され、アカウントの選択を求められます。

**うまくいかなかった場合：** ポップアップを許可して再試行してください。接続が無効になっている場合は、Administratorロールを確認してください。

[「接続」が他のコントロールと区別しにくい場合にのみ、統合パネルのトリミングされた注釈付きキャプチャを挿入します。]

## 3. 正しいGoogleアカウントを承認する

**このステップの目的：** Northstarは、承認されたGoogleアカウントがアクセスできるプロパティのみをリストできます。

**実行すること：** 目的のプロパティを所有するGoogleアカウントを選択し、要求されたアクセスを確認し、承認します。

**うまくいった場合：** Northstar Analyticsに戻り、プロパティセレクターが表示されます。

**うまくいかなかった場合：** プライベートウィンドウを使用して、プロパティ所有者アカウントで承認を再実行してください。

## 4. 本番プロパティを選択する

**このステップの目的：** 承認はアカウントアクセスを証明しますが、選択したプロパティがどのデータがインポートされるかを決定します。

**実行すること：** ステップ1の正規ホストと正確に一致したプロパティを選択し、**保存してインポート** を選択します。

**うまくいった場合：** 統合ステータスが **インポートキュー済み** に変わり、選択したプロパティが表示されます。

**うまくいかなかった場合：** 承認されたアカウントでステップ3に戻ります。プロパティが似ている場合は、完全な識別子を比較してください。

## 5. 最初のインポートを確認する

**このステップの目的：** 接続済みバッジは承認を証明しますが、使用可能なデータがレポートに到達したことを証明するものではありません。

**実行すること：** 表示された待機期間の後、**レポート → 検索クエリ** を開き、Search Consoleデータがある期間に日付範囲を設定します。

**うまくいった場合：** 選択したプロパティからのクエリ、ランディングページ、日付、クリック数、またはインプレッションを示す行が少なくとも1つ表示されます。

**うまくいかなかった場合：** **インポートキュー済み** の場合は、待機して再試行してください。**権限の有効期限切れ** の場合は、再接続してください。**データなし** の場合は、日付範囲とソースプロパティを確認してください。

## 完了チェックリスト

- 統合が目的の本番プロパティを指定している。
- ステータスが単なるキュー済みではなく接続済みである。
- クエリレポートにそのプロパティからの日付入りの行が含まれている。
- 別の管理者がどのアカウントが接続を所有しているかを識別できる。

## トラブルシューティング

### プロパティセレクターが空

承認されたGoogleアカウントにアクセス権がないか、アクセス権が削除されました。プロパティ所有者で再承認し、セレクターをリロードしてください。

### 接続は成功するがレポートが空

レポートの日付範囲をSearch Consoleと比較し、切断する前に正確なプロパティ識別子を確認してください。

### インポートが繰り返しキュー済みに戻る

サイト、プロパティ識別子、開始時間、最新のステータスを記録し、サポートに連絡してください。これらの詳細により、サポートは承認を繰り返し求めることなくインポートを調査できます。

## FAQ
[権限、データ遅延、プロパティタイプ、再接続、削除に関する5～7の残りの質問を追加します。ステップを繰り返さないでください。]

## 次のステップ
[インポートされたデータを使用する1つのアクション（最初のクエリ機会レポートの確認など）を提供します。]

デザイン例

すべてのギャラリーバリエーションは、同じ前提条件、5つのステップ、成功状態、回復テキスト、トラブルシューティング、完了チェックを示す必要があります。

品質チェックリスト

レビュー担当者が作成者なしでクリーンな開始状態からガイドを完了できる場合にのみ、ガイドは公開可能です。

• ヒーローが1つのテスト可能な結果、対象読者、予想アクティブ時間、待機時間、難易度を述べている。
• 前提条件が、後のステップをブロックする可能性のあるロール、アクセス、バージョン、ツール、入力、料金、安全条件を明記している。
• すべてのステップが命令形のタイトルで始まり、理由、アクション、成功、回復を説明している。
• 順序がテストされている。ステップを移動すると結果が変わる、ブロックされる、または無効になる。
• 警告はリスクの前に表示され、オプションのヒントが必須作業を隠すことはない。
• スクリーンショットは実際の曖昧さを解決し、最新のインターフェースコンテキストとアクセシブルな説明があり、指示の唯一の情報源ではない。
• 最終チェックは、最後のクリックではなく、約束された結果を検証する。
• トラブルシューティングは、観察された、または確実に再現可能な障害を、具体的な次のアクションとともにカバーしている。
• HowToデータはすべての可視ステップとプロパティに正確に一致するか、ページは代わりにArticleを使用している。
• 2人目のテスターが、サポート対象のアカウント、デバイス、ロール、バージョンでガイドを完了している。

よくある間違い

最も一般的な失敗はクリックの書き起こしです：「設定を開く。統合をクリック。接続をクリック。」これでは、プロパティが重要な理由、何が表示されるべきか、不足している権限からどう回復するかが省かれています。

他の失敗も同様に具体的です：

• 前提条件をステップ内に隠す。 ステップ4で管理者アクセスに1日かかることが判明すると、読者の時間を浪費し、部分的な作業が放置される可能性があります。
• 警告をアクションの後に置く。 削除指示の下にある削除警告は、削除を防ぐことができません。
• 経過時間を作業時間として使用する。 「40分かかる」は、作業が10分＋30分のインポートの場合に誤解を招きます。両方を明記してください。
• 作成者のアカウントのみでテストする。 管理者は一般メンバーには見えないコントロールをよく見ることができます。ヒーローで指定されたロールでテストしてください。
• 最後のクリックを成功とみなす。 「保存されました」は、リクエストが受け付けられたことのみを意味する場合があります。下流の状態または出力を確認してください。
• スキーマのずれを放置する。 HowToデータを更新せずに可視ステップの名前を変更、並べ替え、またはマージすると、1つのURLに2つの互換性のない手順が作成されます。

内部リンク

ハウツーガイドは、リンク先が前提条件を説明する場合、意思決定をサポートする場合、または次の手順を提供する場合にのみ、外部にリンクします。専門用語は、シーケンスの前または初出時に定義してください。

他のページは、正確なタスクを指定する場合にガイドにリンクする必要がありますが、そのステップを複製してはいけません。プロダクトページ は機能からセットアップにリンクできます。アルティメットガイドは広いフェーズから関連する手順にリンクできます。トラブルシューティング記事は、症状が解決された後、ガイドの開始状態にリンクバックできます。

「選び方」の意思決定ガイド、症状主導のトラブルシューティング経路、または一般的なドキュメントを複製しないでください。兄弟ページが同じシーケンスの短い要約以上を必要とする場合は、1つの正規の手順を確立し、それにリンクしてください。メインルートが共有されている場合は、バージョン固有のバリエーションを1つのページに保持し、ステップまたは前提条件が実質的に異なる場合にのみ分割してください。

結果の測定方法

測定はガイドの約束に従います：手順が意図されたタスクに対して見つけられたか、有用なソースとして選択されたか、フォローされたか、意味のある次の状態に接続されたか。AIランクトラッキング を使用して繰り返し発生する目標に沿ったプロンプトを監視し、次にプロンプトトラッキング で回答の文言、引用URL、エンジン、競合ソースを調査します。実用的なディープリンクはプロンプトトラッキングを開く です。

プロンプトセットと公開前のベースラインを記録します。引用をブランドメンションとは別に追跡します。サイト上では、最終チェックへの到達、次のステップCTAの選択、関連する製品イベントの完了、またはサポート需要の減少などの完了エビデンスを使用します。それぞれがエビデンスであり、証明ではありません。スクロール深度は手順が機能したことを示すことはできません。

FAQ

よくある質問

ガイドを本番環境に投入する

代表的な読者で手順をテストし、CTAブロック を使用して、検証済みの完了から自然に続く1つのアクションを提供してください。