実験用にアプリをコーディングする

パートナーセンターでプロジェクトを作成し、リモート変数を定義したら、ユニバーサル Windows プラットフォーム (UWP) アプリのコードを次に更新する準備が整います。

パートナーセンターからリモート変数の値を受け取ります。
リモート変数を使用して、ユーザーのアプリエクスペリエンスを構成します。
ユーザーが実験を表示し、目的のアクション（変換とも呼ばれます）を実行したことを示すログイベントをパートナーセンターに記録します。

この動作をアプリに追加するには、Microsoft Store Services SDK によって提供される API を使用します。

次のセクションでは、実験のバリエーションを取得し、パートナーセンターにイベントをログに記録する一般的なプロセスについて説明します。アプリを実験用にコーディングした後、パートナーセンターで実験を定義することができます。実験を作成して実行するエンドツーエンドのプロセスを示すチュートリアルについては、「A/B テストを使用して最初の実験を作成して実行する」を参照してください。

注

Microsoft Store Services SDK の一部の実験 API では、非同期パターンを使用してパートナーセンターからデータを取得します。つまり、これらのメソッドの実行の一部はメソッドが呼び出された後に行われる可能性があるため、操作が完了してもアプリの UI の応答性を維持できます。非同期パターンでは、この記事のコード例で示すように、アプリで async キーワードと await 演算子を使用し、API を呼び出す際にそれを待機する必要があります。慣例により、非同期メソッドはAsyncで終了します。

プロジェクトを構成する

開始するには、開発用コンピューターに Microsoft Store Services SDK をインストールし、必要な参照をプロジェクトに追加します。

Microsoft Store Services SDKをインストールします。
Visual Studio でプロジェクトを開きます。
ソリューションエクスプローラーで、プロジェクトノードを展開し、[参照] を右クリックし、[参照の追加] をクリックします。
参照マネージャーで、[ユニバーサル Windows] を展開し、[拡張機能] をクリックします。
SDK の一覧で、Microsoft Engagement Framework の横にあるチェックボックス選択し、[OK] クリック。

注

この記事のコード例では、System.Threading.Tasks および Microsoft.Services.Store.Engagement 名前空間にステートメントを使用してコードファイルがされていることを前提としています。

バリエーションデータを取得し、実験のビューイベントをログに記録する

プロジェクトで、実験で変更する機能のコードを見つけます。バリエーションのデータを取得するコードを追加し、このデータを使用してテストする機能の動作を変更し、実験のビューイベントをパートナーセンターの A/B テストサービスに記録します。

必要な特定のコードはアプリによって異なりますが、次の例は基本的なプロセスを示しています。完全なコード例については、「A/B テストを使用して最初の実験を作成して実行する」を参照してください。

private StoreServicesExperimentVariation variation;
private StoreServicesCustomEventLogger logger;

// Assign this variable to the project ID for your experiment from Dev Center.
// The project ID shown below is for example purposes only.
private string projectId = "F48AC670-4472-4387-AB7D-D65B095153FB";

private async Task InitializeExperiment()
{
    // Get the current cached variation assignment for the experiment.
    var result = await StoreServicesExperimentVariation.GetCachedVariationAsync(projectId);
    variation = result.ExperimentVariation;

    // Refresh the cached variation assignment if necessary.
    if (result.ErrorCode != StoreServicesEngagementErrorCode.None || result.ExperimentVariation.IsStale)
    {
        result = await StoreServicesExperimentVariation.GetRefreshedVariationAsync(projectId);

        if (result.ErrorCode == StoreServicesEngagementErrorCode.None)
        {
            variation = result.ExperimentVariation;
        }
    }

    // Get the remote variable named "buttonText" and assign the value
    // to the button.
    var buttonText = variation.GetString("buttonText", "Grey Button");
    await button.Dispatcher.RunAsync(
        Windows.UI.Core.CoreDispatcherPriority.Normal,
        () =>
        {
            button.Content = buttonText;
        });

    // Log the view event named "userViewedButton" to Dev Center.
    if (logger == null)
    {
        logger = StoreServicesCustomEventLogger.GetDefault();
    }

    logger.LogForVariation(variation, "userViewedButton");
}

次の手順では、このプロセスの重要な部分について詳しく説明します。

現在のバリエーションの割り当てを表す StoreServicesExperimentVariation オブジェクトと、ビューイベントと変換イベントをパートナーセンターに記録するために使用する StoreServicesCustomEventLogger オブジェクトを宣言します。
```
private StoreServicesExperimentVariation variation;
private StoreServicesCustomEventLogger logger;
```
取得する実験のプロジェクト ID に割り当てられている文字列変数を宣言します。

注

プロジェクトをパートナーセンターで作成すると、プロジェクト ID を取得します。次に示すプロジェクト ID は、例を目的としています。
```
private string projectId = "F48AC670-4472-4387-AB7D-D65B095153FB";
```
静的 GetCachedVariationAsync メソッドを呼び出して実験の現在のキャッシュされたバリエーションの割り当てを取得し、実験のプロジェクト ID をメソッドに渡します。このメソッドは、ExperimentVariation プロパティを介してバリエーションの割り当てへのアクセスを提供する StoreServicesExperimentVariationResult オブジェクトを返します。
```
var result = await StoreServicesExperimentVariation.GetCachedVariationAsync(projectId);
variation = result.ExperimentVariation;
```
IsStale プロパティを調べて、キャッシュされたバリエーションの割り当てをサーバーからのリモートバリエーション割り当てで更新する必要があるかどうかを判断します。更新する必要がある場合は、静的 GetRefreshedVariationAsync メソッドを呼び出して、サーバーから更新されたバリエーションの割り当てを確認し、ローカルにキャッシュされたバリエーションを更新します。
```
if (result.ErrorCode != StoreServicesEngagementErrorCode.None || result.ExperimentVariation.IsStale)
{
    result = await StoreServicesExperimentVariation.GetRefreshedVariationAsync(projectId);

    if (result.ErrorCode == StoreServicesEngagementErrorCode.None)
    {
        variation = result.ExperimentVariation;
    }
}
```
StoreServicesExperimentVariation オブジェクトの GetBoolean、GetDouble、GetInt32、または GetString メソッドを使用して、バリエーション割り当ての値を取得します。各メソッドでは、最初のパラメーターは取得するバリエーションの名前です (これは、パートナーセンターで入力したバリエーションの名前と同じです)。 2 番目のパラメーターは、パートナーセンターから指定した値を取得できず (ネットワーク接続がない場合など)、キャッシュされたバージョンのバリエーションを使用できない場合に、メソッドが返す既定値です。

次の例では、GetString を使用して buttonText という名前の変数取得し、既定の変数値灰色のボタンを指定します。
```
var buttonText = variation.GetString("buttonText", "Grey Button");
```
コードで変数値を使用して、テストする機能の動作を変更します。たとえば、次のコードは、buttonText 値をアプリ内のボタンの内容に割り当てます。この例では、プロジェクト内の別の場所でこのボタンを既に定義していることを前提としています。
```
await button.Dispatcher.RunAsync(
    Windows.UI.Core.CoreDispatcherPriority.Normal,
    () =>
    {
        button.Content = buttonText;
    });
```
最後に、実験のビューイベントをパートナーセンターの A/B テストサービスに記録します。 logger フィールドを StoreServicesCustomEventLogger オブジェクトに初期化し、LogForVariation メソッドを呼び出します。現在のバリエーションの割り当てを表す StoreServicesExperimentVariation オブジェクト (このオブジェクトは、パートナーセンターにイベントに関するコンテキストを提供します) と、実験のビューイベントの名前を渡します。これは、パートナーセンターで実験に入力したビューイベント名と一致する必要があります。コードでは、ユーザーが実験の一部であるバリエーションの表示を開始したときに、ビューイベントをログに記録する必要があります。

次の例では、ビューイベント「userViewedButton」をログに記録する方法を示します。この例では、実験の目的は、ユーザーにアプリ内のボタンをクリックしてもらうため、アプリがバリエーションデータ (この場合はボタンテキスト) を取得し、ボタンのコンテンツに割り当てた後にビューイベントがログに記録されます。
```
if (logger == null)
{
    logger = StoreServicesCustomEventLogger.GetDefault();
}

logger.LogForVariation(variation, "userViewedButton");
```

変換イベントをパートナーセンターに記録する

次に、パートナーセンター A/B テストサービスに変換イベントをログに記録するコードを追加します。コードでは、ユーザーが実験の目標に達したときに変換イベントをログに記録する必要があります。必要な特定のコードはアプリによって異なりますが、一般的な手順は次のとおりです。完全なコード例については、「A/B テストを使用して最初の実験を作成して実行する」を参照してください。

ユーザーが実験のいずれかの目標に達したときに実行されるコードで、LogForVariation メソッドをもう一度呼び出し、StoreServicesExperimentVariation オブジェクトと実験の変換イベントの名前を渡します。これは、パートナーセンターで実験に入力する変換イベント名の 1 つと一致する必要があります。

次の例では、ボタンの Click イベントハンドラーから、userClickedButton という名前の変換イベントをログに記録します。この例では、実験の目的は、ユーザーにボタンをクリックしてもらう方法です。
```
private void button_Click(object sender, RoutedEventArgs e)
{
    if (logger == null)
    {
        logger = StoreServicesCustomEventLogger.GetDefault();
    }

    logger.LogForVariation(variation, "userClickedButton");
}
```

次のステップ

アプリで実験をコーディングしたら、次の手順を実行できます。

パートナーセンターで実験を定義します。 A/B テストのビューイベント、変換イベント、および一意のバリエーションを定義する実験を作成します。
パートナーセンターで実験を実行して管理します。

パートナーセンターでプロジェクトを作成し、リモート変数を定義
パートナーセンターで実験を定義する
パートナーセンターで実験を管理する
A/B テストを使用して最初の実験を作成して実行する
A/B テストを使用してアプリの実験を実行する

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-06-10

次の方法で共有

実験用にアプリをコーディングする

プロジェクトを構成する

バリエーション データを取得し、実験のビュー イベントをログに記録する

変換イベントをパートナー センターに記録する

次のステップ

関連トピック

フィードバック

その他のリソース

バリエーションデータを取得し、実験のビューイベントをログに記録する

変換イベントをパートナーセンターに記録する