HubSpotをElidoに接続する

HubSpot連携は、ElidoのコンバージョンイベントをHubSpotのコンタクトプロパティと取引更新として転送します。追跡されたリンクをクリックし、コンバージョン目標を達成すると、Elidoはアトリビューションデータ（UTMソース、キャンペーン、クリックID）をHubSpotにプッシュします — コードを書く必要はありません。

OAuth経由で接続する#

1. ダッシュボード → コンバージョン → HubSpot → HubSpotを接続する に移動します。
2. HubSpot OAuth画面が開きます。「CRM → オブジェクト」アクセス権を持つアカウントでサインインします。
3. HubSpotは要求されたスコープを表示します: crm.objects.contacts.write と crm.objects.deals.write。これらにより、Elidoはコンタクトプロパティに書き込み、取引をステージ間で移動させることができます。
4. アプリを接続する をクリックします。HubSpotはあなたをElidoにリダイレクトします。

リフレッシュトークンは自動的にローテーションします。HubSpot側からアクセスを取り消した場合（設定 → 接続済みアプリ）、Elidoはイベントの送信を直ちに停止し、配信ログに「トークンが取り消されました」エラーを表示します。

フィールドをマッピングする#

接続後、ダッシュボード → コンバージョン → HubSpot → 設定 に移動します:

1. コンタクトプロパティ — Elidoが書き込むHubSpotのコンタクトプロパティを選択します。利用可能なElidoフィールド: utm_source, utm_medium, utm_campaign, utm_content, utm_term, click_id, link_slug。
2. 取引ステージ — コンバージョンが取引を移動させるパイプラインとステージを選択します。HubSpotの取引を使用しない場合は空欄のままにします。
3. コンタクトを照合する基準 — メールアドレス（ランディングページ経由でメールをキャプチャする場合）またはHubSpotのコンタクトID（URLにhs_contact_idを渡すサーバーサイドのアトリビューションの場合）。

ElidoがHubSpotに書き込む内容#

各コンバージョンはHubSpotのタイムラインイベントを作成し、(マッピングされている場合)コンタクトのプロパティを更新します。Elidoが送信する生のペイロード:

{
  "event": "conversion.recorded",
  "click_id": "clk_abc123",
  "value": 99.0,
  "currency": "EUR",
  "utm": {
    "source": "newsletter",
    "medium": "email",
    "campaign": "spring-2026"
  }
}

HubSpotはこれをコンタクトレコード上のカスタムタイムラインイベントとして表示します。取引ステージの更新（設定されている場合）は同じリクエストで実行されます。

同期されないもの#

• コンバージョンのないクリックイベント — 生のクリックではHubSpotレコードは作成されません。コンバージョンのみが作成します。
• 過去のデータ — 連携は接続した瞬間から前方のみです。
• HubSpot → Elido — 連携はアウトバウンドのみです。HubSpotの取引変更はElidoには戻りません。

トラブルシューティング#

「権限が不足しています」エラー — 認証を行ったHubSpotユーザーがCRM書き込みアクセス権を持っていませんでした。HubSpotのスーパー管理者に依頼して、ダッシュボード → コンバージョン → HubSpot → 再接続 から再認証してください。

コンタクトが見つかりません — イベントが破棄されました — ElidoがメールアドレスまたはIDで一致するコンタクトを見つけられない場合、イベントはログに記録されますが転送されません。ダッシュボード → コンバージョン → 配信ログ で「一致するコンタクトなし」のエントリを確認してください。

誤ったキャンペーンアトリビューションで到着するコンバージョン — 宛先URLにUTMパラメータが存在するか確認してください。Elidoはクリックからそれらをキャプチャします。リンクにUTMがない場合、HubSpotフィールドは空になります。

OAuthの有効期限が切れ続ける — HubSpotは、6ヶ月以上リフレッシュエンドポイントを呼び出さないアプリのトークンを取り消します。Elido連携は各イベントでリフレッシュします。数ヶ月間コンバージョンを受信していない場合は、手動で再接続してください。