CitadexDocs

トラブルシューティング:よくあるメッセージと対処

Citadex で表示される実際のメッセージをページ別にまとめ、それぞれの対処を示します:スキャン、クレジットと上限、新しい機能、生成、公開、連携、データの接続、サインイン。

Troubleshooting6 min read

スキャンとプロンプト追跡

  • 「チェックがタイムアウトしました」:エンジンが混雑しています。1 分後に根拠を開いて「今すぐスキャン」。
  • 「前回のチェックが中断 · n / m 完了」:チェック中にページを閉じました。「続ける」で中断箇所から再開します。
  • 「毎日スキャンの上限に達しました」:毎日頻度のプロンプトが多すぎます。他を毎週か毎月に変更してください。
  • 行が「チェック中…」のまま:キューが順に処理しています。再読み込みしなくても結果が表示されます。
  • プロンプトの言語が市場と合わない:バナーの「一致する市場へ移動」で正しい言語でスキャンされるようにします。
  • 中国市場のプロンプトに「Business 限定」と表示される:中国市場は Doubao・DeepSeek・Qwen・Kimi でのみスキャンし、プロには含まれません。ビジネスにアップグレードするまでスキャンされず、海外市場には影響しません。
  • エンジンに鍵マーク:ご利用のプランに含まれていません。
  • カバー率が急に下がった:まずダッシュボードの「AI プラットフォーム全体の変化」や、根拠のカバー率の推移のマーカーを確認します。同じ日にそのエンジンで全プロジェクトが変化していれば、原因はたいていプラットフォームで、ブランドではありません。

クレジットと上限

  • 「クレジット不足」:表示されたダイアログでそのままチャージするか、「API キーとクレジット」→「クレジット」でチャージ、または自動チャージを ON に。無料プランは先にアップグレードが必要です。
  • 「クレジットが足りないためプロンプトを追加できません」:残高が新しいプロンプトの初回チェック分に足りません。ダイアログでチャージしてから追加し直すか、件数を減らしてください。
  • 「プロジェクト上限に達しました」:使っていないプロジェクトを削除するかアップグレード。承認された代理店にはプロジェクト数の上限はありません。
  • 「複数回サンプリングは最大 n 件の質問まで」:先に他の質問の複数回サンプリングをオフにしてください。

新しい機能

  • 「この機能は準備中です」(ブランド情報チェック、エージェント、増分実験):あなたのアカウントで機能を有効化しているところです。しばらくして再読み込みしてください。1 日たっても変わらなければサポートにご連絡ください。プロンプトライブラリで「トピックと顧客の役割は準備中です」と出る場合も、質問の種類・購買段階・需要の裏づけはすでに使えます。トピックと顧客の役割はしばらくして再読み込みしてください。
  • 実験が「データ不足」:実験群か対照群で、開始前か開始後の件数(指標により注文・リード・訪問)が 10 件未満です。データがたまるのを待つか、比較日数を延ばすか、グループにページを増やしてください。
  • エージェントタスクのシミュレーションが「ステップ n:…」で失敗:エージェントがそのステップで先に進めなかったことを示し、続く文字はそれを妨げたページ要素です。エージェントは JavaScript を実行せず、ログインもフォーム送信もしないため、スクリプトだけで表示される価格、ログインが必要な情報、ポップアップ内のリンクがあるとタスクを完了できません。重要な情報をページの HTML に入れてから「実行」するか、月曜の自動実行を待ってください。
  • エージェント タブに「有料プランで利用できます」:継続監視とシミュレーションには有料プランが必要です。単発のチェックは無料の /agent-readiness を使ってください。
  • ブランド情報チェックで電話番号や URL のチェック結果が出ない:まず自動化 → ブランド情報チェックの「公式情報」に公式ドメイン、サポート電話番号、価格を入力してください。チェックはこれと照合します。

生成

  • 「ビジネス情報が未入力」:生産ルールで入力してください。入力しないとパイプラインは始まりません。
  • 「このプロジェクトはすでに記事を生成中」:深掘りはプロジェクトごとに同時 1 本です。完了を待つか、ダイアログでキャンセルします。
  • 「深掘りには 3〜15 件のプロンプトが必要」:プロンプトを増やす(または減らす)。
  • 「レート制限」「AI サービスが過負荷」「タイムアウト」:1 分待って再試行。タイムアウトならテーマを短くします。

公開と連携

  • 「未接続 · 公開は失敗します」:連携ページでそのプラットフォームを接続します。完了後はリンクで記事に戻れます。
  • 「処理中」のまま:拡張プラットフォームは開いたタブで公開ボタンを押してください。自社チャネルは再読み込みしてエラーを確認します。
  • あるプラットフォームで「1 日の上限に達しました」:そのプラットフォームの今日の枠を使い切りました。明日公開するか別のチャネルへ。
  • 拡張が検出されない / 古い:Citadex Publisher(Chrome または Edge)をインストールまたは更新。日本のプラットフォームは 1.2.6、Ameblo は 1.3.0 以上が必要です。
  • GitHub「redirect_uri mismatch」:GitHub OAuth アプリに登録したコールバック URL とサイトの URL が一致していません(www の有無が多い)。Citadex ではなく OAuth アプリを修正してください。
  • ホスト型ブログ「ドメインエラー」:DNS レコードが不足または誤っています。ホスト型ブログのダイアログに表示されたレコードと照合し、「状態を確認」を押します。
  • 「テスト失敗:…」:認証情報、権限、サイト URL(末尾スラッシュなし)を確認します。

データの接続と収益アトリビューション

  • AI トラフィックが空のまま:まだデータが接続されていません。「連携」で方法を選ぶか(「おすすめ」にサイトに合ったものが並びます)、AI トラフィックの「データ元」の行のラベルを押してください。Cloudflare の直接接続は 1 時間ごとに同期します。
  • 「ワークスペースのオーナーのみ接続できます」:Google Analytics はオーナーだけが連携できます。
  • 売上は入るのに AI に紐づかない:まずサイトスクリプトを設置し、フォームのメール自動取得を ON にしてください。収益ソースはメールアドレスで訪問者と照合されます。収益アトリビューション をご覧ください。
  • 欧州からの AI 流入が件数だけで、訪問者やコンバージョンが出ない:サイトスクリプトは訪問者の同意に従います。サイトにある同意設定(Shopify のカスタマープライバシー、WordPress の同意プラグイン、Google 同意モード、Global Privacy Control)を読み取り、同意がない場合は Cookie を書かず、メールも取得せず、AI 流入を匿名で 1 件数えるだけです。同意設定がないサイトでは、欧州のタイムゾーンの訪問者を「未同意」として扱います。訪問者が同意すると、そのページから通常の計測に切り替わります。すべての地域で同意を必須にする場合はスクリプト URL に &consent=required、同意後にのみスクリプトを読み込むサイトでは &consent=off を付けます。

サインイン

  • Google サインインが反応しない:アプリ内ブラウザ(LINE、Instagram、TikTok)にいます。Chrome か Safari で開いてください。
  • 毎回新規プロジェクトに戻される:他のページを開くには、まずプロジェクトが 1 つ必要です。

それでも解決しないとき

「AI アシスタント」に状況を説明するか、サイドバー下のアカウントメニューの「サポートに連絡」(スクリーンショットを添付できます)から、プロジェクト名と期待した動作を書いて送ってください。

Was this article helpful?