このページでは

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

フィーチャーフラグを作成する

Amplitude アカデミー

Amplitudeを使用して機能フラグとロールアウトを管理する

機能フラグを管理し、ターゲットユーザーにそれらをリリースする方法について説明します。 Amplitudeを使用して、プロダクト機能の作成、ロールアウト、モニター、ロールバックを行います。

今すぐ始める

Amplitude 実験では、フラグによってコードを再デプロイすることなく、プロダクトの機能や特徴を有効または無効にできます。フラグは実験と機能の展開の両方を促進します。 フラグを使用して実験を開始して十分なデータを収集した後に実験を終了したり、新しい機能をロールアウトしたり、必要に応じてそれらを迅速にロールバックしたりできます。

Amplitudeはすべてのプランのユーザーにこの機能を提供しています。

この記事では、機能ロールアウト用のフラグを作成する方法について説明します。 実験でフラグを使用する方法の詳細については、「ユーザーに実験を展開する」を参照してください。

Optimizelyからフラグを移行する

OptimizelyからAmplitudeへとフラグを移行します。このプロセスを開始するには、Amplitudeの担当者またはAmplitude サポートに連絡してください。

新しいフラグを作成する

フラグを作成する前に、デプロイメントを作成し、SDKをインストールするか、評価用REST APIを設定してください。次に、以下の手順を実行します。

  1. 左側のサイドバーにある実験 > 機能フラグに移動し、機能フラグの作成をクリックします。
  2. 「フラグを作成」モーダルのプロジェクトドロップダウンメニューから、このフラグに対応するプロジェクトを選択します。フラグの名前を入力してください。実験は名前からフラグキーを生成します。フラグキーはコードベース内のフラグを識別します。
  3. 実験の評価モードを指定します。リモート(AmplitudeがAmplitudeサーバー上のフラグを評価)またはローカルです。次に、この実験のバケット単位を指定します。

最適なバケット単位は通常ユーザーです。一部のB2Bユースケースでは、会社IDまたは都市をバケット単位として使用する場合があります。たとえば、会社 ID によるバケット設定により、会社のすべてのユーザーが同じ体験を得ることができます。 選択したユニットにかかわらず、安定したユニット処理値の仮定が適用されることを確認してください。

  1. 作成をクリックします。 実験では、フラグ用の空白のテンプレートが開きます。
  2. Deploymentドロップダウンメニューから実験用のデプロイメントを選択します。デプロイメントの詳細については、Amplitude 実験の設定を参照してください。
  3. 詳細設定をクリックして、バケットソルトを変更します。

バケットソルトを変更すると、ユーザーが実験のバリアントを切り替えることがあります。Amplitudeは、指示なしにバケットソルトを変更しないことを推奨しています。詳細については、Amplitude 実験でのランダム化の仕組みを参照してください。

  1. 「設定」セクションで、「バリアント」セクションにある追加アイコンをクリックして、バリアントを追加します。フラグには少なくとも 1 つのバリアントが必要です。 バリアントとは、ユーザーが利用できるように展開する新しい機能やプロダクト体験のことです。フィーチャーフラグには必要な数のバリアントを追加できます。
  2. バリアントの名前、値、および説明を入力します。 Amplitude 実験は名前からバリアント値を生成します。バリアント値は、コードベースでフラグとして使用する文字列です。 適用をクリックします。

バリアントにOFFという名前は付けないでください。Amplitude 実験では、この名前をフォールバック用に予約しています(たとえば、実験に含まれていないユーザーセグメントなど)。

新機能のロールアウト

フラグを作成したら、そのフラグを使用して新しい機能をロールアウトしてください。

  1. [割り当て] パネルで、新しい機能を受け取るユーザーセグメントを定義し、ロールアウトの割合を指定します。

    ユーザーセグメントを定義して、特定の地理的場所にいるユーザー、特定の人口統計グループに属するユーザー、または特定の使用基準を満たすユーザー(パワーユーザーなど)にロールアウトを制限します。

    ユーザーセグメントを定義するには、ルールベースのユーザーセグメントセクションまでスクロールし、セグメント1をクリックします。Amplitude アナリティクスでユーザーセグメントを作成する場合と同じ手順に従います。

    Amplitudeのすべてのユーザープロパティとコホートは、ユーザーセグメントを定義するために使用できます。 ユーザーセグメントをいくつでも含めることができます。

  2. この機能のロールアウト率を設定します。 これは、フラグのユーザーセグメントに属するユーザーのうち、この新機能を利用できるユーザーの割合です。 ユーザーセグメント内の全員にアクセス権を付与するには、この値を 100% に設定します。

  3. 各バリアントの割合を設定して、各バリアントを受信するユーザー数を定義します。 パーセンテージの合計は100%である必要があります。たとえば、バリアントAを20%、バリアントBを80%に設定した場合、バリアントBに割り当てられるユーザー数はバリアントAの4倍になります。

  4. 任意のセグメントに含まれていないユーザーに対しては、個別のルールを設定してください。たとえば、対象とするコホートにロールアウトを制限するには、[その他のすべてのユーザー] セクションまでスクロールし、ロールアウトの割合をゼロに設定します。

  5. フラグを保存し、有効に設定する前にQAを実施してください。詳細については、実験を開始する前のQAの実施を参照してください。この機能は、選択したユーザーセグメントに対して有効になっています。

これは役に立ちましたか?