組織とセットアップ
レポート
Answer Engine Insights のレポートエンドポイントは、category_id でスコープされる POST
リクエストで、{info, data} 形式を返します。Visibility、citations、
sentiment、query-fanouts のレポートは、category_id、start_date、
end_date、metrics に加えて、レポート固有の任意フィールドを受け付けます。
トラフィックレポートは異なる形式を使用します。bots と referrals は category_id ではなく
domain でスコープされます。V2 FactCheck レポートと V2 プロンプト
回答はカテゴリと日付でスコープされますが、metrics フィールドは受け付けません。
/v1/reports/visibility
AI の回答にアセットがどのくらいの頻度で登場するか。
一般的なレシピ: Visibility Score(差分付き)、
推移、
リーダーボード、
競合との比較、
モデル/地域/ペルソナ別のセグメント化。
/v1/reports/citations
AI の回答がどの URL とドメインを引用しているか。
一般的なレシピ: Citation Share と差分、
シェアと引用量の推移、
ドメイン別ランク。
citation_share は AI モデルごとの平均値です。count は生の数値です。
一方で並べ替えても、もう一方の順序とは一致しません。答えたい問いを
決めて、それに対応するメトリクスで並べ替えてください。/v1/reports/sentiment
AI の回答がアセットをどの程度ポジティブ/ネガティブに言及しているか。
/v1/reports/query-fanouts
クエリファンアウトのビュー(プロンプトが AI サーフェス全体にどのように波及するか)。同じ
{info, data} 形式です。
/v1/reports/referrals(および /v2/reports/referrals)
AI の回答に起因する、自社ドメインへの人間による参照トラフィック。
/v1/reports/bots(および /v2/reports/bots)
自社ドメインへの AI クローラー / ボットのトラフィック。
/v2/reports/factcheck と /v2/reports/factcheck/claims
カテゴリの FactCheck スコアと不正確な主張。これらのエンドポイントは
category_id、start_date、end_date を受け付けますが、metrics は受け付けません。
V2 レポートエンドポイント
POST /v2/reports/visibility、/v2/reports/citations、
/v2/reports/sentiment、/v2/reports/query-fanouts は、上記の V1 レポートの V2
版です。包含的な end_date、filter ツリー、各行の名前付きメトリクスフィールド、
カーソルページネーションを備えています。
/v2/reports/shopping/* と /v2/reports/social/youtube/* は V2 のみです。
それぞれに /stream SSE バリアントがあります。
フィルタリングと概念 をご覧ください。
Answers(プロンプトごとのデータ)
Agents
Prompts
Content Optimization(ベータ)
正式なパラメータリファレンス(すべての演算子、すべてのフィールド、 必須か任意か)については、REST API タブをご覧ください。