Q1. はじめ方・使い方を教えてください

AI検索対策くんは、Shopify 管理画面内のアプリとして動きます。最初に簡単な設定ウィザード（5ステップ）を終えると初回診断が自動で実行され、ダッシュボードに結果が表示されます。

ダッシュボードでは、AIに届くまでの道のりを「届く→信頼される→理解される→選ばれる→買える」の5つの関門に分けて、いま優先して直すべき1か所（ボトルネック）を強調します。「改善アクション」で具体的な手順、「商品」で商品別の詳細をご確認ください。

Q2. 診断が失敗した場合はどうすればよいですか?

診断が失敗した場合は、ダッシュボードに表示されるエラー内容をご確認のうえ、もう一度「診断を開始」をお試しください。

調査いたしますので、発生した画面・ストア名・（可能であれば）エラー表示の内容をお知らせください。アクセストークン・Client secret・個人情報は送らないでください。

Q3. 関門が「未測定」と表示されるのはなぜですか?

「未測定」は、その項目を確認できなかったことを正直に表示するものです（合格扱いにはしません）。よくある原因は、ストアがパスワード保護中の場合です。公開ストアフロントを読み取れないため、robots.txt・トップページ等の関門が「未測定」になります。

ストアを公開すると測定できるようになります。公開後に再度診断をお試しください。

Q4. スコアはどのように見ればよいですか?

スコアは参考指標です。主な道しるべは上部の「5つの関門」で、スコアは取り組みの推移を見るための補助としてお使いください。

「商品」で商品を選ぶと、カテゴリ別スコア・採点理由・改善アクションを確認できます。診断は、AIや検索面に商品情報が伝わりやすいか（識別・推薦文脈・バリエーション・在庫や価格・信頼根拠・構造化データの整合など）を、読み取り専用データでルールに基づいて評価しています（外部AIには送信していません）。

Q5. ChatGPTなどに必ず推薦されますか?

AI検索対策くんは、商品やストアがAIに発見・比較・推薦されやすい状態かを診断し、不足を改善アクションとして提示します。外部のAIで必ず表示・推薦されることを保証するものではありません（表示可否は各AIの仕様や外部要因に左右されます）。

できることは「AIに伝わりやすい土台を整える準備」です。改善後は再診断で、直した内容が反映されたかをご確認いただけます。

Q6. 自動再診断はいつ実行されますか?

自動再診断は設定でオンにした場合のみ動作します（既定はオフ＝手動）。オンにすると、初回診断のおよそ3日後と7日後に（リリース当初はこの2回）、操作なしで再診断が実行され、「直したことが直ったか」の検証と履歴が自動で更新されます。設定からいつでもオフにできます。

Q7. データはどのように扱われ、解約後に削除されますか?

本アプリは読み取り専用で、購入者（お客様の顧客）の個人情報や注文データは取得・保存しません。診断のために商品情報や判定結果を保存しますが、ポリシー本文やページのHTMLなどの生データは保存せず判定後に破棄します。

アプリをアンインストールすると、当該ストアのデータは削除されます。詳しくはプライバシーポリシー（https://marketdive.net/AgentSync_PrivacyPolicy）をご覧ください。

Q8. すべての商品が診断されないのはなぜですか?

診断は、最近更新された商品を対象とした標本で行います（既定50件・最大250件。設定で変更できます）。商品一覧は、改善の優先度が分かりやすいよう、スコアが低い順に表示しています。画面にも対象件数を表示しています。

対象を増やしたい場合は、設定の「診断対象数」をご調整ください。

Q9. 「AIからの見え方」「効果の観測」とは何ですか?

これらは参考情報で、スコアや関門の判定には影響しません。

• 「AIからの見え方（参考）」: ストア自身のエージェント向けカタログ（UCP）への応答を外部から確認した記録です。
• 「効果の観測（参考）」: Google向けフィード適格性の自己チェック値や、改善前後の推移を観測値として表示するものです（効果や因果を保証するものではありません）。

改善の前後を見比べる参考としてお使いください。

Q10. 商材タイプやアドバイスは変更できますか?

設定（または初回ウィザード）で「商材タイプ（購買決定タイプ）」と「商品ジャンル」を選べます。これに合わせて、診断のアドバイスや、テンプレートで重視する観点が切り替わります（例: コレクション型のストアにはバーコード/GTINの不足を指摘しません）。なお、採点の基準そのものは商材タイプで変わりません。

Q11. 表示言語は切り替えられますか?

表示言語は、設定の「言語」から日本語・英語を切り替えられます。診断結果・改善手順・テンプレートも切り替わります。

Q12. ほしい機能がない場合や、自動修正を希望する場合は?

初期版は読み取り専用の診断に特化しており、商品やテーマを自動で書き換えることはありません。改善は、アプリが示す手順と「Shopifyで編集」リンクから、お客様ご自身で行っていただく形です。

なお、「AIからの見え方（UCP）」や「外部AIでの言及の記録」は参考表示として実装済みです（スコアには影響しません）。ご要望は今後の改善の参考にいたしますので、ぜひ具体的にお聞かせください。

Q1. How do I get started?

AgentSync runs inside your Shopify admin. After a short 5-step setup wizard, your first diagnosis runs automatically and results appear on the dashboard.

The dashboard maps the path to AI recommendation as five gates — Reachable, Trusted, Understood, Matched, Purchasable — and highlights the one bottleneck to fix first. Use Actions for step-by-step fixes and Products for per-product detail.

Q2. What should I do if a diagnosis fails?

If a diagnosis fails, check the error shown on the dashboard and try "Start diagnosis" again.

We’ll take a look — please share the screen, store name, and the visible error text if possible. Do not send access tokens, Client secrets, or personal data.

Q3. Why does a gate show "Not measured"?

"Not measured" honestly indicates we couldn’t check that item (we never count it as passed). The most common cause is a password-protected store: we can’t read the public storefront, so gates like robots.txt and the homepage show as not measured.

Once your store is public, please run the diagnosis again.

Q4. How should I read the score?

The score is a reference indicator. The main guide is the five gates at the top; use the score to watch your progress over time.

Open Products and select a product to see category scores, the reasons, and recommended actions. The diagnosis uses read-only data and rule-based checks (nothing is sent to external AI) to evaluate how clearly your product information comes across to AI and search.

Q5. Will my products definitely be recommended by ChatGPT or other AI services?

AgentSync diagnoses whether your products and store are set up to be discovered, compared, and recommended by AI, and turns gaps into improvement actions. It does not guarantee that any external AI will show or recommend your products (that depends on each AI’s behavior and outside factors).

What it does is help you prepare a foundation that’s easier for AI to read. After you make changes, a re-scan confirms they took effect.

Q6. When does automatic re-diagnosis run?

Automatic re-diagnosis runs only if you turn it on (off by default). When on, it re-scans about 3 and 7 days after your first diagnosis (these two follow-ups at launch), updating verification and history with no action from you. You can turn it off anytime in Settings.

Q7. How is data handled, and is it deleted after uninstall?

The app is read-only and does not access or store any shopper (customer) personal data or order data. It stores product information and assessment results for the diagnosis, but does not store raw data such as policy text or page HTML (it’s discarded after assessment).

When you uninstall, your store’s data is deleted. See our privacy policy (https://marketdive.net/AgentSync_PrivacyPolicy — URL to be published) for details.

Q8. Why were not all products diagnosed?

The diagnosis runs on a sample of your most recently updated products (50 by default, up to 250 — adjustable in Settings). The product list is shown lowest-scoring first so priorities are clear, and the screen shows how many were covered.

To cover more, adjust "Diagnosis scope" in Settings.

Q9. What are "AI visibility" and "Observed outcomes"?

These are reference information and do not affect your scores or gates.

• "How AI sees your store (reference)": a record of probing your store’s own agent-facing catalog (UCP) from the outside.
• "Observed outcomes (reference)": a self-check of Google feed eligibility and trends before/after changes (not a guarantee of effect or causation).

Use them as a reference to compare before and after.

Q10. Can I change merchandise type or advice?

In Settings (or the setup wizard) you can choose your "merchandise type (buying-decision type)" and "product genre." Advice and the emphasis in the templates adapt accordingly (for example, collectibles stores aren’t nagged about missing barcodes/GTINs). Note that the scoring criteria themselves don’t change by merchandise type.

Q11. Can I switch the display language?

You can switch between English and Japanese under Settings → Language. Diagnosis results, fix steps, and templates switch too.

Q12. What if a feature is missing, or I want automatic fixes?

The initial version focuses on read-only diagnosis and never edits your products or theme. Improvements are made by you, using the app’s step-by-step instructions and the "Edit in Shopify" links.

Note that "How AI sees your store (UCP)" and "external AI mention records" are already available as reference views (they don’t affect scores). We’d love to hear your request in detail to inform future improvements.