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

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

HubSpot CRM

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

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

このテンプレートでは、リードから入金までのプロセスを分析するために必要なデータの収集方法を詳しく説明します。ソースシステムから抽出する必要がある属性とアクティビティを示しています。この手順に沿って準備することで、プロセスマイニングに適したデータを用意できます。

収集を推奨する属性
追跡すべき主要なアクティビティ
HubSpot CRM向けの抽出手順

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

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

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

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

5 必須 7 推奨 8 任意

	名前	説明
	営業案件 SalesOpportunityId	営業案件を一意に識別するIDで、リードから入金までのプロセスにおけるケース識別子として機能します。
説明 Sales Opportunity IDは、営業案件の作成から、成約または失注による終了まで、見込み取引を追跡します。プロセスマイニングでは、この識別子によって、電話、ミーティング、見積もり、支払いなど、関連するすべてのアクティビティを1つのエンドツーエンドのプロセスインスタンスに紐づけます。 Sales Opportunityに基づいてプロセスを分析すると、営業活動全体の流れを把握できます。共通する経路、ボトルネック、逸脱を特定し、営業案件ごとの対応方法や、成果につながる要因を明確にできます。重要な理由営業ライフサイクルのすべてのイベントをつなぐ中核識別子です。取引ごとに、エンドツーエンドのリードから入金までのプロセスを分析できます。入手先 HubSpot CRM APIのDealオブジェクトにある`dealId`プロパティです。例 987654321087654321097654321098
	アクティビティ ActivityName	リードから入金までのプロセス内で発生した、特定のイベントまたはタスクの名称です。
説明 Activity Nameは、「Opportunity Created」「Quote Issued」「Payment Received」など、プロセス内の工程を示します。HubSpotに記録されたさまざまなイベントやステータス変更から抽出されます。この属性は、アクティビティの順序を視覚的に表すプロセスマップを作成するための基本項目です。アクティビティの流れを分析すると、プロセスのばらつき、ループ、ボトルネックを特定し、対象を絞った改善施策につなげられます。重要な理由プロセスマップ上の工程を定義する項目であり、プロセスマイニング分析の基盤です。明確なアクティビティがなければ、プロセスの流れを可視化して分析することはできません。入手先 HubSpot内のさまざまな情報源から取得します。Dealステージの変更（例：「Opportunity Qualified」）、タスクの種類、通話結果、QuoteやInvoiceなどの関連オブジェクトが含まれます。例営業案件の作成見積もりの発行契約締結入金
	イベント時刻 EventTime	アクティビティまたはイベントが発生した時点を示すタイムスタンプです。
説明 Event Timeは、プロセス内の各アクティビティについて正確な日付と時刻を示し、イベントの時系列を定めます。このタイムスタンプは、サイクルタイム、所要時間、工程間の待ち時間を計算するために欠かせません。分析では、この属性を使ってプロセスのパフォーマンスを把握し、遅延を特定し、処理量を測定します。営業から入金までのサイクル全体で時間がどのように使われているかを詳細に分析するための、時間軸の基盤となります。重要な理由イベントの時系列を示す項目です。サイクルタイムなどのパフォーマンス指標を計算し、プロセスの遅延を特定するうえで欠かせません。入手先タイムスタンプはアクティビティに応じてさまざまなプロパティから取得します。取引の作成には`createdate`、取引のクローズには`closedate`、タスク、通話、メールにはそれぞれのタイムスタンプを使用します。例 2023-04-15T10:00:00Z2023-05-20T14:30:00Z2023-06-01T09:15:00Z
	ソースシステム SourceSystem	データを抽出した記録元のシステムです。
説明プロセスデータの取得元を示す属性です。リードから入金までのプロセスでは通常HubSpot CRMですが、請求や支払いのアクティビティについては、連携された財務システムのデータが含まれる場合もあります。複数のプラットフォームからデータを統合する環境では、ソースシステムの指定が重要です。データガバナンス、データ品質の問題の調査、プロセスを支えるシステム構成の把握に役立ちます。重要な理由データの取得元に関する重要な背景情報を提供します。データガバナンスや、複数の連携システムにまたがる分析に欠かせません。入手先データ変換の際に追加する固定値「HubSpot CRM」です。例 HubSpot CRM
	最終データ更新 LastDataUpdate	ソースシステムからデータが最後に更新された時点を示すタイムスタンプです。
説明データセットが最後に更新された時点を記録する属性です。分析対象データの鮮度を明確にし、関係者がデータの最新性を把握できるようにします。ダッシュボードや継続的なモニタリングで特に役立ちます。プロセス分析の結果がどの時点の情報に基づくものかを確認でき、最近のパフォーマンス変化と古い情報を区別できます。重要な理由データの鮮度を示します。分析やダッシュボードを最新の情報に基づいて作成するために重要です。入手先この値は、データの抽出または更新のたびに生成され、データセットに記録されます。例 2024-07-21T02:00:00Z
	リードソース LeadSource	リードを獲得した最初の流入元またはチャネルです。
説明リードソースは、見込み顧客が最初に会社と接点を持った経路を示します。たとえば、「Webinar」、「Trade Show」、「Organic Search」などです。さまざまなマーケティングチャネルの効果を評価するために欠かせない情報です。「Lead to Opportunity Conversion Rates」ダッシュボードに欠かせない属性です。リードソース別に成約率や営業サイクル時間を分析すると、マーケティングチームと営業チームは、最も価値の高い営業案件を生み出すチャネルを把握し、マーケティング費用を適切に配分できます。重要な理由異なる流入元から生じた営業案件の成約率や品質を分析し、マーケティングチャネルの効果を測定できます。入手先通常は最初のContactオブジェクトに保存され、Dealオブジェクトのカスタムプロパティにコピーされる場合があります。一般的なプロパティは`hs_analytics_source`です。例オーガニック検索有料ソーシャル紹介展示会
	商談担当者 OpportunityOwner	営業案件を担当し、その責任を負う営業担当者です。
説明商談担当者は、営業パイプラインで商談を進める際の主な連絡先であり、責任者です。通常は、その営業案件を作成した、または割り当てられた営業担当者を指します。商談担当者別にプロセスを分析すると、個人およびチームのパフォーマンスを評価できます。営業担当者間の営業戦略、アクティビティ量、成約率の違いを明らかにし、コーチングやリソース管理に役立つ情報を得られます。重要な理由この属性はパフォーマンス分析に欠かせません。営業担当者ごとの営業サイクル時間、成約率、プロセスのコンプライアンスを比較できます。入手先これはDealオブジェクトの`hubspot_owner_id`プロパティに対応します。担当者名はOwners APIから結合して取得する必要があります。例 Jane DoeJohn SmithEmily Jones
	営業ステージ SalesStage	営業案件がパイプライン上で現在または過去にいたステージです。
説明営業ステージは、定義された営業プロセスに沿って商談が進む状況を示します。「Qualified」、「Proposal Presented」、「Contract Sent」などのステージがあります。このステージの変更は、プロセスログの主要なアクティビティを生成するためによく使われます。この属性は、営業案件の進捗を分析し、ボトルネックを特定するうえで重要です。各ステージにかかった時間や、ステージ間の成約率を追跡できます。これは「Opportunity Stage Progression Metrics」ダッシュボードの基礎となります。重要な理由営業案件が営業ファネルのどの位置にあるかを把握できるため、パイプラインの進行速度やステージごとのボトルネックを分析できます。入手先これはDealオブジェクトの`dealstage`プロパティです。ステージのIDが格納されており、ステージ名にマッピングする必要があります。例アポイントメント設定済み購入見込みありプレゼンテーション設定済み契約書送付済み
	営業案件のクローズ日 OpportunityCloseDate	営業案件が成約または失注としてクローズした日付です。
説明営業案件のクローズ日は、商談の営業プロセスが完了した日を示します。商談のステージが「Closed Won」または「Closed Lost」に移行した時点で設定されます。このタイムスタンプは、作成からクローズまでの営業サイクル全体の時間を計算するために欠かせません。ケースの終了時刻として使われ、「Average Sales Cycle Time」などのパフォーマンスKPIで営業プロセスの効率を測定する際にも利用されます。重要な理由営業案件の営業サイクルの終了を示すため、サイクル全体の時間の計算や営業の進行速度の測定に欠かせません。入手先 HubSpot CRM APIのDealオブジェクトにある`closedate`プロパティです。例 2023-07-10T17:00:00Z2023-08-15T11:20:00Z2023-09-05T16:45:00Z
	営業案件の結果 OpportunityOutcome	営業案件の最終結果で、成約か失注かを示します。
説明この属性は、商談の最終ステータスを示します。通常は最終営業ステージから導出され、「Closed Won」または「Closed Lost」に分類されます。結果別にプロセスマップを分けて分析すると、成約した商談と失注した商談のプロセスフローを直接比較できます。成功または失敗に関連するパターン、アクティビティ、遅延を明らかにできるため、プロセス改善や営業コーチングに役立ちます。重要な理由成功したプロセスインスタンスと成功しなかったプロセスインスタンスを比較分析し、成約に結び付くプロセス上の行動を明らかにできます。入手先 `dealstage`プロパティから導出されます。HubSpotのステージは「Open」、「Closed Won」、「Closed Lost」として定義されており、最終ステージの種類によって結果が決まります。例受注失注
	営業案件金額 OpportunityAmount	営業案件の見込み金額または実際の金銭的価値です。
説明この属性には商談の金額が記録されます。初期段階では見積金額、成約時には最終的な契約金額となる場合があります。営業プロセスが財務に与える影響を把握するための基本的な指標です。営業案件金額でプロセスを分けて分析すると、大型商談が異なるプロセスをたどるのか、成約までにより長い時間がかかるのかを確認できます。財務予測や高額な営業案件の優先順位付けにも欠かせません。重要な理由営業パイプラインを財務面から分析し、高額な商談を優先するとともに、商談規模がプロセスの進み方に与える影響を把握できます。入手先 HubSpot CRM APIのDealオブジェクトにある`amount`プロパティです。例 50000.0012500.50250000.00
	地域 Region	営業案件に関連付けられた地理的な地域またはテリトリーです。
説明地域は、営業案件が属する地理的な市場を示します。顧客の所在地や営業チームに割り当てられたテリトリーに基づく場合があります。HubSpotでは、カスタムプロパティとして設定されることがよくあります。この属性を使うと、地域ごとに営業プロセスを比較できます。地域によるパフォーマンス、プロセスのコンプライアンス、顧客行動の違いを明らかにできるため、「Regional Sales Process Variants」ダッシュボードや、市場ごとの営業戦略の調整に役立ちます。重要な理由地理的に異なる市場間でプロセスのパフォーマンスや違いを比較し、地域戦略や標準化の取り組みを支援できます。入手先通常はCompanyオブジェクトまたはDealオブジェクトのカスタムプロパティです。正確なフィールド名は、対象となるHubSpot環境で確認する必要があります。例北米EMEAAPACLATAM
	停滞中かどうか IsStalled	オープンな営業案件が現在のステージで長期間アクティビティを停止しているかを示すフラグです。
説明この属性はブール型のフラグです。営業案件があらかじめ定めた期間内に新しいステージへ進まなかった場合にtrueになります。「停滞」の定義（たとえば「Proposal」ステージに30日を超えて留まっている場合）は、業務ルールに基づきます。このフラグにより、介入が必要なリスクの高い商談を早期に特定できます。「Stalled Opportunity Rate」KPIの中心的な指標であり、勢いを失いつつある営業案件に営業マネージャーが集中するのに役立ちます。重要な理由進展していないリスクの高い営業案件を早期に特定し、商談を失う前に営業マネージャーが介入できます。入手先現在の日付、商談が現在のステージに入った日付（`hs_lastmodifieddate`）、および各ステージの停滞期間を定める業務ルールに基づく計算フィールドです。例 truefalse
	割引率 DiscountPercentage	営業案件に適用された割引率です。割引がない場合もあります。
説明この属性には、商談総額に対する顧客への割引率が記録されます。通常は、見積書の作成時または最終交渉の段階で記録されます。割引率の分析は、「Discounting Effectiveness Analysis」ダッシュボードの基礎となります。割引が成約率や営業サイクル時間に与える影響を把握し、特定の営業担当者や地域で過度な割引が行われていないかを確認できます。過度な割引は収益性に影響する可能性があります。重要な理由価格戦略が営業成果や収益性に与える影響を分析し、割引を適切に運用するために欠かせません。入手先通常はDealオブジェクトまたはQuoteオブジェクトのカスタムプロパティです。HubSpotのDealには標準の割引フィールドがないため、明細項目から計算される場合もあります。例 0.050.100.150.20
	営業チーム SalesTeam	営業案件の担当者が所属するチームです。
説明営業チームは、営業案件の担当者を、地域、製品分野、市場セグメントなどに基づいてグループ化します。これにより、集計したパフォーマンス分析が可能になります。チーム単位で分析すると、マネージャーはチームの効果を評価し、戦略を比較して、リソースを配分できます。個人の担当者単位の分析よりも高い視点で、プロセス実行における全体的な傾向を把握できます。重要な理由チームのパフォーマンスを集計して分析できるため、マネージャーが営業チーム間でプロセスの実行状況や結果を比較する際に役立ちます。入手先 `team_id`はOwnerオブジェクトのプロパティです。チーム名はTeams APIとの結合によって取得する必要があります。例エンタープライズ営業：東部SMB営業：西部ミッドマーケット営業：中央部
	支払いサイクル時間 PaymentCycleTime	請求書を送付してから入金を受け取るまでの時間です。
説明支払いサイクル時間は、売掛金回収プロセスの効率を測定します。「Payment Received」アクティビティのタイムスタンプと「Invoice Generated」アクティビティのタイムスタンプの差として計算されます。「Average Payment Collection Time」KPIやキャッシュフローの分析に欠かせない指標です。入金回収プロセスのボトルネックを特定し、顧客別または支払条件別に分析して改善機会を見つけられます。重要な理由入金回収プロセスの効率を測定します。健全なキャッシュフローを維持するために重要です。入手先計算フィールド：「Payment Received」アクティビティのタイムスタンプ－「Invoice Generated」アクティビティのタイムスタンプ。元のタイムスタンプは、連携された財務システムから取得します。例 28日45日10日
	支払条件 PaymentTerms	Net 30やNet 60など、合意された支払い条件です。
説明支払条件は、顧客が商品やサービスの代金を支払う際の条件を定めたものです。通常は契約締結の段階で決定されます。この属性は「Payment Cycle Time Analysis」に重要です。合意された条件と実際の支払い状況を比較すると、継続的に支払いが遅れる顧客や、回収サイクルの長期化に関連する支払条件を特定できます。重要な理由支払いサイクルを分析する際の基準となり、想定された支払い期間と実際の遅延を区別できます。入手先通常はDealオブジェクトまたはQuoteオブジェクトのカスタムプロパティ、あるいは連携された会計システムから取得します。例 30日払い60日払い受領時払い
	製品ファミリー ProductFamily	営業案件に含まれる製品のカテゴリーまたはファミリーです。
説明製品ファミリーは、販売する製品またはサービスの種類に基づいて商談を分類します。通常は、商談に関連付けられた明細項目から判定されます。この属性により、製品カテゴリーごとに営業プロセスを分析できます。製品によっては営業サイクルが長く、より複雑になる場合があります。この分類によって違いを明らかにし、製品に合わせた営業プロセスや、より正確な予測につなげられます。重要な理由製品ファミリー別にプロセスを分けると、製品の種類によって営業サイクルやプロセス経路が異なるかを確認でき、製品ごとの戦略立案に役立ちます。入手先 Dealに関連付けられたLine Itemsから導出します。製品をファミリーに分類するロジックが必要です。例ソフトウェアライセンスプロフェッショナルサービスハードウェアサポートサブスクリプション
	請求書番号 InvoiceNumber	営業注文に対して発行された請求書の一意の識別子です。
説明請求書番号は、顧客に送付した請求書を参照するための番号です。通常は注文の履行後に発行され、入金回収プロセスの重要な段階を示します。 HubSpotは主に請求処理を行うシステムではありませんが、このデータはリードから入金までの最終段階を追跡するために重要です。営業案件と財務取引を結び付け、営業から財務への引き継ぎや「Invoice to Revenue Realization Time」KPIを分析できます。重要な理由営業プロセスと入金回収プロセスを結び付け、営業から財務への引き継ぎの効率を分析できます。入手先通常は、連携された会計システムまたはERPシステム（NetSuite、QuickBooksなど）から取得し、カスタムオブジェクトまたはプロパティを介してHubSpotのDealに関連付けます。例 INV-2023-00123INV-2023-00456INV-2023-00789
	顧客名 CustomerName	営業案件に関連付けられた会社または組織の名前です。
説明顧客名は、商談の顧客または見込み顧客を示します。この情報は通常、HubSpotの関連付けられたCompanyオブジェクトに保存されます。顧客別にプロセスを分析すると、支払いサイクルが長い、独自の営業プロセスがあるなど、特定の顧客に固有のパターンを特定できます。主要アカウント管理や、顧客セグメントごとのプロセスの状況を把握する際に特に役立ちます。重要な理由顧客を中心とした分析が可能になり、特定の顧客や業界に固有のプロセスパターンや問題を特定できます。入手先 Dealに関連付けられたCompanyオブジェクトから取得されます。通常、Companyオブジェクトのプロパティ`名前`です。例 Global Tech Inc.Innovate Solutions Ltd.Enterprise Corp

必須推奨任意

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

リードから入金までのフローを正確にプロセスディスカバリーするため、イベントログに記録すべき主要なプロセス手順と重要なマイルストーンです。

7 推奨 7 任意

	アクティビティ	説明
	入金	顧客からの支払いを受領し、照合が完了した時点で、リードから入金までのサイクルの最終工程となります。通常は外部の会計システムで追跡し、HubSpotに同期します。
重要な理由収益実現における最終イベントです。「Average Payment Collection Time」と「End-to-End Lead to Cash Cycle Time」の計算に欠かせません。入手先財務システムから同期された「Payment Date」などのカスタムプロパティの更新、または専用パイプラインでの手動ステージ変更から推定します。取得連携によって更新されたカスタムの「Payment Date」プロパティのタイムスタンプです。イベントタイプ inferred
	営業案件の作成	営業案件のライフサイクルにおける最初のイベントで、HubSpotに新しい取引レコードが作成されたことを示します。ユーザーが手動で取引を作成した場合や、ワークフローまたは連携によって自動作成された場合に、このイベントが明示的に記録されます。
重要な理由このアクティビティは、営業案件の営業サイクルが正式に始まったことを示します。営業サイクル全体の所要時間と、リードから営業案件への転換速度を計算する際の基準となるタイムスタンプです。入手先自動的に記録されます。タイムスタンプは、Dealオブジェクトの標準プロパティ「Create Date」で確認できます。取得 Dealレコードの「Create Date」プロパティです。イベントタイプ explicit
	営業案件の失注	取引が正式に失注し、クローズされたことを示す最終的な失敗イベントです。ユーザーが取引を「Closed Lost」ステージに移動した時点で、標準イベントとして明示的に記録されます。
重要な理由取引をいつ、なぜ失注したかを分析することは、プロセス改善に欠かせません。このイベントは、失注案件の営業サイクル所要時間を計算する終点になります。入手先「Deal Stage」が「Lost」カテゴリーのいずれかのステージに設定された時点で、標準の「Close Date」プロパティに記録されるタイムスタンプです。「Closed Lost Reason」プロパティから背景を確認できます。取得失注した取引のDealに記録された「Close Date」プロパティです。イベントタイプ explicit
	営業案件の成約	取引が正式に成約し、クローズされたことを示す最終的な成功イベントです。ユーザーが取引を「Closed Won」ステージに移動した時点で、HubSpotに標準イベントとして明示的に記録されます。
重要な理由営業案件が成功したことを示すアクティビティで、営業サイクルの所要時間や成約率を測定する際の重要な終点です。後続の履行や請求プロセスが開始されることもあります。入手先「Deal Stage」が「Won」カテゴリーのいずれかのステージに設定された時点で、標準の「Close Date」プロパティに記録されるタイムスタンプです。取得成約した取引のDealに記録された「Close Date」プロパティです。イベントタイプ explicit
	営業案件の適格性確認	営業チームが営業案件の適格性を確認し、予算、決裁権、ニーズ、時期などの条件を満たしていると判断した時点を示します。通常は、営業パイプラインで取引が「Qualified」などの特定ステージに移動したことから推定します。
重要な理由営業パイプラインの質を把握するうえで重要なマイルストーンです。適格性確認までの時間を分析すると、営業プロセスの初期段階にある効率上の課題を特定できます。入手先 Dealオブジェクトの「Deal Stage」フィールドの変更履歴から推定します。具体的には、「Qualified to Buy」などのステージに入った時点のタイムスタンプを使用します。取得 Deal Stageが指定した「Qualified」ステージに変更された時点のタイムスタンプです。イベントタイプ inferred
	契約締結	顧客が契約書に署名し、商取引上の合意が最終確定したことを示します。HubSpotでは、見積もりの承諾後に取引が「Contract Sent」または「Closed Won」ステージへ移動した時点で記録されることが多いイベントです。
重要な理由履行が始まる前の、商取引上の最終的な合意を示すマイルストーンです。「Quote to Contract Cycle Time」KPIの計算に欠かせません。入手先 Deal Stageプロパティが「Contract Signed」または同等のステージに変更された時点のタイムスタンプから推定できます。見積もりに電子署名を使用する場合は、「Quote Accepted」と同じ意味になることがあります。取得 Deal Stageが「Contract Signed」または同等のステージに変更された時点のタイムスタンプです。イベントタイプ inferred
	見積もりの発行	正式な価格見積もりを作成し、顧客に送付したことを示します。HubSpotのSales Hubには専用のQuotesツールがあり、取引に対する見積もりが作成され公開された時点で、このイベントが明示的に記録されます。
重要な理由商談の具体化を示す重要なマイルストーンです。適格性確認から見積もり発行までの時間を分析することは、「Quote to Contract Process Flow」の分析に欠かせません。入手先 Dealに紐づくQuoteオブジェクトの作成時刻です。Quoteオブジェクトの「hs_createdate」プロパティを使用します。取得紐づくQuoteオブジェクトの作成日です。イベントタイプ explicit
	ソリューションの提案	正式なソリューションまたは製品デモを顧客に提示した時点を示します。通常は、Deal Stageが「Presentation Scheduled」や「Demo Completed」などのステータスに変更されたことから推定します。
重要な理由営業ファネルの中盤における重要なマイルストーンです。この時点までにかかった時間を測定すると、営業サイクルのソリューション提案段階の効率を分析できます。入手先取引のプロパティ変更履歴で、Deal Stageが「Presentation Scheduled」などの該当ステージに変更された時点のタイムスタンプから推定します。取得 Deal Stageが「Presentation」または「Proposal」ステージに変更された時点のタイムスタンプです。イベントタイプ inferred
	初回コンタクト	取引に紐づくコンタクトとの最初の記録済みのやり取りを示します。電話、メール、ミーティングなどが該当します。HubSpotのDealレコードに紐づくアクティビティタイムラインに明示的に記録されます。
重要な理由作成から初回コンタクトまでの時間を追跡すると、営業チームの対応の速さを測定できます。最初のコンタクト方法を分析することで、成約した取引に共通する傾向も把握できます。入手先 Dealオブジェクトの作成日以降に記録された、最初のアクティビティ（電話、メール、ミーティングなど）のタイムスタンプです。取得 Dealのタイムラインに記録された最初のアクティビティのタイムスタンプです。イベントタイプ explicit
	営業注文の作成	営業チームから履行またはオペレーションチームへの社内引き継ぎを示します。通常、HubSpot固有のイベントではなく、取引が「Order Processing」や「Pending Fulfillment」などの特定のパイプラインステージに移動したことから推定します。
重要な理由営業からオペレーションへの引き継ぎの効率を分析するうえで重要なアクティビティです。ここでの遅延は、顧客満足度や納期に影響する可能性があります。入手先「Deal Stage」フィールドのプロパティ変更履歴から推定し、販売後のステージに入った時点のタイムスタンプを記録します。取得 Deal Stageが「Order Processing」ステージに変更された時点のタイムスタンプです。イベントタイプ inferred
	注文の履行完了	顧客への製品の納品またはサービス提供が完了したことを示します。通常はHubSpot外で発生し、連携によって記録されるか、Deal Stageを「Service Delivered」または「Order Complete」に手動で更新することで記録されます。
重要な理由納品工程が完了したことを示します。「Order Fulfillment to Invoice Time」KPIの測定開始点です。入手先 ERPまたは履行システムとの連携、または手動更新が必要です。取引が「Fulfilled」などのステージに入った時点のタイムスタンプから推定できます。取得外部システムからのステータス変更、または手動によるステージ変更のタイムスタンプです。イベントタイプ inferred
	要件の収集	ディスカバリーコールまたはミーティングが行われ、顧客のニーズが記録されたことを示します。通常は、営業パイプラインで取引が「Discovery」や「Needs Analysis」などの特定ステージに進んだことから推定します。
重要な理由このマイルストーンを追跡すると、営業チームが適格性確認から顧客ニーズの把握まで、どの程度の速さで進めているかを評価できます。ここでの遅延は、日程調整の問題やリソース不足を示している可能性があります。入手先「Deal Stage」フィールドのプロパティ変更履歴から推定し、取引が「Requirements Gathering」などのステージに入った時点のタイムスタンプを記録します。取得 Deal Stageがニーズ分析を示すステージに変更された時点のタイムスタンプです。イベントタイプ inferred
	見積もりの承諾	顧客が見積もりを正式に承諾した時点で発生します。多くの場合、電子署名によって行われます。HubSpotの電子署名機能で送付した見積もりに顧客が署名した時点で、明示的に記録されます。
重要な理由顧客が条件と価格に同意したことを示す、重要な購買シグナルです。見積もりの発行から承諾までの時間は、交渉サイクルの所要時間を分析するうえで重要です。入手先 Quoteオブジェクトの「hs_quote_accepted_date」プロパティ、または見積もりに紐づく電子署名ログの完了時刻です。取得 Quoteの「hs_quote_accepted_date」プロパティに記録されたタイムスタンプです。イベントタイプ explicit
	請求書の作成	会計システムで顧客向け請求書が作成されたことを示します。HubSpot Sales Hub固有のアクティビティではなく、連携によって取引のカスタムプロパティまたはステージが更新された時点で記録します。
重要な理由キャッシュコンバージョンサイクルにおける重要な工程です。履行完了から請求書作成までの時間は、サービスの請求を開始できるまでの速さに直接影響します。入手先 QuickBooksやXeroなどの会計システムとの連携が必要です。カスタムプロパティのタイムスタンプまたは取引のステージ変更からイベントを推定します。取得「Invoice Generated Date」などのカスタム日付プロパティに記録されたタイムスタンプです。イベントタイプ inferred

推奨任意

抽出ガイド

HubSpot CRMからデータを取得する方法

ステップ

前提条件：HubSpot Private Appを作成
- スーパー管理者権限でHubSpotアカウントにログインします。
- Settings > Integrations > Private Appsに移動し、「Create a new private app」をクリックします。
- Basic Infoタブで、アプリ名を「ProcessMind Extraction」などに設定します。
- Scopesタブに移動します。必要なCRMオブジェクトへの読み取り権限を付与します。次のスコープを選択します：crm.objects.deals.read、crm.objects.contacts.read、crm.objects.engagements.read、crm.objects.quotes.read、crm.objects.owners.read。
- アプリを作成したら、生成されたアクセストークンをコピーします。このトークンは、PythonスクリプトがAPIで認証するために必要です。
Python環境を設定
- Python 3.6以降がシステムにインストールされていることを確認します。
- 新しいプロジェクトディレクトリを作成し、仮想環境を設定します。
- ターミナルで次のコマンドを実行し、必要なPythonライブラリをインストールします：pip install requests pandas。
Pythonスクリプトを設定
- 提供されたPythonスクリプトを、たとえばextract_hubspot_log.pyというファイル名で保存します。
- スクリプトを開き、先頭の設定セクションにあるプレースホルダーを置き換えます。HubSpotのACCESS_TOKEN、抽出期間のSTART_DATE、END_DATEを指定してください。
取引ステージをアクティビティに対応付け
- HubSpotの取引ステージIDを、標準のプロセスマイニングアクティビティに対応付けることが重要です。スクリプト内でPIPELINE_STAGE_MAPPING辞書を探します。
- 営業パイプライン内の各取引ステージの内部IDを確認します。これらのIDは、Pipelinesエンドポイント（/crm/v3/pipelines/deals）へのAPI呼び出し、またはHubSpotの画面で取引ステージを編集するときのURLから確認できます。
- ステージIDをキー、対応するアクティビティ名を値として辞書を更新します。たとえば、「Qualified」ステージのIDが「12345」の場合、エントリは'12345': 'Opportunity Qualified'となります。
抽出スクリプトを実行
- ターミナルまたはコマンドプロンプトを開き、スクリプトを保存したディレクトリに移動します。
- 次のコマンドでスクリプトを実行します：python extract_hubspot_log.py。
- スクリプトがHubSpot APIからデータの取得を開始します。処理した取引数がコンソールに表示されます。
- 大規模なデータセットではAPIのレート制限により時間がかかる場合があるため、完了までお待ちください。
出力ファイルを確認
- スクリプトが完了すると、同じディレクトリにhubspot_event_log.csvというCSVファイルが生成されます。
- このファイルには、指定したすべてのアクティビティと属性を含むイベントログが格納されます。
アップロードの準備
- スプレッドシートソフトでhubspot_event_log.csvを開き、データが想定どおりか確認します。
- ファイルには必要な列（SalesOpportunityId、ActivityName、EventTimeなど）がすでに設定されており、そのままProcessMindにアップロードできます。

設定

HubSpot Private App Token：認証には、HubSpot Private Appの有効なアクセストークンが必要です。アプリには、Deals、Contacts、Engagements、Quotes、Ownersへの読み取り権限が必要です。
日付範囲：スクリプトではSTART_DATEとEND_DATEの変数を設定します。抽出時間とAPIの使用量を抑えるため、まずは3～6か月など、短い期間から始めることをお勧めします。日付形式はYYYY-MM-DDで指定します。
パイプラインステージのマッピング：「Opportunity Qualified」や「Requirements Gathered」など、ステージに基づくアクティビティの正確性は、PIPELINE_STAGE_MAPPING辞書に完全に依存します。この設定には、HubSpotにおける組織の営業パイプラインのステージを正確に反映させる必要があります。
APIのレート制限：HubSpot APIにはレート制限があります（例：Professionalプランでは10秒あたり100リクエスト）。スクリプトにはこれに対応する基本的なtime.sleep()の仕組みが含まれていますが、下位プランで非常に大規模なデータセットを扱う場合は、より慎重な間隔に調整する必要があります。
カスタムプロパティ：HubSpotの環境で、地域などの属性や「Invoice Generated」などのアクティビティを追跡するためにカスタムプロパティを使用している場合は、取得できるよう、スクリプトのdeal_propertiesリストにそれらのプロパティ名を追加する必要があります。

a サンプルクエリ python

import requests
import pandas as pd
import datetime
import time
import os

class=class="hl-string">"hl-comment"># --- CONFIGURATION SECTION --- #
class=class="hl-string">"hl-comment"># 1. HubSpot Private App Access Token
ACCESS_TOKEN = class="hl-string">"YOUR_HUBSPOT_ACCESS_TOKEN" class=class="hl-string">"hl-comment"># Replace with your token

class=class="hl-string">"hl-comment"># 2. Date range for the extraction
START_DATE = class="hl-string">"2023-01-01" class=class="hl-string">"hl-comment"># Format: YYYY-MM-DD
END_DATE = class="hl-string">"2023-12-31" class=class="hl-string">"hl-comment"># Format: YYYY-MM-DD

class=class="hl-string">"hl-comment"># 3. Critical: Map your Deal Stage IDs to Process Mining Activities
class=class="hl-string">"hl-comment"># You must find your internal HubSpot stage IDs and map them here.
class=class="hl-string">"hl-comment"># Example: class="hl-string">'123456': class="hl-string">'Opportunity Qualified'
PIPELINE_STAGE_MAPPING = {
    class="hl-string">'[Your Qualified Stage ID]': class="hl-string">'Opportunity Qualified',
    class="hl-string">'[Your Discovery Stage ID]': class="hl-string">'Requirements Gathered',
    class="hl-string">'[Your Presentation Stage ID]': class="hl-string">'Solution Proposed',
    class="hl-string">'[Your Contract Sent Stage ID]': class="hl-string">'Contract Signed',
    class="hl-string">'[Your Order Processing Stage ID]': class="hl-string">'Sales Order Created',
    class="hl-string">'[Your Order Fulfilled Stage ID]': class="hl-string">'Order Fulfilled',
    class="hl-string">'[Your Invoice Sent Stage ID]': class="hl-string">'Invoice Generated',
    class="hl-string">'[Your Payment Received Stage ID]': class="hl-string">'Payment Received',
    class=class="hl-string">"hl-comment"># Standard closed won/lost stages are handled separately by their internal names
    class="hl-string">'closedwon': class="hl-string">'Opportunity Closed Won',
    class="hl-string">'closedlost': class="hl-string">'Opportunity Closed Lost'
}
class=class="hl-string">"hl-comment"># --- END CONFIGURATION SECTION --- #

API_BASE_URL = class="hl-string">"https://api.hubapi.com"
AUTH_HEADER = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {ACCESS_TOKEN}'}

def fetch_paginated_data(url, params=None, body=None):
    class="hl-string">"""Helper function to handle paginated API responses."""
    results = []
    after = None
    while True:
        if body:
            if after:
                body[class="hl-string">'after'] = after
            response = requests.post(url, headers=AUTH_HEADER, json=body)
        else:
            if after:
                params[class="hl-string">'after'] = after
            response = requests.get(url, headers=AUTH_HEADER, params=params)
        
        if response.status_code == 429:
            print(class="hl-string">"Rate limit hit, sleeping for 10 seconds...")
            time.sleep(10)
            continue
        
        response.raise_for_status() class=class="hl-string">"hl-comment"># Raise an exception for bad status codes
        data = response.json()
        results.extend(data.get(class="hl-string">'results', []))
        
        paging = data.get(class="hl-string">'paging')
        if paging and paging.get(class="hl-string">'next'):
            after = paging[class="hl-string">'next'][class="hl-string">'after']
        else:
            break
    return results

def format_timestamp(ts_string):
    class="hl-string">"""Converts HubSpot timestamps to ISO 8601 format."""
    if not ts_string:
        return None
    return pd.to_datetime(ts_string).isoformat()


def main():
    print(class="hl-string">"Starting HubSpot data extraction...")
    event_log = []
    last_data_update = datetime.datetime.now(datetime.timezone.utc).isoformat()

    class=class="hl-string">"hl-comment"># 1. Fetch all deals within the date range
    print(class="hl-string">"Fetching deals...")
    deal_properties = [
        class="hl-string">'dealname', class="hl-string">'createdate', class="hl-string">'dealstage', class="hl-string">'amount', 
        class="hl-string">'closedate', class="hl-string">'dealownerid', class="hl-string">'hs_lead_source', class="hl-string">'region', class="hl-string">'pipeline'
    ]
    search_body = {
        class="hl-string">'filterGroups': [{
            class="hl-string">'filters': [{
                class="hl-string">'propertyName': class="hl-string">'createdate',
                class="hl-string">'operator': class="hl-string">'BETWEEN',
                class="hl-string">'highValue': int(datetime.datetime.strptime(END_DATE, class="hl-string">'%Y-%m-%d').timestamp() * 1000),
                class="hl-string">'value': int(datetime.datetime.strptime(START_DATE, class="hl-string">'%Y-%m-%d').timestamp() * 1000)
            }]
        }],
        class="hl-string">'properties': deal_properties,
        class="hl-string">'limit': 100
    }
    all_deals = fetch_paginated_data(fclass="hl-string">"{API_BASE_URL}/crm/v3/objects/deals/search", body=search_body)
    print(fclass="hl-string">"Found {len(all_deals)} deals.")

    class=class="hl-string">"hl-comment"># Fetch owners for mapping
    owners_map = {owner[class="hl-string">'id']: fclass="hl-string">"{owner['firstName']} {owner['lastName']}" for owner in fetch_paginated_data(fclass="hl-string">"{API_BASE_URL}/crm/v3/owners/")}

    class=class="hl-string">"hl-comment"># 2. Process each deal to create events
    for i, deal in enumerate(all_deals):
        print(fclass="hl-string">"Processing deal {i+1}/{len(all_deals)}: {deal['id']}")
        deal_id = deal[class="hl-string">'id']
        props = deal.get(class="hl-string">'properties', {})
        
        base_event = {
            class="hl-string">'SalesOpportunityId': deal_id,
            class="hl-string">'SourceSystem': class="hl-string">'HubSpot CRM',
            class="hl-string">'LastDataUpdate': last_data_update,
            class="hl-string">'OpportunityAmount': props.get(class="hl-string">'amount'),
            class="hl-string">'OpportunityCloseDate': format_timestamp(props.get(class="hl-string">'closedate')),
            class="hl-string">'LeadSource': props.get(class="hl-string">'hs_lead_source'),
            class="hl-string">'Region': props.get(class="hl-string">'region'),
            class="hl-string">'OpportunityOwner': owners_map.get(props.get(class="hl-string">'dealownerid'))
        }

        class=class="hl-string">"hl-comment"># Activity: Opportunity Created
        event_log.append({
            **base_event,
            class="hl-string">'ActivityName': class="hl-string">'Opportunity Created',
            class="hl-string">'EventTime': format_timestamp(props.get(class="hl-string">'createdate')),
            class="hl-string">'SalesStage': class="hl-string">'Created',
            class="hl-string">'OpportunityOutcome': None
        })

        class=class="hl-string">"hl-comment"># Activities from Stage History
        try:
            stage_history_url = fclass="hl-string">"{API_BASE_URL}/crm/v3/objects/deals/{deal_id}?properties=dealstage&archived=false"
            history_response = requests.get(stage_history_url, headers=AUTH_HEADER)
            history_response.raise_for_status()
            history_data = history_response.json()
            for version in history_data.get(class="hl-string">'propertiesWithHistory', {}).get(class="hl-string">'dealstage', []):
                stage_id = version[class="hl-string">'value']
                if stage_id in PIPELINE_STAGE_MAPPING:
                    event_log.append({
                        **base_event,
                        class="hl-string">'ActivityName': PIPELINE_STAGE_MAPPING[stage_id],
                        class="hl-string">'EventTime': format_timestamp(version[class="hl-string">'timestamp']),
                        class="hl-string">'SalesStage': stage_id,
                        class="hl-string">'OpportunityOutcome': None
                    })
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Could not fetch stage history for deal {deal_id}: {e}")
        
        class=class="hl-string">"hl-comment"># Activities: Closed Won / Closed Lost
        final_stage = props.get(class="hl-string">'dealstage')
        if final_stage in [class="hl-string">'closedwon', class="hl-string">'closedlost']:
             event_log.append({
                **base_event,
                class="hl-string">'ActivityName': PIPELINE_STAGE_MAPPING[final_stage],
                class="hl-string">'EventTime': format_timestamp(props.get(class="hl-string">'closedate')),
                class="hl-string">'SalesStage': class="hl-string">'Closed',
                class="hl-string">'OpportunityOutcome': class="hl-string">'Won' if final_stage == class="hl-string">'closedwon' else class="hl-string">'Lost'
            })

        class=class="hl-string">"hl-comment"># Activities from Associated Objects (Engagements, Quotes)
        try:
            class=class="hl-string">"hl-comment"># Engagements for class="hl-string">'Initial Contact Made'
            assoc_engagements_url = fclass="hl-string">"{API_BASE_URL}/crm/v3/objects/deals/{deal_id}/associations/engagements"
            engagements = fetch_paginated_data(assoc_engagements_url)
            if engagements:
                first_engagement_time = None
                for engagement_assoc in engagements:
                    eng_id = engagement_assoc[class="hl-string">'id']
                    eng_details_url = fclass="hl-string">"{API_BASE_URL}/crm/v3/objects/engagements/{eng_id}?properties=hs_timestamp"
                    eng_res = requests.get(eng_details_url, headers=AUTH_HEADER)
                    if eng_res.ok:
                        eng_ts = eng_res.json()[class="hl-string">'properties'][class="hl-string">'hs_timestamp']
                        if not first_engagement_time or eng_ts < first_engagement_time:
                            first_engagement_time = eng_ts
                if first_engagement_time:
                    event_log.append({
                        **base_event,
                        class="hl-string">'ActivityName': class="hl-string">'Initial Contact Made',
                        class="hl-string">'EventTime': format_timestamp(first_engagement_time),
                        class="hl-string">'SalesStage': props.get(class="hl-string">'dealstage'),
                        class="hl-string">'OpportunityOutcome': None
                    })

            class=class="hl-string">"hl-comment"># Quotes for class="hl-string">'Quote Issued' and class="hl-string">'Quote Accepted'
            assoc_quotes_url = fclass="hl-string">"{API_BASE_URL}/crm/v3/objects/deals/{deal_id}/associations/quotes"
            quotes = fetch_paginated_data(assoc_quotes_url)
            for quote_assoc in quotes:
                quote_id = quote_assoc[class="hl-string">'id']
                quote_details_url = fclass="hl-string">"{API_BASE_URL}/crm/v3/objects/quotes/{quote_id}?properties=hs_createdate,hs_quote_status,hs_acceptance_date"
                quote_res = requests.get(quote_details_url, headers=AUTH_HEADER)
                if quote_res.ok:
                    quote_props = quote_res.json()[class="hl-string">'properties']
                    event_log.append({
                        **base_event,
                        class="hl-string">'ActivityName': class="hl-string">'Quote Issued',
                        class="hl-string">'EventTime': format_timestamp(quote_props[class="hl-string">'hs_createdate']),
                        class="hl-string">'SalesStage': props.get(class="hl-string">'dealstage'),
                        class="hl-string">'OpportunityOutcome': None
                    })
                    if quote_props.get(class="hl-string">'hs_quote_status') == class="hl-string">'SIGNED' and quote_props.get(class="hl-string">'hs_acceptance_date'):
                        event_log.append({
                            **base_event,
                            class="hl-string">'ActivityName': class="hl-string">'Quote Accepted',
                            class="hl-string">'EventTime': format_timestamp(quote_props[class="hl-string">'hs_acceptance_date']),
                            class="hl-string">'SalesStage': props.get(class="hl-string">'dealstage'),
                            class="hl-string">'OpportunityOutcome': None
                        })
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Could not fetch associations for deal {deal_id}: {e}")

    class=class="hl-string">"hl-comment"># 3. Create DataFrame and export to CSV
    print(class="hl-string">"Finalizing event log...")
    df = pd.DataFrame(event_log)
    df = df.dropna(subset=[class="hl-string">'EventTime'])
    df = df.sort_values(by=[class="hl-string">'SalesOpportunityId', class="hl-string">'EventTime'], ascending=[True, True])
    
    class=class="hl-string">"hl-comment"># Reorder and select final columns
    final_columns = [
        class="hl-string">'SalesOpportunityId', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate',
        class="hl-string">'OpportunityOwner', class="hl-string">'SalesStage', class="hl-string">'OpportunityAmount', class="hl-string">'OpportunityCloseDate',
        class="hl-string">'OpportunityOutcome', class="hl-string">'Region', class="hl-string">'LeadSource'
    ]
    df = df[final_columns]

    output_filename = class="hl-string">'hubspot_event_log.csv'
    df.to_csv(output_filename, index=False)
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")

if __name__ == class="hl-string">"__main__":
    main()

ステップ

前提条件：HubSpot Private Appを作成
- HubSpotポータルでSettings > Integrations > Private Appsに移動します。
- 新しいPrivate Appを作成します。アプリ名はProcessMind_Extractionなど、用途が分かる名前にします。
- 「Scopes」タブで、次の読み取り権限を付与します：crm.objects.deals.read、crm.objects.quotes.read、crm.objects.owners.read。
- アクセストークンを生成します。このトークンはAPI認証に使用するため、安全にコピーして保管します。
APIクライアントを設定
- Postman、Insomnia、またはPythonなどのスクリプト言語（requestsライブラリを使用）でHubSpot GraphQL APIに接続します。
- GraphQL APIのエンドポイントはhttps://api.hubapi.com/graphql/v1です。
APIリクエストを設定
- APIエンドポイントに新しいPOSTリクエストを作成します。
- リクエストヘッダーにAuthorizationヘッダーを追加し、値にBearer YOUR_PRIVATE_APP_TOKENを設定します。YOUR_PRIVATE_APP_TOKENは生成したトークンに置き換えてください。
- Content-Typeヘッダーをapplication/jsonに設定します。
GraphQLクエリを準備
- POSTリクエストの本文に、GraphQLクエリを含むJSONペイロードを記述します。
- 提供されているクエリでは、取引、ステージ履歴、関連する見積、コミュニケーションアクティビティを取得します。
- クエリ変数のstartTimestampとendTimestampに値を設定し、抽出期間を指定します（例：2023-01-01T00:00:00Z）。
クエリを実行してページネーションを処理
- リクエストを送信します。APIは最大100件の取引を1回の応答で返します。
- 応答にはpaging.next.afterカーソルが含まれます。この値がある場合は、afterの値を変数として渡してクエリを再実行し、次のページを取得します。
- 指定した期間のすべての取引を取得するまで、この処理をループで繰り返します。paging.next.afterカーソルがNULLになれば完了です。
JSON応答をイベントログに変換
- APIはネストされたJSON構造を返します。この応答を解析し、表形式のイベントログに変換するスクリプトを作成します。返された各取引オブジェクトについて、次の処理を行います。
- イベント1：Opportunity Created：1行作成します。ActivityNameは「Opportunity Created」、EventTimeは取引のcreatedateです。
- イベント2：Initial Contact Made：関連するすべてのCall、Email、Meetingから最も早いhs_created_dateを特定します。この日時で1行作成します。アクティビティがない場合、このイベントは作成しません。
- イベント3～12：ステージに基づくアクティビティ：dealstageのproperties_with_history配列を順に処理します。各エントリについて、ステージ名をアクティビティ名（「Opportunity Qualified」「Solution Proposed」など）に対応付け、updated_atをEventTimeとする行を作成します。この対応関係は、実際の営業パイプラインに合わせて定義してください。
- イベント13、14：見積アクティビティ：関連するquote_collectionを順に処理します。見積のcreatedateを使って「Quote Issued」の行を作成します。hs_quote_accepted_dateが存在する場合は、その日時を使って「Quote Accepted」の行を作成します。
- イベント15、16：クローズステータス：dealstage履歴の最後のエントリは、「Opportunity Closed Won」または「Opportunity Closed Lost」に対応します。この履歴エントリのupdated_atをEventTimeに使用します。取引のclosedateプロパティを使用することもできます。
属性をマッピング
- 前の手順で作成した各行に、必須属性と推奨属性を入力します。
  - SalesOpportunityId：hs_object_id
  - SalesStage：対応するdealstage履歴エントリのvalue
  - OpportunityOwner：dealowner.email
  - OpportunityAmount：amount
  - OpportunityCloseDate：closedate
  - その他の属性は、取引の主要プロパティから入力できます。
固定列と最終列を追加
- SourceSystem列に固定値「HubSpot CRM」を入力します。
- LastDataUpdate列に、抽出スクリプトを実行した日時を入力します。
CSVにエクスポート
- 変換後の表形式データをCSVファイルとして保存します。タイムスタンプはISO 8601など、一貫した形式にしてください。このファイルをProcessMindにアップロードできます。

設定

Private App Scopes：HubSpot Private Appには、最低限、次のスコープに対する読み取りアクセス権が必要です：crm.objects.deals.read、crm.objects.quotes.read、crm.objects.owners.read。
GraphQL Query Variables：このクエリでは、フィルタリング用の変数が必要です。取引の作成日に基づいて抽出期間を指定するため、startTimestampとendTimestampを設定してください。まずは、過去6～12か月分のデータから始めることをおすすめします。
Custom Property Placeholders：クエリには、[your_lead_source_property]や[your_region_property]などのプレースホルダーが含まれています。これらを、HubSpot環境で使用しているカスタム取引プロパティの実際の内部名に置き換えてください。
Sales Stage Mapping：「Opportunity Qualified」や「Solution Proposed」などのアクティビティを抽出するには、HubSpotの取引ステージとの論理的なマッピングが必要です。この業務ロジックを変換スクリプトで設定してください。
Pagination：APIのlimitは、1回のリクエストにつき最大100件です。すべてのデータを取得できるよう、afterカーソルを使ったページネーションに対応する抽出スクリプトを設計してください。
API Rate Limits：大量のデータを抽出する場合は、HubSpotのAPIレート制限に注意してください。信頼性の高いスクリプトには、エラー処理に加えて、必要に応じたバックオフと再試行のロジックを組み込むことをおすすめします。

a サンプルクエリ graphql

query getLeadToCashData($after: String, $startTimestamp: DateTime!, $endTimestamp: DateTime!) {
  CRM {
    deal_collection(
      limit: 100
      after: $after
      filter: {
        createdate: { gte: $startTimestamp, lte: $endTimestamp }
      }
    ) {
      items {
        hs_object_id
        createdate
        closedate
        amount
        dealstage
        hs_is_closed_won
        properties_with_history(properties: ["dealstage"]) {
          ... on PropertyValuesWithHistoryDealDealstage {
            values {
              value
              source
              source_id
              updated_at
            }
          }
        }
        associations {
          quote_collection__deal_to_quote(limit: 100) {
            items {
              hs_object_id
              createdate
              hs_quote_accepted_date
              hs_status
            }
          }
          call_collection__deal_to_call(limit: 100, sort: [{ propertyName: "hs_created_date", direction: ASC }]) {
            items {
              hs_created_date
            }
          }
          email_collection__deal_to_email(limit: 100, sort: [{ propertyName: "hs_created_date", direction: ASC }]) {
            items {
              hs_created_date
            }
          }
          meeting_collection__deal_to_meeting(limit: 100, sort: [{ propertyName: "hs_created_date", direction: ASC }]) {
            items {
              hs_created_date
            }
          }
        }
        dealowner {
          email
        }
        properties {
          your_lead_source_property: [your_lead_source_property]
          your_region_property: [your_region_property]
        }
      }
      paging {
        next {
          after
        }
      }
    }
  }
}

準備はできましたか？

このテンプレートでデータを準備し、リードから入金までのプロセスを最大限に改善します。今すぐ効率化と収益向上への取り組みを始めましょう。

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

成果を20％増やす：今すぐリードから入金までをマスター

当社のプラットフォームで長期化した営業サイクルを解消し、成約率を20％高めます。

無料トライアルを開始

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

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

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

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

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

抽出ガイド

HubSpot REST APIを使ったカスタムPythonスクリプト

ステップ

設定

a サンプルクエリ python

HubSpot GraphQL APIを使った対象データの抽出

ステップ

設定

a サンプルクエリ graphql

準備はできましたか？

成果を20％増やす：今すぐリードから入金までをマスター

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

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

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

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

抽出ガイド

HubSpot REST APIを使ったカスタムPythonスクリプト

ステップ

設定

a サンプルクエリ python

HubSpot GraphQL APIを使った対象データの抽出

ステップ

設定

a サンプルクエリ graphql

準備はできましたか？

成果を20％増やす：今すぐリードから入金までをマスター

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