HubSpot 接続

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
宛先

作成対象：

管理者
ユーザー

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

この Adobe Experience Platformdestination は、HubSpot Contacts 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

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

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

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

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

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 token

HubSpot プライベートアプリの Access token。
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 のセグメント化サービスで生成したすべてのオーディエンスのアクティブ化をサポートします。

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

オーディエンスタイプ

説明

カスタムアップロード

CSV ファイルから Experience Platform に読み込まれたオーディエンス。

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

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

項目

タイプ

メモ

書き出しタイプ

プロファイルベース

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

書き出し頻度

ストリーミング

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

宛先への接続 connect

IMPORTANT

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

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

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

宛先に対する認証 authenticate

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

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

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

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

宛先の詳細を入力 destination-details

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

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

アラートの有効化 enable-alerts

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

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

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

IMPORTANT

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

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

属性と ID のマッピング map

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

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

`Email` ID のマッピング

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

マッピング 手順で、「新しいマッピングを追加」を選択します。これで、新しいマッピング行が画面に表示されます。
ソースフィールドを選択 ウィンドウで、「ID 名前空間を選択 を選択し、ID を選択します。
ターゲットフィールドを選択 ウィンドウで 属性を選択 を選択し email す。

ソースフィールド

ターゲットフィールド

必須

IdentityMap: Email

Identity: email

○

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

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

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

マッピング 手順で、「新しいマッピングを追加」を選択します。これで、新しいマッピング行が画面に表示されます。
ソースフィールドを選択 ウィンドウで、属性を選択 カテゴリを選択して、XDM 属性を選択します。
ターゲットフィールドを選択 ウィンドウで 属性を選択 カテゴリを選択し、HubSpot アカウントから自動的に入力される属性のリストから選択します。宛先では HubSpot Properties 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

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

宛先接続のマッピングの指定を終えたら「次へ」を選択します。

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

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

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