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

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

Name: リードから入金までのプロセスマイニング用データテンプレート
Creator: ProcessMind
License: https://creativecommons.org/licenses/by/4.0/

HubSpot CRM

← 改善ガイドに戻る

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

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

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

収集を推奨する属性
追跡する主なアクティビティ
HubSpot CRMに合わせたデータ抽出ガイド

イベントログを初めて作成する方はこちら：プロセスマイニング用イベントログの作成方法.

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

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

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

5 必須 7 推奨 8 任意

	名前	説明
	営業機会 SalesOpportunityId	営業機会を一意に識別するIDで、リードから入金までのプロセスにおけるケースIDとして使われます。
説明営業機会IDは、取引の作成から受注または失注による終了までを追跡します。プロセスマイニングでは、このIDを使って電話、ミーティング、見積もり、入金などの関連アクティビティを1つのエンドツーエンドのプロセスインスタンスに紐づけます。営業機会を基準にプロセスを分析すると、営業活動の全体像を把握できます。よくある経路、ボトルネック、逸脱を特定し、営業機会ごとの対応状況や、成果につながる要因を明らかにできます。重要な理由営業ライフサイクルのすべてのイベントを紐づける基本の識別子です。取引ごとに、リードから入金までのプロセス全体を分析できます。入手先 HubSpot CRM APIの取引オブジェクトにある「dealId」プロパティです。例 987654321087654321097654321098
	アクティビティ ActivityName	リードから入金までのプロセスで発生した、特定のイベントまたはタスクの名前。
説明アクティビティ名は、「営業機会の作成」「見積もりの発行」「入金の確認」など、プロセス内のステップを表します。HubSpotに記録されたさまざまなイベントやステータス変更から抽出されます。この属性は、アクティビティの順序を視覚的に示すプロセスマップの作成に欠かせません。アクティビティの流れを分析すると、プロセスの違い、ループ、ボトルネックを特定し、対象を絞った改善に取り組めます。重要な理由プロセスマップの各ステップを定義する属性であり、プロセスマイニング分析の基盤です。アクティビティを明確に区別できなければ、プロセスフローを可視化して分析することはできません。入手先 HubSpot内のさまざまな情報源から取得します。「営業機会の適格性確認」などの取引ステージの変更、タスクの種類、通話結果、見積もりや請求書などの関連オブジェクトが含まれます。例営業機会の作成見積もりの発行契約の締結入金の確認
	イベント時刻 EventTime	アクティビティまたはイベントが発生した日時を示すタイムスタンプ。
説明イベント時刻は、プロセス内の各アクティビティが発生した正確な日時を示し、イベントの時系列を明らかにします。このタイムスタンプは、サイクルタイム、所要時間、各ステップ間の待ち時間の算出に欠かせません。分析では、プロセスのパフォーマンスの把握、遅延の特定、処理量の測定に使います。営業から入金までの各段階で時間がどのように使われているかを詳しく分析するための、時間軸の基盤となります。重要な理由イベントの時系列を示す属性です。サイクルタイムなどのパフォーマンス指標の算出や、プロセスの遅延の特定に欠かせません。入手先タイムスタンプの取得元はアクティビティによって異なります。取引の作成には「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	リードを獲得した最初の流入元またはチャネルです。
説明リードソースは、見込み顧客が最初に企業と接点を持った経路を示します。たとえば、「ウェビナー」「展示会」「自然検索」などです。この情報は、マーケティングチャネルごとの効果を評価するうえで欠かせません。この属性は「リードから商談への転換率」ダッシュボードに必要です。リードソース別に転換率や営業サイクルの期間を分析すると、どのチャネルから価値の高い商談が生まれているかをマーケティングチームと営業チームが把握し、マーケティング予算の配分を見直せます。重要な理由流入元ごとの転換率や商談の質を分析し、マーケティングチャネルの効果を測定できます。入手先通常、最初のContactオブジェクトに保存され、Dealオブジェクトのカスタムプロパティにコピーされる場合もあります。よく使われるプロパティは`hs_analytics_source`です。例自然検索有料ソーシャル広告紹介展示会
	営業ステージ SalesStage	営業パイプラインにおける営業機会の現在または過去のステージ。
説明営業ステージは、「適格性確認済み」「提案提示済み」「契約書送付済み」など、定義された営業プロセスに沿った取引の進捗を示します。このステージの変更から、プロセスログの主要なアクティビティを記録することがよくあります。この属性は、営業機会の進捗を分析し、ボトルネックを特定するうえで重要です。各ステージの滞在時間やステージ間の転換率を追跡できます。これは「営業機会のステージ進捗指標」ダッシュボードの分析に役立ちます。重要な理由営業ファネルのどの段階に営業機会があるかを示し、パイプラインの進行速度やステージごとのボトルネックを分析できます。入手先取引オブジェクトの「dealstage」プロパティです。ステージIDが格納されているため、ステージ名との対応付けが必要です。例アポイントの設定購入適格プレゼンテーションの予定契約書の送付
	営業機会のクローズ日 OpportunityCloseDate	営業機会の受注または失注が確定した日付。
説明営業機会のクローズ日は、取引の営業プロセスが終了した日を示します。取引ステージが「受注成立」または「失注」のカテゴリに移ると、この日付が設定されます。作成からクローズまでの営業サイクル全体の所要時間を算出するうえで重要なタイムスタンプです。ケースの終了時刻として使われ、「平均営業サイクルタイム」などのパフォーマンス指標で営業プロセスの効率を測定する際にも利用されます。重要な理由営業機会の営業サイクルの終了を示します。サイクル全体の所要時間の算出や、営業活動の進行速度の測定に欠かせません。入手先 HubSpot CRM APIの取引オブジェクトにある「closedate」プロパティです。例 2023-07-10T17:00:00Z2023-08-15T11:20:00Z2023-09-05T16:45:00Z
	営業機会の担当者 OpportunityOwner	営業機会を担当し、その進行に責任を持つ営業担当者。
説明営業機会の担当者は、営業パイプラインで取引を進める際の主な窓口であり、管理責任を担います。通常は、営業機会を作成した、または担当に割り当てられた営業担当者です。営業機会の担当者別にプロセスを分析すると、個人やチームのパフォーマンスを評価できます。営業担当者ごとの営業戦略、活動量、転換率の違いを把握でき、コーチングやリソース配分に役立つインサイトが得られます。重要な理由営業担当者ごとの営業サイクル所要時間、受注率、プロセスのコンプライアンスを比較できるため、パフォーマンス分析に欠かせない属性です。入手先取引オブジェクトの「hubspot_owner_id」プロパティに対応します。担当者名はOwners APIから結合する必要があります。例山田花子山田太郎佐藤恵美
	営業機会の結果 OpportunityOutcome	営業機会の最終結果で、受注か失注かを示します。
説明この属性は、取引の最終ステータスを示します。通常は最終営業ステージから取得し、「受注成立」または「失注」のいずれかに分類されます。結果別にプロセスマップを分類することは、効果的な分析方法です。受注した取引と失注した取引のプロセスフローを直接比較し、成功または失敗に関連するパターン、アクティビティ、遅延を明らかにできます。こうしたインサイトは、プロセス改善や営業担当者へのコーチングに役立ちます。重要な理由成功したプロセスインスタンスと成功しなかったプロセスインスタンスを比較し、受注につながるプロセス上の行動を明らかにできます。入手先「dealstage」プロパティから取得します。HubSpotのステージは「オープン」「受注成立」「失注」として定義され、最終ステージの種類から結果を判定します。例受注失注
	営業機会の金額 OpportunityAmount	営業機会の見込み金額または実際の金額。
説明この属性には取引金額が記録されます。初期段階では見積もり金額、取引のクローズ後は最終的な契約金額となる場合があります。営業プロセスの財務的な影響を把握するための基本的な指標です。営業機会の金額でプロセスを分類すると、取引規模によってプロセスが異なるか、成約までの時間が長くなるかを確認できます。財務予測や高額な営業機会の優先順位付けにも欠かせません。重要な理由営業パイプラインの財務分析に役立ち、高額な取引の優先順位付けや、取引規模がプロセスに与える影響の把握につながります。入手先 HubSpot CRM APIの取引オブジェクトにある「amount」プロパティです。例 50000.0012500.50250000.00
	地域 Region	営業案件に関連付けられた地域またはテリトリーです。
説明地域は、営業案件が属する地理的な市場を示します。顧客の所在地や、営業チームに割り当てられたテリトリーに基づいて設定されます。HubSpotでは、カスタムプロパティとして登録されていることがよくあります。この属性を使うと、地域ごとに営業プロセスを比較できます。分析によって、業績、プロセスのコンプライアンス、顧客行動に見られる地域差を把握できます。これは「地域別営業プロセスのバリアント」ダッシュボードや、市場に応じた営業戦略の策定に役立ちます。重要な理由地域ごとのプロセスの実績や違いを比較でき、地域戦略の策定や標準化の取り組みに役立ちます。入手先通常、CompanyまたはDealオブジェクトのカスタムプロパティです。正確なフィールド名は、対象のHubSpot環境で確認する必要があります。例北米欧州・中東・アフリカアジア太平洋中南米
	停滞中かどうか IsStalled	進行中の営業案件が、現在のステージで長期間動いていないことを示すフラグです。
説明この属性は真偽値のフラグです。営業案件が所定の期間内に次のステージへ進まなかった場合に、真になります。「停滞」の定義（たとえば「提案」ステージに30日を超えてとどまっている場合）は、業務ルールに基づきます。このフラグを使うと、対応が必要なリスクのある取引を早期に特定できます。「停滞中の営業案件率」の重要業績評価指標（KPI）を測る中心的な指標であり、勢いを失いつつある案件に営業マネージャーが注力する際に役立ちます。重要な理由進展していないリスクのある営業案件を早期に特定し、取引を失う前に営業マネージャーが対応できるようにします。入手先現在の日付、取引が現在のステージに入った日付（`hs_lastmodifieddate`）、およびステージごとの停滞期間を定める業務ルールに基づく計算フィールドです。例 truefalse
	割引率 DiscountPercentage	営業案件に適用された割引率です。割引がない場合は該当しません。
説明この属性には、取引総額に対する割引の割合を記録します。通常、見積もりの作成時または最終交渉の段階で記録されます。割引率の分析は「割引効果分析」ダッシュボードに欠かせません。割引が受注率や営業サイクルの期間に与える影響を把握し、担当者や地域によって過度な割引が行われていないかを確認できます。過度な割引は、収益性に影響する可能性があります。重要な理由価格戦略が営業成果や収益性に与える影響を分析し、割引を効果的に適用できているか確認するうえで重要です。入手先 HubSpotのDealには標準の割引フィールドがないため、通常はDealまたはQuoteオブジェクトのカスタムプロパティとして設定します。明細項目から算出する場合もあります。例 0.050.100.150.20
	営業チーム SalesTeam	営業案件の担当者が所属するチームです。
説明営業チームは、営業案件の担当者をチーム単位でまとめたものです。地域、製品分野、市場セグメントなどに基づいて編成され、チーム単位で実績を分析できます。チーム単位の分析は、マネージャーがチームの有効性を評価し、戦略を比較してリソースを配分する際に役立ちます。個々の担当者を分析する場合より広い視点でプロセスの実行状況を把握でき、全体的な傾向の特定にも役立ちます。重要な理由チームの実績をまとめて分析できるため、マネージャーが営業チーム間でプロセスの実行状況や成果を比較する際に役立ちます。入手先 `team_id`はOwnerオブジェクトのプロパティです。チーム名を取得するには、Teams APIとの結合が必要です。例エンタープライズ営業－東部中小企業営業－西部中堅企業営業－中部
	支払いサイクル時間 PaymentCycleTime	請求書の送付から支払いの受領までにかかる時間です。
説明支払いサイクル時間は、売掛金回収プロセスの効率を測る指標です。「支払い受領」アクティビティのタイムスタンプから「請求書発行」アクティビティのタイムスタンプを差し引いて算出します。この指標は「平均入金回収時間」の重要業績評価指標（KPI）やキャッシュフローの分析に欠かせません。入金回収プロセスのボトルネックを特定できるほか、顧客や支払い条件ごとに分析して改善の機会を見つけられます。重要な理由入金回収プロセスの効率を測定します。健全なキャッシュフローの維持に欠かせない指標です。入手先計算フィールド：「支払い受領」アクティビティのタイムスタンプ－「請求書発行」アクティビティのタイムスタンプ。元となるタイムスタンプは、連携した財務システムから取得します。例 28日45日10日
	支払い条件 PaymentTerms	Net 30やNet 60など、合意した支払い条件です。
説明支払い条件は、商品やサービスの代金を顧客が支払う条件を定めたものです。通常、契約の締結時に決まります。この属性は「支払いサイクル時間分析」に重要です。合意した条件に照らして支払い状況を分析すると、支払いが常に遅れる顧客を特定したり、特定の支払い条件が回収期間の長期化につながっていないかを確認したりできます。重要な理由支払いサイクルの分析に必要な情報です。想定される支払い期間と実際の遅延を区別できます。入手先通常、DealまたはQuoteオブジェクトのカスタムプロパティとして設定するか、連携した会計システムから取得します。例 Net 30Net 60受領時払い
	製品ファミリー ProductFamily	営業案件に含まれる製品のカテゴリまたはファミリーです。
説明製品ファミリーは、販売する製品やサービスの種類に基づいて取引を分類します。通常、取引に関連付けられた明細項目から判断します。この属性を使うと、製品カテゴリごとに営業プロセスを分析できます。製品によって営業サイクルの長さや複雑さが異なる場合があり、分類して分析することでその違いが明らかになります。製品に合わせた営業プロセスの策定や、より正確な予測にもつながります。重要な理由製品ファミリー別にプロセスを分類すると、製品の種類によって営業サイクルやプロセスの経路に違いがあるかを把握でき、製品ごとの戦略策定に役立ちます。入手先 Dealに関連付けられたLine Itemsから導き出します。製品をファミリーに分類するためのロジックが必要です。例ソフトウェアライセンスプロフェッショナルサービスハードウェアサポートサブスクリプション
	請求書番号 InvoiceNumber	受注に対して発行された請求書を識別する一意の番号です。
説明請求書番号は、顧客に送付した請求書を識別する番号です。通常、注文の履行後に発行され、プロセスの入金段階における重要なステップを示します。 HubSpotは主に請求書を管理するシステムではありませんが、このデータはリードから入金までのプロセスの最終段階を追跡するうえで重要です。営業案件と金銭取引を結び付けることで、営業から経理への引き継ぎを分析し、「請求書発行から売上計上までの時間」という重要業績評価指標（KPI）を確認できます。重要な理由営業プロセスと入金プロセスを結び付け、営業から経理への引き継ぎの効率を分析できます。入手先通常、NetSuiteやQuickBooksなどの連携した会計システムまたはERPシステムから取得し、カスタムオブジェクトまたはプロパティを介してHubSpotのDealに関連付けます。例 INV-2023-00123INV-2023-00456INV-2023-00789
	顧客名 CustomerName	営業案件に関連付けられた企業または組織の名前です。
説明顧客名は、取引先または見込み顧客を特定する情報です。通常、HubSpotでは関連付けられたCompanyオブジェクトに保存されています。顧客別にプロセスを分析すると、支払いサイクルが長い、独自の営業プロセスがあるなど、特定の顧客に固有の傾向を把握できます。主要顧客の管理や、顧客セグメントごとのプロセスの実績を理解する際に役立ちます。重要な理由顧客を軸に分析することで、特定の顧客や業界に固有のプロセスの傾向や問題を特定できます。入手先 Dealに関連付けられたCompanyオブジェクトから取得します。Companyオブジェクトのプロパティ名は通常、`名前`です。例グローバルテック株式会社イノベートソリューションズ株式会社エンタープライズ株式会社

必須推奨任意

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

リードから入金までの流れを正確に把握するために、イベントログに記録する主なプロセスのステップと重要な節目です。

7 推奨 7 任意

	アクティビティ	説明
	入金の確認	顧客からの入金が確認され、消し込みが完了した時点を示す、リードから入金までのサイクルの最終段階です。通常は外部の会計システムで追跡し、HubSpotに同期します。
重要な理由売上回収の最終イベントです。「平均入金回収期間」と「リードから入金までのエンドツーエンドのサイクルタイム」を算出するうえで欠かせません。入手先財務システムから同期された「入金日」などのカスタムプロパティの更新、または専用パイプラインでの手動ステージ変更から判断します。記録連携によって更新されたカスタムの「入金日」プロパティのタイムスタンプ。イベントタイプ inferred
	営業機会の作成	営業機会のライフサイクルにおける最初のイベントで、HubSpotに新しい取引レコードが作成されたことを示します。ユーザーが手動で取引を作成した場合や、ワークフローまたは連携によって自動作成された場合に、このイベントが明示的に記録されます。
重要な理由このアクティビティは、営業機会の営業サイクルの正式な開始点です。営業サイクル全体の所要時間や、リードから商談への転換速度を算出する際の基準となるタイムスタンプです。入手先このイベントは自動的に記録されます。タイムスタンプは、取引オブジェクトの標準プロパティ「作成日」で確認できます。記録取引レコードの「作成日」プロパティ。イベントタイプ explicit
	営業機会の受注確定	取引の受注が正式に確定し、クローズしたことを示す最終的な成功イベントです。HubSpotの標準イベントであり、ユーザーが取引を「受注成立」ステージに移すと明示的に記録されます。
重要な理由営業活動が成功したことを示すアクティビティであり、営業サイクルの所要時間や受注率を測定する際の重要な終点です。その後の納品や請求のプロセスが始まるきっかけにもなります。入手先「取引ステージ」が「受注」カテゴリのいずれかのステージに設定されたときに、標準の「クローズ日」プロパティに記録されるタイムスタンプです。記録受注となった場合の取引レコードの「クローズ日」プロパティ。イベントタイプ explicit
	営業機会の失注確定	取引の失注が正式に確定し、クローズしたことを示す最終的な失敗イベントです。ユーザーが取引を「失注」ステージに移すと明示的に記録される標準イベントです。
重要な理由取引を失注した時期と理由の分析は、プロセス改善に欠かせません。このイベントは、失注した取引の営業サイクル所要時間を算出する終点となります。入手先「取引ステージ」が「失注」カテゴリのいずれかのステージに設定されたときに、標準の「クローズ日」プロパティに記録されるタイムスタンプです。「失注理由」プロパティから背景を確認できます。記録失注となった場合の取引レコードの「クローズ日」プロパティ。イベントタイプ explicit
	営業機会の適格性確認	営業チームが営業機会の適格性を確認し、予算、決裁権、ニーズ、導入時期などの基準を満たしていると判断した時点を示します。通常は、営業パイプラインで取引が「購入適格」などの特定のステージに移ったことから判断します。
重要な理由営業パイプラインの質を把握するうえで重要な節目です。適格性確認までの時間を分析すると、営業プロセスの初期段階における効率を確認できます。入手先取引オブジェクトの「取引ステージ」フィールドのプロパティ履歴から判断します。具体的には、「購入適格」などのステージに入った時点のタイムスタンプを使います。記録取引ステージが指定された「適格」ステージに変更された時点のタイムスタンプ。イベントタイプ inferred
	契約の締結	顧客が契約書に署名し、商業上の合意が成立したことを示すアクティビティです。HubSpotでは、見積もりの承諾後に取引が「契約書送付済み」または「受注成立」ステージに移った時点で記録されることが一般的です。
重要な理由納品開始前の商業上の合意を示す最終的な節目です。「見積もりから契約までのサイクルタイム」の重要業績評価指標（KPI）を算出するうえで欠かせません。入手先取引ステージのプロパティが「契約締結」または同等のステージに変更された時点のタイムスタンプから判断できます。見積もりに電子署名を使用している場合、「見積もりの承諾」と同じ時点を指すことがあります。記録取引ステージが「契約締結」などに変更された時点のタイムスタンプ。イベントタイプ inferred
	見積もりの発行	顧客向けの正式な価格見積もりを作成し、送付したことを示します。HubSpotのSales Hubには専用の見積もり機能があり、取引の見積もりを作成して公開すると、このイベントが明示的に記録されます。
重要な理由商談が具体化したことを示す重要な節目です。適格性確認から見積もり発行までの時間は、「見積もりから契約までのプロセスフロー」の分析に欠かせません。入手先取引に紐づく見積もりオブジェクトの作成タイムスタンプ。見積もりオブジェクトの「hs_createdate」プロパティ。記録紐づく見積もりオブジェクトの作成日。イベントタイプ explicit
	ソリューションの提示	正式なソリューションまたは製品デモを顧客に提示した時点を示します。通常は、取引ステージが「プレゼンテーション予定」や「デモ完了」などに変更されたことから判断します。
重要な理由営業ファネルの中盤における重要な節目です。この時点までにかかった時間を測定すると、営業サイクルのソリューション提案段階の効率を分析できます。入手先取引のプロパティ履歴で、取引ステージが「プレゼンテーション予定」などの該当ステージに変更された時点のタイムスタンプから判断します。記録取引ステージが「プレゼンテーション」または「提案」ステージに変更された時点のタイムスタンプ。イベントタイプ inferred
	初回コンタクト	取引に紐づくコンタクトとの最初のやり取りを示します。電話、メール、ミーティングなどが該当します。この情報は、HubSpotの取引レコードに紐づくアクティビティタイムラインに明示的に記録されます。
重要な理由取引の作成から初回コンタクトまでの時間を追跡すると、営業チームの対応速度を測定できます。最初のコンタクトの種類を分析することで、成約につながりやすいパターンが見つかることもあります。入手先取引オブジェクトの作成後に記録された最初のアクティビティ（電話、メール、ミーティングなど）のタイムスタンプ。記録取引のタイムラインに記録された最初のアクティビティのタイムスタンプ。イベントタイプ explicit
	受注の作成	営業から納品または業務運用チームへの社内引き継ぎを示します。通常、HubSpot標準のイベントではありません。「受注処理中」や「納品待ち」などの特定のパイプラインステージに取引が移ったことから判断します。
重要な理由営業から業務運用への引き継ぎの効率を分析するうえで重要なアクティビティです。ここでの遅れは、顧客満足度や納品スケジュールに影響する場合があります。入手先「取引ステージ」フィールドのプロパティ履歴から判断し、販売後のステージに入った時点のタイムスタンプを記録します。記録取引ステージが「受注処理中」ステージに変更された時点のタイムスタンプ。イベントタイプ inferred
	受注品の納品完了	顧客への製品の納品またはサービスの提供が完了したことを示します。このイベントは通常HubSpot以外で発生し、連携によって記録するか、取引ステージを「サービス提供済み」または「受注完了」に手動で更新して記録します。
重要な理由プロセスにおける納品段階の完了を示します。「受注処理完了から請求書発行までの時間」の重要業績評価指標（KPI）を測定する起点です。入手先 ERPまたは納品管理システムとの連携、あるいは手動での更新が必要です。取引が「納品完了」などのステージに入った時点から判断できます。記録外部システムからのステータス変更、または手動でのステージ変更のタイムスタンプ。イベントタイプ inferred
	要件の把握	ディスカバリーコールまたはミーティングが行われ、顧客のニーズが文書化されたことを示すアクティビティです。通常は、取引が営業パイプラインの「ディスカバリー」や「ニーズ分析」などの特定のステージに進んだことから判断します。
重要な理由この節目を追跡すると、営業チームが適格性確認から顧客ニーズの把握まで、どれだけ速く進めているかを評価できます。ここでの遅れは、日程調整の問題やリソース不足を示している場合があります。入手先「取引ステージ」フィールドのプロパティ履歴から判断し、取引が「要件の把握」などのステージに入った時点のタイムスタンプを記録します。記録ニーズ分析を示すステージに取引ステージが変更された時点のタイムスタンプ。イベントタイプ inferred
	見積もりの承諾	顧客が見積もりを正式に承諾したときに発生するイベントです。多くの場合、電子署名によって承諾されます。HubSpotの電子署名機能で送付した見積もりに顧客が署名すると、このイベントが明示的に記録されます。
重要な理由顧客が条件と価格に同意したことを示す、重要な購買シグナルです。見積もりの発行から承諾までの時間は、交渉サイクルの分析に役立ちます。入手先見積もりオブジェクトの「hs_quote_accepted_date」プロパティ、または見積もりに紐づく電子署名ログの完了タイムスタンプ。記録見積もりの「hs_quote_accepted_date」プロパティに記録されたタイムスタンプ。イベントタイプ explicit
	請求書の発行	会計システムで顧客向け請求書が作成されたことを示します。HubSpot Sales Hubの標準機能では記録されないため、連携によって取引のカスタムプロパティまたはステージを更新し、記録する必要があります。
重要な理由入金までのサイクルにおける重要な段階です。納品から請求書発行までの時間は、サービスの請求をどれだけ早く行えるかに直接影響します。入手先 QuickBooksやXeroなどの会計システムとの連携が必要です。カスタムプロパティのタイムスタンプ、または取引ステージの変更からイベントを判断します。記録「請求書発行日」などのカスタム日付プロパティのタイムスタンプ。イベントタイプ inferred

推奨任意

データ抽出ガイド

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

ステップ

前提条件：HubSpotプライベートアプリの作成
- スーパー管理者権限を持つアカウントでHubSpotにログインします。
- ［設定］>［連携］>［プライベートアプリ］に移動し、［新しいプライベートアプリを作成］をクリックします。
- ［基本情報］タブで、アプリ名を入力します。例：ProcessMind Extraction。
- ［スコープ］タブで、必要な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をキー、対応するアクティビティ名を値として辞書を更新します。たとえば、「有望」ステージのIDが12345の場合、エントリーは'12345': '商談の有望度確認'となります。
データ抽出スクリプトの実行
- ターミナルまたはコマンドプロンプトを開き、スクリプトを保存したディレクトリに移動します。
- 次のコマンドでスクリプトを実行します：python extract_hubspot_log.py。
- スクリプトがHubSpot APIからデータを取得します。処理した取引数などの進捗がコンソールに表示されます。
- 大量のデータを抽出する場合は、APIのレート制限により時間がかかることがあります。
出力ファイルの確認
- スクリプトの実行が完了すると、同じディレクトリにhubspot_event_log.csvが作成されます。
- このファイルには、指定したアクティビティと属性を含むイベントログが保存されます。
アップロードの準備
- hubspot_event_log.csvをスプレッドシートソフトで開き、データが想定どおりであることを確認します。
- ファイルには必要な列（SalesOpportunityId、ActivityName、EventTimeなど）がすでに設定されているため、そのままProcessMindにアップロードできます。

設定

HubSpotプライベートアプリのトークン：認証には、HubSpotプライベートアプリの有効なアクセストークンが必要です。アプリには、取引、コンタクト、エンゲージメント、見積もり、担当者への読み取り権限を付与してください。
期間：スクリプトではSTART_DATEとEND_DATEの変数を設定します。抽出時間とAPIの使用量を抑えるため、まずは3～6か月など短い期間から始めることをおすすめします。日付形式は「YYYY-MM-DD」です。
パイプラインステージの対応付け：「商談の適格性確認」や「要件の把握」など、ステージに基づくアクティビティの正確性は、PIPELINE_STAGE_MAPPING辞書の設定に左右されます。この設定をHubSpot上の組織の営業パイプラインに正確に合わせてください。
APIのレート制限：HubSpot APIにはレート制限があります（例：Professionalプランでは10秒あたり100リクエスト）。スクリプトにはこれに対応する基本的なtime.sleep()の処理が含まれていますが、下位プランで非常に大量のデータを抽出する場合は、より余裕を持たせるために調整が必要になることがあります。
カスタムプロパティ：HubSpotで「地域」などの属性や「請求書発行」などのアクティビティをカスタムプロパティで追跡している場合は、データを取得できるよう、スクリプト内のdeal_propertiesリストに該当するプロパティ名を追加してください。

クエリの例 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プライベートアプリの作成
- HubSpotポータルで［設定］>［連携］>［プライベートアプリ］に移動します。
- 新しいプライベートアプリを作成し、ProcessMind_Extractionなど、用途が分かる名前を付けます。
- ［スコープ］タブで、次の読み取り権限を付与します：crm.objects.deals.read、crm.objects.quotes.read、crm.objects.owners.read。
- アクセストークンを発行します。このトークンはAPI認証に使用するため、安全な場所にコピーしてください。
APIクライアントの設定
- PostmanやInsomniaなどのAPIクライアント、またはスクリプト言語（requestsライブラリを使うPythonなど）でHubSpot GraphQL APIに接続します。
- GraphQL APIのエンドポイントはhttps://api.hubapi.com/graphql/v1です。
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件の取引が返されます。
- レスポンスにpaging.next.afterカーソルが含まれます。この値がある場合は、afterの値を変数として渡してクエリを再実行し、次のページを取得します。
- paging.next.afterカーソルがnullになるまで、この処理を繰り返します。指定した期間の取引をすべて取得すると、カーソルがnullになります。
JSONレスポンスをイベントログに変換
- APIからは、入れ子構造のJSONが返されます。レスポンスを解析し、表形式のイベントログに変換するスクリプトを作成します。返された各取引オブジェクトについて、次の処理を行います。
- イベント1：商談作成：行を1つ作成します。ActivityNameは「商談作成」、EventTimeには取引のcreatedateを設定します。
- イベント2：初回コンタクト：関連するすべての電話、メール、ミーティングから、最も早いhs_created_dateを特定します。この日時を使って行を1つ作成します。アクティビティがない場合、このイベントは作成しません。
- イベント3～12：ステージに基づくアクティビティ：dealstageのproperties_with_history配列を順に確認します。各項目について、ステージ名を「商談の有望度確認」「ソリューションの提案」などのActivityNameに対応付け、updated_atの日時をEventTimeに設定した行を作成します。この対応関係は、実際の営業パイプラインに合わせて設定してください。
- イベント13、14：見積もり関連のアクティビティ：関連するquote_collectionを順に確認します。見積もりのcreatedateを使って「見積もり発行」の行を作成します。hs_quote_accepted_dateがある場合は、その日時を使って「見積もり承諾」の行を作成します。
- イベント15、16：クローズのステータス：dealstageの履歴の最後の項目が「クローズ・成約」または「クローズ・失注」に該当します。この履歴項目の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のスコープ：HubSpot Private Appには、少なくとも次のスコープへの読み取りアクセスが必要です：crm.objects.deals.read、crm.objects.quotes.read、crm.objects.owners.read。
GraphQLクエリの変数：データを絞り込むには、クエリに変数を指定する必要があります。取引の作成日を基準に抽出期間を定めるため、startTimestampとendTimestampを指定してください。まずは直近6～12か月分のデータを対象にすることをおすすめします。
カスタムプロパティのプレースホルダー：クエリには[your_lead_source_property]や[your_region_property]などのプレースホルダーが含まれています。HubSpot環境で使用しているカスタム取引プロパティの実際の内部名に置き換えてください。
営業ステージのマッピング：「商談の適格性確認」や「ソリューションの提案」などのアクティビティを抽出するには、HubSpotの取引ステージに基づく論理的なマッピングが必要です。この業務ロジックは、変換スクリプトで設定してください。
ページネーション：APIのlimitは、1回のリクエストにつき最大100件です。すべてのデータを取得できるよう、抽出スクリプトではafterカーソルを使ったページネーションに対応してください。
APIのレート制限：大量のデータを抽出する場合は、HubSpotのAPIレート制限にご注意ください。信頼性の高いスクリプトにするには、エラー処理と、必要に応じた待機時間の延長および再試行の仕組みを含めることをおすすめします。

クエリの例 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％増やす：リードから入金までのプロセスを今すぐ把握

ProcessMindで長期化する営業サイクルを解消し、成約率を20％高めましょう。

無料トライアルを開始しましょう。

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

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

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

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

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

データ抽出ガイド

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

ステップ

設定

クエリの例 python

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

ステップ

設定

クエリの例 graphql

始める準備はできていますか？

成約数を20％増やす：リードから入金までのプロセスを今すぐ把握