> 継続的なプロセス改善 > リードから入金まで > Oracle CX Sales > データテンプレート

リードから入金までのデータテンプレート

Oracle CX Sales

リードから入金までの属性 (20) リードから入金までのアクティビティ (14) 抽出ガイド (2)

リードから入金までのデータテンプレート

このテンプレートでは、リードから入金までのデータをプロセスマイニング用に準備する手順を説明します。収集すべき必須属性、追跡すべき主要なアクティビティ、Oracle CX Salesからこれらの情報を抽出するためのガイダンスをまとめています。このテンプレートに沿って準備することで、プロセスを正確かつ詳細に分析できます。

リードから入金までの分析に推奨される属性
販売サイクルと入金サイクル全体で追跡すべき主要なアクティビティ
Oracle CX Salesからデータを抽出するための詳細なガイダンス

イベントログを初めて扱いますか。学ぶプロセスマイニングのイベントログを作成する方法.

テンプレートをダウンロード

リードから入金までの属性

リードから入金までのプロセスを詳細に分析するため、イベントログに含めることを推奨するデータ項目です。

5 必須 5 推奨 10 任意

	名前	説明
	アクティビティ名 ActivityName	Sales Opportunityについて、特定の時点で発生した業務アクティビティまたはイベントの名称です。
説明この属性は、リードから入金までのプロセスにおける具体的なステップまたはマイルストーンを表します。たとえば、「Lead Converted To Opportunity」、「Quote Created」、「Payment Received」などです。これらのアクティビティがプロセスマップの基本要素になります。アクティビティの順序と頻度を分析すると、プロセスフローを可視化し、一般的な経路と代替経路を特定できます。また、逸脱やボトルネックの検出にも役立ちます。ステップ間の遷移時間を測定し、実際の業務の進め方を把握するための基盤となります。重要な理由この属性は、プロセスマップを作成し、販売ライフサイクルにおけるイベントの順序を把握するための基本要素です。入手先通常は、Opportunity、Quote、Orderオブジェクトに関連するステータス変更、イベントログ、特定のタスク完了レコードから取得します。例商談の選別完了見積もりを顧客に送付注文履行完了入金を受領
	イベント時刻 EventTime	特定のアクティビティまたはイベントが発生した時点を示すタイムスタンプです。
説明イベント時刻は、アクティビティが記録された日付と時刻です。イベントを時系列に並べ、プロセス内の異なるステップ間の所要時間を計算するために欠かせません。このタイムスタンプは、サイクル時間の計算、待ち時間によるボトルネックの特定、サービスレベル合意に対するパフォーマンスの監視など、時間に基づく分析の基盤になります。正確なタイムスタンプは、信頼性の高いプロセスマイニング分析に不可欠です。重要な理由イベントの時系列を示します。サイクル時間や所要時間など、すべてのパフォーマンス指標を計算するために欠かせません。入手先ステータス変更のタイムスタンプなど、特定のアクティビティに関連するレコードの作成日または最終更新日に対応します。例 2023-04-15T10:00:00Z2023-05-01T14:30:00Z2023-05-20T09:15:00Z
	営業案件 SalesOpportunity	Sales Opportunityを一意に識別するIDであり、リードから入金までのプロセスのCase IDとして機能します。
説明 Sales Opportunityは、収益につながる可能性のある商談を、リードとしての初期段階から受注または失注という最終結果まで追跡する中心的なオブジェクトです。適格性確認、見積、注文、入金など、関連するすべてのアクティビティを結び付けます。プロセスマイニング分析では、この識別子が各商談のエンドツーエンドの経路を再構成するうえで欠かせません。ステージ間のサイクル時間、コンバージョン率、受注につながる経路と失注に至る経路を含む、ライフサイクル全体を分析できます。重要な理由すべてのプロセスイベントを結び付ける重要なCase IDです。商談ごとの販売ライフサイクル全体を、完全かつ正確に把握できます。入手先 Oracle CX SalesのOpportunityオブジェクトにおける主要な識別子です。例 OPP-0012345OPP-0023456OPP-0034567
	ソースシステム SourceSystem	データを抽出したシステムです。
説明プロセスデータの取得元を示す属性です。この場合はOracle CX Salesが該当します。複数のシステムを利用する環境では、データソースを区別するために役立ちます。分析では、データの出所に関するコンテキストを提供します。複数のシステムからデータを統合する場合や、システム固有の動作を理解する場合に重要です。データガバナンスと追跡可能性を支える標準的なフィールドです。重要な理由データの出所に関する重要な情報を提供し、追跡可能性を確保するとともに、複数の連携システムから取得したデータの管理に役立ちます。入手先通常は、データ抽出時にデータソースを示す固定値として追加されます。例 Oracle CX Sales
	最終データ更新日時 LastDataUpdate	ソースシステムからデータが最後に更新または抽出された時点のタイムスタンプです。
説明この属性は、分析対象データの鮮度を示します。Oracle CX Salesから最後にデータを取得した日付と時刻を表します。ダッシュボードやレポートでは、表示中のデータがどの時点のものかを利用者に伝えるうえで重要です。最新のアクティビティが分析に含まれているかどうかを判断する際にも役立ちます。重要な理由データの更新状況を利用者に伝えます。ダッシュボードを解釈し、適切な判断を行うために欠かせません。入手先通常は、データの抽出、変換、ロード（ETL）処理の中で生成・追加されます。例 2024-06-10T02:00:00Z
	Opportunityの担当者 OpportunityOwner	Sales Opportunityを主に担当する営業担当者です。
説明 Opportunityの担当者は、商談の管理と成約に責任を持つユーザーです。この属性により、個人またはチーム単位でパフォーマンスを分析できます。プロセスマイニングでは、Opportunityの担当者でフィルタリングすることで、業務パターン、パフォーマンスの基準値、標準営業プロセスへの準拠状況の違いを把握できます。営業マネージャーが育成の機会を特定し、成果の高い担当者が営業サイクルをどのように進めているかを理解する際にも役立ちます。重要な理由営業担当者またはチーム単位でパフォーマンスを分析でき、優れた実践例や育成が必要な領域の特定に役立ちます。入手先 Oracle CX SalesのOpportunityオブジェクトにある標準の「Owner」または「AssignedTo」フィールドで提供されます。例 John SmithJane DoePeter Jones
	Opportunityの金額 OpportunityValue	Sales Opportunityの見積金額または実績金額です。
説明この属性は、Sales Opportunityに関連する潜在収益または最終収益を表します。ライフサイクル全体で商談を分類し、優先順位を付けるために利用できます。プロセスマイニングでは、Opportunityの金額を分析することで、異なるプロセスバリアントが高額商談と低額商談に与える影響を把握できます。「Opportunity Loss & Drop-Off Reasons」分析など、収益漏れを追跡するダッシュボードにも欠かせません。プロセス経路と財務上の結果を関連付けて分析できます。重要な理由プロセスの非効率による財務的な影響を定量化し、商談と改善施策の優先順位付けに役立ちます。入手先 Oracle CX SalesのOpportunityオブジェクトにある「Revenue」や「Amount」などのフィールドで提供される可能性があります。例 50000.00125000.0025000.00
	営業ステージ SalesStage	営業パイプラインにおけるSales Opportunityの現在のステージです。
説明営業ステージは、定義された営業プロセスにおける商談の進捗を示します。「Qualification」、「Solution Proposed」、「Negotiation」などの値が使われます。任意の時点における商談の状態を把握するための主要な属性です。この属性は、営業ファネルの可視化や「Stalled Opportunity Stage Analysis」ダッシュボードの作成に欠かせません。各ステージに滞在した時間を分析することで、商談が停滞している箇所を特定し、パイプラインの進行を妨げている要因を解消できます。重要な理由営業ファネルの分析や、商談が停滞・失注しやすいボトルネックの特定に欠かせません。入手先 Oracle CX SalesのOpportunityオブジェクトに標準で用意されているフィールドで、通常は「SalesStage」または「StageName」という名称です。例 01：見込み判定03：提案05：交渉受注確定
	地域 Region	Opportunityに関連付けられた地理的地域または営業テリトリーです。
説明地域属性は、「North America」、「EMEA」、「APAC」など、地理的な場所に基づいて商談を分類します。業績を分類する際によく使われるディメンションです。「Regional Sales Performance Benchmarks」ダッシュボードに欠かせない属性です。営業サイクル時間、コンバージョン率、プロセスバリアントなどの主要指標を地域間で比較し、成果の高い地域と重点的な改善が必要な地域を特定できます。重要な理由地理的に異なる地域間でプロセスパフォーマンスを比較し、地域ごとの違いや優れた実践例を明らかにします。入手先 Oracle CX SalesのAccountまたはOpportunityオブジェクトに、標準フィールドまたはカスタムフィールドとして用意されていることがよくあります。例北米EMEAAPACLATAM
	失注理由 LossReason	Opportunityを失注した理由です。
説明商談が成約せずにクローズされた場合、失注理由には「Lost to Competitor」、「Price」、「No Decision」など、主な原因が記録されます。戦略分析とプロセス改善に欠かせない情報です。この属性は、「Opportunity Loss & Drop-Off Reasons」ダッシュボードの中核となります。失注が発生したステージと失注理由を組み合わせて分析することで、競争上の弱点を把握し、営業戦略、製品構成、価格モデルを見直せます。重要な理由商談を受注できなかった理由を把握し、営業プロセスや製品構成の戦略的な改善に役立てます。入手先 Oracle CX SalesでOpportunityのステータスが「Closed Lost」に設定された際に記録される標準フィールドです。例価格競合他社に敗退製品適合性意思決定なし
	ユーザー名 UserName	特定のアクティビティまたはイベントを実行したユーザーです。
説明この属性は、「Quote Created」や「Order Submitted」などのタスクを実行した人物を特定します。Opportunityの担当者が商談全体の責任者であるのに対し、ユーザー名は個々のアクションを実行した人物を記録します。この詳細情報は、リソース配分、業務量の分布、役割と責任の遵守状況を把握するうえで役立ちます。特定のユーザーがプロセスのボトルネックになっていないか、特定のタスクが権限のない担当者によって繰り返し処理されていないかを確認できます。重要な理由各アクションを実行した人物を記録し、詳細な業務量分析とアクティビティの監査を可能にします。入手先通常は、Oracle CX Salesでアクティビティに関連するオブジェクトの「CreatedBy」または「LastUpdatedBy」フィールドに記録されています。例 Alice WilliamsBob BrownCharlie Davis
	停滞しているかどうか IsStalled	商談が同じ販売ステージに長期間とどまっているかどうかを示すフラグです。
説明この属性は、商談における連続する2つのアクティビティ間の時間が、あらかじめ定めた業務上のしきい値（例：30日）を超えた場合にtrueになるブール型フラグです。「Stalled Opportunity Rate」KPIの計算や、「Stalled Opportunity Stage Analysis」ダッシュボードに使用します。停滞している商談を特定することで、営業マネージャーが早期に介入し、支援を提供して、販売パイプライン全体の進行速度を高められます。重要な理由対応が進まず失注するリスクのある商談を早期に特定し、適切なタイミングで介入できるようにします。入手先ケース内の連続するイベント間の時間を測定し、定義済みのしきい値と比較して算出します。例 truefalse
	割引率 DiscountPercentage	Sales QuoteまたはOpportunityに適用された割引率です。
説明この属性は、特定の商談に適用された割引率を記録します。最終価格と販売利益に直接影響します。割引水準の分析は、「Average Discount Utilization」KPIの把握に欠かせません。割引が利益率に与える影響を理解し、承認を得ずに、または一貫性なく割引が適用されていないかを確認できます。見積承認ワークフローの潜在的な問題を明らかにすることにも役立ちます。重要な理由収益性と値引き戦略の有効性を分析し、管理されていない値引きの可能性を特定するのに役立ちます。入手先 Oracle CX Salesのドキュメントで、QuoteまたはOpportunity Product Line Itemオブジェクトの値引きフィールドを確認します。例 0.050.100.150.20
	商品名 ProductName	商談で販売する主な商品またはサービスです。
説明この属性は、営業商談に関連付けられた商品または商品ファミリーを指定します。複数の商品を含む商談では、主な対象商品を示す場合や、商品明細ごとに繰り返し記録される場合があります。商品別にプロセスフローを分析すると、特定の商品で営業サイクルが長期化または複雑化しているかどうかを確認できます。この情報は、商品ごとの営業戦略、トレーニング、プロセス改善の検討に役立ちます。重要な理由商品やサービスによって営業プロセスがどのように異なるかを分析し、商品固有のボトルネックを明らかにできます。入手先 Oracle CX SalesのProductオブジェクトにあり、Opportunity Product Line Itemを介して関連付けられています。例エンタープライズCRMライセンスクラウドストレージ：ティア1プロフェッショナルサービスパッケージ
	履行前の請求書発行 InvoiceBeforeFulfillment	注文の履行前に請求書が発行されたかどうかを示すフラグです。
説明このブール型の属性は、特定のケースで「Invoice Generated」イベントが「Order Fulfilled」イベントより前に発生した場合にtrueになります。これは、コンプライアンスに反する、またはリスクのあるプロセス経路を示します。「Invoice Before Fulfillment Rate」KPIを直接支援し、プロセスコンプライアンスのダッシュボードで使用します。この逸脱を追跡することで、組織は適切な請求手続きを徹底し、顧客との紛争を減らし、収益認識に関するリスクを抑えられます。重要な理由注文の履行前に顧客へ請求するという重大なプロセスコンプライアンス違反を示します。顧客満足度の低下や財務上のリスクにつながる可能性があります。入手先同じケース内にある「Invoice Generated」と「Order Fulfilled」アクティビティのタイムスタンプを比較して算出します。例 truefalse
	注文ID OrderId	成約した商談から作成された営業注文の一意の識別子です。
説明 Order IDは、顧客が見積もりを承認し、商談が成立した後、履行に回される正式な販売注文の参照番号です。販売から業務処理への重要な移行点を示します。この識別子は、「Order Submitted For Fulfillment」アクティビティ以降のプロセスを追跡するうえで欠かせません。Lead to Cashサイクルにおける販売と履行の工程をつなぎ、注文処理と履行にかかる時間をエンドツーエンドで分析できます。重要な理由販売商談と履行プロセスを関連付け、リードから最終納品までをエンドツーエンドで分析できます。入手先 Sales Orderオブジェクトの主要な識別子については、Oracle CX Salesのドキュメントまたは連携しているERPシステムを確認してください。例 SO-554433SO-554434SO-554435
	見積ID QuoteId	商談に関連付けられた営業見積の一意の識別子です。
説明 Quote IDは、商談用に作成された特定の営業見積書を参照する番号です。手戻りが発生する場合など、商談のライフサイクル中に複数の見積が作成されることがあります。この識別子を追跡することは、「Quote-to-Order Cycle Time」と「Quote Rework Rate」を分析するうえで重要です。見積の発行から承認までの時間を正確に測定し、初回見積と修正版を区別できます。重要な理由営業見積を一意に識別し、手戻りや成約までの時間を含む見積サイクルを正確に分析できます。入手先 Oracle CX SalesのQuoteオブジェクトにおける主識別子で、Opportunityに関連付けられています。例 QUO-98765QUO-98766QUO-98767
	見積書の手戻りかどうか IsQuoteRework	同じ商談について、見積もりがやり直された、または複数回作成されたかどうかを示すフラグです。
説明このブール型の属性は、1件の販売商談で「Quote Reworked」などのアクティビティ、または2回目の「Quote Created」イベントが発生した場合にtrueになります。見積もり段階でプロセスが非効率になっているケースを特定できます。「Quote Rework Rate」KPIの計算や、「Process Deviation & Rework Analysis」ダッシュボードに使用します。やり直しを可視化することで、初期要件の収集、価格設定、製品構成に関する問題を特定し、追加作業や遅延の原因を把握できます。重要な理由見積もりプロセスにおける非効率や逸脱を直接示し、遅延や繰り返し作業の根本原因の特定に役立ちます。入手先イベントログを分析して算出します。特定のSales Opportunityについて、「Quote Created」または「Quote Reworked」アクティビティが複数回出現した場合にtrueになります。例 truefalse
	請求書ID InvoiceId	販売注文に対して発行された請求書の一意の識別子です。
説明 Invoice IDは、注文の履行後に顧客へ送付される請求書類の参照番号です。プロセスの最終的な財務工程で使用する主要な書類です。この識別子は、「Invoice Generation Cycle Time」や「Payment Collection Cycle」を分析するうえで欠かせません。請求書の作成から最終入金までを追跡できるため、キャッシュフローと売掛金の状況を監視するうえで重要です。重要な理由最終的な財務取引を追跡し、請求サイクルの所要時間と入金効率の分析に役立ちます。入手先 Invoiceオブジェクトの識別子については、Oracle CX Salesのドキュメントまたは連携しているERP／財務システムを確認してください。例 INV-2023-001INV-2023-002INV-2023-003
	顧客名 CustomerName	営業商談に関連付けられた顧客またはアカウントの名前です。
説明この属性は、商談の対象となる見込み顧客または既存顧客を識別します。営業プロセスを分割して分析するための基本的な軸です。顧客でフィルタリングすると、特定のアカウントにおける営業活動の経路を詳しく分析でき、重要顧客の管理に役立ちます。また、顧客規模、業界、その他の特徴によってプロセスのパフォーマンスを分けて分析し、営業アプローチを調整できます。重要な理由顧客別にプロセスを分けて分析できるため、顧客ごとの行動を理解し、重要顧客を管理するうえで役立ちます。入手先 Oracle CX SalesのOpportunityオブジェクトに関連付けられたAccount Nameです。例 Global Tech Inc.Innovate Solutions LLCPioneer Corp

必須推奨任意

リードから入金までのアクティビティ

正確なプロセスディスカバリーとボトルネックの特定のため、イベントログに記録すべき重要なプロセス手順とマイルストーンです。

6 推奨 8 任意

	アクティビティ	説明
	リードを商談に転換	有望なSales LeadからSales Opportunityが作成されたことを示します。このイベントは、商談を中心としたプロセス分析の開始点であり、ユーザーがシステム上でリードを転換した際に明示的に発生します。
重要な理由このイベントは、プロセスの主要な開始イベントです。転換されたリードの件数と流入元を分析することは、リード獲得と選別の取り組みの有効性を把握するうえで重要です。入手先このイベントは、Sales Opportunityレコード（Opportunityオブジェクト）が作成され、`LeadId`または同様のソースフィールドに値が設定されている場合に取得します。これにより、転換されたリードが起点であることを確認できます。取得元のLead参照がnullではないOpportunityオブジェクトについて、作成タイムスタンプを取得します。イベントタイプ explicit
	入金を受領	顧客からの入金が受領・記録され、リードから入金までのサイクルが正常に完了したことを示します。このイベントは財務システムから発生します。
重要な理由プロセスが成功裏に完了した最終地点であり、収益が実現したことを示します。販売サイクル全体の時間とキャッシュフローの効率を測定するうえで重要です。入手先外部の売掛金システムまたは財務システムから取得します。プロセス分析を完結させるため、データをSales Opportunityに関連付ける必要があります。取得イベントのタイムスタンプは、財務システムの入金消込レコードから取得されます。イベントタイプ explicit
	商談の失注	商談が成約せずにクローズされた、失注という結果を表します。Opportunityのステータスが「Closed - Lost」に更新された場合に推定されます。
重要な理由重大な失敗の終点です。商談を失注した時期、理由、金額を分析することで、プロセス上の弱点や市場の課題を特定できます。入手先 Opportunityオブジェクトの「StatusCode」が「LOST」に更新されたことから推定されます。「ReasonWonLostCode」フィールドに理由が記録されていることがよくあります。取得 Opportunityのステータスフィールドが、システムで定義された「Lost」ステータスに更新されたことを検出します。イベントタイプ inferred
	商談成立	顧客が購入を決定し、取引が成立したことを示します。通常は、商談のステータスが最終状態である「Closed - Won」に変更されたことから推定します。
重要な理由営業ファネルにおける主要な成功マイルストーンです。後続の履行および請求プロセスを開始するトリガーになります。入手先 Opportunityオブジェクトの「StatusCode」が「WON」に更新されたことから推定されます。「WinProb」（受注確度）フィールドも通常は100％に変わります。取得 Opportunityのステータスフィールドが、システムで定義された「Won」ステータスに更新されたことを検出します。イベントタイプ inferred
	見積もり作成	商談に関連付けられた正式な価格見積書が作成されたことを示します。Opportunityにリンクされた新しいQuoteレコードの作成によって明示的に記録されるイベントです。
重要な理由これは、購入意向が明確になったことを示す主要なマイルストーンです。商談の作成から見積もり作成までの時間を分析することで、営業の進捗速度を測定できます。入手先 Sales Opportunity ID（OptyId）にリンクされたQuoteレコード（Q_Quoteオブジェクト）の作成イベントから取得します。取得商談に関連付けられたQuoteオブジェクトの作成タイムスタンプを使用します。イベントタイプ explicit
	顧客が見積もりを承認	顧客が見積もりの条件と価格に正式に同意したことを示します。通常は、Quoteオブジェクトのステータスが「Accepted」に変更されたことで記録される重要なマイルストーンです。
重要な理由これは購入意思を示す重要なシグナルであり、受注作成の前提条件です。交渉段階の成功裏の完了を示し、見積もりから受注までのサイクルにおけるマイルストーンとなります。入手先 Quoteオブジェクトのステータスが「Accepted」または「Customer Approved」に変更されたことから推定します。取得 Quoteオブジェクトのステータスフィールドが、指定した「Accepted」値に変更されたことを検出します。イベントタイプ inferred
	ソリューション提案	正式なソリューションまたは提案書が顧客に提示されたことを示します。通常は、商談が「Proposal」または「Presentation」ステージに移行したことから推定します。
重要な理由このアクティビティを追跡すると、ソリューションの作成と提案にかかった時間を分析できます。また、商談が長期間滞留しやすいため、「停滞商談率」KPIを把握するうえでも重要なステージです。入手先 Opportunityオブジェクトの「Sales Stage」フィールドが、「4 - Proposal」や「Presentation」などの値に変更されたことから推定します。取得 Opportunityの営業ステージフィールドが、提案ステータスに変更されたことを検出します。イベントタイプ inferred
	ニーズ分析完了	営業チームが顧客の要件を収集し、記録したことを示します。通常は、商談の営業ステージがディスカバリーまたは分析の段階を越えたことから推定します。
重要な理由このアクティビティは、ソリューションを提案する前の重要なマイルストーンです。ここでの遅延は、顧客との関係構築や、技術的な詳細検討に必要なリソースの確保に問題があることを示す場合があります。入手先 Opportunityオブジェクトの「Sales Stage」フィールドの変更から推定します。たとえば、「2 - Discovery」から「3 - Solution Building」への変更が該当します。取得 Opportunityの営業ステージフィールドが、ディスカバリー完了を示すステータスに変更されたことを検出します。イベントタイプ inferred
	商談の選別完了	商談の初期選別段階が完了したことを示します。通常は、初期評価が完了し、有望な商談であることを示す営業ステージに更新された時点で推定します。
重要な理由このマイルストーンを追跡すると、初期営業プロセスの効率と、商談が選別に要した時間を測定できます。これは、リードから商談への転換率KPIを把握するうえで重要です。入手先 Opportunityオブジェクトの「Sales Stage」フィールド（StgId）が変更され、選別を示す値になったことから推定します。たとえば、「1 - Qualification」から「2 - Discovery」への変更が該当します。取得 Opportunityの営業ステージフィールドが、指定した「Qualified」ステータスに変更されたことを検出します。イベントタイプ inferred
	履行のために注文を送信	営業から注文履行チームへの引き継ぎを示します。Oracle CX Salesでは、商談の受注を契機に、連携されたERPシステムでSales Orderを作成するプロセスとして推定される場合があります。
重要な理由このアクティビティは、営業と業務運用の間をつなぎます。この引き継ぎを分析することは、「Order Fulfillment Time」KPIを把握し、改善するうえで重要です。入手先このイベントは、CX Sales内では概念上のものとなることが多く、別のシステムで注文を作成するトリガーを表します。「Opportunity Won」のタイムスタンプ、または後続する連携確認ステータスと関連付けることができます。取得多くの場合、「Opportunity Won」のタイムスタンプを代替値として使用するか、連携されたOrder Managementシステムのデータが必要です。イベントタイプ inferred
	注文履行完了	商品が出荷された、またはサービスが顧客に提供されたことを示します。このイベントデータはOracle CX Salesに標準で含まれていないため、連携されたOrder ManagementシステムまたはERPシステムから取得する必要があります。
重要な理由顧客への納品約束が完了したことを示し、請求のトリガーになります。履行サイクル時間の測定に欠かせないイベントです。入手先外部ERPシステムまたは履行システムとの連携が必要です。データは、元のSales Opportunity IDに関連付ける必要があります。取得イベントのタイムスタンプは、連携を通じて履行システムから取得されます。イベントタイプ explicit
	見積もりの手戻り	見積もりが修正され、顧客に再発行されたケースを記録します。同じ商談に対する複数の「Quote Created」イベント、または1つのQuoteレコードのバージョン情報から推定します。
重要な理由手戻りが頻繁に発生する場合、初回提案の精度不足や交渉の長期化が原因で、営業サイクルが延びている可能性があります。「見積もり手戻り率」KPIや手戻り分析ダッシュボードに直接役立ちます。入手先顧客への送付後に、新しいQuoteのバージョンが作成されたこと、または既存の見積もりが大幅に更新されたこと（例：ステータスがドラフトに戻ったこと）を検出して推定します。取得同じ商談について、その後に発生した「Quote Created」イベントまたはバージョン番号の増加を特定します。イベントタイプ inferred
	見積もりを顧客に送付	見積もりが確認のため顧客に正式に送付された時点を示します。通常は、Quoteオブジェクト自体のステータスが「Presented」や「Sent」などに変更されたことから推定します。
重要な理由このアクティビティを起点に、顧客による確認と交渉の期間を測定します。「見積もりから受注作成までの時間」KPIの測定開始点です。入手先商談に関連付けられたQuoteオブジェクトのステータス変更から推定します。ステータスフィールドの名称は「StatusCode」などの場合があります。取得 Quoteオブジェクトのステータスフィールドが「Sent」または「Presented」に変更されたことを検出します。イベントタイプ inferred
	請求書を生成	履行済みの注文に対する顧客向け請求書の作成を表します。このアクティビティはOracle CX Salesではなく、請求または財務システムで発生するため、データを連携する必要があります。
重要な理由このイベントを起点に入金回収サイクルが始まります。履行から請求までの遅延は、キャッシュフローと「Invoice to Payment Cycle Time」KPIに悪影響を及ぼす可能性があります。入手先外部ERPシステムまたは売掛金システムから取得します。プロセス分析では、イベントデータをSales Opportunity IDと関連付ける必要があります。取得イベントのタイムスタンプは、財務システムの請求書作成ログから取得されます。イベントタイプ explicit

推奨任意

抽出ガイド

Oracle CX Salesからデータを取得する方法

ステップ

前提条件と認証：Oracle CX Salesで、Sales Administratorなど、商談と見積もりのREST APIにアクセスするために必要な権限を持つユーザーアカウントを用意します。Oracle Cloud管理者からOAuth 2.0のクライアント認証情報（Client IDとClient Secret）を取得し、APIリクエストを認証してベアラートークンを生成します。
環境を設定：ローカルマシンまたはサーバーにNode.js環境を設定します。HTTPリクエストの送信とCSVファイルの処理に必要なライブラリをインストールします。ターミナルを開き、次のコマンドを実行します。 npm install axios npm install json2csv
APIエンドポイントを確認：この抽出で使用する主なエンドポイントは、OpportunityオブジェクトとQuoteオブジェクト用です。ベースURLはOracleインスタンスごとに異なります。例：https://[your-oracle-cx-cloud-host].fa.us2.oraclecloud.com。主なリソースは次のとおりです。

Opportunities：/salesApi/resources/latest/opportunities
Quotes（Opportunityの子オブジェクト）：/salesApi/resources/latest/opportunities/{OptyId}/child/Quote

抽出スクリプトを設定：提供されたJavaScriptコードをextract.jsなどのファイルにコピーします。スクリプト冒頭のプレースホルダー変数を、Oracle CX CloudのホストURL、クライアントID、クライアントシークレット、抽出対象の期間に合わせて更新します。
スクリプトを実行：ターミナルでnode extract.jsコマンドを実行します。スクリプトはまず認証トークンを取得し、その後APIから商談をページ単位で取得します。
データ取得とページング：スクリプトがAPIのページネーションを自動的に処理します。1回のリクエストで指定件数の商談を取得し、offsetパラメーターを使って次のページをリクエストします。指定した期間内のすべての商談を取得するまで処理を続けます。
関連する見積もりデータを取得：取得した各商談について、関連するすべての見積もりを取得するAPI呼び出しを追加で実行します。このデータは、「Quote Created」や「Quote Accepted」などの見積もり関連アクティビティを生成するために必要です。
イベントログへ変換：スクリプトの中心的な処理では、各商談と関連する見積もりを処理し、階層構造のJSONデータを表形式のイベントログに変換します。ステータスコード、販売ステージ、作成日などからイベントを推定し、業務アクティビティごとに1行を生成します。
外部データの依存関係を処理：「Order Fulfilled」、「Invoice Generated」、「Payment Received」などのアクティビティは外部システムで発生します。スクリプトは販売から履行への引き継ぎ用にプレースホルダーアクティビティを生成します。ERPまたは財務システムから別途データを抽出し、共通キーであるSalesOpportunityを使ってこのイベントログと結合してください。
CSVへエクスポート：すべてのデータを取得して変換したら、スクリプトはjson2csvライブラリを使い、最終的なイベントログレコードの配列をoracle_cx_sales_event_log.csvというCSVファイルに変換します。ファイルはスクリプトを実行したディレクトリと同じ場所に保存されます。
アップロードの準備：生成されたCSVファイルの正確性と完全性を確認します。ファイルにはSalesOpportunity、ActivityName、EventTimeなどの必要な列が含まれており、ProcessMindにアップロードして分析できます。

設定

APIホストURL：Oracle CX Sales環境のベースURLです。例：https://[your-instance].fa.us2.oraclecloud.com。
認証：スクリプトは、サーバー間認証にClient IDとClient Secretを使うOAuth 2.0を使用します。これらの認証情報は、Oracle CloudのID管理設定で発行する必要があります。
期間：スクリプトはLastUpdateDateフィールドに基づいて商談を絞り込みます。データ量とAPIの負荷を抑えるため、まずは過去3～6か月など、直近の期間から始めることを推奨します。形式はYYYY-MM-DDです。
フィールドの選択：スクリプトはfieldsクエリパラメーターを使い、APIから必要なフィールドだけを取得します。これによりパフォーマンスが大幅に向上し、ネットワークトラフィックを削減できます。カスタムフィールドを使用する場合は、このパラメーターに追加してください。
ページネーションの上限：limitパラメーターは、1回のAPI呼び出しで返すレコード数を指定します。必要なAPI呼び出し回数を抑えるため、スクリプトでは一般的な最大値である500を設定しています。
必要な権限：使用するユーザーまたはOAuthアプリケーションの認証情報には、標準フィールドと関連するカスタムフィールドを含む「Opportunity」および「Quote」RESTリソースへの読み取り権限が必要です。

a サンプルクエリ javascript

const axios = require('axios');
const { Parser } = require('json2csv');
const fs = require('fs');

// --- Configuration --- //
const ORACLE_CX_HOST = 'https://[your-oracle-cx-cloud-host].fa.us2.oraclecloud.com';
const CLIENT_ID = '[Your Client ID]';
const CLIENT_SECRET = '[Your Client Secret]';
const START_DATE = '2023-01-01'; // YYYY-MM-DD
const END_DATE = '2023-06-30'; // YYYY-MM-DD
const PAGE_LIMIT = 500;
// --- End Configuration --- //

const tokenUrl = `${ORACLE_CX_HOST}/fscmRestApi/tokenrelay`;
const opportunitiesUrl = `${ORACLE_CX_HOST}/salesApi/resources/latest/opportunities`;

const getAuthToken = async () => {
    try {
        const response = await axios.post(tokenUrl, 'grant_type=client_credentials', {
            headers: {
                'Content-Type': 'application/x-www-form-urlencoded',
                'Authorization': `Basic ${Buffer.from(`${CLIENT_ID}:${CLIENT_SECRET}`).toString('base64')}`
            }
        });
        console.log('Successfully obtained authentication token.');
        return response.data.access_token;
    } catch (error) {
        console.error('Error fetching auth token:', error.response ? error.response.data : error.message);
        throw new Error('Authentication failed.');
    }
};

const fetchAllOpportunities = async (token) => {
    let allOpportunities = [];
    let hasMore = true;
    let offset = 0;

    console.log(`Fetching opportunities updated between ${START_DATE} and ${END_DATE}...`);

    while (hasMore) {
        const params = {
            q: `LastUpdateDate between '${START_DATE}' and '${END_DATE}'`,
            onlyData: true,
            limit: PAGE_LIMIT,
            offset: offset,
            fields: 'OptyId,CreationDate,LastUpdateDate,Name,SalesStage,StatusCode,RevnAmount,OwnerResourcePartyId,PrimaryContactPartyName,LossReasonCode,LeadId,OrganizationName,OptyNumber,OwnerName'
        };

        try {
            const response = await axios.get(opportunitiesUrl, { headers: { Authorization: `Bearer ${token}` }, params });
            const opportunities = response.data.items;
            if (opportunities && opportunities.length > 0) {
                allOpportunities.push(...opportunities);
                offset += opportunities.length;
                console.log(`Fetched ${opportunities.length} opportunities, total so far: ${allOpportunities.length}`);
            } else {
                 hasMore = false;
            }
            hasMore = response.data.hasMore;
        } catch (error) {
            console.error(`Error fetching opportunities at offset ${offset}:`, error.response ? error.response.data : error.message);
            hasMore = false; // Stop on error
        }
    }
    return allOpportunities;
};

const fetchQuotesForOpportunity = async (token, optyId) => {
    const quotesUrl = `${opportunitiesUrl}/${optyId}/child/Quote`;
    try {
        const response = await axios.get(quotesUrl, {
            headers: { Authorization: `Bearer ${token}` },
            params: { fields: 'QuoteId,CreationDate,LastUpdateDate,QuoteStatus,QuoteNumber', onlyData: true }
        });
        return response.data.items;
    } catch (error) {
        console.error(`Error fetching quotes for opportunity ${optyId}:`, error.response ? error.response.data : error.message);
        return [];
    }
};

const transformToEventLog = async (token, opportunities) => {
    const eventLog = [];
    const now = new Date().toISOString();

    for (const opp of opportunities) {
        const commonAttributes = {
            SalesOpportunity: opp.OptyNumber,
            SourceSystem: 'Oracle CX Sales',
            LastDataUpdate: now,
            OpportunityValue: opp.RevnAmount,
            SalesStage: opp.SalesStage,
            OpportunityOwner: opp.OwnerName,
            Region: opp.OrganizationName, // Example mapping, adjust as needed
            LossReason: opp.LossReasonCode
        };

        // Activity: Lead Converted To Opportunity
        if (opp.LeadId) {
            eventLog.push({ ...commonAttributes, ActivityName: 'Lead Converted To Opportunity', EventTime: opp.CreationDate });
        }
        
        // Inferred stage-based activities. Using LastUpdateDate as proxy.
        // A more accurate method requires audit trail data which is more complex to extract.
        const stageNumber = parseInt(opp.SalesStage?.split('-')[0], 10);
        if (stageNumber >= 2) {
             eventLog.push({ ...commonAttributes, ActivityName: 'Opportunity Qualified', EventTime: opp.LastUpdateDate });
        }
        if (stageNumber >= 3) {
             eventLog.push({ ...commonAttributes, ActivityName: 'Needs Analysis Completed', EventTime: opp.LastUpdateDate });
        }
        if (stageNumber >= 4) {
             eventLog.push({ ...commonAttributes, ActivityName: 'Solution Proposed', EventTime: opp.LastUpdateDate });
        }

        // Fetch and process quotes
        const quotes = await fetchQuotesForOpportunity(token, opp.OptyId);
        let quoteCreationCount = 0;
        for (const quote of quotes) {
            quoteCreationCount++;
            // Activity: Quote Created
            eventLog.push({ ...commonAttributes, ActivityName: 'Quote Created', EventTime: quote.CreationDate });
            // Activity: Quote Reworked (inferred from second or later quote creation)
            if (quoteCreationCount > 1) {
                 eventLog.push({ ...commonAttributes, ActivityName: 'Quote Reworked', EventTime: quote.CreationDate });
            }
            // Activity: Quote Sent To Customer
            if (['PRESENTED', 'SENT'].includes(quote.QuoteStatus)) {
                 eventLog.push({ ...commonAttributes, ActivityName: 'Quote Sent To Customer', EventTime: quote.LastUpdateDate });
            }
            // Activity: Quote Accepted By Customer
            if (quote.QuoteStatus === 'ACCEPTED') {
                 eventLog.push({ ...commonAttributes, ActivityName: 'Quote Accepted By Customer', EventTime: quote.LastUpdateDate });
            }
        }

        // Final Opportunity Status activities
        if (opp.StatusCode === 'WON') {
            eventLog.push({ ...commonAttributes, ActivityName: 'Opportunity Won', EventTime: opp.LastUpdateDate });
            // Activity: Order Submitted For Fulfillment (inferred from Opportunity Won)
            eventLog.push({ ...commonAttributes, ActivityName: 'Order Submitted For Fulfillment', EventTime: opp.LastUpdateDate });
            
            // Placeholder for events from external systems. Data should be merged from other sources.
            // eventLog.push({ ...commonAttributes, ActivityName: 'Order Fulfilled', EventTime: [Timestamp from ERP] });
            // eventLog.push({ ...commonAttributes, ActivityName: 'Invoice Generated', EventTime: [Timestamp from Financials] });
            // eventLog.push({ ...commonAttributes, ActivityName: 'Payment Received', EventTime: [Timestamp from Financials] });

        } else if (opp.StatusCode === 'LOST') {
            eventLog.push({ ...commonAttributes, ActivityName: 'Opportunity Lost', EventTime: opp.LastUpdateDate });
        }
    }
    return eventLog;
};

const main = async () => {
    try {
        const token = await getAuthToken();
        const opportunities = await fetchAllOpportunities(token);
        console.log(`Total opportunities to process: ${opportunities.length}`);

        if (opportunities.length > 0) {
            console.log('Transforming data into event log...');
            const eventLog = await transformToEventLog(token, opportunities);
            console.log(`Generated ${eventLog.length} event records.`);
            
            const parser = new Parser();
            const csv = parser.parse(eventLog);
            fs.writeFileSync('oracle_cx_sales_event_log.csv', csv);
            console.log('Event log saved to oracle_cx_sales_event_log.csv');
        }
    } catch (error) {
        console.error('An error occurred during the extraction process:', error.message);
    }
};

main();

ステップ

Python環境を準備：システムにPythonがインストールされていることを確認します。pipを使って必要なライブラリをインストールします：pip install requests pandas。
API認証情報を取得：管理者アカウントでOracle CX Salesにログインします。Security Console（Navigator > Tools > Security Console）に移動し、「Sales Representative」またはカスタム統合ロールを持つ新しいユーザーを作成します。このユーザーには、salesLeads、opportunities、quotesおよび関連オブジェクトへのAPIアクセス権が必要です。ユーザー名とパスワードを控えます。
Oracle CXドメインを特定：固有のOracle CX SalesドメインURLを確認します。通常はhttps://[your-pod-name].fa.em2.oraclecloud.comの形式です。
スクリプトを設定：提供されているPythonスクリプトをエディターで開きます。ORACLE_CX_DOMAIN、USERNAME、PASSWORD、START_DATE、END_DATEのプレースホルダーを、実際の認証情報と抽出対象の日付範囲に置き換えます。
APIエンドポイントとフィールドをカスタマイズ：スクリプト内のAPI呼び出しを確認します。要求されるフィールド（例：OptyId、名前、SalesStage、StatusCode）は標準フィールドです。分析に重要なカスタムフィールド（接尾辞_c）がある場合は、該当するAPIリクエストのfieldsパラメーターに追加します。
外部システム連携を実装：スクリプトには、Oracle CX Salesの外部で発生するアクティビティ用に、プレースホルダー関数（get_order_data_from_erp、get_invoice_data_from_finance、get_payment_data_from_finance）が含まれています。これらのプレースホルダーの処理を、ERPおよび財務システムの実際のAPI呼び出しに置き換え、「Order Submitted」、「Order Fulfilled」、「Invoice Generated」、「Payment Received」イベントのデータを取得します。リードから入金までの全体像を把握するには、この連携が欠かせません。
スクリプトを実行：コマンドラインでpython your_script_name.pyを実行します。スクリプトがOracle CX Salesに対して一連のAPI呼び出しを行い、データを処理して1つのイベントログにまとめます。
出力を確認：スクリプトによってlead_to_cash_event_log.csvというファイルが生成されます。スプレッドシートアプリケーションで開き、構造と内容を確認します。SalesOpportunity、ActivityName、EventTime、SourceSystemなど、想定される列が含まれていることを確認します。
APIのページネーションを処理：提供されているスクリプトには基本的なページネーションループが含まれています。非常に大規模なデータセットでは、APIのレート制限に達しないよう、より詳細なエラー処理やリクエスト間の短い待機時間を追加する必要がある場合があります。
アップロードの準備：最終CSVファイルはProcessMindに直接アップロードできる構造になっています。列見出しがProcessMindプロジェクトのマッピングと一致していることを確認します。通常、追加の書式設定は必要ありません。

設定

API認証情報：Sales Lead、Sales Opportunity、Quoteオブジェクトを読み取るために十分な権限を持つ専用APIユーザーが必要です。ステータスやステージの変更に関する履歴データまたは監査証跡へのアクセスも必要です。
Oracle CXドメイン：Oracle CX SalesインスタンスのベースURLをスクリプトに正しく指定する必要があります。
期間：スクリプトのSTART_DATEとEND_DATE変数で抽出期間を指定します。データ量とパフォーマンスのバランスを取るため、初回の分析では3～6か月の期間を推奨します。
商談のフィルター：特定の条件で商談を絞り込むよう、スクリプトをカスタマイズできます。たとえば、API URLにクエリパラメーターを追加し、Organization_Idやカスタムフィールドで事業部門や商談タイプを限定できます。
外部システムのエンドポイント：ERPと財務システムから注文、請求書、入金のデータを抽出するには、実際のAPIエンドポイント、認証情報、処理ロジックを用意する必要があります。スクリプトでは、Sales Opportunity IDまたは関連するOrder IDを使ってこれらのシステムを関連付けられることを前提としています。
ページネーションの上限：API呼び出しのlimitパラメーターは100に設定されています。変更できますが、値を大きくすると複雑なクエリでタイムアウトが発生するリスクが高まります。

a サンプルクエリ python

import requests
import pandas as pd
from requests.auth import HTTPBasicAuth
import datetime

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
class=class="hl-string">"hl-comment"># Replace with your Oracle CX Sales domain, username, and password
ORACLE_CX_DOMAIN = class="hl-string">"https://[your-pod-name].fa.em2.oraclecloud.com"
USERNAME = class="hl-string">"[Your_API_Username]"
PASSWORD = class="hl-string">"[Your_API_Password]"

class=class="hl-string">"hl-comment"># Define the date range for the extraction (YYYY-MM-DD format)
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-12-31"

class=class="hl-string">"hl-comment"># --- Helper Function for API Calls ---
def fetch_all_pages(endpoint, q_filter):
    all_items = []
    url = fclass="hl-string">"{ORACLE_CX_DOMAIN}/salesApi/resources/latest/{endpoint}"
    params = {
        class="hl-string">'q': q_filter,
        class="hl-string">'onlyData': class="hl-string">'true',
        class="hl-string">'limit': 100, class=class="hl-string">"hl-comment"># Max records per page
        class="hl-string">'offset': 0
    }
    
    while True:
        try:
            response = requests.get(url, auth=HTTPBasicAuth(USERNAME, PASSWORD), params=params)
            response.raise_for_status()
            data = response.json()
            items = data.get(class="hl-string">'items', [])
            if not items:
                break
            all_items.extend(items)
            if data.get(class="hl-string">'hasMore', False):
                params[class="hl-string">'offset'] += params[class="hl-string">'limit']
            else:
                break
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching {url}: {e}")
            break
    return all_items

class=class="hl-string">"hl-comment"># --- Placeholder Functions for External Systems ---
def get_order_data_from_erp(opportunity_ids):
    class=class="hl-string">"hl-comment"># CRITICAL: Replace this with actual API calls to your ERP system.
    class=class="hl-string">"hl-comment"># This function should return a list of dictionaries.
    class=class="hl-string">"hl-comment"># Each dictionary should have class="hl-string">'OptyId', class="hl-string">'EventTime', class="hl-string">'ActivityName'.
    print(class="hl-string">"Fetching placeholder Order data from ERP...")
    placeholder_data = []
    class=class="hl-string">"hl-comment"># Example: placeholder_data.append({class="hl-string">'OptyId': 12345, class="hl-string">'EventTime': class="hl-string">'2023-10-25T10:00:00Z', class="hl-string">'ActivityName': class="hl-string">'Order Submitted For Fulfillment'})
    class=class="hl-string">"hl-comment"># Example: placeholder_data.append({class="hl-string">'OptyId': 12345, class="hl-string">'EventTime': class="hl-string">'2023-10-28T14:00:00Z', class="hl-string">'ActivityName': class="hl-string">'Order Fulfilled'})
    return placeholder_data

def get_invoice_data_from_finance(opportunity_ids):
    class=class="hl-string">"hl-comment"># CRITICAL: Replace this with actual API calls to your financial system.
    print(class="hl-string">"Fetching placeholder Invoice data...")
    return [] class=class="hl-string">"hl-comment"># Example: [{class="hl-string">'OptyId': 12345, class="hl-string">'EventTime': class="hl-string">'2023-10-29T11:00:00Z', class="hl-string">'ActivityName': class="hl-string">'Invoice Generated'}]

def get_payment_data_from_finance(opportunity_ids):
    class=class="hl-string">"hl-comment"># CRITICAL: Replace this with actual API calls to your financial system.
    print(class="hl-string">"Fetching placeholder Payment data...")
    return [] class=class="hl-string">"hl-comment"># Example: [{class="hl-string">'OptyId': 12345, class="hl-string">'EventTime': class="hl-string">'2023-11-15T09:30:00Z', class="hl-string">'ActivityName': class="hl-string">'Payment Received'}]


class=class="hl-string">"hl-comment"># --- Main Extraction Logic ---
print(class="hl-string">"Starting Lead to Cash extraction...")

class=class="hl-string">"hl-comment"># 1. Fetch all relevant opportunities within the date range
date_filter = fclass="hl-string">"LastUpdateDate between '{START_DATE}' and '{END_DATE}'"
opportunities = fetch_all_pages(class="hl-string">'opportunities', date_filter)

if not opportunities:
    print(class="hl-string">"No opportunities found for the given date range. Exiting.")
    exit()

print(fclass="hl-string">"Found {len(opportunities)} opportunities to process.")
opp_ids = [opp[class="hl-string">'OptyId'] for opp in opportunities]

class=class="hl-string">"hl-comment"># DataFrame to hold all events
event_log_df = pd.DataFrame()

class=class="hl-string">"hl-comment"># 2. Extract activities from Opportunity and related objects
all_events = []

for opp in opportunities:
    opp_id = opp[class="hl-string">'OptyId']
    last_update = datetime.datetime.now().isoformat()

    base_attributes = {
        class="hl-string">'SalesOpportunity': opp_id,
        class="hl-string">'OpportunityValue': opp.get(class="hl-string">'Revenue'),
        class="hl-string">'SalesStage': opp.get(class="hl-string">'SalesStage'),
        class="hl-string">'OpportunityOwner': opp.get(class="hl-string">'OwnerResourcePartyName'),
        class="hl-string">'Region': opp.get(class="hl-string">'TerritoryName_c'), class=class="hl-string">"hl-comment"># Example custom field
        class="hl-string">'LossReason': opp.get(class="hl-string">'ReasonWonLostCode'),
        class="hl-string">'SourceSystem': class="hl-string">'Oracle CX Sales',
        class="hl-string">'LastDataUpdate': last_update
    }
    
    class=class="hl-string">"hl-comment"># Activity: Lead Converted To Opportunity (inference)
    if opp.get(class="hl-string">'PrimaryContactEmailAddress') and opp.get(class="hl-string">'SalesMethod') != class="hl-string">'Renewal': class=class="hl-string">"hl-comment"># Heuristic for lead-based opportunities
        all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Lead Converted To Opportunity', class="hl-string">'EventTime': opp.get(class="hl-string">'CreationDate')})
        
    class=class="hl-string">"hl-comment"># Activities from Sales Stage history
    stage_history = opp.get(class="hl-string">'ChildSalesStage', [])
    for stage in stage_history:
        stage_name = stage.get(class="hl-string">'SalesStageCode')
        event_time = stage.get(class="hl-string">'LastUpdateDate')
        activity = None
        if stage_name in [class="hl-string">'01-QUALIFICATION', class="hl-string">'QUALIFIED']: activity = class="hl-string">'Opportunity Qualified'
        elif stage_name in [class="hl-string">'02-DISCOVERY', class="hl-string">'ANALYSIS']: activity = class="hl-string">'Needs Analysis Completed'
        elif stage_name in [class="hl-string">'03-PROPOSAL', class="hl-string">'SOLUTION_PROPOSED']: activity = class="hl-string">'Solution Proposed'
        
        if activity:
            all_events.append({**base_attributes, class="hl-string">'ActivityName': activity, class="hl-string">'EventTime': event_time})

    class=class="hl-string">"hl-comment"># Activities: Opportunity Won / Lost
    if opp.get(class="hl-string">'StatusCode') == class="hl-string">'WON':
        all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Opportunity Won', class="hl-string">'EventTime': opp.get(class="hl-string">'LastUpdateDate')})
    elif opp.get(class="hl-string">'StatusCode') == class="hl-string">'LOST':
        all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Opportunity Lost', class="hl-string">'EventTime': opp.get(class="hl-string">'LastUpdateDate')})

    class=class="hl-string">"hl-comment"># Activities from Quotes
    quotes = opp.get(class="hl-string">'ChildQuote', [])
    quote_creation_dates = []
    for quote in quotes:
        quote_creation_dates.append(quote.get(class="hl-string">'CreationDate'))
        all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Quote Created', class="hl-string">'EventTime': quote.get(class="hl-string">'CreationDate')})
        
        class=class="hl-string">"hl-comment"># Infer other quote events from status or custom date fields
        if quote.get(class="hl-string">'QuoteStatus_c') == class="hl-string">'SENT' and quote.get(class="hl-string">'DateSent_c'):
            all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Quote Sent To Customer', class="hl-string">'EventTime': quote.get(class="hl-string">'DateSent_c')})
        if quote.get(class="hl-string">'QuoteStatus_c') == class="hl-string">'ACCEPTED' and quote.get(class="hl-string">'DateAccepted_c'):
            all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Quote Accepted By Customer', class="hl-string">'EventTime': quote.get(class="hl-string">'DateAccepted_c')})
    
    class=class="hl-string">"hl-comment"># Activity: Quote Reworked (inference)
    if len(quote_creation_dates) > 1:
        class=class="hl-string">"hl-comment"># Mark all but the first creation as a rework event
        sorted_dates = sorted(quote_creation_dates)
        for rework_date in sorted_dates[1:]:
            all_events.append({**base_attributes, class="hl-string">'ActivityName': class="hl-string">'Quote Reworked', class="hl-string">'EventTime': rework_date})

class=class="hl-string">"hl-comment"># 3. Add data from external systems
print(class="hl-string">"Fetching data from external systems...")
order_events = get_order_data_from_erp(opp_ids)
invoice_events = get_invoice_data_from_finance(opp_ids)
payment_events = get_payment_data_from_finance(opp_ids)

external_system_events = []
last_update = datetime.datetime.now().isoformat()

for event in order_events + invoice_events + payment_events:
    opp_id = event[class="hl-string">'OptyId']
    class=class="hl-string">"hl-comment"># Find the corresponding opportunity to get base attributes
    opp_data = next((item for item in opportunities if item[class="hl-string">"OptyId"] == opp_id), None)
    if opp_data:
         base_attributes = {
            class="hl-string">'SalesOpportunity': opp_id,
            class="hl-string">'OpportunityValue': opp_data.get(class="hl-string">'Revenue'),
            class="hl-string">'SalesStage': opp_data.get(class="hl-string">'SalesStage'),
            class="hl-string">'OpportunityOwner': opp_data.get(class="hl-string">'OwnerResourcePartyName'),
            class="hl-string">'Region': opp_data.get(class="hl-string">'TerritoryName_c'),
            class="hl-string">'LossReason': opp_data.get(class="hl-string">'ReasonWonLostCode'),
            class="hl-string">'SourceSystem': class="hl-string">'ERP/Finance',
            class="hl-string">'LastDataUpdate': last_update
        }
    else:
        base_attributes = {class="hl-string">'SalesOpportunity': opp_id, class="hl-string">'SourceSystem': class="hl-string">'ERP/Finance', class="hl-string">'LastDataUpdate': last_update}
    
    external_system_events.append({**base_attributes, class="hl-string">'ActivityName': event[class="hl-string">'ActivityName'], class="hl-string">'EventTime': event[class="hl-string">'EventTime']})

all_events.extend(external_system_events)

class=class="hl-string">"hl-comment"># 4. Finalize the DataFrame
if all_events:
    event_log_df = pd.DataFrame(all_events)
    class=class="hl-string">"hl-comment"># Standardize column names
    event_log_df = event_log_df.rename(columns={class="hl-string">'ActivityName': class="hl-string">'ActivityName', class="hl-string">'EventTime': class="hl-string">'EventTime'})
    
    class=class="hl-string">"hl-comment"># Ensure required columns exist
    required_cols = [class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate', class="hl-string">'OpportunityValue', class="hl-string">'SalesStage', class="hl-string">'OpportunityOwner', class="hl-string">'Region', class="hl-string">'LossReason']
    for col in required_cols:
        if col not in event_log_df.columns:
            event_log_df[col] = None
            
    class=class="hl-string">"hl-comment"># Select and order columns
    event_log_df = event_log_df[required_cols]
    
    class=class="hl-string">"hl-comment"># Clean up and sort
    event_log_df = event_log_df.dropna(subset=[class="hl-string">'SalesOpportunity', class="hl-string">'ActivityName', class="hl-string">'EventTime'])
    event_log_df[class="hl-string">'EventTime'] = pd.to_datetime(event_log_df[class="hl-string">'EventTime'])
    event_log_df = event_log_df.sort_values(by=[class="hl-string">'SalesOpportunity', class="hl-string">'EventTime'])
    
    class=class="hl-string">"hl-comment"># Save to CSV
    output_filename = class="hl-string">'lead_to_cash_event_log.csv'
    event_log_df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%S.%fZ')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")
else:
    print(class="hl-string">"No events were generated.")

準備はできましたか？

このテンプレートを使ってデータを確実に準備し、リードから入金までのプロセスに隠れている改善機会を見つけ出してください。今すぐ業務を最適化し、効率を高めましょう。

改善ガイドに戻るテンプレートをダウンロード

リードから入金までの成約率を今すぐ20％向上

ボトルネックを特定し、失注を減らして、成約率を20％高めます。

無料トライアルを開始

クレジットカードは不要です。数分で設定できます。

リードから入金までのデータテンプレート

リードから入金までのデータテンプレート

リードから入金までの属性

リードから入金までのアクティビティ

抽出ガイド

Oracle CX Sales REST APIによる直接クエリ抽出

ステップ

設定

a サンプルクエリ javascript

Oracle CX Sales REST APIを使ったPythonスクリプト

ステップ

設定

a サンプルクエリ python

準備はできましたか？

リードから入金までの成約率を今すぐ20％向上

リードから入金までのデータテンプレート

リードから入金までのデータテンプレート

リードから入金までの属性

リードから入金までのアクティビティ

抽出ガイド

Oracle CX Sales REST APIによる直接クエリ抽出

ステップ

設定

a サンプルクエリ javascript

Oracle CX Sales REST APIを使ったPythonスクリプト

ステップ

設定

a サンプルクエリ python

準備はできましたか？

リードから入金までの成約率を今すぐ20％向上

プライバシーを大切にしています