回答の分析: ブランドの言及、順位、センチメント、出典の種類

payload.include.analysis を true にすると、タスクは回答と一緒に次の情報を返します。回答が挙げたすべてのブランドとその順序、ブランドごとに推薦したかどうかとどのような姿勢で述べたか、自社ブランドと競合が登場したか、各引用元がどの種類のサイトかです。自前のモデルを回答ごとに実行しなくても、言及率、平均順位、センチメント、シェア・オブ・ボイス、出典シェアを計算できます。

リクエスト

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "CHATGPT",
    "payload": {
      "prompt": "best CRM for a small team",
      "country": "US",
      "include": { "analysis": true },
      "brand": "Acme CRM",
      "brandAliases": ["Acme"],
      "brandDomains": ["acme-crm.example"],
      "competitors": ["Northwind", { "name": "Contoso CRM", "aliases": ["Contoso"], "domains": ["contoso-crm.example"] }]
    }
  }'

フィールド	必須	説明
`include.analysis`	はい	`true` で分析を実行します。
`brand`	いいえ	自社ブランド名、200文字まで。URLは不可です。サイトは `brandDomains` に入れてください。
`brandAliases`	いいえ	自社ブランドの別名、最大20件。`brand` と一緒の場合のみ。
`brandDomains`	いいえ	`acme-crm.example` のようなサイト、最大20件。そのサイトやサブドメインへの引用は自社のものとして数えます。`brand` と一緒の場合のみ。
`competitors`	いいえ	競合、最大50件。それぞれ名前、または `{ name, aliases, domains }`(別名最大20件、ドメイン最大20件)。

どの名前も2文字以上、または2文字以上の別名が必要です。brand と competitors がなくても、分析は回答が挙げたすべてのブランドを一覧します。

対応エンジン

CHATGPT、GEMINI、PERPLEXITY、GOOGLE、AIMODE、NAVER_AI_BRIEF、NAVER_AI_TAB(およびそのエイリアス)。followUps 付きの CHATGPT タスクでは、最初の回答を分析します。

クレジット

分析はエンジンの料金に加えてタスクあたり 1クレジット です。タスクは送信時にこれを確保し、analysis.status が ok のときだけ請求します。クレジットと制限を参照してください。

レスポンス

タスクの response に analysis オブジェクトが加わります。例:

{
  "analysis": {
    "version": 1,
    "status": "ok",
    "brands": [
      { "name": "Northwind", "domain": null, "writtenAs": "Northwind", "spellings": ["Northwind"], "rank": 1, "role": "competitor", "recommended": true, "sentiment": "positive", "sentimentScore": 0.9 },
      { "name": "Acme CRM", "domain": "acme-crm.example", "writtenAs": "Acme", "spellings": ["Acme", "Acme CRM"], "rank": 2, "role": "brand", "recommended": true, "sentiment": "positive", "sentimentScore": 0.5 },
      { "name": "Fabrikam", "domain": "fabrikam.example", "writtenAs": "Fabrikam", "spellings": ["Fabrikam"], "rank": 3, "role": null, "recommended": false, "sentiment": "neutral", "sentimentScore": 0 }
    ],
    "targets": [
      { "name": "Acme CRM", "role": "brand", "mentioned": true, "rank": 2, "recommended": true, "sentiment": "positive", "sentimentScore": 0.5, "cited": true },
      { "name": "Northwind", "role": "competitor", "mentioned": true, "rank": 1, "recommended": true, "sentiment": "positive", "sentimentScore": 0.9, "cited": false },
      { "name": "Contoso CRM", "role": "competitor", "mentioned": false, "rank": null, "recommended": null, "sentiment": null, "sentimentScore": null, "cited": false }
    ],
    "sources": [
      { "position": 1, "url": "https://www.acme-crm.example/pricing", "domain": "acme-crm.example", "kind": "owned", "brand": "Acme CRM" },
      { "position": 2, "url": "https://www.g2.com/categories/crm", "domain": "g2.com", "kind": "reviews", "brand": null }
    ]
  }
}

フィールド	説明
`status`	`ok`、`no_answer`、`failed` のいずれか。ステータスを参照してください。
`brands`	回答が挙げたすべてのブランドを、最初に言及した順に並べます。製品はメーカーとして数えるため、「MacBook Air」はAppleの順位になります。`rank` は1から始まります。`role` は送ったブランドなら `brand` か `competitor`、それ以外は `null` です。
`brands[].name`, `domain`, `writtenAs`, `spellings`	自社ブランドと競合は、送った名前が `name` になります。それ以外のブランドは言語にかかわらず同じ名前で、公式のラテン文字表記、なければ元の名前です。마켓컬리 と 컬리 はどちらも `Kurly` です。`domain` はブランドのサイトで、送ったドメインの最初のもの、そのブランドについて見つけたサイト、または `null` です。`spellings` は回答がブランド名を書いた表記を、最初に出た順にすべて含みます。たとえば Baemin には 배민 と 배달의민족 が入ります。名前の後に続く製品名や説明は表記に含みません。`writtenAs` はその最初の表記です。
`targets`	送ったブランドを送った順に並べ、それぞれ `mentioned` と `brands` 内の `rank` を返します。`cited` はそのブランドのドメインへの引用があれば `true`、ドメインを送っていなければ `false` です。
`recommended`	回答がそのブランドを推薦したか、良い選択肢として示したか。
`sentiment`、`sentimentScore`	回答がそのブランドに対して取る姿勢を5段階で判定し、0.9、0.5、0、-0.5、-0.9のスコアを付けます。他のブランドへの称賛や批判は数えず、推薦や警告は付随的な言及より優先されます。
`sources[].kind`	`owned` と `competitor` は送ったドメインで決まります。既知のサイトは固定リストに従います: `editorial`(ニュース、雑誌)、`review_media`(製品テスト・レビュー媒体)、`pr_wire`、`reviews`(ユーザーレビューサイト)、`commerce`、`social`(SNS)、`blog`(ブログプラットフォーム)、`community`(フォーラム、Q&A、Wiki)、`video`、`institution`(政府、教育機関)。それ以外のサイトはモデルが一度分類し、その結果を再利用します: `brand`(企業の公式サイト)、`content`(個人運営のサイトやブログ)、または上記のいずれか。`other` は検索エンジンやツールなどどれにも当てはまらないサイト、または分類できなかったサイトです。

判定方法

どの名前がブランドか、そのうちどれが自社か、recommended、sentiment はモデルが判定します。位置、順位、名前の照合、出典の種類はルールで計算するため、同じモデル判定からは同じ結果になります。
自社ブランドと競合は、モニターと同じルールで名前と別名を探します。ラテン文字は単語単位、韓国語、日本語、中国語、タイ語はどこでも一致し、引用リンクの中は探しません。モデルは見つけた別の表記も結び付けます。ブランド名そのものと確認した表記（例: Kurly の 컬리）は保存し、以降の回答ではルールで照合します。回答に含まれない名前は報告しません。
名前は一致したものの、モデルがこの回答でブランドとして読まなかった場合(別の意味で使われた一般的な単語)は、ブランドは一覧に残り、recommended、sentiment、sentimentScore が null になります。
送っていないブランドは、どの回答であれその表記が初めて現れたときにモデルが名前を決め、その名前とサイトを以降のすべての回答で使います。引用サイトや似た表記ですでに名前が決まったブランドを一緒に渡すため、支店や別の文字の表記も同じ名前になります。名前を決められない場合は回答の表記のままで、domain は null です。
1つのサイトは1つのブランドです。同じサイトで名前が決まったブランドは、サイト自身の名前(baemin.com の Baemin)、なければそのサイトに最初に付いた名前で1回だけ出ます。아임웹 と I’mweb は1つのブランドです。送ったブランドのサイトで見つかったブランドは、そのブランドです。ブログ、コミュニティ、動画、ソーシャルの投稿は、送っていないブランドには結び付けません。NAVER の blog.naver.com のように、そのブランド自身のプラットフォームでも同じです。
モデルがブランドではないと読んだ名前(一般名詞、場所、施術名など)は含まれません。回答が「마켓컬리, 오아시스마켓, SSG닷컴」のように1つの名前としてまとめて書いたブランドは、それぞれのブランドとして数えます。名前の後に続く説明は名前に含めません。
モデルは回答の最初の40,000文字を読みます。それ以降に初めて登場するブランドは報告しません。
分析によってタスクの完了が数秒遅くなります。

ステータス

`status`	意味	請求
`ok`	分析を実行しました。	1クレジット
`no_answer`	エンジンが回答テキストなしで完了しました(AIによる概要がないGoogle検索など)。送ったブランドはすべて未言及です。	なし
`failed`	分析を実行できませんでした。`error` は `ANALYSIS_FAILED`、`ANALYSIS_TIMEOUT`、`ANALYSIS_UNAVAILABLE` のいずれかです。タスクは回答とともに完了します。	なし

エラー

ステータス	コード	条件
`422`	`VALIDATION_ERROR`	`include.analysis` がブール値でない、エンジンが分析に対応していない、または `brand`、`brandAliases`、`brandDomains`、`competitors` が上記のルールに反しています。`details[].field` がフィールドを示します。

はじめに

基本概念

回答エンジン

検索とウェブデータ

リクエストオプション

リサーチ

GEOモニタリング

アカウントとデータ

回答の分析: ブランドの言及、順位、センチメント、出典の種類

リクエスト

対応エンジン

クレジット

レスポンス

判定方法

ステータス

エラー

関連

​リクエスト

​対応エンジン

​クレジット

​レスポンス

​判定方法

​ステータス

​エラー

​関連

リクエスト

対応エンジン

クレジット

レスポンス

判定方法

ステータス

エラー

関連