HubSpot 接続

最終更新日: 2024-01-25
  • トピック:
  • Destinations
    このトピックの詳細を表示
  • 作成対象:
  • Developer
    User
    Admin
    Leader

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

この Adobe Experience Platform 宛先 は、 HubSpot 連絡先 API,内の連絡先を更新 HubSpot アクティブ化後に既存のExperience Platformオーディエンスから

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

ユースケース

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

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

前提条件

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

Experience Platform の前提条件

に対してデータをアクティブ化する前に HubSpot 宛先の スキーマ, a データセット、および audiences 次で作成: Experience Platform.

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

の前提条件 HubSpot 宛先

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

次をお持ちの場合は、 HubSpot アカウント

Platform からにデータを書き出すには、以下を実行します。 Hubspot アカウントに HubSpot アカウント。 まだない場合は、 HubSpot アカウントの設定 ページを開き、ガイダンスに従って登録し、アカウントを作成します。

を収集します。 HubSpot プライベートアプリアクセストークン

次が必要です: HubSpot Access token 許可する HubSpot の宛先を使用して、 HubSpot 内のプライベートアプリ HubSpot アカウント。 The Access token ~の役割を果たす Bearer token いつ 宛先の認証.

プライベートアプリをお持ちでない場合は、ドキュメントに従って、 でのプライベートアプリの作成 HubSpot.

重要

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

資格情報 説明
Bearer token The Access token の HubSpot プライベートアプリ。
次の手順で、 HubSpot Access token 後を追う HubSpot ~に関する文書 アプリのアクセストークンで API 呼び出しをおこなう.
pat-na1-11223344-abcde-12345-9876-1234a1b23456

ガードレール

HubSpot 非公開アプリは次の条件を満たす レート制限. プライベートアプリで実行できる呼び出しの数は、 HubSpot アカウントの購読と、API アドオンを購入したかどうか。 また、 その他の制限.

サポートされる ID

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

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

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

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

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

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

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

書き出しのタイプと頻度

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

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

宛先への接続

重要

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

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

宛先カタログ​内で HubSpot を検索します。または、CRM カテゴリの下に配置することもできます。

宛先に対する認証

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

  • Bearer トークン: HubSpot プライベートアプリ。

宛先を認証するには、「 宛先に接続」を選択します。
認証方法を示す Platform UI のスクリーンショット。

指定した詳細が有効な場合、UI で​接続済み​ステータスに緑色のチェックマークが付きます。その後、次の手順に進むことができます。

宛先の詳細を入力

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

  • 名前:今後この宛先を認識するための名前。
  • 説明:今後この宛先を識別するのに役立つ説明。

アラートの有効化

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

宛先接続の詳細の入力を終えたら「次へ」を選択します。

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

重要

データをアクティブ化するには、 宛先の表示, 宛先のアクティブ化, プロファイルの表示、および セグメントを表示 アクセス制御権限. アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。

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

属性と ID のマッピング

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

XDM フィールドを HubSpot 宛先フィールドには、次の手順に従います。

のマッピング Email id

The Email id は、この宛先での必須マッピングです。 次の手順に従って、マッピングします。

  1. マッピング​手順で、「新しいマッピングを追加」を選択します。これで、新しいマッピング行が画面に表示されます。
    新しいマッピングを追加ボタンがハイライト表示された Platform UI のスクリーンショット。
  2. Adobe Analytics の ソースフィールドを選択 ウィンドウで、 ID 名前空間を選択 ID を選択します。
    ID としてマッピングするソース属性として電子メールを選択した Platform UI のスクリーンショット。
  3. Adobe Analytics の ターゲットフィールドを選択 ウィンドウで、 属性を選択 を選択し、 email.
    ID としてマッピングするターゲット属性としてメールを選択した Platform UI のスクリーンショット。
ソースフィールド ターゲットフィールド 必須
IdentityMap: Email Identity: email

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

マッピング オプション 属性

XDM プロファイルスキーマと HubSpot アカウントは、以下の手順を繰り返します。

  1. マッピング​手順で、「新しいマッピングを追加」を選択します。これで、新しいマッピング行が画面に表示されます。
    新しいマッピングを追加ボタンがハイライト表示された Platform UI のスクリーンショット。
  2. Adobe Analytics の ソースフィールドを選択 ウィンドウで、 属性を選択 カテゴリを選択し、XDM 属性を選択します。
    ソース属性として名を選択した Platform UI のスクリーンショット。
  3. Adobe Analytics の ターゲットフィールドを選択 ウィンドウ:選択 属性を選択 カテゴリを選択し、属性のリストから選択します。属性のリストは、 HubSpot アカウント。 宛先は、 HubSpot プロパティ この情報を取得する API です。 両方 HubSpot デフォルトのプロパティ およびすべてのカスタムプロパティがターゲットフィールドとして取得され、選択できます。
    ターゲット属性として名を選択した Platform UI のスクリーンショット。

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

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

宛先接続のマッピングの指定が完了したら、「 」を選択します。 次へ.

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

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

  1. にログインします。 HubSpot web サイトに移動し、 連絡先 ページを開いて、オーディエンスのステータスを確認します。 このリストは、オーディエンス名を使用して作成されたカスタムプロパティの列を表示するように設定でき、その値がオーディエンスのステータスになります。
    オーディエンス名とセルのオーディエンスステータスを示す列ヘッダーを持つ連絡先ページを示す HubSpot UI スクリーンショット

  2. 別の方法として、個人にドリルダウンすることもできます。 人物 ページを開き、オーディエンス名とオーディエンスのステータスを表示しているプロパティに移動します。
    HubSpot UI のスクリーンショットに、オーディエンス名とオーディエンスのステータスを示すカスタムプロパティを含む連絡先ページが表示されています。

データの使用とガバナンス

Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。

その他のリソース

以下に示すその他の役に立つ情報 HubSpot 以下のドキュメントです。

変更ログ

この節では、この宛先コネクタに対する機能の概要と重要なドキュメントの更新について説明します。

 変更ログを表示
リリース月 更新タイプ 説明
2023年9月 初回リリース 宛先の初回リリースとドキュメントの公開。

このページ