この記事のテーマ:
|
Amplitude Experimentでは、フラグは、実験と機能ロールアウトの両方を推進します。フラグは、毎回新しいコードをデプロイする必要なく、製品内で機能を有効または無効にする方法です。Amplitude Experimentでは、アクティブスイッチのオン/オフを切り替えることで、この機能が実行できます。これらは、実験を始めてから、十分なデータを収集した後、実験を終了するか、または新しい機能をロールアウトする(必要に応じて、迅速にロールバックする)場合に理想的です。
この記事では、機能ロールアウトでフラグを作成する方法について説明します。実験でフラグの使用方法の情報を見つける場合は、実験をユーザーにロールアウトすることについてのヘルプセンターの記事を参照してください。
新しいフラグを作成する
新しい機能フラグを作成するには、最初にデプロイメントを作成し、SDKをインストールします。次に、以下のステップに従ってください:
- メインExperimentページから、[+新規]をクリックして、ドロップダウンメニューから[ロールアウト]を選択するか、または、左側のサイドバーから[フラグ]ページに移動して、[+ロールアウトを作成]をクリックします。
- [ロールアウト作成]モーダルで、[プロジェクト]ドロップダウンメニューから、このフラグを含むプロジェクトを選択します。次に、フラグに名前と説明を付けます。これは、コードベースで使用されるフラグの識別子です。Amplitude Experimentは、選択した名前からフラグキーを自動的に生成します。
- 完了したら、[作成]をクリックします。Experimentは、フラグの空白のテンプレートを開きます。
- [設定]パネルで、[言語]ドロップダウンメニューから、このフラグで使用する実装言語(Android、iOS、JavaScript Client、JavaScript Server、またはReact)を選択します。Experimentは、コードベースでコードスニペットを生成します。これは、必要に応じてコピーおよび修正できます。
Experiment SDKの作業の詳細は、インストールガイドとGitHubリポジトリを参照してください。
- 次に、[デプロイメント]ドロップダウンメニューから実験のデプロイメントを選択します。Experimentでのデプロイメントの作業についての詳細は、このヘルプセンターの記事を参照してください。
- フラグには、少なくとも1つのバリアントが必要です。バリアントは、ユーザーにロールアウトする新しい機能または製品エクスペリエンスです。フラグを最初に作成する場合、Experimentは自動的にtrueのバリアントを生成
します。これはフラグがアクティブのときに返されます。このバリアントは編集できます。追加する他のバリアントは、デフォルト値で、フラグがアクティブでないことを示しています。
機能フラグに必要なだけ多くのバリアントを追加できます。フラグにバリアントを追加するには、[+バリアントを作成]をクリックします。[バリアントを作成]モーダルが表示されます。
適切なフィールドで、バリアントの名前と説明を入力
します。Experimentは、入力した名前からバリアント値を自動的に生成します。バリアント値は、コードベースでフラグとして使用する文字列です。完了したら、[バリアントを作成]をクリックします。
注意: バリアントに「OFF」という名前を付けないでください。Amplitude Experimentでは、この名前は、フォールバック(実験に含まれていないユーザーセグメント)に予約されています。
- [割り当て]パネルでは、新しい機能が表示されるユーザーセグメントを定義して、ロールアウトするユーザーの割合を指定し、各バリアントの相対的な配布ウェイトを設定できます。
ユーザーセグメントを定義すると、特定の地理的な場所でユーザーへのロールアウトを制限する場合、または、特定の人口統計グループに属するユーザーや、製品で特定の使用しきい値を満たすユーザー(パワーユーザー)へのロールアウトを制限する場合に役立ちます。
ユーザーセグメントを定義するには、[ルールベースユーザーセグメント]セクションにスクロールして、[セグメント1]をクリックします。次に、Amplitude Analyticsでユーザーセグメントを構築するに使用するものと同じステップに従ってください。
Amplitudeのユーザープロパティとコホートは、ユーザーセグメントを定義するのに使用できます。ここに含めることができるユーザーセグメントの数には制限はありません。
- 次に、この機能のロールアウトパーセントを設定します。これは、フラグのユーザーセグメントに含まれるユーザーの割合で、新しい機能が表示されます。プリセット値のいずれかを選択するか、または手動で希望の値を入力します。ユーザーセグメントの全員に機能にアクセスさせる場合は、この値を100%に設定します。
- その後、バリアントを配布する方法をExperimentに伝える必要があります。これは、各バリアントが表示されるユーザーの数を決定します。ウェイトは相対値です: 例えば、バリアントAに1のウェイトとバリアントBに4のウェイトを付与した場合、バリアントAよりもバリアントBが表示されるユーザーの数が4倍多くなります。
- 次に、ステップ7で作成したセグメントでカバーされていないすべてのユーザーに個別のルールを設定できます。例えば、先にターゲットした特定のコーホートに機能をロールアウトするだけの場合は、
[非ターゲットユーザー]セクションにスクロールして、ロールアウトパーセントをゼロに設定します。[要約]セクションでは、すべてのユーザーでバリアントの合計効果分布の推定値を確認することができます
。 - 次に、まだフラグを保存していない場合は、フラグを保存します。そして、[アクティブ]にする前に、QAを実行します。フラグをQAする方法についての詳細は、フラグのQAのヘルプセンターの記事を参照してください。
- 最後に、準備ができたら、右上隅の[非アクティブ]トグルを[アクティブ]に切り替えます。これで、機能は、選択したユーザーセグメントで動作します。