> 継続的なプロセス改善 > リードからキャッシュまで > HubSpot CRM > データテンプレート

リード・ツー・キャッシュデータテンプレート

HubSpot CRM

リードからキャッシュまでの属性 (21) リードからキャッシュまでのアクティビティ (14) 抽出ガイド (2)

リード・ツー・キャッシュデータテンプレート

このテンプレートは、Lead to Cashプロセスを分析するために必要なデータを収集するための包括的なガイドを提供します。ソースシステムから抽出する必要がある不可欠な属性と活動を概説しています。このガイダンスに従うことで、洞察に満ちたプロセスマイニングのためにデータが準備されていることを確実にできます。

収集を推奨する項目
追跡すべき主要アクティビティ
HubSpot CRMに特化した抽出ガイダンス

イベントログについて初めての方へ：プロセスマイニングのイベントログ作成方法.

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

リードからキャッシュまでの属性

これらは、Lead to Cashプロセスを徹底的に分析するために、イベントログに含めるべき推奨されるデータフィールドと不可欠な属性です。

5 必須 7 推奨 9 任意

	名前	説明
	営業商談 SalesOpportunityId	Lead to Cashプロセスのケース識別子として機能する、営業商談の一意の識別子。
説明営業商談IDは、潜在的な取引を、作成から受注または失注という結論まで追跡します。プロセスマイニングでは、この識別子が、電話、会議、見積書、支払いなどの関連するすべての活動を単一のエンドツーエンドのプロセスインスタンスにリンクします。営業商談に基づいてプロセスを分析することで、企業は営業ジャーニー全体を理解できます。共通のパス、ボトルネック、および逸脱を特定するのに役立ち、異なる商談がどのように処理され、何が成功につながるかを明確に把握できます。その重要性これは営業ライフサイクル内のすべてのイベントを接続するコア識別子であり、各取引のエンドツーエンドのLead to Cashプロセスを分析することを可能にします。取得元これはHubSpot CRM APIのDealオブジェクトからの`dealId`プロパティです。例 987654321087654321097654321098
	アクティビティ ActivityName	Lead to Cashプロセス内で発生した特定のイベントまたはタスクの名前。
説明アクティビティ名とは、「商談作成」、「見積書発行」、「支払い受領」など、プロセス内のステップを記述するものです。これらの活動は、HubSpotに記録された様々なイベントやステータス変更から抽出されます。この属性は、活動の順序を視覚的に表現するプロセスマップを構築するための基本的な要素です。活動の流れを分析することで、プロセスのバリエーション、ループ、ボトルネックを特定し、的を絞ったプロセス改善イニシアチブを可能にします。その重要性プロセスマップ内のステップを定義します。これはすべてのプロセスマイニング分析の基盤です。明確なアクティビティがなければ、プロセスフローを可視化したり分析したりすることはできません。取得元この属性は、HubSpot内の様々なソース（取引ステージの変更（例：「Opportunity Qualified」）、タスクタイプ、通話の処理結果、および見積書や請求書などの関連オブジェクトを含む）から派生します。例商談作成見積書発行済み契約締結済み入金確認済み
	イベント日時 EventTime	アクティビティ／event の発生時刻を示すタイムスタンプ。
説明イベントタイムは、プロセス内の各アクティビティの正確な日時を提供し、イベントの時系列順序を確立します。このタイムスタンプは、異なるステップ間のサイクルタイム、期間、および待機時間を計算するために不可欠です。分析では、この属性はプロセスパフォーマンスを理解し、遅延を特定し、スループットを測定するために使用されます。これにより、営業および支払いサイクル全体で時間がどのように費やされているかを詳細に分析するための、プロセスの時間的基盤が形成されます。その重要性この属性はイベントの時系列シーケンスを提供し、サイクルタイムなどのパフォーマンス指標を計算し、プロセス遅延を特定するために極めて重要です。取得元タイムスタンプは、活動に応じて様々なプロパティから取得されます。例えば、取引作成には`createdate`、取引クローズには`closedate`、または関連するタスク、電話、メールのタイムスタンプなどが使用されます。例 2023-04-15T10:00:00Z2023-05-20T14:30:00Z2023-06-01T09:15:00Z
	ソースシステム SourceSystem	`データ`が抽出された記録システム。
説明この属性は、プロセスデータの発生源を特定します。Lead to Cashプロセスの場合、これは通常HubSpot CRMですが、請求書や支払い活動のために統合された財務システムからのデータも含まれる可能性があります。複数のプラットフォームからデータが統合される環境では、ソースシステムを指定することが重要です。これにより、データガバナンス、データ品質問題のトラブルシューティング、およびプロセスの技術的ランドスケープの理解に役立ちます。その重要性データの出所に関する重要なコンテキストを提供します。これはデータガバナンスと、複数の統合システムにまたがる分析にとって不可欠です。取得元これは、データ変換プロセス中に付加されるべき静的な値、「HubSpot CRM」です。例 HubSpot CRM
	最終データ更新 LastDataUpdate	ソースシステムからデータが最後に更新されたことを示すタイムスタンプです。
説明この属性は、データセットが最後に更新された日時を記録します。これにより、分析されるデータの鮮度に関する透明性が提供され、関係者がデータの適時性を認識していることを保証します。これはダッシュボードや継続的なモニタリングにとって特に有用であり、プロセスインサイトがどれほど最新であるかをユーザーに示します。最近のパフォーマンス変更と古い情報を区別するのに役立ちます。その重要性データの鮮度を示します。これは、分析とダッシュボードが最新の情報に基づいていることを確認するために不可欠です。取得元この値は、各データ抽出または更新サイクル中に生成され、データセットに刻印されます。例 2024-07-21T02:00:00Z
	リードソース LeadSource	リードが獲得された元のソースまたはチャネル。
説明リードソースは、潜在顧客が最初にどのように企業と接触したか（例：「ウェビナー」、「展示会」、「オーガニック検索」など）を追跡します。この情報は、異なるマーケティングチャネルの有効性を評価するために不可欠です。この属性は、「リードから商談へのコンバージョン率」ダッシュボードに不可欠です。リードソース別のコンバージョン率と営業サイクル時間を分析することで、マーケティングチームと営業チームは、どのチャネルが最も価値のある商談を生み出しているかを理解し、それに応じてマーケティング費用を最適化できます。その重要性異なるソースから発生する商談のコンバージョン率と品質を分析することで、マーケティングチャネルの効果を測定するのに役立ちます。取得元この情報は元のContactオブジェクトに保存されることが多く、Dealオブジェクトのカスタムプロパティにコピーされる場合があります。一般的なプロパティは`hs_analytics_source`です。例自然検索有料ソーシャル広告紹介展示会
	商談クローズ日 OpportunityCloseDate	受注または失注として営業商談がクローズされた日付。
説明商談クローズ日は、特定の取引における営業プロセスの完了を示します。この日付は、取引のステージが「Closed Won」（受注）または「Closed Lost」（失注）カテゴリに移動されたときに設定されます。このタイムスタンプは、作成からクローズまでの全体的な営業サイクルタイムを計算するために極めて重要です。ケースの終了時間として機能し、「平均営業サイクルタイム」などの多くのパフォーマンスKPIで使用され、営業プロセスの効率性を測定します。その重要性商談の営業サイクルの終了を示し、総サイクルタイムの計算と営業速度の測定に不可欠です。取得元これはHubSpot CRM APIのDealオブジェクトからの`closedate`プロパティです。例 2023-07-10T17:00:00Z2023-08-15T11:20:00Z2023-09-05T16:45:00Z
	商談担当者 OpportunityOwner	営業商談を担当する営業担当者。
説明商談担当者は、営業パイプラインを通じて取引を管理する主要な連絡先であり責任者です。これは通常、商談を作成または割り当てられた営業担当者を指します。商談担当者別にプロセスを分析することで、個人およびチームのパフォーマンス評価に役立ちます。営業担当者間の営業戦略、活動レベル、コンバージョン率の違いを明らかにでき、コーチングとリソース管理のための貴重なインサイトを提供します。その重要性この属性はパフォーマンス分析にとって不可欠であり、異なる営業担当者間の営業サイクルタイム、勝率、およびプロセスコンプライアンスの比較を可能にします。取得元これはDealオブジェクトの`hubspot_owner_id`プロパティに対応します。オーナーの名前はOwners APIから結合して取得する必要があります。例ジェーン・ドウJohn Smithエミリー・ジョーンズ
	商談結果 OpportunityOutcome	受注か失注かを示す、営業商談の最終結果。
説明この属性は、取引の最終ステータスを提供します。これは通常、「Closed Won」（受注）または「Closed Lost」（失注）に分類される最終営業ステージから派生します。結果別にプロセスマップをセグメント化することは、強力な分析手法です。これにより、受注取引と失注取引のプロセスフローを直接比較でき、成功または失敗と相関するパターン、活動、または遅延を明らかにします。このインサイトは、プロセス最適化と営業コーチングにとって非常に貴重です。その重要性成功したプロセスインスタンスと失敗したプロセスインスタンスの比較分析を可能にし、どのプロセス行動が案件の獲得と相関しているかを明らかにします。取得元これは`dealstage`プロパティから派生します。HubSpotのステージは「Open」、「Closed Won」、「Closed Lost」として定義されています。結果は最終ステージのタイプによって決定されます。例獲得失注
	商談金額 OpportunityAmount	営業商談の潜在的または実際の金銭的価値。
説明この属性は、取引の価値を捕捉します。これは初期段階での見積額、またはクローズ時の最終契約額である可能性があります。営業プロセスの財務的影響を理解するための基本的な指標です。商談金額を分析することで、取引規模別にプロセスをセグメント化し、より大きな取引が異なるプロセスに従うか、クローズに時間がかかるかを把握できます。また、財務予測と高価値の商談に優先順位を付ける上で不可欠です。その重要性これにより営業パイプラインの財務分析が可能になり、高価値の取引に優先順位を付け、取引規模がプロセス行動にどのように影響するかを理解するのに役立ちます。取得元これはHubSpot CRM APIのDealオブジェクトからの`amount`プロパティです。例 50000.0012500.50250000.00
	営業ステージ SalesStage	パイプラインにおける営業商談の現在または過去のステージ。
説明営業ステージは、定義された営業プロセスを通じて取引が進行する様子を表します。「Qualified」（適格化）、「Proposal Presented」（提案提示）、「Contract Sent」（契約書送付）などのステージがあります。このステージの変更は、プロセスログにおける主要な活動を生成するためによく使用されます。この属性は、商談の進行を分析し、ボトルネックを特定するために極めて重要です。各ステージに費やされた時間とステージ間のコンバージョン率を追跡することができ、「商談ステージ進行メトリクス」ダッシュボードにとって重要な要素となります。その重要性商談が営業ファネルのどこにあるかのスナップショットを提供し、パイプラインの速度とステージ固有のボトルネックの分析を可能にします。取得元これはDealオブジェクト上の`dealstage`プロパティです。ステージのIDが含まれており、ステージラベルにマッピングする必要があります。例アポイントメント設定済み購入適格プレゼンテーション予定契約書送付済み
	地域 Region	営業商談に関連付けられた地理的な地域またはテリトリー。
説明地域は、営業商談が所在する地理的市場を指定します。これは、顧客の所在地または営業チームの担当テリトリーに基づく場合があります。HubSpotではカスタムプロパティであることがよくあります。この属性は、異なる地域間の営業プロセスを比較するために使用されます。分析により、パフォーマンス、プロセスコンプライアンス、顧客行動における地域差が明らかになり、「地域別営業プロセスバリアント」ダッシュボードや特定の市場に合わせた営業戦略の策定にとって不可欠です。その重要性異なる地理的市場間でのプロセスパフォーマンスとバリエーションの比較を可能にし、地域戦略と標準化の取り組みを支援します。取得元これは通常、CompanyまたはDealオブジェクトのカスタムプロパティです。正確なフィールド名は、特定のHubSpotインスタンスで確認する必要があります。例北米EMEAAPACLATAM
	停滞中である IsStalled	進行中の商談が現在のステージで長期間非アクティブ状態であるかを示すフラグです。
説明この属性は、営業商談が事前に定義された時間制限内に新しいステージに進んでいない場合にtrueとなるブール値フラグです。「停滞」の定義（例：「Proposal」ステージで30日以上）は、ビジネスルールに基づいています。このフラグは、介入が必要なリスクのある取引をプロアクティブに特定するのに役立ちます。これは「停滞商談率」KPIのコアメトリックであり、営業マネージャーが勢いを失っている商談に注意を集中するのに役立ちます。その重要性進捗していないリスクのある商談をプロアクティブに特定し、商談が失われる前に営業マネージャーが介入できるようにします。取得元現在の日付、取引が現在のステージに入った日付（`hs_lastmodifieddate`）、および各ステージの停滞時間を定義するビジネスルールに基づいて計算されるフィールドです。例 truefalse
	割引率 DiscountPercentage	営業商談に適用された割引率（もしあれば）。
説明この属性は、顧客に提供された割引を取引総額に対する割合として捕捉します。通常、見積書が作成されたとき、または最終交渉中に記録されます。割引率の分析は、「割引効果分析」ダッシュボードにとって重要です。割引が勝率と営業サイクルタイムに与える影響を理解し、特定の担当者や地域が過度な割引を提供しており、それが収益性に影響を与える可能性があるかを特定するのに役立ちます。その重要性価格戦略が販売結果と収益性に与える影響を分析する上で重要であり、割引が効果的に使用されていることを確認するのに役立ちます。取得元これはDealまたはQuoteオブジェクトのカスタムプロパティであることがよくあります。HubSpotには取引に標準の割引フィールドがないためです。明細項目から計算される場合もあります。例 0.050.100.150.20
	営業サイクルタイム SalesCycleTime	商談が作成されてからクローズされるまでの合計時間。
説明営業サイクルタイムは、単一の商談における営業プロセス全体の期間を測定する主要業績評価指標（KPI）です。これは「商談クローズ日」と「商談作成日」の差として計算されます。この計算された指標は、営業速度と効率を理解するための基本的なものであり、「平均営業サイクルタイム」の主要なKPIです。どの種類の取引、担当者、または地域がより長いまたは短いサイクルを持つかを特定するために使用されます。その重要性これは営業プロセスの効率性を測定するための重要なKPIです。商談がクローズドディールに変換されるまでの時間を直接定量化します。取得元計算フィールド: 商談の`OpportunityCloseDate` - `CreateDate`。例 30日12時間92日4時間15 days 2 hours
	営業チーム SalesTeam	商談担当者が所属するチーム。
説明営業チームは、個々の商談担当者を、地域、製品の焦点、または市場セグメントに基づいてチームにまとめます。これにより、集計されたパフォーマンス分析が可能になります。チームレベルで分析することで、マネージャーはチームの有効性を評価し、戦略を比較し、リソースを割り当てることができます。これは、個々の担当者の分析よりも高レベルな視点を提供し、プロセス実行におけるより広範な傾向を特定するのに役立ちます。その重要性チームパフォーマンスの集計分析を可能にし、マネージャーが異なる営業チーム間のプロセス実行と成果を比較するのに役立ちます。取得元 `team_id`はOwnerオブジェクトのプロパティです。チーム名はTeams APIと結合して取得する必要があります。例エンタープライズ営業 - 東日本SMB向け営業 - 西中堅企業向け営業 - 中央
	支払いサイクルタイム PaymentCycleTime	請求書が送付されてから支払いが受領されるまでの時間。
説明支払いサイクルタイムは、売掛金回収プロセスの効率性を測定します。これは、「支払い受領」活動のタイムスタンプと「請求書発行」活動のタイムスタンプの差として計算されます。この指標は、「平均支払い回収時間」KPIおよびキャッシュフロー分析にとって極めて重要です。支払い回収プロセスのボトルネックを特定するのに役立ち、顧客別または支払い条件別に分析することで、改善の機会を見つけることができます。その重要性健全なキャッシュフローを維持するために不可欠な、債権回収プロセスの効率性を測定します。取得元計算フィールド: 「入金済み」アクティビティのタイムスタンプ - 「請求書発行済み」アクティビティのタイムスタンプ。ソースとなるタイムスタンプは統合された財務システムから取得されます。例 28 days45日間10日
	支払条件 PaymentTerms	Net 30やNet 60などの、合意された支払い条件。
説明支払い条件とは、顧客が商品やサービスの支払いを行う際の条件を定義するものです。これは通常、契約締結フェーズで設定されます。この属性は「支払いサイクルタイム分析」にとって重要です。合意された条件に対する支払いパフォーマンスを分析することで、支払い遅延が常態化している顧客を特定し、特定の支払い条件がより長い回収サイクルに関連しているかどうかを理解するのに役立ちます。その重要性これは支払いサイクル分析のコンテキストを提供し、予測される支払い時間と実際の遅延を区別するのに役立ちます。取得元これは通常、DealまたはQuoteオブジェクトのカスタムプロパティであるか、統合された会計システムから取得されます。例支払条件：正味30日支払条件：正味60日受領時支払い
	製品ファミリー ProductFamily	営業商談に含まれる製品のカテゴリまたはファミリー。
説明製品ファミリーは、販売されている製品またはサービスのタイプに基づいて取引を分類します。これは通常、取引に関連付けられた明細項目によって決定されます。この属性により、異なる製品カテゴリの営業プロセスを分析できます。一部の製品はより長く、より複雑な営業サイクルを持つ可能性があり、このセグメンテーションはその違いを明らかにすることで、よりカスタマイズされた営業プロセスとより正確な予測につながります。その重要性製品ファミリー別にプロセスをセグメント化することで、異なる種類の製品がそれぞれ異なる営業サイクルやプロセスパスを持つかどうかを明らかにでき、製品固有の戦略策定に役立ちます。取得元これはDealに関連付けられた明細項目から派生します。製品をファミリーに分類するためのロジックが必要です。例ソフトウェアライセンスプロフェッショナルサービスハードウェアサポートサブスクリプション
	請求書番号 InvoiceNumber	販売注文のために生成された請求書の一意の識別子。
説明請求書番号は、顧客に送付された請求書の参照番号です。これは通常、注文が履行された後に生成され、プロセスにおけるキャッシュ回収の重要なステップを示します。 HubSpotは主に請求システムではありませんが、このデータはLead to Cashプロセスの最終段階を追跡するために極めて重要です。営業商談と財務取引をリンクさせ、営業から財務への引き渡しと「請求書から収益認識までの時間」KPIの分析を可能にします。その重要性営業プロセスと財務回収プロセスを連携させ、営業と財務間の引き渡しの効率性を分析できるようにします。取得元このデータは通常、統合された会計システムまたはERPシステム（NetSuite、QuickBooksなど）から取得され、カスタムオブジェクトまたはプロパティを介してHubSpot Dealに関連付けられます。例 INV-2023-00123INV-2023-00456INV-2023-00789
	顧客名 CustomerName	営業商談に関連付けられた会社または組織名。
説明顧客名は、取引の顧客または潜在顧客を特定するものです。この情報は通常、HubSpotの関連するCompanyオブジェクトに保存されます。顧客別にプロセスを分析することで、特定のクライアントに固有のパターン（より長い支払いサイクルや独自の営業プロセスなど）を特定できます。これは、主要顧客管理や、異なる顧客セグメントに対してプロセスがどのように機能するかを理解する上で特に役立ちます。その重要性顧客中心の分析を可能にし、特定の顧客や業界に特有のプロセスパターンや問題を特定するのに役立ちます。取得元これは取引にリンクされた関連Companyオブジェクトから取得されます。プロパティは通常、Companyオブジェクト上の`name`です。例 `Global Tech Inc.`Innovate Solutions Ltd.エンタープライズ株式会社

必須推奨任意

リードからキャッシュまでのアクティビティ

これらは、Lead to Cashフロー内で正確なプロセス発見を行うために、イベントログに捕捉すべき主要なプロセスステップと重要なマイルストーンです。

7 推奨 7 任意

	アクティビティ	説明
	入金確認済み	この活動は、顧客からの支払いが受領され、照合された時点を指す、Lead to Cashサイクルにおける最終ステップを示します。これは通常、外部の会計システムで追跡され、HubSpotに同期されます。
その重要性これは収益実現のための最終イベントです。「平均支払い回収時間」と「エンドツーエンドのLead to Cashサイクルタイム」を計算するために不可欠です。取得元財務システムから同期された「支払い日」のようなカスタムプロパティの更新、または専用パイプラインでの手動ステージ変更から推測されます。取得統合によって更新されたカスタム「支払い日」プロパティからのタイムスタンプ。イベントタイプ inferred
	商談作成	これは営業商談ライフサイクルにおける最初のイベントであり、HubSpotで新しい取引レコードが作成されたことを示します。ユーザーが手動で取引を作成したとき、またはワークフローや統合を通じて自動的に作成されたときに、このイベントが明示的に捕捉されます。
その重要性この活動は、商談の営業サイクルの正式な開始として機能します。全体的な営業サイクルタイムとリードから商談へのコンバージョン速度を計算するための主要なタイムスタンプです。取得元これは自動的に記録されます。タイムスタンプは、Dealオブジェクトの標準「作成日」プロパティで見つけることができます。取得取引レコードの「作成日」プロパティ。イベントタイプ explicit
	商談受注	これは、取引が正式に受注としてクローズされる最終的な成功イベントです。ユーザーが取引を「Closed Won」ステージに移動したときに捕捉されるHubSpotにおける明示的で標準的なイベントです。
その重要性この活動は、成功した結果を示し、営業サイクルタイムと勝率を測定するための重要な終点となります。多くの場合、下流のフルフィルメントおよび請求プロセスをトリガーします。取得元これは、「取引ステージ」が「受注」カテゴリのいずれかのステージに設定されたときに、標準「クローズ日」プロパティに記録されたタイムスタンプです。取得結果が受注であった場合の取引の「クローズ日」プロパティ。イベントタイプ explicit
	商談失注	これは、取引が正式に失注としてクローズされる最終的な失敗イベントです。ユーザーが取引を「Closed Lost」ステージに移動したときに捕捉される明示的で標準的なイベントです。
その重要性案件がいつ、なぜ失注したかを分析することは、プロセス改善にとって非常に重要です。このイベントは、失注案件の営業サイクル時間を計算するための終点となります。取得元これは、「取引ステージ」が「失注」カテゴリのいずれかのステージに設定されたときの、標準「クローズ日」プロパティのタイムスタンプです。「失注理由」プロパティがコンテキストを提供します。取得結果が失注であった場合の取引の「クローズ日」プロパティ。イベントタイプ explicit
	商談適格化	営業チームが商談を適格化し、予算、決定権、ニーズ、導入時期といった特定の基準を満たしていることを確認した時点を示します。これは通常、商談が営業パイプライン内の特定の「適格」ステージに移行したことから判断されます。
その重要性これは営業パイプラインの品質を理解するための重要なマイルストーンです。適格化までの時間を分析することは、営業プロセスの初期段階における効率性を特定するのに役立ちます。取得元取引オブジェクトの「取引ステージ」フィールドのプロパティ履歴から推測されます。具体的には、「購入資格あり」などのステージに入った際のタイムスタンプです。取得指定された「Qualified」ステージへの取引ステージ変更のタイムスタンプ。イベントタイプ inferred
	契約締結済み	この活動は、顧客が契約に署名した際の商業契約の最終決定を表します。HubSpotでは、見積書が承認された後、取引が「Contract Sent」または「Closed Won」ステージに移行したときに、このイベントが捕捉されることがよくあります。
その重要性これは、履行が始まる前の最終的な商業的合意のマイルストーンです。「見積もりから契約までのサイクルタイム」KPIを計算するために不可欠です。取得元これは、Deal Stageプロパティが「Contract Signed」またはそれに相当するステージに変更されたタイムスタンプから推測できます。見積書に電子署名が使用された場合、「Quote Accepted」と同義である可能性があります。取得「Contract Signed」または類似のステージへの取引ステージ変更のタイムスタンプ。イベントタイプ inferred
	見積書発行済み	この活動は、顧客への正式な価格見積書の作成と送付を示します。HubSpotのSales Hubには専用の「見積書」ツールがあり、取引のために見積書が作成され公開されたときに、このイベントが明示的に捕捉されます。
その重要性これは商業的意図を示す主要なマイルストーンです。適格化から見積書発行までの時間を分析することは、「見積もりから契約までのプロセスフロー」分析にとって極めて重要です。取得元取引に関連付けられたQuoteオブジェクトの作成タイムスタンプ。Quoteオブジェクトの「hs_createdate」プロパティ。取得関連する見積もりオブジェクトの作成日です。イベントタイプ explicit
	初回接触完了	取引に関連するコンタクトとの最初の記録されたインタラクション（電話、メール、会議など）を示します。これは、HubSpotの取引レコードに関連付けられたアクティビティタイムラインに明示的に捕捉されます。
その重要性作成から最初の連絡までの時間を追跡することは、営業チームの対応速度を測定するのに役立ちます。最初の連絡のタイプを分析することで、成功した取引におけるパターンを明らかにできます。取得元 Dealオブジェクトの作成日以降にそのオブジェクトに関連付けられた、最初の記録された活動（例：電話、メール、会議）のタイムスタンプ。取得取引のタイムライン上の最初の記録された活動のタイムスタンプ。イベントタイプ explicit
	注文完了	顧客への製品配送またはサービス提供の完了を示します。このイベントは通常HubSpotの外部で発生し、統合機能または「Service Delivered」もしくは「Order Complete」への手動の取引ステージ更新を介して記録されます。
その重要性プロセスの配送部分の完了を示します。これは「受注処理完了から請求書発行までの時間」KPIを測定するための出発点です。取得元 ERPまたはフルフィルメントシステムとの連携、あるいは手動更新が必要です。取引が「Fulfilled」のようなステージに入ったタイムスタンプから推測することができます。取得外部システムまたは手動ステージ変更からのステータス変更のタイムスタンプ。イベントタイプ inferred
	要件収集済み	この活動は、ディスカバリーコールまたは会議が行われ、顧客のニーズが文書化されたことを示します。通常、取引が営業パイプラインの特定のステージ（「Discovery」や「Needs Analysis」など）に進むことから推測されます。
その重要性このマイルストーンを追跡することは、営業チームが適格化から顧客ニーズの理解までどれだけ迅速に移行するかを評価するのに役立ちます。ここでの遅延は、スケジューリングの問題やリソースの制約を示唆する可能性があります。取得元「取引ステージ」フィールドのプロパティ履歴から推測されます。取引が「要件収集」のようなステージに入った際のタイムスタンプを捕捉します。取得ニーズ分析を表すステージへの取引ステージ変更のタイムスタンプ。イベントタイプ inferred
	見積書承認済み	このイベントは、顧客が正式に見積書を承認したときに発生し、多くの場合、電子署名を介して行われます。HubSpotの電子署名機能を通じて送付された見積書に顧客が署名したときに、このイベントが明示的に捕捉されます。
その重要性顧客が条件と価格に合意したことを示し、重要な購入シグナルです。見積もり発行から承認までの時間は、交渉サイクル時間を分析する上で鍵となります。取得元 Quoteオブジェクトの「hs_quote_accepted_date」プロパティ、または見積書に関連付けられた電子署名ログからの完了タイムスタンプ。取得 Quoteオブジェクトの「hs_quote_accepted_date」プロパティからのタイムスタンプ。イベントタイプ explicit
	解決策提示済み	顧客に正式なソリューションまたは製品デモンストレーションが提示された時点を示します。これは一般的に、「Presentation Scheduled」や「Demo Completed」といったステータスへの取引ステージ変更から推測されます。
その重要性この活動は、重要なミッドファネルのマイルストーンです。この時点までの時間を測定することで、営業サイクルのソリューションフェーズの効率性を分析するのに役立ちます。取得元取引のプロパティ履歴において、「プレゼンテーション予定」など関連するステージに取引ステージプロパティが変更されたタイムスタンプから推測されます。取得「Presentation」または「Proposal」ステージへの取引ステージ変更のタイムスタンプ。イベントタイプ inferred
	請求書生成済み	会計システムで顧客請求書が作成されたことを示します。このアクティビティはHubSpot Sales Hubネイティブのものではなく、取引のカスタムプロパティまたはステージを更新する統合によって捕捉されます。
その重要性これはキャッシュコンバージョンサイクルにおける重要なステップです。履行から請求書発行までの時間は、企業がサービスに対してどれだけ迅速に請求できるかに直接影響します。取得元 QuickBooksやXeroのような会計システムとの連携が必要です。このイベントは、カスタムプロパティのタイムスタンプや取引ステージの変更から推測されます。取得「請求書生成日」のようなカスタム日付プロパティからのタイムスタンプ。イベントタイプ inferred
	販売注文作成済み	営業から履行または運用チームへの内部引き渡しを示します。これは通常、HubSpotネイティブのイベントではなく、取引が「受注処理中」や「履行保留中」のような特定のパイプラインステージに移動したときに推測されます。
その重要性この活動は、営業から運用への引き渡しの効率性を分析するために極めて重要です。ここでの遅延は、顧客満足度と納期に影響を与える可能性があります。取得元「取引ステージ」フィールドのプロパティ履歴から推測され、販売後ステージへの移行タイムスタンプを記録します。取得「Order Processing」ステージへの取引ステージ変更のタイムスタンプ。イベントタイプ 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 UIで取引ステージを編集する際に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プライベートアプリトークン: 認証にはHubSpotプライベートアプリの有効なアクセストークンが必要です。このアプリは、Deals、Contacts、Engagements、Quotes、およびOwnersに対する読み取り権限を持っている必要があります。
日付範囲: スクリプトはSTART_DATEとEND_DATE変数で設定されます。抽出時間とAPI使用量を管理するため、まずは3～6ヶ月のような短い期間から始めることを推奨します。日付形式は「YYYY-MM-DD」である必要があります。
パイプラインステージマッピング: 「商談の資格あり」や「要件の収集」といったステージベースのアクティビティに関するスクリプトの精度は、PIPELINE_STAGE_MAPPING辞書に完全に依存します。この設定は、貴社のHubSpotにおける営業パイプラインステージを正確に反映している必要があります。
APIレート制限: HubSpotはAPIにレート制限を課しています（例：プロフェッショナルプランでは10秒あたり100リクエスト）。スクリプトにはこれを処理するための基本的なtime.sleep()メカニズムが含まれていますが、下位プランで非常に大規模なデータセットを扱う場合は、より控えめに調整する必要があるかもしれません。
カスタムプロパティ: HubSpotインスタンスがRegionのような属性や「請求書発行済み」のようなアクティビティのデータを追跡するためにカスタムプロパティを使用している場合、それらのプロパティ名をスクリプトの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プライベートアプリの作成
- 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リクエストの設定
- 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になるまでこのプロセスをループで続行します。これは、指定した日付範囲内のすべての取引を取得したことを示します。
JSONレスポンスをイベントログに変換する
- APIはネストされたJSON構造を返します。このレスポンスを解析し、フラットな表形式のイベントログに変換するスクリプトを作成する必要があります。返される各取引オブジェクトについて：
- イベント1: 商談作成: 1行作成します。ActivityNameは「商談作成」、EventTimeは取引のcreatedateです。
- イベント2: 最初の連絡: 関連するすべての通話、メール、会議の中から最も早いhs_created_dateを見つけます。このタイムスタンプで1行作成します。アクティビティが存在しない場合、このイベントは作成されません。
- イベント3-12: ステージベースのアクティビティ: dealstageのproperties_with_history配列を繰り返し処理します。各エントリについて、ActivityNameがステージ名（例：「商談の資格あり」、「ソリューションの提案」）にマッピングされ、EventTimeがupdated_atタイムスタンプである行を作成します。このマッピングは、特定の営業パイプラインステージに基づいて定義する必要があります。
- イベント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
  - その他の属性は、主要な取引プロパティから入力できます。
静的および最終的な列の追加
- 静的な値「HubSpot CRM」を持つSourceSystem列を追加します。
- 抽出スクリプトが実行されたタイムスタンプを持つLastDataUpdate列を追加します。
CSVへのエクスポート
- 最終的に変換された表形式データをCSVファイルとして保存します。タイムスタンプが consistent な形式（例：ISO 8601）であることを確認してください。このファイルはProcessMindへのアップロード準備が整いました。

設定

プライベートアプリのスコープ: HubSpotプライベートアプリには、最低限、以下のスコープに対する読み取りアクセス権が必要です: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はリクエストあたり100レコードに制限されています。すべてのデータを取得するために、抽出スクリプトはafterカーソルを使用したページネーションを処理するように設計する必要があります。
APIレート制限: 特に大量のデータを抽出する際には、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
        }
      }
    }
  }
}

リード・ツー・キャッシュデータテンプレート

リード・ツー・キャッシュデータテンプレート

リードからキャッシュまでの属性

リードからキャッシュまでのアクティビティ

抽出ガイド

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

ステップ

設定

a クエリ例 python

HubSpot GraphQL APIによるターゲット抽出

ステップ

設定

a クエリ例 graphql

今すぐ始めますか？

20%以上の勝率を達成：今すぐLead to Cashをマスター

リード・ツー・キャッシュ データテンプレート

リード・ツー・キャッシュ データテンプレート

リードからキャッシュまでの属性

リードからキャッシュまでのアクティビティ

抽出ガイド

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

ステップ

設定

a クエリ例 python

HubSpot GraphQL APIによるターゲット抽出

ステップ

設定

a クエリ例 graphql

お客様のプライバシーを大切にしています

今すぐ始めますか？

20%以上の勝率を達成：今すぐLead to Cashをマスター

リード・ツー・キャッシュデータテンプレート

リード・ツー・キャッシュデータテンプレート