segment-audience

/digital-marketing-pro:segment-audience

目的

行動、属性、またはエンゲージメントの基準に基づいて、ブランドの CRM またはメールプラットフォームでオーディエンスセグメントを作成または更新します。セグメントは、広告ターゲティング、メールキャンペーン、リターゲティング、パーソナライズに使用できます。セグメントの定義が明確で、適切な規模があり、各プラットフォームで活用でき、再現可能なように明確な条件が記録されるようにします。これにより、チームはセグメントに誰が含まれているのか、その理由を正確に把握できます。高度なオーディエンス戦略向けに、RFM（最新購入時期、購入頻度、購入金額）モデリング、ライフサイクルに基づくセグメンテーション、予測スコアリング基準に対応しています。

キャンペーン開始前にターゲティングオーディエンスを作成するには、このコマンドを使用してください。新しい連絡先を先に CRM にインポートする場合は、/digital-marketing-pro:lead-import を使用してください。 セグメント作成後に、セグメントのメンバーデータを外部ツールにエクスポートする場合は、/digital-marketing-pro:data-export を使用してください。

実行ゲート（必須 — 省略できません）

1. ライブシステムに変更を加える前に、受信者数／費用／変更内容／コンプライアンスを含むプレビュー全体を 実行サマリー として提示してください。
2. ユーザーが yes（または同等の明示的な承認）を入力する必要があります。それ以外の入力（曖昧、暗示的、部分的な承認、または承認なし）は、すべて実行をキャンセルします。
3. 曖昧な入力に基づいて処理を進めてはいけません。失敗した処理を自動で再試行してはいけません。再実行の前に、人による確認が必要です。
4. 実行前に python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"risk_level":"<tier>","summary":"..."}' を使用して承認を記録し、プラットフォームで成功が確認された後に python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action mark-executed --id {approval_id} を実行してください。

必要な入力

ユーザーは以下を指定する必要があります（または入力を求められます）。

• セグメント条件：セグメントへの所属を定義するルールです。属性（年齢、所在地、役職、企業規模、業界）、行動（閲覧したページ、開封したメール、クリックしたリンク、購入、参加したイベント）、エンゲージメントレベル（過去30／60／90日間にアクティブ、休眠中、離脱リスクあり、解約済み）、購入履歴（最終購入時期、購入頻度、購入金額、製品カテゴリ）、ライフサイクル段階（購読者、リード、MQL、顧客）、またはカスタムフィールドのフィルターを指定します。
• 対象プラットフォーム：セグメントを作成する場所です。CRM（Salesforce、HubSpot、Zoho、Pipedrive）、メールプラットフォーム（ActiveCampaign、Mailchimp）、または広告プラットフォーム（Meta Custom Audiences、Google Ads Customer Match、LinkedIn Matched Audiences、TikTok Custom Audiences）を指定します。
• セグメント名：ブランドの命名規則に沿った、わかりやすく標準化された名前です。例：「High-Value-Customers-Last-90d」や「MQL-SaaS-Enterprise-US」などです。
• セグメントの用途：このセグメントの使用目的です。メールキャンペーンのターゲティング、有料広告のオーディエンス、リターゲティング用リスト、パーソナライズ対象のグループ、配信停止・除外リスト、類似オーディエンスのシード、またはクロスセル／アップセルのターゲティングを指定します。
• 動的か静的か：連絡先が条件を満たしたり満たさなくなったりした際にセグメントを自動更新するか（動的／スマートリスト）、作成時点の状態を固定して維持するか（静的／スナップショット）を指定します。継続的なキャンペーンには動的、一度限りの配信や特定時点の分析には静的が適しています。
• 更新頻度（動的セグメントの場合）：セグメントのメンバーシップを再計算する頻度です。リアルタイム（イベントをトリガー）、毎日、毎週、またはキャンペーン配信前にオンデマンドで更新します。
• 除外条件（任意）：明示的に除外する連絡先です。配信停止、ハードバウンス、競合他社、社内チームメンバー、既存顧客（新規顧客獲得キャンペーンの場合）、別の進行中キャンペーンの対象者（配信頻度の制限）、またはパートナーから提供された配信抑制リストを指定します。
• セグメントの最小サイズ（任意）：用途に応じて許容される最小のセグメントサイズです。広告プラットフォームでは効果的な配信に通常1,000件以上が必要です。類似オーディエンスのシードは1,000～10,000件が最適で、メールのセグメントはA/Bテストで統計的有意性を得られる規模が必要です。
• プラットフォーム間の同期（任意）：このセグメントを追加のプラットフォームにも自動同期するかどうかを指定します。たとえば、CRMで作成し、Meta Custom AudiencesとGoogle Adsに同時に送信します。
• セグメントの説明：チーム内での記録用に、セグメントの目的と条件を人が読める形で説明します。将来の参照やナレッジの引き継ぎに備えて、セグメントとともに保存します。
• RFMパラメーター（任意）：最終購入時期・購入頻度・購入金額に基づくセグメンテーションを使用する場合は、各指標のスコア基準、取引履歴の参照期間、作成するセグメント数を定義します（例：優良顧客、ロイヤル顧客、離脱リスクあり、離反顧客）。
• 類似オーディエンスの拡張（任意）：このセグメントを類似オーディエンスのシードとして使用する場合は、拡張率（1～10％）と対象プラットフォームを指定します。これにより、単に規模を大きくするのではなく、シードの品質を重視してセグメントを最適化できます。

プロセス

1. ブランドコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.json を読み、アクティブなスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.json を読み込みます。ブランドのトーン、対象市場のコンプライアンスルール（skills/context-engine/compliance-rules.md）、業界のコンテキストを適用します。ガイドラインも確認します。~/.claude-marketing/brands/{slug}/guidelines/_manifest.json が存在する場合は、制限事項と関連するカテゴリーファイルを読み込みます。~/.claude-marketing/sops/ に代理店の SOP があるか確認します。ブランドが存在しない場合は、「先にブランドを設定しますか（/digital-marketing-pro:brand-setup）？」と尋ねるか、デフォルト設定で進めます。
2. 利用可能なデータソースを特定する：接続済みのプラットフォームを照会し、セグメント化に利用できるデータを特定します。CRM の連絡先フィールドとカスタムプロパティ、メールのエンゲージメント指標（開封、クリック、バウンス）、広告プラットフォームのオーディエンスデータ、ウェブサイトの行動データ（アナリティクス MCP が接続されている場合）、購入・取引記録を確認します。各条件をどのデータソースで評価できるかを整理し、利用可能なデータでは対応できない条件にフラグを付けます。
3. セグメント条件のロジックを構築する：ユーザーの条件を、プラットフォーム固有のフィルターロジックに変換します。AND／OR 条件、ネストされたグループ、日付範囲、相対日付期間（例：「過去 30 日間」を動的に再計算）、数値のしきい値、文字列の一致ルール、リストへの所属確認などを設定します。参照するすべてのフィールドが、対象プラットフォームのスキーマに存在することを検証します。
4. 利用可能なデータからセグメントの規模を推定する：対象プラットフォームに対して件数クエリを実行するか、推定して、セグメントの対象人数を予測します。想定用途に対してセグメントが小さすぎる場合（例：広告ターゲティングで 1,000 人未満、メールの A/B テストで 100 人未満）、または広すぎる場合（例：データベース全体の 80％を超えており、絞り込みが不十分でターゲティングの精度を欠いている可能性がある）にフラグを付けます。
5. 既存のセグメントとの重複を確認する：プラットフォーム上の既存セグメントを照会し、現在のキャンペーンで使用中のアクティブなセグメントにすでに含まれている連絡先との重複を特定します。重複率、共通する連絡先数を提示し、セグメントの目的とキャンペーンの頻度制限ルールに基づき、重複する連絡先を除外するか、セグメントを統合するか、重複を許容するかを推奨します。
6. 除外条件を適用する：配信停止済みの連絡先、恒久的なバウンス、抑制リスト、競合他社、社内チームメンバー、およびユーザー指定の除外条件を含む除外ルールを適用します。各除外ルールがセグメントの規模に及ぼす影響を、個別および累積で示します。
7. 広告プラットフォームのオーディエンスに関するコンプライアンスを検証する：広告プラットフォームと同期する場合、連絡先が広告利用に適切な同意を得ていること（メール配信への同意だけでは不十分です）を確認し、オーディエンスがプラットフォーム固有の要件（カスタマーマッチ用のハッシュ化メール形式、最小オーディエンス規模）を満たしていることを確認します。また、プラットフォームの利用規約への準拠も確認します。
8. セグメント定義ペイロードを作成する：プラットフォーム固有のセグメント定義を作成します。プラットフォームの API 形式のフィルター条件、セグメント名、説明、種類（動的／静的）、更新スケジュール、整理用のフォルダーまたはタグの割り当て、クロスプラットフォーム同期設定を含めます。
9. 承認ゲートを設ける：すべてのセグメント操作のリスクを中程度と評価します。条件の概要をわかりやすくまとめたセグメントプレビュー、推定メンバー数、データベース全体に占める割合、既存セグメントとの重複、除外による影響、代表的なメンバープロフィールのサンプル（代表的な連絡先の上位 5 件）、セグメントを作成するプラットフォームを提示します。
10. 承認後、プラットフォーム MCP 経由でセグメントを作成する：適切な MCP を通じて、セグメント定義を対象プラットフォームに送信します。広告プラットフォームのオーディエンスの場合は、オーディエンスの同期を開始し、処理完了の確認を待ってからマッチ率を検証します。CRM／メールのセグメントの場合は、作成と初期メンバー数を確認します。
11. クロスプラットフォーム同期を開始する（要望がある場合）：複数プラットフォームにまたがるセグメントの場合、オーディエンスを追加の送信先に送ります。広告プラットフォームのカスタマーマッチへのアップロード用にメールアドレスをハッシュ化し、プラットフォームの要件に沿って電話番号を整形して、同期ジョブを開始します。マッチ率を監視し、ソースと送信先の件数に大幅な差がある場合はフラグを付けます。
12. セグメントの作成を検証して結果を記録する：対象となるすべてのプラットフォームでセグメントが正常に作成されたことを確認します。メンバー数が許容範囲内の誤差で推定値と一致すること、サンプルメンバーが条件を満たしていること、各プラットフォームの UI でセグメントが正しく表示されることを検証し、マッチ率に差異があれば記録します。実行内容を ~/.claude-marketing/brands/{slug}/logs/segment-log.json に記録します。

出力

次の内容を含む、構造化されたオーディエンスセグメンテーションレポートです。

• セグメント ID とプラットフォームの確認：対象プラットフォーム上のセグメント固有の識別子、作成日時、セグメントの種類（動的／静的）、およびプラットフォームの UI 上のセグメントへの直接リンク
• メンバー数：すべての条件と除外を適用した後のセグメント内の連絡先の合計数。初期推定値との比較、データベース全体に占める割合、指定された目的に必要な最小サイズとの比較も含みます
• 条件のドキュメント化：使用した条件を、人が読める形式ですべて記録します。各フィルタールール、論理演算子（AND／OR）、日付範囲、数値のしきい値、除外を含め、チーム内のナレッジ共有や今後のセグメント保守に使えるリファレンスドキュメントとして整形します
• プラットフォームのフィルターロジック：プラットフォーム上で実装された正確なフィルター設定。監査、デバッグ、他のプラットフォームでの再現に使える API レベルの条件を含みます
• 重複分析：各アクティブなセグメントとの重複率、セグメントごとの共有連絡先数、重複によってオーディエンス疲れや予算の無駄（同じ人に二重にリーチするための費用）が生じるリスクがあるか、または意図的なもの（例：一部のオーディエンスへのリターゲティング）かどうかの評価
• 除外の影響レポート：各除外ルールによって個別に除外された連絡先数、累積除外数、除外理由別の内訳を含む最終的な対象者と除外者の比率
• サンプルメンバープロファイル：セグメントを代表する連絡先 5 件について、名前、メールアドレス、会社、エンゲージメントレベル、ライフサイクルステージ、スコア、および該当した具体的な条件などの主要フィールドを表示します
• プラットフォーム間の同期状況：広告プラットフォームと同期している場合は、プラットフォームごとのマッチ率、各同期先のオーディエンスサイズ、処理状況、全件反映までの推定時間、適用されたハッシュ化や形式変換を表示します
• セグメントサイズの推移（更新時）：既存のセグメントを更新する場合は、メンバー数の変化（追加、削除、純増減）、適用された条件の変更、および可能であれば直近 5 回の更新におけるセグメントサイズの推移を表示します
• 類似オーディエンスのシードとしての適性：このセグメントが類似オーディエンスのシードに適しているかを評価します。最適なサイズ範囲（1,000-10,000）に収まっているか、エンゲージメント品質スコア、デモグラフィックの一貫性、広告プラットフォームごとに推奨する類似オーディエンスの拡張率を含みます
• セグメント品質スコア：セグメントのターゲティング精度を評価します。条件の具体性（絞り込みが狭いか広いか）、セグメント内のエンゲージメントレベルの分布、デモグラフィックの一貫性、データベース全体と比較した予測反応率を含みます
• 推奨される次のステップ：類似オーディエンス作成のための広告プラットフォームへの同期、メールナーチャーシーケンスの開始、パーソナライズされたランディングページのバリエーション作成、補完的な除外セグメントの作成、動的セグメントの定期更新のスケジュール設定、最適化に向けたセグメント条件のスプリットテストなど、推奨アクションを示します
• 関連セグメント：この新しいセグメントとの結合、併用、または明示的な除外に適した既存のセグメントを、重複率およびユースケースの推奨事項とともに示します
• 実行ログ：セグメンテーションプロセスの日時付き記録。プラットフォーム API の呼び出し、応答ステータス、対象者の確定所要時間、マッチ率、プラットフォーム間の同期結果、発生した警告やエラーを含みます

使用するエージェント

• crm-manager — セグメント条件のロジック、CRM データのクエリ、重複排除、重複分析、プラットフォーム固有のフィルター構築、コンプライアンス確認、プラットフォーム間の同期、セグメント作成の管理
• email-specialist — メールエンゲージメントに基づくセグメンテーション条件、抑制リストの管理、配信可能性に関する考慮事項、送信頻度の上限設定ロジック、メールプラットフォームのセグメント最適化
• media-buyer — 広告プラットフォームのオーディエンス要件、類似オーディエンスのシード品質評価、Customer Match の形式、広告プラットフォームとのオーディエンス同期確認