本文へ移動
Telemetry
製品分析 SQL レシピ

アップグレード前に使用されていた機能を検索する

フィーチャー イベントに参加してイベントをアップグレードし、有料コンバージョンの前に発生する行動をランク付けします。

上級者向けproduct_eventsレビュー済み 2026-07-27テスト済み アパッチ DataFusion 45.2.0

レビュー者 Telemetry 製品チーム . SQL の互換性、イベント コントラクト、合成出力、および操作上の注意事項. 基準と所有権を確認する

質問に回答しました

アカウントをアップグレードする前に最も一般的に採用される機能はどれですか?

相関関係は因果関係ではありませんが、アップグレード前の動作は、製品チームがオンボーディング、ライフサイクル メッセージング、および計画のパッケージ化においてテストする価値のある機能を見つけるのに役立ちます。

イベント契約

クエリが期待するフィールド

フィールド種類なぜ存在するのか
timestamp_utcTimestampイベントが発生したとき。
team_idUtf8安定したアカウントまたはワークスペースの識別子。
event_nameUtf8製品イベント名。
feature_nameUtf8feature_used イベントの安定した機能の識別子。
DataFusion SQL

クエリをコピーする

sql
WITH upgrades AS (
  SELECT
    team_id,
    MIN(timestamp_utc) AS upgraded_at
  FROM product_events
  WHERE event_name = 'plan_upgraded'
  GROUP BY team_id
),
pre_upgrade_features AS (
  SELECT DISTINCT
    e.team_id,
    e.feature_name
  FROM product_events e
  JOIN upgrades u ON e.team_id = u.team_id
  WHERE e.event_name = 'feature_used'
    AND e.timestamp_utc < u.upgraded_at
    AND e.timestamp_utc >= u.upgraded_at - INTERVAL '30 days'
)
SELECT
  feature_name,
  COUNT(DISTINCT team_id) AS upgraded_teams_using_feature
FROM pre_upgrade_features
GROUP BY feature_name
ORDER BY upgraded_teams_using_feature DESC;

この読み取り専用クエリは、空の型付きテーブルに対して計画され、実行されます。 アパッチ DataFusion 45.2.0。決定論的なサンプル出力は合成され、個別にレビューされます。フィールド タイプ、しきい値、ビジネス定義を独自のデータと照合して検証します。 テスト方法を読んでください。

クエリ結果

アップグレードされたチーム間での機能の導入

この合成例では、共有ダッシュボードが最も一般的なアップグレード前の動作です。

feature_nameupgraded_teams_using_feature
shared_dashboard184
alert_created151
scheduled_export112
ai_query97

合成出力例。運用上の決定に使用する前に、独自のイベント スキーマとしきい値に対してクエリを実行します。

Feature adoption among upgraded teams: Find Features Used Before Upgrade 結果例からの合成 upgraded_teams_using_feature 値の静的チャート
決定論的な出力例のインデックス可能な SVG。記事、ランブック、または出典を明示した設計レビューのためにダウンロードしてください。

例を再現する

パブリックフィクスチャをダウンロードする

JSON バンドルには、型付きイベント コントラクトが含まれています。 illustrative 入力行、正確な SQL、予想される出力、レビューメモ、およびエンジンのバージョン。 CSV には、表示された結果が含まれます。

SQL の仕組み

  1. 1アップグレード CTE は、チームごとの最初のアップグレード時間を見つけます。
  2. 2結合により、機能のアクティビティがアップグレードの 30 日前に制限され、アップグレード後の導入によって結果が汚染されるのを防ぎます。
  3. 3DISTINCT チームと機能のペアにより、ヘビーユーザーがランキングを独占しないようにします。

決定すべきエッジケース

  • 共通の機能を予測として扱う前に、アップグレードされていないチームと比較してください。
  • アカウントのサイズ、プランの適格性、および保有期間を制御します。これらの変数は導入とアップグレードの両方に影響します。
  • すべてのアカウントで機能が利用できない場合は、露出イベントを使用します。

推奨されるダッシュボード

  • 棒グラフ: upgraded_teams_using_feature
  • 比較表: アップグレードされたチームとアップグレードされていない対象チーム間の導入状況
  • 折れ線グラフ: 最初の機能の使用からアップグレードまでの時間

アラートガイダンス

これは製品学習のためのクエリであり、運用上のアラートではありません。毎週のダッシュボードレビューとしてスケジュールを設定します。

アラート設定を読む

レシピを活用する

関連する機器とガイド

分析を続ける

実際のイベントで実行する

テーブルを作成し、フィールドを調整して、結果を保存します

無料で始めて、構造化されたイベントを送信し、クエリ結果をグラフ、共有ダッシュボード ウィジェット、またはアラート入力として使用します。

API キーを取得する