本文へスキップ

トラッキングプラン

トラッキングプランとは、プロダクトが計測するすべての分析イベントについて、イベント名、プロパティ、発火するタイミング、担当者をまとめた、更新し続ける仕様書です。コードをリリースする人とデータを読む人との間の約束事であり、同じ行動が常に同じ形で記録されるようにします。

更新日:2分で読めます執筆 fromHello

要点

  1. 1イベントにつき1行(名前、プロパティ、発火条件、担当者)。プランは、コードと同じプルリクエストで更新します。

  2. 命名規則を1つに統一すると、数か月後もイベントを検索しやすくなります。よく使われるのは、スネークケースのobject_action(subscription_started)です。

  3. ずれ(名前の変更、重複、欠けたプロパティ)は、ファネル、セグメント、その先のすべてのレポートを、気づかないうちに壊します。

トラッキングプランには何を含めますか?

最低限、1イベントにつき1行です。イベント名、付随するプロパティ、発火する正確なタイミング、担当者。優れたプランは、どのツールがそのイベントを受け取るか、そのイベントが答えるべき問いは何かも記録します。誰も検索しないイベントは、見返りのない保守作業です。形式よりも習慣が大切です。スプレッドシートでも、リポジトリ内のバージョン管理されたファイルでも、Segment ProtocolsやAmplitude Dataのようなスキーマツールでもかまいません。トラッキングのコードと同じプルリクエストでプランを更新している限り、どれでも機能します。

トラッキングプランと、それを構成する用語。

イベントにはどう名前を付けるべきですか?

規則を1つ選び、あらゆる場所で徹底します。最も一般的なのは、スネークケースのobject_actionです。subscription_started、invoice_paid、report_exported。関連するイベントが並ぶように対象を先に、イベントは起きたことを記録するので行動は過去形にします。どの規則を選ぶかより、統一されていることのほうが重要です。1つのデータセットに「Sign Up」「signup」「user_signed_up」があれば、分析ツールはそれを互いに無関係な3つのイベントとして扱い、その上につくったグラフはすべて誤りになります。

トラッキングのずれとは何か、なぜ分析を台無しにするのか?

ずれとは、プランとコードが実際に送るものとの間に生じる差です。プランを更新せずにイベント名が変わる、プロパティの型が変わる、重複したイベントが別の名前で現れる、といった具合です。一つひとつの変化は小さくても、積み重なるとファネルの数値は実際より少なくなり、動的セグメントは本来合致すべきユーザーを拾わなくなり、ダッシュボードは作り話に近づきます。そうなると、チームはデータをまったく信用しなくなります。治し方は技術ではなく手順です。プランへの記載なしにイベントをリリースしない、そしてその記載のレビューをコードレビューの一部にすることです。

2人のチームにとってなぜ重要か

小さなチームがプランを省くのは、まだなっていない規模の会社のための手続きのように感じるからです。理屈は逆です。2人しかいなければ、10月にはcheckout_completedとorder_completedがなぜ両方あるのか、誰も覚えていません。最初のイベントの前に書く1ページのプランにかかるのは半日です。グロースエンジニアが最初にやる仕事でもあります。SDKから同意まで、完全なセットアップの中でプランがどう位置づけられるかは、ファーストパーティデータとトラッキングのガイドをご覧ください。

FAQ

よくある質問

  • トラッキングプランとデータディクショナリの違いは何ですか?

    トラッキングプランは規範的で、コードをリリースする前に、何を計測すべきかを定めます。データディクショナリは記述的で、すでに存在するデータを、欠点も含めてそのまま文書化します。小さなチームは通常この2つを統合し、仕様書であり参照資料でもある1つのドキュメントにします。

  • トラッキングプランは誰が担当すべきですか?

    名前の決まった1人です。小さなスタートアップなら、たいていはデータに最も近い創業者か、グロースエンジニアです。担当するとは、すべての新しいイベントを了承し、規則に反する名前を差し戻すことで、すべての項目を自分で書くことではありません。

  • トラッキングプランにはいくつのイベントを含めるべきですか?

    思っているより少ない数で十分です。ファネルとアクティベーション指標に必要なイベントから始め、実際の問いが求めるときにだけ1つずつ追加します。イベントはどれも保守の約束です。SegmentもAmplitudeも、分類体系を小さく保つことを勧めています。

  • トラッキングプランを強制できるツールはありますか?

    スキーマ検証ツール(Segment Protocols、Amplitude Data、Avo)は、プランに合わないイベントをブロックしたり、警告を出したりします。こうしたツールがなくても、イベント名のリンターと、レビューのルール1つ(プランに記載のない新しいイベントは不可)があれば、2人規模ならほとんどのずれを見つけられます。

fromHelloは、オープンソースのマーケティングオートメーションです。

人の行動をきっかけにメッセージを届けます。fromHello Cloudは、ウェイトリスト経由でアーリーアクセスを提供しています。

アーリーアクセス

fromHello Cloud

小さくまとまるために始めたわけではない。

fromHello Cloudのアーリーアクセスは、段階的にご案内します。 オンボーディングは伴走型です。セットアップからコンタクトの移行まで、私たちがお手伝いします。

ご利用の準備が整い次第、メールでお知らせします。スパムは送りません。

まだ登録する段階ではありませんか?GitHubで見る