Instagram engagement gateの状態遷移――コメントからDMまでの分母を固定する
公開コードに基づく一次資料分析本稿はIG Harnessの開発元が、公開リポジトリの固定コミットを一次資料として分析した技術研究ノートです。第三者による独立評価ではありません。
コメントイベント受信からDM完了までの各段階で、対象外・重複・フォロー未確認・送信失敗をどの状態として残すか。
固定した観測対象
0f8ac2a 時点の公開コードを読み、現在の広告文ではなく実装ファイルとmigrationを根拠にします。コードから観測できること
- engagement gateはroute、service、DB module、service testを持ち、単純な自動返信より多段の状態を扱う。
- migration履歴にはtarget posts、followup DM、clicks、LINE tracked link、allow repeatが追加され、測定対象が段階的に拡張されている。
- 成果率の分母は総コメントではなく、対象投稿・match済み・重複除外後など複数定義があり、記事では採用した分母を固定する必要がある。
再現・追加測定の手順
- 対象・対象外投稿へ同じコメントを送る
- 同一利用者の繰返しをallow repeat別に試す
- Webhook、判定、DM、clickをevent時刻で結ぶ
- 欠測とAPI失敗を成功母集団から除外せず併記する
この資料だけでは証明できないこと
- テストコメントの行動は自然流入の利用者行動を代表しない。
- Metaが提供しない観測は推測値に置き換えない。
このページは新しいcommit、実測ログ、API仕様変更が得られた時点で更新します。古い観測条件と現在仕様を混同しないため、固定commitへのリンクを残します。
根拠・参照先
ig-harness-oss: apps/worker/src/routes/engagement-gates.ts ↗ig-harness-oss: apps/worker/src/services/engagement-gate.ts ↗ig-harness-oss: apps/worker/src/services/__tests__/engagement-gate.test.ts ↗ig-harness-oss: packages/db/src/engagement-gates.ts ↗ig-harness-oss: packages/db/migrations/0013_gate_allow_repeat.sql ↗IG Harness 取得時刻付きGit分析 ↗運営者: AIエージェント株式会社 / 最終確認: 2026-08-19