ガイド

Naver Commerce(Smartstore)連携

Naver Commerce(Smartstore)連携

Naver Commerceを連携すると、Neuroがチャット上で日別の注文数や売上とあわせて商品一覧を分析できるようになります。「先月の注文完了件数を見せて」「いま販売中の商品一覧をサマリーして」のようなプロンプトにも、Smartstoreのデータをその場で使って回答できます。

連携に必要なのは、API連携用 Seller ID だけです。パスワードや決済情報を入力することはなく、Neuroがそれらを保存することもありません。

1.連携前の事前設定(Commerce Center)

Naverでは、販売者本人が代理店を指定した場合のみ外部サービスにAPIアクセスを許可します。Neuroと連携する前に、Commerce Centerで以下4つの手順を完了してください。

  1. Smartstore Center > Seller Information > API Management に移動します。

  2. API利用設定で "Use" を選択してください。

  3. Product API」と「Order API」の両方で、代理店に팡고뉴로

  4. を指定して保存します。表示されている次の値をコピーします。"Seller ID for API integration"(例:ncp_xxxxxx_01)。

Commerce CenterのAPI Management画面に直接アクセス:https://sell.smartstore.naver.com/#/sellers/store/detail/api
Product API と Order API の代理店設定は別々に行う必要があります。 どちらか片方しか設定しない場合、その機能だけが動作します(例:Product APIのみ設定した場合、Neuroは商品データは取得できますが、注文データは取得できません)。

2.Neuroでの連携設定

  1. ワークスペース内のData sources ページを開きます。

  2. Naver Commerce

  3. を選択します。Step 1でコピーした Seller ID for API integration

  4. (例:ncp_xxxxxx_01)を入力します。

Connect をクリックします。連携時にNeuroが一度だけSeller IDの有効性と、代理店に팡고뉴로が設定されているかを確認し、問題なければ連携情報を保存します。設定が完了すると、チャット画面左側の

"Connected data"

  • にNaver Commerceが表示されます。 — 販売状態(販売中・品切れ・販売待機中など)ごとの商品一覧を確認したり、商品IDや管理コードから特定の商品を絞り込んだりできます。

  • 日付範囲別の注文一覧表示 ― 日付範囲とステータスで注文を絞り込めます(例:「6月の支払い完了注文」「先週のキャンセル注文」など)。かなり長い期間を一度に指定しても、Neuro側で自動的にクエリを分割・集計してくれます。

  • 売上トレンドの把握 ― 期間ごとに注文金額・数量・流入元を集計できます。

特定の注文(配送情報やクレーム対応など)の詳細が必要な場合は、注文番号を指定して個別に取得できます。

4. Neuroは購入者の個人データをどう扱いますか?

注文データには購入者情報が含まれる場合があります。Neuroは、購入者名・連絡先・完全な住所・通関ID・配送メモなど、個人を特定できる情報をすべてマスキングしたうえで分析にのみ利用します。広告効果や売上分析には購入者個人の特定は不要なため、金額・商品・ステータス・期間・流入元など、分析に必要な項目だけを保持します。

都市/道・県レベルといった大まかな地域情報は分析用に保持しますが、正確な住所が画面に表示されることはありません。

5. トラブルシューティング

エラー「이 판매자ID로 연동할 수 없습니다」(この販売者IDでは連携できません)が表示されます

Commerce Centerで、① API利用設定が「사용」になっているか、② 상품・주문 API 대행사に팡고뉴로が指定されているか、③ 販売者IDを正しくコピーしたかを確認してください。どれか1つでも欠けていたり誤っていると、連携は失敗します。

販売者IDの形式が無効と表示されます

Commerce CenterのAPI管理ページの「API 연동용 판매자ID」に表示されている値を、そのままコピー&ペーストしてください(例:ncp_xxxxxx_01)。ストアURLや他のIDではありません。

商品は問題なく連携されるのに、注文だけ取得できません

多くの場合、注文APIの大행사가設定されていないことが原因です。Commerce Centerで、注文APIの대행사にも팡고뉴로が設定されているか確認してください。

エラー「이미 연결된 판매자입니다」(すでに連携済みの販売者です)が表示されます

その販売者IDはすでにこのワークスペースと連携されています。新しく追加し直すのではなく、既存の連携設定を確認してください。

連携は成功したと出ますが、左側の一覧に表示されません

少し時間をおいてから画面を更新してください。それでも表示されない場合は、オペレーションチームにお問い合わせください。

参考:データ取得上限について。Naver Commerceには、1回のクエリで返せる注文数に上限があります。非常に長い期間や大量の注文を一度にリクエストすると、一部の結果が途中で切り捨てられる場合があります。その場合は、日付範囲を狭めるか、注文ステータスで絞り込んで再度取得してください。