HubSpotインテグレーションは、HubSpotのメタデータをPendoのサブスクリプションに取り込みます。このインテグレーションでは、サブスクリプションのタイムゾーンに従って、毎晩午前0時から午前6時の間にHubSpotのデータを取り込みます。これにより、訪問者IDおよびアカウントIDに新しいメタデータフィールドが追加され、既存のフィールドの以前のメタデータはすべて上書きされます。
得られた訪問者とアカウントのメタデータは、ガイドやアナリティクスでセグメントに使用したり、レポートに追加してPendoでCRMデータを表示したりすることができます。HubSpotとPendoを連携することで、CRMデータを以下のように使用することができます。
- 顧客セグメントやマーケティングキャンペーンに基づいたアプリ内ガイドのターゲティングを行うことができます。
- 顧客の種類、価格、アカウントの状況別にプロダクトの利用状況レポートを作成できます。
- PendoのプロダクトインサイトをHubSpotのトライアルコンバージョンやアップセルと組み合わせることができます。
- 収益増加につながるフィーチャーや使用パターンを見つけることができます。
要件
- Pendo管理者ユーザー
- HubSpotの管理者ユーザーまたはHubSpotのアプリ追加権限。
- Pendoでの有効なHubSpotインテグレーション。
- HubspotのPendoアカウントID
ヒント：HubSpotインテグレーションをPendoのサブスクリプションに追加する必要がある場合は、Pendoの担当者までご連絡ください。
HubSpotインテグレーションの設定
HubSpotインテグレーションは完全にセルフサービスで、コードは一切必要ありません。Pendoでの認証にはHubSpotのログイン情報を使用します。設定は数分で完了し、初期設定後にメタデータを追加するなど、必要に応じて更新することができます。
Pendoに取り込んだ後、メタデータを手動で変更したり、削除したりすることはできません。最初に訪問者とアカウントIDのマッピングに使用するパラメータを確認し、セットアップの際にPendoメタデータとして使用したいフィールドのみを選択します。
以下の動画では、データのインストールとマッピングを順を追って説明し、その後に説明を記述しています。
ステップ1：HubSpotで認証する
HubSpotの認証が必要なのは一度だけで、［設定（Setting）］> ［データマッピング（Data Mappings）］の［訪問者レベル］もしくは［アカウントレベル］から実行できます。HubSpotインテグレーションウィジェットは、［訪問者レベルのデータ（Visitor Level Data）］タブと［アカウントレベルのデータ（Account Level Data）］タブの両方の下部にあります。アカウントレベルと訪問者レベルの両方で同じ認証が適用されます。
1. ページの下部のHubSpotインテグレーションウィジェット（HubSpot訪問者インテグレーション、もしくはHubSpotアカウントインテグレーションのいずれか）で、［1. HubSpotで認証（1. Authenticate With HubSpot）］を選択します。2. ブラウザが自動的にHubSpotにリダイレクトされます。
-
- すでにHubSpotにサインインしていて、HubSpotアカウントを1つのみ所有している場合、すぐに［アクセスを許可（Grant Access）］のプロンプトが表示されます。
- HubSpotにサインインしていない場合は、サインインして［インテグレーションの許可（Integration Permissions）］ページに移動し、［アクセスを許可］を選択します。
- HubSpotのアカウントを複数所有している場合は、アカウント一覧からPendoと同期させたいアカウントを選択して［アクセスを許可］を選択します。
2. アクセスが許可されると、ブラウザは［データマッピング］に戻ります。
ページの下部のHubSpotインテグレーションウィジェットに移動します。認証に成功すると、［HubSpotで認証］（ステップ1）の横に緑色のチェックマークが表示されます。
3. 必要に応じて、訪問者レベルもしくはアカウントレベルのデータマッピング設定でも本操作を繰り返してください。
2回目の認証では、HubSpotでアカウントを再度選択しなくても、［認証］をクリックするだけで接続が自動的に確立されます。
ステップ2：データマッピングを設定する
正常にマッピングするには、HubSpotの値がPendo IDと正確に一致する必要があります。どちらかのプラットフォームでプレフィックスを付けたり、IDを変更したりして部分的な一致になった場合は、正常にマッピングできません。他のすべてのメタデータは、これらの値を唯一のリンクパラメータとして取り込まれます。
HubSpotの［連絡先（Contacts）］や［会社名（Companies）］をPendoの訪問者IDやアカウントIDにマッピングするには、［設定］>［データマッピング］のそれぞれのタブで訪問者とアカウントのメタデータに対して個別に実行する必要があります。［訪問者レベルのデータ］タブで、HubSpotの連絡先をPendoの訪問者IDにマッピングします。［アカウントレベルのデータ］タブで、HubSpotの連絡先をPendoのアカウントIDにマッピングします。
データマッピングの手順は、訪問者メタデータもアカウントメタデータも同じです。
1. ページの下部のHubSpotインテグレーションウィジェット（HubSpot訪問者インテグレーション、もしくはHubSpotアカウントインテグレーションのいずれか）で、［2. セットアップ（2. Setup）］を選択します。
2. Pendoの訪問者IDまたはアカウントIDと完全に一致するHubSpotフィールドを選択します。
訪問者IDを設定する場合は、HubSpotの連絡先をマッピングします。アカウントIDを設定する場合は、HubSpotの会社名をマッピングします。
3. ［保存（Save）］を選択してIDのマッピングを設定します。マッピングが成功すると、［セットアップ］（ステップ2）の横に緑色のチェックマークが表示されます。
4. 必要に応じて、訪問者レベルもしくはアカウントレベルのデータマッピングでも本操作を繰り返します。
ステップ3：Pendoを追加するフィールドを選択する
Pendoに取り込むフィールドを変更する場合は、いつでもこのステップに戻ってください。すでにPendoに取り込まれているデータには影響がありませんが、必要に応じて新たなフィールドの取り込みを開始したり、選択したフィールドの取り込みを停止したりできます。
フィールドの選択は、［設定］>［データマッピング］のそれぞれのタブで訪問者とアカウントのメタデータに対して個別に実行する必要があります。［訪問者レベルのデータ］タブには、HubSpotの連絡先に関連付けられたフィールドが表示され、［アカウントレベルのデータ］タブには、HubSpotの会社名に関連付けられたフィールドが表示されます。
Pendoに取り込むフィールドを選択する手順は、訪問者メタデータもアカウントメタデータも同じです。
1. ページの下部のHubSpotインテグレーションウィジェット（HubSpot訪問者インテグレーション、もしくはHubSpotアカウントインテグレーションのいずれか）で、［3. Pendoに追加するフィールドを選択（3. Choose Fields to Add to Pendo）］を選択します。
2. ［+フィールドを追加（+ Add Fields）］を選択します。これにより、複数選択メニューが開きます。
3. メニューの項目の横にあるチェックボックスで、フィールドの選択と選択解除を行います。選択したフィールドはHubSpotインテグレーションウィジェットに移動されます。
4. 右下の［保存して同期（Save & Sync）］を選択してインテグレーション設定を保存し、最初のデータ同期を開始します。同期に成功すると、［Pendoに追加するフィールドを選択（Choose Fields to Add to Pendo）］（ステップ3）の横に緑色のチェックマークが表示されます。
7. 必要に応じて、訪問者レベルもしくはアカウントレベルのデータマッピングでも本操作を繰り返します。
ウィジェットには、最後に同期した日付と時刻が表示されます。1時間経つと、Pendo UIにHubSpotのメタデータが表示されるようになります。毎晩、自動的に同期が繰り返されます。また、手動で再度同期するオプションもあります。
フィールドを削除するには、フィールド名の横にある［X］を選択します。これにより、そのフィールドは今後の同期から除外されます。すでにPendoに取り込まれたデータには影響はありません。
メタデータタイプに関する技術的なトラブルシューティング
HubSpotの連絡先と会社名のプロパティには、いくつかの異なるタイプがあります。HubSpotのプロパティタイプは、Pendoの対応するメタデータタイプにマッピングされています。HubSpotのプロパティで、Pendoに翻訳がないものは、インポートできません。その結果、一部のHubSpotのフィールドが使用できなくなることがあります。
HubSpotのカスタムプロパティの変換
テキスト入力
- 1行のテキスト <> Pendo文字列
- 複数行のテキスト <> Pendo文字列
オプションの選択
- 単一のチェックボックス <> Pendoブール値
- 複数のチェックボックス <> Pendo文字列
- ドロップダウン選択 <> Pendo文字列
- ラジオボタン選択 <> Pendo文字列
- 日付ピッカー <> Pendo時刻
値
- 数字フィールド <> Pendo小数
- 計算 <> 計算に応じて、Pendo小数、ブール値など
- スコア <> Pendo小数
その他
- ファイル <> 非対応
- HubSpotユーザー <> Pendo文字列
対応するメタデータの翻訳
- HubSpot文字列 <> Pendo文字列
- HubSpot数値 <> Pendo小数
- HubSpotブール値 <> Pendoブール値
- HubSpot日付 <> Pendo時刻
- HubSpot日時 <> Pendo時刻
- HubSpot列挙（リストまたは選択値）<> Pendo文字列
- HubSpot電話番号 <> Pendo文字列
よくある質問
PendoからHubSpotにデータをプッシュするにはどうすればよいですか？
Pendoには、PendoからHubSpotに直接データをプッシュするためのネイティブなインテグレーション機能はありませんが、さまざまな方法でPendoからデータをエクスポートして（CSV、API、その他のサードパーティ）HubSpotにアップロードすることが可能です。
Pendoの訪問者IDとアカウントIDの値が現在HubSpotに存在しない場合はどうすればいいですか？
PendoからアカウントIDをエクスポートし、その値をHubSpotの会社名レコードのフィールドにプッシュするプロセスを設定します。HubSpotで適切な会社名レコードを識別するには、Pendoから追加のデータを取り込む必要がある場合があります。訪問者IDについても同様のプロセスを設定し、その値をHubSpotの連絡先レコードのフィールドにプッシュする必要があります。これらのプロセスは、Pendoで新しい訪問者IDとアカウントIDが作成された際、HubSpotの適切な連絡先と会社名レコードに訪問者IDとアカウントIDを追加するために定期的に実行する必要があります。
Pendoの複数のアカウントをHubSpotの1つの会社にマッピングすることはできますか？
Pendoの複数のアカウントをHubSpotの1つの会社にマッピングすることはできません。正確にマッピングするには、Pendo IDで使用する値がHubSpotの値と完全に一致する必要があります。