実験のクイックスタート

実験と機能フラグは、Amplitude実験 SDKまたはREST APIを使用してAmplitude実験と通信します。

実験の設定は、以下の手順を含む複数の段階にわたるプロセスです。

1. SDK とデプロイメントをインストールして設定します。
2. 機能フラグを作成します。
3. デプロイメントを選択し、ペイロードを作成します。
4. バリエーションを作成し、ペイロードを送信します。
5. 実験を設計する。

始める前に

実験の使用を開始する前に：

• Experiment SDK への開発者書き込みアクセス権を持っていることを確認してください。
• 実験機能へのアクセス権があることを確認してください。
• 機能フラグを統合するアプリケーションへの開発者アクセス権を持っていることを確認してください。

SDK の設定

実験クライアントと一緒にAmplitude SDKをインストールします。 例えば：

npm install @amplitude/analytics-browser @amplitude/experiment-js-client

import * as amplitude from "@amplitude/analytics-browser";
import { Experiment } from "@amplitude/experiment-js-client";
amplitude.init("AMPLITUDE_API_KEY");
const experiment = Experiment.initialize("DEPLOYMENT_API_KEY");
await experiment.start();

デプロイメントのセットアップ

実験はAmplitudeアナリティクスと同じプロジェクトを使用しています。 ベストプラクティスとして、プロダクトごとと環境ごとにプロジェクトを1つ作成してください。 フラグ、実験、およびデプロイメントは単一のプロジェクト内にのみ存在するため、これらのオブジェクトを同じプロダクト内の複数のプロジェクトに複製する必要があります。

Amplitude実験では、デプロイメントはアプリケーションで使用するためのフラグや実験のグループを提供します。 各プロジェクトには、デフォルトで使用できるプロジェクトAPIキーをデプロイキーとして使用するデプロイメントがあります。作成時に、実験はランダムに生成されたデプロイメントキーを各デプロイメントに割り当てます。実験はデプロイメントキーを使用してデプロイメントを識別し、評価サーバーへのリクエストを承認します。

デプロイメントはAmplitudeアナリティクスプロジェクトに属しており、1つのプロジェクトに複数のデプロイメントがある可能性があります。 Amplitudeは、Experimentがバリアントを提供するプラットフォーム（クライアント側）またはサービス（サーバー側）にちなんでデプロイメントに名前を付けることを推奨しています（例：android、ios、web）。 デフォルトのプロジェクト API キーのデプロイメントは、始める際に役立ちます。 大規模な組織やチームでは、同じアプリケーションに対して複数のプラットフォーム間で同じAmplitudeプロジェクトを共有している可能性があるため、各プラットフォームやサービスに対して明示的なデプロイメントを使用してください。 各デプロイメントは、アプリケーションで使用するための一意のキーを受け取ります。

デプロイメントを作成するには

1. Experiments > Deployments に移動します。
2. 「デプロイメントを作成」を選択します。
3. ドロップダウンリストから目的のプロジェクトを選択します。
4. デプロイメントに名前を付けます。
5. デプロイメントがクライアント用かサーバー用かを選択します。
6. 「デプロイメントを作成」を選択します。 詳細については、「実験の設定」を参照してください。

新しいフラグを作成する

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

新しいフィーチャーフラグを作成するには

1. _「実験」>「機能フラグ」_に移動します。
2. **[機能フラグの作成] **を選択します。
3. 「フラグを作成」セクションで、ドロップダウンリストから必要なプロジェクトを選択し、フラグに名前を付けます。 Amplitude実験は、選択した名前からフラグキーを生成します。 フラグキーは、コードベースで使用されているフラグの識別子です。
4. 実験の評価モードを指定します。 Remote または Local を選択します。
5. この実験に使用するバケット単位を指定してください。

6. [作成] を選択します。 実験では、フラグ用の空白のテンプレートが開きます。
7. [デプロイ]ドロップダウンメニューから目的のデプロイを選択します。
8. （オプション）詳細設定を選択して、バケットソルトのオプションを変更します。

バリエーションを作成する

バリアントはフラグや実験の期間内に存在し、ユーザーにとってのさまざまな体験を表します。バリアントとは、テストしたいA/B変更を意味します。 すべての機能フラグには、少なくとも1つのバリアントが含まれている必要があります。フラグには必要な数のバリアントを追加できます。

バリアントを追加するには

1. _実験 > 機能フラグ_に移動し、自分のフラグを選択します。
2. 「バリアント」セクションで、「プラス」アイコンを選択してバリアントを作成します。
3. バリアントの名前、値、および説明を入力します。
4. 適用を選択します。

{
  "layout": "cards",
  "titlePosition": "above",
  "gradient": false,
  "showDescription": true,
  "cardCount": 3
}

フラグにターゲット設定を追加する

「割り当て」セクションで、新機能を体験したいユーザーセグメントを定義します。 ユーザーセグメントを定義すると、特定の地理的場所にいるユーザー、特定の人口統計グループ、またはプロダクトで特定の使用基準を満たすユーザー（パワーユーザーなど）にロールアウトを制限できます。セグメンテーションの詳細については、「オーディエンスの定義」を参照してください。

ターゲット設定を追加するには

1. バリアントを受け取るユーザーの割合を指定します。
2. ユーザーセグメントを定義するには、ルールベースのユーザーセグメントセクションに移動し、セグメント1を選択します。次に、Amplitudeアナリティクスでユーザーセグメントを作成する場合と同じ手順に従います。

フラグを完成させる

フラグを設定し、それをデプロイに関連付けて、バリアントまたはペイロードを設定し、ユーザーをターゲットに設定したら、機能フラグを完成させます。 フラグを完成させると、フラグがアクティブになり、使用できるようになります。

フィーチャーフラグを確定するには

1. フィーチャーフラグに移動します。
2. **[アクティブ化フラグ] **を選択します。

実験を設計する

実験を直接作成することも、既存のフラグを実験に変換することもできます。

実験を設計する場合：

• 実験のメトリックを設定します。
• 任意のバリエーションとペイロードを設定します。

目標（または指標）を追加することで、実験の成功率を追跡できます。 すべての実験には少なくとも1つのメトリックが必要です。 Amplitude実験にどのような主要なメトリックを望むかを伝えて、任意の副次メトリックを定義してください。主要なメトリックは、Amplitudeが仮説を受け入れるか拒否するかどうかを決定し、したがって実験が成功したか失敗したかを決定します。

メトリクスを追加するには

1. 実験を開き、「メトリクス」セクションに移動します。
2. メトリックドロップダウンから推奨されるメトリックを選択するか、カスタムメトリックを作成します。
3. 「should」または「should not」を使用してメトリックタイプを選択します。
   • 「Should」：成功メトリックは、目標が目標量および目標方向へ変化することを示します。
   • 「Should not」：ガードレールメトリックは、目標が目標量および目標方向へ変化しないことを示します。
4. メトリックが増加または減少することを期待するかを指定します。
5. （オプション）実験の許容可能な最小限の目標を設定します。これは最小検出効果とも呼ばれます。検出可能な最小効果とは、実験が肯定的な結果とみなされるための対照とバリアントとの間の最小限の差です。
6. セカンダリメトリックを追加するには、［メトリックを追加］を選択し、追加したいメトリックごとにこのプロセスを繰り返します。

より多くのバリエーションとペイロードを追加するには

さらに多くのバリエーションとペイロードを作成するには、「フラグにバリエーションを作成する」の手順を繰り返します。

実験を開始する

実験の設計が完了したら、「実験を開始」を選択して開始します。

コード例

次のコード例は、フィーチャーフラグとJSONペイロードのコードを示しています。

import { useState, useEffect } from 'react';
import { getBlogLayoutFlag } from '../services/featureFlags'; // Adjust to wherever you fetch your Amplitude flag
import type { BlogPost } from '../types';
type LayoutFlag = {
  layout: 'cards' | 'list' | 'carousel';
  titlePosition: 'above' | 'below' | 'center';
  gradient: boolean;
  showDescription: boolean;
  cardCount: number;
};
export default function BlogPostLayoutClient({ posts }: { posts: BlogPost[] }) {
  const [layoutFlag, setLayoutFlag] = useState<LayoutFlag | null>(null);
  useEffect(() => {
    getBlogLayoutFlag().then((flag) => {
      console.log(':magic_wand: Received Flag from Amplitude:', flag);
      if (flag) {
        setLayoutFlag(flag);
      } else {
        console.log(':warning: No flag returned, falling back to default layout');
        setLayoutFlag({
          layout: 'cards',
          titlePosition: 'above',
          gradient: false,
          showDescription: true,
          cardCount: 3,
        });
      }
    });
  }, []);
  if (!layoutFlag) {
    // You might render a loader here
    return null;
  }
  // Render your posts according to layoutFlag...
  return (
    <div>
      {/* e.g. layoutFlag.layout === 'cards' ? <CardGrid posts={posts} /> : ... */}
    </div>
  );
}