計画およびインストルメンテーションのワークフロー

計画にAmplitudeデータを活用することで、最初から高品質なデータを確保でき、後でクリーンアップする必要性を減らすことができます。 この記事では、Amplitude データのワークフロー全体について説明します。

イベントを計画する

ほとんどの企業にとって、ライフサイクルはプロダクトや機能の発売時に始まります。

プロダクトチームが新しいオンボーディングフローを作成し、そのフローがどのように機能するかを確認したいとします。最初のステップは、このオンボーディングフローで何を追跡すべきかを決定することです。 この機能はどのような指標に影響を与え、成功とはどのようなものなのでしょうか？

追跡するイベントとプロパティを特定したら、_イベント_ページでこれらのイベントおよびプロパティを作成します。プレミアム プランでは、他のユーザーに影響を与えることなく、関連するすべての変更をキャプチャするためのブランチを作成できます。 コード内のGitブランチとAmplitudeデータ内のブランチは、プロセス全体を通じて共存します。エンジニアリングチームは、この機能の開発中ずっと、Amplitude データブランチからGitブランチにアナリティクスコードをプルできます。

ブランチは、複数のチームが同じプロジェクトで作業している場合や、チームがさまざまな機能で同時に作業している場合に特に役立ちます。

イベントのインストルメント

まだ招待していない場合は、この機能に取り組んでいる開発者をAmplitude データに招待し、提案された計画をレビューしてもらうよう依頼してください。ブランチに所属する場合は、ブランチの_アクティビティ_ページへのリンクを送信してください。このページには、あなたが実行する予定のすべての変更が表示されます。

次に、エンジニアは更新された追跡計画をブランチに実装します。この際エンジニアはAmpli CLIを使用して、Amplitudeデータブランチの変更に一致する新しいトラッキングライブラリを生成します（ampli pull -b {branch-name}）。

開発者とトラッキング計画について繰り返し検討するのはよくあることです。彼らが直面する問題や課題に対応することもあるかもしれません。フィードバックに基づいて理解が深まるにつれて、計画を更新してください。

レビューを依頼する

プロジェクトをチームレビュー用に設定した場合、直接マージする権限がない可能性があります。 代わりに、まずマージリクエストを作成します。マージリクエストは、チーム外の関係者に変更内容を確認してもらい、明示的に承認してもらうためのものです。

機能開発チームが変更に満足したら（計画が包括的であり、エンジニアリングチームがそれを正しく実装している状態）、ブランチを他の関係者によるレビューに提出できます。

アナリティクス変更は多くの場合、より広範な組織に影響を与えるため、フィードバックを得ることが不可欠です。 一般的な関係者には、セキュリティおよび法務チーム、グロースチーム、データチームなどが含まれます。

レビューの依頼は、マージ リクエストを作成することから始まります。 マージリクエストを作成する際は、提案する変更内容について説明し、含めたい特定のレビュー担当者または承認者がいれば@でメンションしてください。その後、管理者またはマネージャレベルのユーザーが変更を承認できます。

マージ

追跡計画の変更が完了し、承認が必要な全員が変更を完了したら、メインにマージする準備が整いました。

他の機能チームが Git でマージする準備ができたら、まず Amplitude データで自分のブランチをマージしてください。マージを行うと、メインにトラッキングプランの新しい公式バージョンが作成され、すべての新規イベントや変更されたイベントに新しいバージョンが割り当てられます。

ご使用の Git ブランチがすでにマージされた Amplitude データブランチと最新の状態になっている場合は、Git ブランチをそのままマージできます。ampli status --is-mergedを実行して、Ampliコードが最新の状態でマージされたデータブランチと一致していることを確認してください。コマンドがエラーを返す場合は、ampli pull を実行して生成されたライブラリを最新バージョンに更新してください。

ampli status --is-mergedが成功したら、Gitブランチをマージできます。