HubSpot 接続

Last update: Mon Apr 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
宛先

作成対象：

管理者
ユーザー

HubSpotは、マーケティング、セールス、コンテンツ管理、カスタマーサービスの連携に必要なあらゆるソフトウェア、統合、リソースを備えたCRM プラットフォームです。単一のCRM プラットフォームで、データ、チーム、顧客を結びつけることができます。

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

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

ユースケース use-cases

HubSpot宛先を使用する方法とタイミングをより理解しやすくするために、Adobe Experience Platformのお客様がこの宛先を使用して解決できる使用例を次に示します。

HubSpot件の連絡先には、自社と接触した個人に関する情報が保存されています。チームはHubSpotに存在する連絡先を使用して、Experience Platform オーディエンスを構築します。これらのオーディエンスをHubSpotに送信すると、情報が更新され、各コンタクトには、そのコンタクトがどのオーディエンスに属しているかを示すオーディエンス名として、その値を持つプロパティが割り当てられます。

前提条件 prerequisites

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

Experience Platform の前提条件 prerequisites-in-experience-platform

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

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

HubSpot宛先の前提条件 prerequisites-destination

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

HubSpot アカウントが必要です prerequisites-account

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

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

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

プライベートアプリをお持ちでない場合は、ドキュメントのCreate a private app in HubSpotに従ってください。

IMPORTANT

プライベートアプリには、以下のスコープを割り当てる必要があります。
crm.objects.contacts.write, crm.objects.contacts.read
crm.schemas.contacts.write, crm.schemas.contacts.read

資格情報

説明

例

Bearer token

Access token プライベートアプリのHubSpot。
お客様のHubSpot Access tokenを取得するには、HubSpot ドキュメントに従って、アプリのアクセストークンを使用してAPI呼び出しを行います。

pat-na1-11223344-abcde-12345-9876-1234a1b23456

ガードレール guardrails

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

サポートされる ID supported-identities

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

ターゲット ID

例

説明

注意点

email

test@test.com

連絡先のメールアドレス。

必須

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

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

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

この宛先は、次の表に記載されているオーディエンスのアクティブ化もサポートしています。

オーディエンスの由来

サポートあり

説明

Segmentation Service

○

Experience Platform セグメント化サービスを通じて生成されたオーディエンス。

その他すべてのオーディエンスの生成元

このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。様々なオーディエンスの起源について読みます。次に例を示します。

カスタムアップロードオーディエンスがCSV ファイルからExperience Platformにをインポートしました。
類似オーディエンス，
連合オーディエンス，
Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
その他。

オーディエンスのデータタイプ別にサポートされるオーディエンス：

オーディエンスのデータタイプ

サポートあり

説明

ユースケース

人物オーディエンス

○

顧客プロファイルにもとづいて、マーケティング施策の特定のグループをターゲットにすることができます。

買い物客やカートの放棄が多い

アカウントオーディエンス

アカウントベースドマーケティング戦略のために、特定の組織内の個人をターゲットにします。

B2B マーケティング

見込みオーディエンス

まだ顧客ではないが、ターゲットオーディエンスと特徴を共有する個人をターゲットにします。

サードパーティデータによる見込み顧客の開拓

データセットの書き出し

Adobe Experience Platform データレイクに保存されている構造化データのコレクション。

レポート，データサイエンスワークフロー

書き出しのタイプと頻度 export-type-frequency

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

項目

タイプ

メモ

書き出しタイプ

Profile-based

オーディエンスのすべてのメンバーを、フィールドマッピングに従って、目的のスキーマフィールド （例：電子メールアドレス、電話番号、姓）と共に書き出します。
さらに、HubSpotで新しいプロパティがオーディエンス名を使用して作成され、その値は、選択した各オーディエンスについて、Experience Platformの対応するオーディエンスステータスになります。

書き出し頻度

Streaming

ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。

宛先への接続 connect

IMPORTANT

宛先に接続するには、View DestinationsおよびManage Destinations アクセス制御権限が必要です。詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。

Destinations > Catalog内でHubSpotを検索します。または、CRM カテゴリの下に配置することもできます。

宛先に対する認証 authenticate

以下の必須のフィールドに入力します。ガイダンスについては、プライベートアプリアクセストークン HubSpot を収集の節を参照してください。

Bearer token: HubSpot プライベートアプリのアクセストークン。

宛先に対する認証を行うには、Connect to destinationを選択します。
認証方法を示す Experience Platform UIのスクリーンショット。

指定された詳細が有効な場合、UIには緑色のチェックマークが付いたConnected ステータスが表示されます。その後、次の手順に進むことができます。

宛先の詳細を入力 destination-details

宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
宛先の詳細を示す Experience Platform UIのスクリーンショット。

Name：今後この宛先を認識する際に使用する名前。
Description：今後この宛先を特定するのに役立つ説明です。

アラートの有効化 enable-alerts

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続の詳細の提供が完了したら、Nextを選択します。

この宛先に対してオーディエンスをアクティブ化 activate

IMPORTANT

データをアクティブ化するには、View Destinations、Activate Destinations、View ProfilesおよびView Segments アクセス制御権限が必要です。アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。

この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。

属性と ID のマッピング map

オーディエンスデータをAdobe Experience PlatformからHubSpot宛先に正しく送信するには、フィールドマッピング手順を実行する必要があります。マッピングでは、Experience Platform アカウントのExperience Data Model （XDM）スキーマフィールドと、ターゲット先の対応するスキーマフィールドとの間にリンクを作成します。

XDM フィールドをHubSpot宛先フィールドに正しくマッピングするには、次の手順に従います。

`Email` IDのマッピング map-email-identity

Email IDは、この宛先の必須マッピングです。マッピングするには、次の手順に従います。

Mapping ステップで、Add new mappingを選択します。新しいマッピング行が画面に表示されるようになりました。
「新しいマッピングを追加」ボタンがハイライト表示された
Select source field ウィンドウで、Select identity namespaceを選択し、IDを選択します。
Select target field ウィンドウで、Select attributesを選択し、emailを選択します。

ソースフィールド

ターゲットフィールド

必須

IdentityMap: Email

Identity: email

○

ID マッピングの例を次に示します。
電子メール ID マッピングを使用した Experience Platform UI スクリーンショットの例。

オプション属性のマッピング mapping-optional-attributes

XDM プロファイルスキーマとHubSpot アカウントの間で更新するその他の属性を追加するには、次の手順を繰り返します。

Mapping ステップで、Add new mappingを選択します。新しいマッピング行が画面に表示されるようになりました。
「新しいマッピングを追加」ボタンがハイライト表示された
Select source field ウィンドウで、Select attributes カテゴリを選択し、XDM属性を選択します。
Select target field ウィンドウで、Select attributes カテゴリを選択し、HubSpot アカウントから自動的に入力される属性のリストから選択します。宛先はHubSpot プロパティ APIを使用して、この情報を取得します。 HubSpot デフォルトのプロパティとカスタムプロパティの両方が、ターゲットフィールドとして選択用に取得されます。

XDM プロファイルスキーマとHubspot間の使用可能なマッピングをいくつか次に示します。

ソースフィールド

ターゲットフィールド

xdm: person.name.firstName

Attribute: firstname

xdm: person.name.lastName

Attribute: lastname

xdm: workAddress.street1

Attribute: address

xdm: workAddress.city

Attribute: city

xdm: workAddress.country

Attribute: country

これらの属性マッピングを使用した例を次に示します。
属性マッピングを使用したExperience Platform UI スクリーンショットの例。

宛先接続のマッピングの提供が完了したら、Nextを選択します。

データの書き出しを検証する exported-data

宛先が正しく設定されていることを検証するには、次の手順に従います。

HubSpot web サイトに移動し、Contacts ページに移動して、オーディエンスのステータスを確認します。このリストは、オーディエンス名で作成されたカスタムプロパティの列を、その値がオーディエンスステータスで表示するように設定できます。
または、個々のPerson ページにドリルダウンして、オーディエンス名とオーディエンスのステータスを表示するプロパティに移動することもできます。
オーディエンス名とオーディエンスのステータスを表示するカスタムプロパティを含む連絡先ページを示す