HubSpotをElidoに接続する

HubSpot連携は、リンクのクリックをカスタムタイムラインイベントとしてHubSpotに書き込みます。誰かが追跡対象のリンクをクリックし、Elidoがそのクリックをメールアドレスに結び付けられる場合、そのイベントはHubSpotのコンタクトレコードに表示されます。

OAuthで接続する

1. ElidoでDashboard → Integrations → HubSpotを開き、接続を開始します。
2. HubSpotのOAuth画面が開きます。ポータルにアプリをインストールする権限のあるアカウントでサインインします。
3. HubSpotが要求されるスコープを表示します：コンタクトの読み取りと書き込み、タイムラインイベント、オートメーション。Elidoはメールアドレスでコンタクトを検索し、そこにタイムラインイベントを書き込みます。
4. アプリを承認します。HubSpotからElidoにリダイレクトされます。

リフレッシュトークンは自動的に更新されます。HubSpot側でアクセスを取り消した場合（Settings → Connected Apps）、再接続するまでElidoはイベントを書き込めません。

クリックとコンタクトの照合方法

Elidoは次の順序でメールアドレスを探し、最初に見つかった有効なものを使用します：

1. クリックイベントとともに渡された email の値。
2. クリックイベントの metadata.email。
3. utm_content（メールアドレスが含まれている場合）。
4. 宛先URLの email= クエリパラメータ（トランザクションメールでよく使われるパターン）。

その後、HubSpotのコンタクトからそのメールアドレスを検索します。一致するコンタクトがない場合、何も書き込まれません。

ElidoがHubSpotに書き込む内容

照合できたクリックごとに、次のトークンを持つタイムラインイベントが1件、コンタクトに作成されます：

• short_url と destination_url
• campaign（utm_campaign から）と source（utm_source から）
• occurred_at

HubSpotでは、コンタクトレコード上のカスタムタイムラインイベントとして表示されます。Elidoはコンタクトのプロパティや取引を変更しません。

同期されないもの

• メールアドレスのないクリック: Elidoがメールアドレスを特定できない場合、そのクリックはスキップされます。
• コンバージョン: コンバージョンイベントはまだHubSpotに送信されません（上記の「予定」の注記を参照）。
• 過去のデータ: この連携は、接続した時点から先のデータのみが対象です。
• HubSpot → Elido: 送信のみです。HubSpotでの変更はElidoには反映されません。

トラブルシューティング

クリックがコンタクトに表示されない。 上記4つの経路のいずれかでメールアドレスがElidoに届いていること、およびそのメールアドレスと完全に一致するHubSpotコンタクトが存在することを確認してください（照合では大文字と小文字は区別されません）。

アプリを取り消した後、イベントが止まった。 Dashboard → Integrations → HubSpotから再接続してください。

イベントのcampaignまたはsourceが空。 Elidoはこれらをクリックに付いたUTMパラメータから取得します。リンクにUTMがない場合、これらのトークンは空になります。