MixpanelをElidoに接続する

ElidoはクリックおよびコンバージョンイベントをサーバーサイドでMixpanelに送信します。既にMixpanelを使用してユーザーの行動を追跡している場合、Elidoイベントを追加することで、クライアントサイドのJavaScriptなしで、同じファネル分析にリンクエンゲージメントを組み込むことができます。

必要なもの#

• Mixpanelプロジェクト。
• プロジェクトの Project Token（シークレットではありません — ここに貼り付けても安全です）。

ステップ1 — プロジェクトトークンを確認する#

1. Mixpanelにログインします。
2. Settings → Project → Access Keys に移動します。
3. Project Token をコピーします。32文字の文字列です。Secret（バッチでのデータインポートに使用）と混同しないでください。ElidoはServ-to-serverの標準トラックエンドポイントを使用します。

ステップ2 — Elidoで設定する#

1. Dashboard → コンバージョン → Mixpanel → 転送を設定 に移動します。
2. プロジェクトトークンを貼り付けます。
3. （任意）転送するイベントを選択します：link.clicked、conversion.recorded、または両方。
4. 保存 をクリックします。Elidoはすぐにテストイベントを送信します。

distinct_idのマッピング方法#

Mixpanelはイベントをユーザーに帰属させるために distinct_id が必要です。Elidoは次のようにマッピングします：

1. ショートリンクの宛先URLに mixpanel_distinct_id パラメーターを含めるか、Conversions APIに渡す場合、Elidoはそのバリューを直接使用します。これにより完全なセッション結合が可能です。
2. それ以外の場合、ElidoはElido click_id のハッシュを使用します。これによりクリックごとに安定した匿名IDが作成されます。クリックとサーバーイベントをまたがるファネルは自動的に結合されませんが、リンクごとの分析は正常に機能します。

ほとんどのユースケース（リンクキャンペーン分析、コンバージョン帰属）では、オプション2で十分です。ユーザーレベルのジャーニーマッピングにはオプション1を実装してください。

Mixpanelに送信されるイベントプロパティ#

すべてのElidoイベントには以下が含まれます：

{
  "event": "elido_click",
  "properties": {
    "token": "your-project-token",
    "distinct_id": "clk_abc123-hashed",
    "time": 1715515200,
    "link_slug": "spring-2026",
    "destination_url": "https://example.com/spring",
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "spring-2026",
    "country": "DE",
    "device": "mobile",
    "browser": "Chrome"
  }
}

コンバージョンイベントには value と currency も含まれます。

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

MixpanelのライブビューにイベントがGETていない — プロジェクトトークンが正しいことを確認してください。誤ったトークンはMixpanelからHTTP 200を返しますが（サイレントに受け入れ）、イベントは表示されません。トークンを1文字ずつコピーして確認してください。

イベントが異なるプロジェクトに表示される — MixpanelトークンはプロジェクトGETとに固有です。複数のプロジェクトがある場合は、Settings → Project で正しいプロジェクトからコピーしたことを確認してください。

distinct_idが既存のMixpanelユーザーと一致しない — ElidoのショートリンクGETの宛先URLまたはConversions APIを介して mixpanel_distinct_id を渡す必要があります。それなしでは、Elidoは匿名IDを生成するため、既存の識別済みユーザーとは一致しません。

テストイベントのみ表示され、実際のイベントがGETていない — Dashboard → コンバージョン → Mixpanel → イベントを設定 でイベントタイプが有効になっていることを確認してください。link.clicked と conversion.recorded は独立して切り替え可能です。