b2c-cip

CIP analytics

トレンドの分析にはウェアハウス分析を使用し、現在のレコードや即時の診断にはSCAPI／ログを使用します。b2cが利用できない場合は、npx @salesforce/b2c-cliを使用してください。

使用するインターフェースを選ぶ

• 利用可能な場合は、MCPのcip_discover／cip_queryを優先してください。クエリの前にskill://mcp/b2c-mcp-cip/SKILL.mdを読み、skillRead: trueを渡してください。レポートの検出／設定の確認にはゲートがありません。ターミナルやトークンのエクスポートは不要です。
• CLIは、明示的なCLIの依頼、自動化、大規模なローカルCSV／JSONエクスポートに使用してください。MCPの結果は500行／24 KBに制限されます。truncatedは出力が不完全であることを示し、rowCountは返された行数を示します。CLIのデフォルトは異なります。日付フラグは、上書きしない限り当月を使用します。ユーザーのタスクに合わせて明示的な日付を設定してください。
• どちらのインターフェースも同じレポートとツールキット設定を使用します。正常に取得できた結果を繰り返すために両方を実行しないでください。

設定とアクセス

dw.json、環境、インスタンスの選択、設定プラグインから解決済みのtenantId、clientId、clientSecretを再利用してください。対象またはアクセス権が不明な場合に限り、マスキングされたb2c setup inspectを使用してください。不足している値は推測せず、確認してください。通常の分析リクエストでは、シークレットファイルを読んだり、トークンをエクスポートしたりしないでください。

Account Managerのクライアント認証情報と、テナントフィルターに対象テナントを含むSalesforce Commerce APIロールが必要です。ユーザー／SLAS／JWTのフローは適用されません。 オーバーライド：

値	CLI／環境
テナント	--tenant-id（--tenant）／SFCC_TENANT_ID
クライアント	--client-id／SFCC_CLIENT_ID
シークレット	--client-secret／SFCC_CLIENT_SECRET
Analyticsホスト	--cip-host／SFCC_CIP_HOST
ステージング分析を強制	--staging／SFCC_CIP_STAGING

末尾が_prdのテナントでは本番分析が選択され、それ以外のテナントではステージングが選択されます。ホストを明示的に設定した場合は、その設定が優先されます。ステージング分析は接続先であり、対象インスタンスを変更する指示ではありません。本番以外のデータには、26.1以降のEnable Reports & Dashboards Data Trackingが必要です。テストレルムの本番テナントでも、ステージング分析が必要になる場合があります。ダッシュボード：https://ccac.stg.analytics.commercecloud.salesforce.com

設定／利用可否が不明な場合： 分析ガイド（b2c docs read guide-analytics-reports-cip-ccac）。 解決方法の詳細：b2c-cli/b2c-config。関連するセクションのみを読んでください。

検出して実行する

1. レポートを一覧表示／検索し、選択したレポートのパラメーターを確認します。MCPのレポート詳細には、テーブルと利用可能な結果に関する注記も含まれます。
2. サイト／日付の範囲を適切に設定します。ウェアハウスのnsite_idは、多くの場合Sites-Example-Siteのような形式です。SCAPIのサイトIDから組み立てず、ccdw_dim_siteで確認してください。
3. レポートを実行します。SQLのプレビューは、SQLを調整する場合や、定義が不明確な場合にのみ使用してください。カスタムSQLで列が必要な場合はテーブルの列を確認し、網羅的な閲覧は避けてください。

b2c cip report list --category "Sales Analytics"
b2c cip report sales-analytics --describe
b2c cip report sales-analytics --site-id Sites-Example-Site --from 2026-09-01 --to 2026-09-07

# Existing report does not fit: inspect the relevant table, then adapt SQL.
b2c cip tables --pattern "ccdw_aggr_sales%"
b2c cip describe ccdw_aggr_sales_summary
b2c cip report sales-analytics --site-id Sites-Example-Site --from 2026-09-01 --to 2026-09-07 --sql

# Execute a reviewed query; CLI replaces <FROM>/<TO> date placeholders.
b2c cip query --file ./query.sql --from 2026-09-01 --to 2026-09-07 --format csv > sales.csv

Raw SQLは位置指定クエリまたは標準入力も受け付けます。MCPのSQLには日付をリテラルで含める必要があります。プレースホルダーの置換はCLIの機能です。出力をリダイレクトする場合は、終了ステータス／エラーを保持してください。--format table|csv|jsonでレポート／クエリの出力形式を制御します。--jsonはCLI標準のJSONエンベロープを使用します。

技術レポートを選ぶ

質問	レポート／制約
SCAPIエンドポイントの遅延	scapi-latency-distribution。ヒストグラムのバケットは分布を示すもので、正確なパーセンタイルではありません
HTTPエラー	scapi-error-rate-by-status --status-class 5xx
キャッシュの有効性	scapi-cache-hit-ratio
統合クライアントの使用状況	ocapi-client-usage
SFRAコントローラー	controller-health-scorecard、controller-error-rate-trend。サイトの指定が必要です

SCAPIのトラフィックはヘッドレスの場合や、サイトに割り当てられていない場合があります。意図的に全サイトを分析する場合に限り、任意のサイトフィルターを省略し、対象範囲を説明してください。フラグを推測で指定せず、--describeで正確なパラメーターを確認してください。すべての例で日付範囲を選択する必要があります。

クエリと解釈

日付やサイトで絞り込み、必要な列を選択してください。LIMIT だけではデータベースの処理量を制限できません。ファクトテーブルを結合するより、集計テーブルを優先してください。期間の AOV は日次平均ではなく、売上合計 ÷ 注文数合計で計算してください。比率の null、欠損日、通貨、タイムゾーン、対象範囲の制限を保持してください。最新イベントの日付は、データの取り込みが最新であることを意味しません。

Safety Mode が適用されます。CIP は SELECT やメタデータの取得でも POST を使用します。ブロックを回避しないでください。401/403 の場合は、すべての拒否がロール不足によるものと決めつけずに、認証情報、ロール、テナントフィルターを確認してください。クォータ超過やタイムアウトの場合は、期間またはクエリを絞り込んでください。再試行ループは使用しないでください。公式の アクセスおよびサービス制限。

条件付きの参考資料

タスクで必要な場合にのみ、該当するセクションを読んでください。

• 売上の比較、差分、最新のアクティビティ：SALES_ANALYSIS.md。
• カスタム SQL のパターン：STARTER_QUERIES.md。
• 不明なテーブルファミリー：KNOWN_TABLES.mdを確認してから、ライブメタデータを確認します。
• CLI オプション：コマンドリファレンス（b2c docs read cli-cip）。

要求された結果と重要な制限が明らかになった時点で終了してください。