設定すること
- ワークスペース内の短縮リンクのクリックをすべて、リダイレクト上のJavaScriptなしで、
link_clickイベントとしてMixpanelにサーバーサイドで転送します。 - MixpanelのProject TokenとData residency（US、EU、インド）の設定。プロジェクトが存在するホストにイベントを届けるために必要です。
- Mixpanelの生の応答と、その応答から確認できること、確認できないことを表示するTest connectionボタン。
Elidoは、誰かが短縮リンクをクリックするたびに、Mixpanelの取り込みAPIへlink_clickイベントを送信します。チームがすでにMixpanelを利用している場合は、どこにもトラッキングスクリプトを追加せずに、リンクのエンゲージメントをプロダクトイベントの横で確認できます。
転送されるのはクリックだけです。コンバージョンイベントのMixpanelへの転送は予定されています。
必要なもの
- Mixpanelプロジェクト。
- プロジェクトのProject Token。Mixpanelのモデルでは秘密情報ではありませんが、Elidoでは引き続き暗号化して保存します。
- プロジェクトのデータレジデンシーがUS、EU、インドのどれかを把握していること。
- ElidoワークスペースのAdminまたはOwnerロール（
conversions.manage権限）。
ステップ1: プロジェクトトークンとデータレジデンシーを確認する
- Mixpanelにログインし、Settings → Project Settingsを開きます。
- Access KeysでProject Tokenをコピーします。API Secretやサービスアカウントは使用しないでください。Elidoには必要ありません。
- プロジェクトのData Residencyの値を確認します。Elidoでも同じものを選択します。
ステップ2: Elidoで接続する
- Dashboard → Integrations → Mixpanelに移動します。
- Connect Mixpanelをクリックします。
- トークンをProject Tokenに貼り付けます。
- プロジェクトに合わせてData residencyを設定します。
- United Statesでは
api.mixpanel.com（デフォルト）に送信します。 - EUでは
api-eu.mixpanel.comに送信します。 - Indiaでは
api-in.mixpanel.comに送信します。
- United Statesでは
- Saveをクリックします。パネルにConnectedと、先頭と末尾の4文字だけを表示したマスク済みトークンが表示されます。
転送の対象はワークスペース内のすべてのリンクで、リンクごとの切り替えはありません。保存してから約5分以内に開始され、トークンまたはデータレジデンシーの変更、あるいは切断も同じ時間枠内に反映されます。
ステップ3: 接続をテストする
Test connectionをクリックします。Elidoはlink_clickイベントを1件、elido_test: trueおよびスラッグ_testとともに送信し、ボタンの下にMixpanelの応答を表示します。HTTPステータス、投稿先のホスト、レスポンスボディが含まれます。
成功しても証明にはなりません。Mixpanelの/trackエンドポイントは、トークンが有効かどうかや、プロジェクトがそのデータレジデンシーに存在するかどうかを確認しないため、間違ったトークンや地域でもテストに成功する場合があります。一方、失敗は実際の問題です。Mixpanelがイベントを拒否しており、メッセージに理由が示されます。
Elidoが送信する内容
クリックごとに1件のイベントになります：
{
"event": "link_click",
"properties": {
"token": "your-project-token",
"distinct_id": "elido-link-4711",
"time": 1789000000,
"workspace_id": 42,
"link_id": 4711,
"slug": "spring-26",
"destination": "https://example.com/spring",
"country": "DE",
"device": "mobile",
"ip": "203.0.113.7"
}
}
distinct_idはelido-link-にリンクIDを加えたもので、訪問者ごとではなくリンクごとに1つの値になります。timeはUnix秒単位のクリック時刻です。destinationは訪問者の転送先URLです。countryは2文字の国コードで、deviceはデバイスの種類です。ipは訪問者のIPアドレスです。Mixpanelは独自のジオロケーションに使用します。- テストイベントには
elido_test: trueが追加されます。
記録されたクリックはすべて転送されます。Elidoのアナリティクスが不審またはボットのトラフィックと判定したクリックも含まれます。Mixpanelに到達できない場合、Elidoは1秒後に1回再試行し、その後イベントを破棄します。バックログもリプレイもありません。フィールドごとの詳しい説明とレポートのアイデアについては、Mixpanelのlink_clickイベントをご覧ください。
distinct_idの仕組みと制限
distinct_idはリンクごとに設定されるため、同じリンクへのすべてのクリックは同じMixpanelの「ユーザー」としてカウントされます。つまり、次のようになります。
link_clickのUniquesは人ではなくリンクを数えます。代わりにイベントの合計数を使用してください。link_clickから登録または購入イベントへのファネルはつながりません。これらのイベントは別のdistinct_idに属するためです。- Mixpanelのホットシャード制限は
distinct_idごとに適用されるため、最初に制限に達する可能性があるのは、非常にアクセスの多い1つのリンクです。
現時点でクリックから登録まで個人を追跡するには、リンク先URLにUTMタグを付け、ランディングページのMixpanel SDKでそれを取得してから、通常どおりそこでユーザーを識別します。
トラブルシューティング
Test connectionは成功するが、Mixpanelに何も表示されない。 まずトークンを確認します。Settings → Project Settings → Access Keysからもう一度コピーしてください。次に、プロジェクトの設定とData residencyを照合します。上記のとおり、どちらを間違えてもテストには成功します。
Test connectionが失敗する。 ボタンの下にあるエラーとレスポンスボディを確認してください。Mixpanelから直接返されたものです。トークンまたはデータレジデンシーを修正し、Update keyをクリックして保存し、もう一度テストします。
イベントが間違ったプロジェクトに到着する。 トークンはプロジェクトごとに異なります。複数ある場合は、目的のプロジェクトからトークンをコピーしたことを確認してください。
接続直後に実際のクリックが表示されない。 転送の開始まで約5分かかる場合があります。その後に短縮リンクをクリックし、Eventsビューを確認してください。
Mixpanelのユーザーと識別済みユーザーが一致しない。 これは想定された動作です。Elidoのdistinct_idはリンクごとに設定されます。UTMを使った回避策については上のセクションをご覧ください。