設定すること
- Elido に接続する Linear 個人 API キー — OAuth 不要、アプリ登録不要。
- 追跡リンクがクリックしきい値に達した場合や URL スキャンが失敗した場合に自動作成される Linear の issue。
- 自動作成されるすべての issue に適用されるオプションのデフォルト担当者とラベル。
2026年第3四半期登場予定。 早期アクセスには ダッシュボード → インテグレーション → Linear → 通知を受け取る でサインアップしてください。以下の設定は計画されているデザインを反映しています。
Linear インテグレーションは、特定の Elido イベントで issue を自動的に開きます。キャンペーンの失敗やリンクスキャンアラートを第一級の作業として追跡するチームに役立ちます。2つのイベントがサポートされています:しきい値超過(リンクが N 回のクリックに達した場合 — プロモーションの強化やインフラの拡張の合図となることが多い)と スキャン失敗(宛先 URL が悪意のあるものとしてフラグ付けされた場合)。
必要なもの#
- ターゲットチームで issue を作成する権限を持つ Linear アカウント。
- Linear の個人 API キー(生成に30秒かかります)。
Linear API キーを生成する#
- Linear → 設定 → API → 個人 API キー に移動します。
- キーを作成 をクリックします。「Elido integration」のようなラベルを付けます。
- キーをコピーします。Linear は一度しか表示しません。
Elido で設定する#
- ダッシュボード → インテグレーション → Linear → 設定 に移動します。
- API キーを貼り付けます。
- チームを取得 をクリックします。Elido は Linear API を呼び出し、キーがアクセスできるすべてのチームをリストします。
- ターゲットチームを選択します。Issue はそこに作成されます。
- (オプション)デフォルトのアサイン担当者とラベルを設定します。両方とも Linear の issue に引き継がれます。
- 保存 をクリックします。
イベントトリガーを設定する#
ダッシュボード → インテグレーション → Linear → トリガー で:
- しきい値超過 — クリック数を入力します。追跡対象のリンクがいずれかを超過すると、Elido は「キャンペーンマイルストーン: [slug] が [N] クリックに達しました」というタイトルの Linear issue を開きます。リンクごとに異なるしきい値を設定できます。
- スキャン失敗 — オンに切り替えます。フラグが立てられた各リンクは、「スキャンフラグの調査: [slug]」というタイトルの issue を開き、説明にスキャナーの理由が含まれます。
Linear に書き込まれる内容#
自動作成された各 issue には以下が含まれます:
- 上記で説明したタイトル。
- 短縮 URL、宛先 URL、およびイベント詳細を含む説明。
- リンクの Elido アナリティクスビューへの直接リンク。
- 設定した場合のアサイン担当者とラベル。
Elido は Linear から読み戻しません — issue をクローズしたり、issue の状態を追跡したりしません。その部分はチームのワークフローに任されます。
トラブルシューティング#
チームの取得時に「認証されていません」 — API キーが間違っているか、失効しています。Linear 設定 → API から再生成してください。
間違ったチームに issue が表示される — ダッシュボード → インテグレーション → Linear → 設定 でチーム選択を確認してください。キーが複数のチームにアクセスできる場合、ピッカーが最初のチームをデフォルトとして選択した可能性があります。
しきい値を超過しても issue が作成されない — リンクにしきい値が設定されていることを確認してください。グローバルなトリガーは、リンクごとにしきい値が定義されているか、グローバルデフォルトが有効になっているリンクに対してのみ発火します。
重複する issue — しきい値トリガーは、クリックごとではなく、超過ごとに1回発火します。重複が見られる場合、同じ Linear ワークスペースが2つの Elido ワークスペースの下で接続されていないか確認してください。