記事に埋め込む診断ツールの作り方|AntigravityでHTMLを生成して公開する手順

記事に診断ツールを入れたいとき、最初から外注やエンジニア依頼を前提にしなくても、AntigravityでHTMLを作成してカスタムHTMLへ貼り付ける方法なら小さく始められます
さらに、事例によっては「診断というインタラクティブなCTAに置き換えることでCVRが5倍になる」こともあります

AIzen株式会社は、CV導線を意識した記事設計や業務アプリ開発を支援する中で、診断ツールは「設問設計」と「公開後の改善」が成果を分けると考えています。

結論として、診断ツール付き記事を作る近道は、先に設問数・分岐・結果パターンを決め、Antigravityには1ファイル完結のHTMLとして具体的に生成させ、WordPressやWixのカスタムHTML枠で動作確認してから公開することです。

目次

記事に埋め込む診断ツールの構成を先に整理する

診断ツールがうまくいかない原因の多くは、コードではなく設計不足です。最初に設問と結果の関係を整理しておくと、Antigravityへの依頼も安定します。

設問数・回答分岐・結果パターンを決める

最初に決めるのは、何問出すか、各回答でどこへ分岐するか、最終的に何パターンの結果を返すかです。設問が多すぎると離脱しやすく、少なすぎると診断結果が似通うため、5〜7問前後から始めると調整しやすいです。

診断結果ごとのCTAと遷移先ページを整理する

診断ツールは結果表示がゴールではありません。結果ごとに問い合わせ、資料請求、関連サービス紹介、関連記事誘導など、次の行動を1つ決めておくとCV導線として機能しやすくなります。結果Aでは相談、結果Bでは資料、結果Cでは別記事のように役割を分けると、読者の温度感に合わせた導線を作りやすくなります。

記事内での表示位置と見せ方を決める

表示位置は、読者の関心が高まる本文中盤か、導入直後のどちらかに絞るのが基本です。記事冒頭に置くなら設問数は少なめ、中盤に置くなら結果後に本文を読み進める導線まで考えておくと自然です。診断ツールだけが浮かないように、前後の本文見出しとも役割をそろえておくと読みやすくなります。

最初に決める項目目安理由
設問数5〜7問前後離脱しにくく調整しやすい
結果パターン3〜5種類CTAを分けやすい
CTA1結果につき1つ読者が迷いにくい

Antigravityで診断ツールのHTMLを生成する手順

ここではコードを書くのではなく、AIに必要な材料を渡して作ってもらう考え方が重要です。依頼内容が具体的なほど、初回の出力精度が上がります。

診断ツールの要件を伝えるプロンプトを作る

最初の依頼では、テーマ、対象読者、設問数、結果パターン数、ボタン文言、結果ごとのCTA、スマートフォン表示対応までまとめて渡します。単に「診断ツールを作って」だけでは、目的に合わない見た目や動きになりやすいです。記事に埋め込む用途であること、スクロール量を抑えたいこと、外部ファイルを分けずに完結したいことまで書くと、貼り付け後の調整が減ります。

設問数・分岐条件・結果数を具体的に指定する

たとえば「6問、各設問は2択、回答の組み合わせで4パターンへ分岐、結果画面にはタイトル・説明文・CTAボタンを表示」と書くと、必要な構造が伝わります。途中で仕様が増えるより、最初に箱を決めるほうが修正回数を減らせます。さらに、各設問の表示順と、前へ戻るボタンや再診断ボタンの有無まで書いておくと、操作の抜け漏れが起こりにくくなります。

HTML・CSS・JavaScriptを1ファイルで出力させる

埋め込み先で扱いやすいのは、HTML・CSS・JavaScriptを1ファイルにまとめた形です。WordPressやWixのカスタムHTML枠へそのまま貼り付けやすく、修正時もどこを差し替えるか分かりやすくなります。読み込み先が増えるほど、公開環境で動かない原因も増えるため、初回はシンプルな構成を優先してください。

診断ツールのコード生成で失敗しやすい指示

Antigravityの出力が安定しないときは、ほとんどの場合、AIへの依頼が抽象的すぎます。不足しやすい指定を先に埋めておくことが大切です。

「診断ツールを作って」だけではエラーが出やすい理由

AIは、結果表示の見せ方、設問の進み方、分岐条件、デザインの方向性が見えないと、一般的な形へ寄せて出力します。その結果、意図しないレイアウト崩れや、結果分岐の漏れが起きやすくなります。記事本文のトーンと診断ツールの見た目がズレるのも、この段階の指定不足が原因になりやすいです。

JavaScriptエラーを防ぐために不足しやすい指定項目

不足しやすいのは、設問ID、選択肢数、ボタンの進行順、結果表示条件、再診断ボタンの有無、スマートフォン幅での表示ルールです。ここを明示すると、公開前の手直しが大きく減ります。

修正依頼で追記したい条件の伝え方

修正は「見た目」「設問」「結果」「遷移」の単位で分けて依頼します。たとえば「3問目の文言だけ変更」「結果BのCTA先だけ変更」のように分けると、前の動作を壊さずに直しやすくなります。複数の修正を一度に頼む場合も、優先順位を明記すると、どこを守るべきかがAIへ伝わりやすくなります。

指定しておきたい項目
設問構造6問、各2択、前問回答で次問を分岐
結果画面タイトル、説明文、CTAボタンを表示
画面要件スマートフォンで1列表示、ボタンは大きめ

生成したコードをカスタムHTMLに貼り付ける方法

生成したコードは、埋め込み枠へ貼って終わりではありません。表示、分岐、導線の確認まで含めて作業完了です。必ず手元で試してください。重要です。

カスタムHTMLブロックにコードを貼り付ける

WordPressならカスタムHTMLブロック、WixならHTML埋め込み枠へ貼り付ける進め方が分かりやすいです。貼り付け時は、余計な装飾ブロックを混ぜず、診断ツール部分だけを単体で配置すると崩れにくくなります。本文幅いっぱいに広げるのか、本文内の通常カラムに収めるのかも先に決めると、デザイン調整のやり直しを防げます。

プレビューで確認したい分岐と遷移先の動作

公開前には、すべての回答パターンを最低1回ずつ試し、結果画面とCTA遷移先が合っているか確認します。1パターンだけの確認で終えると、特定分岐だけ表示が崩れていることに気づきにくいです。結果別にスクリーンショットを残しておくと、差し替え後の再確認もしやすくなります。

スマートフォン表示で確認したいレイアウトと操作性

診断ツールはスマートフォン利用が多いため、ボタンの押しやすさ、文字の折り返し、スクロール量を必ず確認します。PCでは問題なくても、スマートフォンで結果画面が縦に長すぎると離脱率が上がりやすくなります。特に選択肢ボタンの高さ、余白、CTAボタンの位置は、片手操作を前提に見直すべきです。

公開前チェック見るポイント
分岐すべての結果パターンが出るか
CTA遷移先が結果内容と合っているか
スマートフォンボタンが押しやすいか、長すぎないか

弊社エンジニアからのコメント:

記事に埋め込む診断ツールは、コード生成そのものよりも、先に設問設計と結果導線を固めておくことが重要です。特に、設問数、分岐条件、結果ごとのCTAが曖昧なままHTMLを生成すると、見た目は動いていても、診断結果と導線がかみ合わず成果につながりにくくなります。

また、Antigravityで生成する場合は、HTML・CSS・JavaScriptを1ファイルにまとめ、カスタムHTMLへ貼り付けやすい形で作ると運用しやすくなります。公開前には全分岐とスマートフォン表示を確認し、公開後は完了率とCTAクリック率を見ながら小さく改善していく進め方が安定しやすいです。

公開後に診断ツールの効果を見直すポイント

公開後は、完成ではなく改善フェーズに入ります。診断完了率とCTAクリック率の2点を見るだけでも、次の修正方針が立てやすくなります。

診断完了率を下げにくい設問数と文言に整える

完了率が低い場合は、設問が長すぎる、質問の意味が分かりづらい、途中で結果が想像できないといった要因を疑います。まずは設問数を減らすより、文言を短くして回答しやすくするのが先です。設問の主語を揃え、専門用語を減らすだけでも回答の進みやすさは変わります。

診断結果ページのCTA文言と導線を見直す

結果画面のCTAが弱いと、診断は完了してもCVに結びつきません。「無料で相談する」「詳しい資料を見る」のように、次の行動がすぐ分かる文言へ調整することが重要です。結果の説明文とCTAの内容がつながっていない場合もクリック率が下がるため、文脈の連続性を見直してください。

離脱しやすい箇所から優先して修正する

途中離脱が多いなら設問部分、結果表示までは進むのにクリックされないならCTA部分を優先して直します。全部を一度に変えるのではなく、1回の修正で1テーマに絞ると改善結果を判断しやすくなります。改善履歴を簡単に残しておくと、どの変更が効いたかを後から振り返りやすくなります。

まとめ

記事に埋め込む診断ツールをAntigravityで作るときの要点は、次の3つです。

  • 先に設問数、分岐、結果パターン、CTAを決めてからAIへ依頼することです。
  • Antigravityには、1ファイル完結のHTMLとして具体的に生成させることです。
  • 公開前に全分岐とスマートフォン表示を確認し、公開後は完了率とCTA導線を見直すことです。

AIzen株式会社では、診断ツール付き記事の設計支援から、CV導線を踏まえた実装整理まで伴走しています。記事からの問い合わせ導線を強化したい場合は、設問設計の段階からご相談ください。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

ITコンサル・SEとして経営層直下での全社横断プロジェクトを多数主導。経営課題を起点としたKPI設計、ROI最適化、プロジェクトガバナンスの構築に精通。単なるシステム導入に留まらず、BIツールを用いた意思決定支援や、属人化を排除するBPR(業務再設計)を通じて、再現性のある事業基盤の構築を得意とする。「経営層のビジョン」を「現場のオペレーション」へと翻訳し、データドリブンな組織変革を支援している。

コメント

コメントする

目次