HubSpot on hdknr blog

HubSpot Line Items API：取引・見積もりに紐づく商品項目を管理する

Wed, 18 Mar 2026 00:00:00 +0000

HubSpot CRM の Line Items（商品項目）API について整理します。Line Items は製品（Product）が取引（Deal）や見積もり（Quote）に紐付けられたときに生成される個別のインスタンスです。

Line Items とは

HubSpot における Line Items は、製品カタログ（Products）とは異なる概念です。

Product: 製品カタログ上のマスターデータ
Line Item: Product が取引・見積もりなどに追加された際の個別インスタンス

Line Items への変更は元の Product には影響しません。取引ごとに価格や数量をカスタマイズできます。

API エンドポイント

ベース URL: /crm/v3/objects/line_items

操作	メソッド	エンドポイント
作成	POST	`/crm/v3/objects/line_items`
個別取得	GET	`/crm/v3/objects/line_items/{lineItemId}`
一覧取得	GET	`/crm/v3/objects/line_items`
更新	PATCH	`/crm/v3/objects/line_items/{lineItemId}`
削除	DELETE	`/crm/v3/objects/line_items/{lineItemId}`

必要なスコープ

スコープ	用途
`crm.objects.line_items.read`	データ取得
`crm.objects.line_items.write`	作成・更新
`tax_rates.read`	税率情報の取得

データモデル詳細

Line Item の全プロパティは GET /crm/v3/properties/line_item で取得できます。以下はカテゴリ別の主要プロパティです。

基本情報

内部名	表示名	説明	備考
`name`	名前	商品項目の名前	必須
`description`	説明	製品の詳細な説明
`hs_sku`	SKU	製品の固有識別子
`hs_product_id`	製品 ID	関連する製品ライブラリの ID	製品から作成時に指定
`hs_object_id`	レコード ID	Line Item の一意な ID	自動設定・読み取り専用
`hs_product_type`	製品タイプ	`INVENTORY`（在庫）/ `NON_INVENTORY`（非在庫）/ `SERVICE`（サービス）
`hs_url`	URL	製品の Web ページ URL
`hs_images`	画像 URL	製品画像の URL

価格・数量

内部名	表示名	説明	備考
`quantity`	数量	含まれる製品の単位数
`price`	単価	購入者向けの製品単価	負の値は不可
`amount`	正価（Net price）	合計金額（数量 × 単価）	計算フィールド
`hs_cost_of_goods_sold`	売上原価	製品の原価
`hs_line_item_currency_code`	通貨	通貨コード（例: `JPY`, `USD`）
`hs_pricing_model`	価格モデル	`FLAT`（定額）または `TIERED`（段階制）
`hs_effective_unit_price`	有効単価	段階制価格の場合に適用される実効単価

割引

内部名	表示名	説明	備考
`hs_discount_percentage`	割引率	適用される割引の割合（%）
`discount`	単位割引額	単位あたりの割引金額
`hs_total_discount`	合計割引額	割引率と割引金額を考慮した総割引額	計算フィールド
`hs_pre_discount_amount`	割引前金額	割引適用前の金額	計算フィールド

税金

内部名	表示名	説明	備考
`hs_tax_rate_group_id`	税率グループ ID	適用する税率の識別子
`tax`	税額	適用される税金額
`hs_tax_amount`	計算税額	税率から自動計算された税額	計算フィールド
`hs_tax_rate`	税率	適用される税率（%）
`hs_after_tax_amount`	税込金額	税額適用後の金額	計算フィールド

定期請求（Recurring Billing）

内部名	表示名	説明	備考
`recurringbillingfrequency`	請求頻度	定期請求の頻度（`monthly`, `quarterly`, `annually` など）
`hs_recurring_billing_period`	請求期間	ISO-8601 期間形式（例: `P12M` = 12ヶ月, `P1Y` = 1年）	PnYnMnD / PnW 形式
`hs_recurring_billing_start_date`	請求開始日	定期請求の開始日
`hs_recurring_billing_end_date`	請求終了日	定期請求の終了日
`hs_recurring_billing_terms`	請求条件	`FIXED`（固定回数）または `AUTO_RENEW`（自動更新）
`hs_recurring_billing_number_of_payments`	支払い回数	固定回数請求の場合の支払い総数
`hs_billing_start_delay_days`	請求開始遅延（日）	請求開始を遅延させる日数
`hs_billing_start_delay_months`	請求開始遅延（月）	請求開始を遅延させる月数
`hs_billing_start_delay_type`	請求遅延タイプ	`FIXED_DATE`（固定日）または `DELAYED_PERIOD`（遅延期間）
`hs_term_in_months`	期間（月）	契約期間の月数

収益指標（計算フィールド）

内部名	表示名	説明
`hs_tcv`	総契約額（TCV）	Total Contract Value
`hs_acv`	年間契約額（ACV）	Annual Contract Value
`hs_arr`	年間経常収益（ARR）	Annual Recurring Revenue
`hs_mrr`	月間経常収益（MRR）	Monthly Recurring Revenue
`hs_margin`	マージン	売上 − 売上原価
`hs_margin_tcv`	マージン TCV	TCV − 売上原価合計
`hs_margin_acv`	マージン ACV	ACV − 売上原価（年間）
`hs_margin_arr`	マージン ARR	ARR − 売上原価（年間）
`hs_margin_mrr`	マージン MRR	MRR − 売上原価（月間）

システムプロパティ（読み取り専用）

内部名	表示名	説明
`createdate`	作成日時	レコード作成日時
`hs_lastmodifieddate`	最終更新日時	プロパティが最後に変更された日時
`hs_created_by_user_id`	作成者ユーザー ID	レコードを作成したユーザー
`hs_updated_by_user_id`	更新者ユーザー ID	最後に更新したユーザー
`hs_object_source`	レコードソース	レコードの作成方法
`hs_was_imported`	インポートフラグ	インポートによって作成されたかどうか

プロパティの種別

必須: name のみが作成時に必須。ただし price と quantity も通常は指定する
計算フィールド: amount, hs_total_discount, hs_pre_discount_amount, hs_after_tax_amount, hs_tax_amount, 収益指標（TCV/ACV/ARR/MRR）は HubSpot が自動計算する。API から直接設定はできない
読み取り専用: システムプロパティ（作成日時、更新日時、ユーザー ID 等）は自動設定される
price の制約: 負の値を設定できない

Line Item の作成例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


POST /crm/v3/objects/line_items

{
 "properties": {
 "name": "Web開発サービス",
 "hs_product_id": "12345",
 "quantity": "1",
 "price": "500000"
 }
}

取引や見積もりへの関連付けを同時に行う場合は、後述の「関連付け」セクションを参照してください。

HubSpotを活用したレストランのディナータイム集客戦略

Wed, 18 Mar 2026 00:00:00 +0000

HubSpotを活用してディナータイムの集客を強化するのは、非常に理にかなった戦略です。レストランの場合、**「適切なタイミングで、適切な人に、美味しそうな視覚情報を届ける」**のが鉄則です。

MA（マーケティングオートメーション）の強みを活かした、具体的で即効性のある施策を紹介します。

1. 顧客リストのセグメント化とパーソナライズ

「夜の利用者」を増やすには、まず「誰が夜に来てくれる可能性が高いか」を分類します。

「ランチのみ利用者」の抽出

HubSpotのコンタクト管理で、過去の予約データからランチ利用のみの顧客をリスト化します。「ランチとは違う夜の特別な雰囲気」を訴求するメールを自動送信します。

記念日フラグの活用

誕生日や結婚記念日の1ヶ月前に、「ディナー限定の乾杯スパークリングサービス」などの特典付きワークフローを起動させます。

2. 行動ログに基づいた「空腹時」のプッシュ

HubSpotのトラッキング機能を使い、顧客がWebサイトを閲覧した瞬間にアプローチします。

夕方の特定ページ閲覧をトリガーに

16:00〜18:00の間にメニューページや予約ページを見たが予約に至らなかったユーザーに対し、**「本日空席あり。今すぐの予約でデザート1品サービス」**といった内容を、LINE（連携時）やメールで即座に送ります。

HubSpotではカスタムイベントと行動トリガーを組み合わせたワークフローを構築でき、ページ閲覧をトリガーとした自動配信が可能です。行動トリガーメールは、通常の一斉配信メールと比較して約50%高い開封率が期待できるとされています。

3. シーン別のコンテンツ作成とリードマグネット

「夜に行こう」と思うきっかけをWebサイト上に作ります。

利用シーン別のランディングページ (LP)

「接待・会食」「大人のデート」「自分へのご褒美」など、目的別のLPを用意します。HubSpotのCMS Hubを使えば、これらのページを簡単に作成・管理できます。

eBook/クーポンの配布

「ソムリエが選ぶ、お肉料理に合うワインガイド」などの資料ダウンロードと引き換えにメールアドレスを獲得し、そこからディナー誘導のステップメールを流します。

4. HubSpotとSNS・広告の連携

リターゲティング広告

Webサイトのディナーメニューを見たユーザーに対して、Instagramで「夜のシズル感溢れる動画広告」を配信します。HubSpotの広告管理ツールを通じて、Facebook/Instagram広告との連携が可能です。

Google ビジネスプロフィールとの連動

HubSpotで収集したポジティブなレビューをGoogleに反映させる仕組みを作り、「夜の評判」を可視化して新規客の安心感を高めます。

施策の優先順位

施策内容	難易度	期待効果	必要なツール
記念日自動メール	低	高	HubSpot ワークフロー
ランチ客へのディナー訴求	低	中	リストセグメント
閲覧行動ベースのリアルタイム配信	中	高	トラッキングコード + ワークフロー
シーン別LP作成	中	中	CMS Hub

LINE連携について

HubSpotとLINEの連携には、LITTLE HELP CONNECT などのサードパーティツールを利用します。連携することで、HubSpotのワークフローからLINEメッセージの自動配信が可能になり、セグメントごとに異なるメッセージを適切なタイミングで届けられます。

まとめ

HubSpotのMA機能をレストランの集客に活用することで、「来てほしい人に、来てほしいタイミングで、行きたくなる情報を届ける」仕組みを構築できます。まずは難易度の低い記念日メールやランチ客へのディナー訴求から始め、段階的にトラッキングベースの施策へ拡張していくのがおすすめです。

Zapier を使った HubSpot と Asana の連携：集計ロジックも追加する方法

Wed, 18 Mar 2026 00:00:00 +0000

Zapier を使って HubSpot と Asana を連携させる方法と、Code by Zapier で集計ロジックを追加するテクニックを紹介します。

HubSpot × Asana 連携の基本

HubSpot（CRM・マーケティング）と Asana（プロジェクト管理）を連携させることで、営業パイプラインとタスク管理を自動化できます。Zapier を使えばノーコードで連携を構築できます。

よくある連携パターン

トリガー（HubSpot）	アクション（Asana）	ユースケース
新規ディールが作成された	タスクを作成	商談ごとにプロジェクトタスクを自動生成
ディールのステージが変わった	タスクを更新	進捗をリアルタイムに反映
フォーム送信があった	タスクを作成	問い合わせ対応タスクを自動起票
新規チケットが作成された	タスクを作成	サポート対応を Asana で管理

逆方向の連携もあります。

トリガー（Asana）	アクション（HubSpot）	ユースケース
タスクが完了した	コンタクトを更新	納品完了を CRM に反映
タスクにコメントが追加された	エンゲージメントを作成	活動履歴を CRM に記録

Zapier での連携セットアップ

1. Zap の作成

Zapier にログインし、「Create Zap」から新しい Zap を作成します。

トリガーの設定（例: HubSpot → Asana）:

トリガーアプリに HubSpot を選択
トリガーイベントに「New Deal」を選択
HubSpot アカウントを接続
テストを実行して動作確認

アクションの設定:

ジオマーケティングとは？位置情報を活用した集客手法と FreakOut ASE の特徴

Wed, 18 Mar 2026 00:00:00 +0000

ジオマーケティング（Geo-marketing）は、スマートフォンの GPS やWi-Fi、ビーコンなどから取得した位置情報を活用して、特定エリアのユーザーに最適な広告や情報を配信するマーケティング手法です。ここでは、ジオマーケティングの基本と、FreakOut 社が提供する位置情報マーケティングプラットフォーム「ASE」を紹介します。

ジオマーケティングの基本

ジオマーケティングとは、ユーザーの位置情報データを分析・活用して、地域に根差した集客やプロモーションを行う手法です。

取得できるデータ

来訪者の属性: どこから来ているか、年代、単身か家族連れか
行動パターン: 何曜日の何時に人が集まるか
商圏分析: 周辺エリアの人流データ

主なデータソース

GPS（スマートフォン）
Wi-Fi 接続情報
ビーコン（Bluetooth）
IP アドレス

FreakOut ASE — 位置情報マーケティングプラットフォーム

FreakOut ASE は、フリークアウト社が提供する位置情報マーケティングプラットフォームです。

主な特徴

項目	内容
リーチ規模	5,000万以上のユーザー
エリア精度	最小半径1m の円指定、ポリゴン指定に対応
配信面	Red ネットワーク、TVer PMP、各種 SNS
来店計測	建物に沿った精密な来店計測
分析機能	推定居住エリア、ユーザー行動分析

データソース

チェーンストアデータ
NTT iタウンページ
ゼンリン社の住居データ

提携した大手スマートフォンアプリベンダーや位置情報データプラットフォーマーから位置情報を取得し、国内最大規模の位置情報データベースを構築しています。

活用シーン

ジオマーケティングは、実店舗を持つビジネスとの相性が良く、以下のような活用が可能です。

チラシ・OOH の補完

ショッピングモールへの来場促進
新店舗オープンの告知

ターゲティング広告

大学オープンキャンパスの告知（周辺エリアの高校生向け）
自動車ディーラーへの来店促進
住宅展示場への誘導
学習塾の受講者募集

流通対策

家電量販店での販売促進
ドラッグストア来店者への医薬品告知

国内主要サービス比較 — ASE / AIR TRACK / GeoLogic Ad

FreakOut ASE 以外にも、国内にはジオターゲティング広告の主要プラットフォームがあります。ここでは代表的な 2 サービスと機能を比較します。