転送先 - HubSpot

概要

HubSpotへデータを転送する設定のヘルプページです。

対応プロトコル

• データ転送（Embulk）
• subscriptionオブジェクトの更新時に利用しているAPIについては、Subscription preferencesを参照ください。

設定項目

STEP1 基本設定

オブジェクトへの関連付け

HubSpotでは、あるオブジェクトのレコードを他のオブジェクトのレコードに関連付けることができます。
troccoでは、エンゲージメントオブジェクトを転送する際に、既存のHubSpotオブジェクトに対する関連付けを合わせて行います。

エンゲージメントオブジェクトの一覧

エンゲージメントオブジェクトの一覧と、それぞれが関連付けられるオブジェクトの一覧は以下のとおりです。

オブジェクトへの関連付けの設定項目

オブジェクトタイプにてエンゲージメントオブジェクトを選択すると、オブジェクトへの関連付けが表示されます。

• 対象オブジェクト
  • 関連付けを行う対象のオブジェクトを選択します。
• HubSpot側のユニークキー
  • 関連付けを行う対象のオブジェクトから、ユニークな値を持つカラムを入力します。
• 転送データ側のカラム名
  • 転送対象のデータに含まれる「関連付け対象のレコードを特定するためのカラム」の名前を入力します。
  • カラム内の値がHubSpot側のユニークキーの値と一致するときに、該当レコードにエンゲージメントが関連付けられます。

オブジェクトへの関連付けの設定例

以下のデータを転送するとします。

hs_timestamp,hs_call_body,company_id
2023-08-01T00:00:00.000Z,hoge,hoge@example.com,XXXXXXXXXX1
2023-08-02T00:00:00.000Z,fuga,fuga@example.com,XXXXXXXXXX1
2023-08-03T00:00:00.000Z,piyo,piyo@example.com,XXXXXXXXXX2

オブジェクトタイプにcallを選択し、オブジェクトへの関連付けにて以下のように設定します。

• 対象オブジェクト：company
• HubSpot側のユニークキー：hs_object_id
• 転送データ側のカラム名：company_id

この転送設定を実行すると、転送データはそれぞれ以下のレコードに関連付けられます。

• 転送データの1～2行目：companyオブジェクトのhs_object_idカラムの値がXXXXXXXXXX1であるレコード
• 転送データの3行目：companyオブジェクトのhs_object_idカラムの値がXXXXXXXXXX2であるレコード

補足事項

任意のプロパティーをUPSERTキーに設定する場合

UPSERTキーにhs_object_idまたはcontactオブジェクトのemail以外のプロパティーを設定したい場合は、あらかじめHubSpot側で設定を行う必要があります。
以下で、設定手順を説明します。

1. HubSpotにログインし、ご利用中のHubSpotアカウントをクリック
2. 画面右上、赤枠内の設定アイコンをクリック
   
3. プロパティーをクリック
   
4. オブジェクトを選択し、UPSERTキーとして使用したいプロパティーをクリック
   
5. ルールタブをクリック
   
6. このプロパティーでは、重複にならない値を必須にするを有効化し、保存をクリック
   

subscriptionオブジェクトを更新する場合

subscriptionオブジェクトを更新するためには、trocco上でカラム名や型をマッピングする必要があります。
以下の表を参照し、troccoの転送設定STEP2「カラム定義」タブにて、マッピングを行ってください。

サブスクリプションIDの確認方法

1. HubSpotの画面上で設定＞データ管理＞プロパティーを選択します。
2. プロパティー画面右上の全てのプロパティーをエクスポートを選択し、モーダルの「エクスポート」をクリックして、エクセル/CSVファイルをダウンロードします。
3. エクセル/CSVファイルのCONTACTシートの中に hs_email_optout_で始まる項目を探します。
   例：hs_email_optout_111 の場合、サブスクリプションIDは111です。