HubSpot 接続

最終更新日： 2025年5月5日

作成対象：

  • 管理者
  • ユーザー

HubSpot は、マーケティング、セールス、コンテンツ管理、カスタマーサービスを結び付けるために必要なすべてのソフトウェア、統合、リソースを備えた CRM プラットフォームです。 データ、チーム、顧客を 1 つの CRM プラットフォームに接続できます。

この Adobe Experience Platform 宛先は、HubSpot Contacts API を活用して、アクティブ化後に既存のExperience Platform オーディエンスから HubSpot 内の連絡先を更新します。

HubSpot インスタンスを認証する手順は、さらに下の宛先に対する認証の節にあります。

ユースケース

HubSpot 宛先を使用する方法とタイミングを理解しやすくするために、Adobe Experience Platform のお客様がこの宛先を使用して解決できるユースケースのサンプルを以下に示します。

連絡先 HubSpot、ビジネスとやり取りする個人に関する情報を保存します。 チームは、HubSpot に存在する連絡先を使用してExperience Platform オーディエンスを作成します。 これらのオーディエンスを HubSpot に送信すると、その情報が更新され、各連絡先には、連絡先が属するオーディエンスを示すオーディエンス名としてその値を持つプロパティが割り当てられます。

前提条件

Experience Platformと HubSpot で設定する必要がある前提条件と、HubSpot の宛先を使用する前に収集する必要がある情報については、以下の節を参照してください。

Experience Platform の前提条件

HubSpot の宛先へのデータをアクティブ化する前に、 スキーマ、 データセットおよび オーディエンスを Experience Platform で作成する必要があります。

オーディエンスのステータスに関するガイダンスが必要な場合は、 オーディエンスメンバーシップの詳細スキーマフィールドグループに関するExperience Platform ドキュメントを参照してください。

HubSpot の宛先の前提条件

Experience Platformから HubSpot アカウントにデータを書き出すには、次の前提条件に注意してください。

HubSpot アカウントが必要です

Experience Platformから Hubspot アカウントにデータをエクスポートするには、HubSpot アカウントが必要です。 アカウントをお持ちでない場合は、HubSpot アカウントの設定ページにアクセスし、ガイダンスに従ってアカウントを登録して作成してください。

HubSpot プライベートアプリアクセストークンの収集

HubSpot の宛先が HubSpot アカウント内の HubSpot プライベートアプリを介して API 呼び出しを行えるようにするには、HubSpot Access token が必要です。 Access token は、（宛先を認証 する際の Bearer token として機能ます。

プライベートアプリがない場合は、のドキュメントに従って プライベートアプリの作成 HubSpot してください。

IMPORTANT
プライベートアプリには、次の範囲を割り当てる必要があります。
crm.objects.contacts.write, crm.objects.contacts.read
crm.schemas.contacts.write, crm.schemas.contacts.read
資格情報説明例
Bearer tokenHubSpot プライベートアプリの Access token。
HubSpot を取得する Access token は、HubSpot のドキュメントに従って アプリのアクセストークンを使用して API 呼び出しを行うください。		pat-na1-11223344-abcde-12345-9876-1234a1b23456

ガードレール

HubSpot のプライベートアプリには、「レート制限 の対象となます。 プライベートアプリで実行できる呼び出しの数は、HubSpot アカウントのサブスクリプションと、API アドオンを購入したかどうかに基づきます。 また、 その他の制限も参照してください。

サポートされる ID

HubSpot では、以下の表で説明する ID の更新をサポートしています。ID についての詳細情報。

ターゲット ID例説明注意点
emailtest@test.com連絡先のメールアドレス。必須

サポートされるオーディエンス

この節では、この宛先に書き出しできるすべてのオーディエンスについて説明します。

この宛先では、Experience Platform のセグメント化サービスで生成したすべてのオーディエンスのアクティブ化をサポートします。

この宛先では、以下の表で説明するオーディエンスのアクティブ化もサポートされています。

オーディエンスタイプ説明
カスタムアップロードCSV ファイルから Experience Platform に読み込まれたオーディエンス。

書き出しのタイプと頻度

宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。

項目タイプメモ
書き出しタイププロファイルベース
  • フィールドマッピングに従って、目的のスキーマフィールド （例：メールアドレス、電話番号、姓） と共に、オーディエンスのすべてのメンバーを書き出します。
  • さらに、HubSpot では、選択した各オーディエンスに対して、オーディエンス名を使用して新しいプロパティが作成され、その値はExperience Platformの対応するオーディエンスステータスになります。
書き出し頻度ストリーミング
  • ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。