カスタム アプリ プロモーション キャンペーンの作成

  • [アーティクル]

Windows アプリ内で実行されるアプリの広告キャンペーンの作成に加えて、他のチャネルを使ってアプリを宣伝することもできます。 たとえば、サード パーティのアプリ マーケティング プロバイダーを使ってアプリを宣伝したり、ソーシャル メディア サイトにアプリのリンクを投稿したりできます。 これらの活動はカスタム キャンペーンと呼ばれます。

アプリのカスタム キャンペーンを実行する場合、カスタム キャンペーンごとに異なるキャンペーン ID を含んだ異なる URL を作成することによって、各キャンペーンの相対的な成果を追跡できます。 Windows 10 を実行しているユーザーがキャンペーン ID を含む URL をクリックすると、Microsoft により対応するカスタム キャンペーンに関連付けられ、そのデータがパートナー センターで使用できるようになります。

重要

このデータは、Windows 10 ユーザーについてのみ追跡されます。 他のオペレーティング システムを使用しているユーザーも、アプリの登録情報へのリンクをたどることはできますが、それらのユーザーの活動に関するデータは含まれません。

カスタム キャンペーンに関連付けられる 2 種類の主要なデータがあります。アプリの Store 登録情報のページ ビューとコンバージョンです。 コンバージョンとは、カスタム キャンペーン ID を含む URL からアプリのストア登録情報ページを閲覧したユーザーが、結果としてアプリを取得することです。 コンバージョンについて詳しくは、このトピックの「アプリの取得がコンバージョンとして認められるしくみについて」をご覧ください。

次の方法でアプリのカスタム キャンペーンのパフォーマンス データが得られます。

  • アプリやアドオンのページ ビューとコンバージョンに関するデータは、[取得] レポートで、[キャンペーン ID ごとのアプリ ページ ビューとコンバージョン] グラフと [キャンペーンのコンバージョン合計] グラフから確認できます。
  • アプリがユニバーサル Windows プラットフォーム (UWP) アプリの場合は、Windows SDK の API を使って、コンバージョンの基となるカスタム キャンペーン ID をプログラムによって取得できます。

カスタム キャンペーンのシナリオの例

新しいゲームの作成を終えたゲーム開発者がおり、このゲームをこの開発者の以前のゲームのプレーヤーに宣伝したいと考えているとします。 開発者は、自分の Facebook のページで新しいゲームのリリースに関するお知らせを投稿し、その中にこのゲームの Store 登録情報へのリンクを含めます。 また、Twitter でも多くのプレーヤーがこの開発者をフォローしているため、このゲームの Store 登録情報へのリンクを含むお知らせをツイートします。

これらの各プロモーション チャネルの成果を追跡するためには、このゲームの Store 登録情報への URL を 2 種類作成します。

  • Facebook のページに投稿する URL には、カスタム キャンペーン ID my-facebook-campaign を含めます。

  • Twitter に投稿する URL には、カスタム キャンペーン ID my-twitter-campaign を含めます。

Facebook や Twitter のフォロワーがその URL をクリックすると、それが記録されて対応するカスタム キャンペーンに関連付けられます。 以降、ゲームおよびアドオンの購入に関して要件を満たすものは、カスタム キャンペーンと関連付けられてコンバージョンとして報告されます。

取得がコンバージョンとして認められるしくみについて

カスタム キャンペーンのコンバージョンとは、カスタム キャンペーンによって宣伝された URL をクリックしたユーザーが、結果としてアプリを取得することです。 [取得] レポートの [キャンペーン ID ごとのアプリ ページ ビューとコンバージョン] と [キャンペーンのコンバージョン合計] グラフでコンバージョンであると認められるシナリオと、プログラムによってキャンペーン ID を取得した場合にコンバージョンであると認められるシナリオは異なります。

取得レポートでの変換の修飾

[取得] レポートの [キャンペーン ID ごとのアプリ ページ ビューとコンバージョン] グラフと [キャンペーンのコンバージョン合計] グラフで、コンバージョンとして認められるシナリオは次のとおりです。

  • ユーザー (認識されている Microsoft アカウントを使っているかどうかにかかわらない) が、カスタム キャンペーン ID が含まれているアプリの URL をクリックし、アプリのストア登録情報のページにリダイレクトされ、 その後、同じユーザーが、カスタム キャンペーン ID が含まれている Microsoft Store の URL を最初にクリックしてから 24 時間以内にアプリを取得している。

  • カスタム キャンペーン ID が含まれている Windows ストアの URL をクリックしたのとは別のデバイスでアプリを取得した場合には、URL をクリックしたときと同じ Microsoft アカウントを使ってユーザーがサインインしている場合に限り、コンバージョンとしてカウントされる。

注意

カスタム キャンペーンのコンバージョンとしてカウントされるアプリの取得については、アプリ内で購入されたアドオンも、同じカスタム キャンペーンのコンバージョンとしてカウントされます。

プログラムによってキャンペーン ID を取得する場合にコンバージョンと認められる条件

アプリに関連付けられているキャンペーン ID をプログラムによって取得するときに、コンバージョンであると認められるには、次の条件を満たす必要があります。

  • Windows 10 バージョン 1607 以降を実行しているデバイスの場合: ユーザー (認識されている Microsoft アカウントを使ってサインインしているかどうかにかかわらない) が、カスタム キャンペーン ID が含まれている URL をクリックし、アプリのストア登録情報ページにリダイレクトされ、 URL をクリックした結果としてストア登録情報を閲覧している最中にアプリを取得している。

  • Windows 10 バージョン 1511 以前を実行しているデバイスの場合: ユーザー (認識されている Microsoft アカウントを使ってサインインしている) が、カスタム キャンペーン ID が含まれている URL をクリックし、アプリのストア登録情報ページにリダイレクトされ、 URL をクリックした結果としてストア登録情報を閲覧している最中にアプリを取得している。 これらのバージョンのWindows 10またはWindows 11では、プログラムによってキャンペーン ID を取得するときに、取得がコンバージョンとして適格になるには、認識された Microsoft アカウントを使用してユーザーがサインインする必要があります。

注意

ユーザーがストア登録情報ページから離れても、(同じデバイスを使うか、別のデバイスの場合は同じ Microsoft アカウントでサインインした状態で) 24 時間以内にページに再びアクセスし、アプリを取得した場合、これは [取得] レポートの [キャンペーン ID ごとのアプリ ページ ビューとコンバージョン] グラフと [キャンペーンのコンバージョン合計] グラフでコンバージョンとして認められます。 ただし、プログラムによってキャンペーン ID を取得した場合にはコンバージョンとして認められません。

アプリの Microsoft Store のページの URL にカスタム キャンペーン ID を埋め込む

カスタム キャンペーン ID が含まれているアプリの Microsoft Store のページの URL を作成するには、次の手順を実施します。

  1. カスタム キャンペーン用の ID 文字列を作成します。 この文字列は最大 100 文字にできますが、簡単に識別できる短いキャンペーン ID を定義することをお勧めします。

注意

キャンペーン ID 文字列は、他の開発者がその開発者のアプリの [取得] レポートを閲覧するときに、表示される場合があります。 これは、ユーザーがカスタム キャンペーン ID をクリックしてストアに入り、同じセッション中に別の開発者のアプリを購入した場合、つまり、そのコンバージョンにそのカスタム キャンペーン ID が寄与した場合に発生します。 その開発者には、最初にこのキャンペーン ID をクリックした結果として発生したその開発者のアプリのコンバージョン数とキャンペーン ID の名前が表示されますが、このキャンペーン ID をクリックしてキャンペーン ID の所有者 (またはその他の開発者) のアプリを購入したユーザー数についてのデータは表示されません。

  1. HTML またはプロトコル形式でアプリの Store 登録情報のリンクを取得します。

    • どのオペレーティング システムであっても、ユーザーがブラウザーからアプリの Web ベースのストア登録情報に移動できるようにするには、HTML URL を使います。 Windows デバイスでは、ストア アプリも起動して、アプリの登録情報を表示します。 この URL の形式は https://www.microsoft.com/store/apps/*your app ID* です。 たとえば、Skype 用の HTML URL は https://www.microsoft.com/store/apps/9wzdncrfj364 になります。 この URL は、[アプリ ID] ページで確認できます。

    • UWP アプリがインストールされたデバイスやコンピューター上で実行されている他の Windows アプリ内でアプリを宣伝するか、ユーザーが Microsoft Store をサポートするデバイスを使用していることが確かな場合は、プロトコル形式を使います。 このリンクは、ブラウザーを開かずに直接アプリのストア登録情報に移動します。 この URL の形式は ms-windows-store://pdp/?PRODUCTID=*your app id* です。 たとえば、Skype 用のプロトコル URL は ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364 になります。

  2. アプリの URL の末尾に次の文字列を追加します。

    • HTML 形式の URL の場合は ?cid=*my custom campaign ID*?cid= を追加します。 たとえば、Skype でキャンペーン ID の値が custom_campaign であるキャンペーンを紹介する場合、このキャンペーン ID を含む新しい URL は https://www.microsoft.com/store/apps/skype/9wzdncrfj364?cid=custom\_campaign になります。

    • プロトコル形式の URL の場合は &cid=*my custom campaign ID* を追加します。 たとえば、Skype でキャンペーン ID の値が custom_campaign であるキャンペーンを紹介する場合、このキャンペーン ID を含む新しいプロトコル URL は ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364&cid=custom\_campaign になります。

アプリのカスタム キャンペーン ID をプログラムで取得する

アプリが UWP アプリの場合、アプリの取得に関連付けられているカスタム キャンペーン ID を、Windows SDK の API を使ってプログラムで取得できます。 これらの API によって、多くの分析シナリオや収益化シナリオが可能になります。 たとえば、現在のユーザーが Facebook のキャンペーンによってアプリを見つけた後でアプリを取得したかどうかがわかるので、それに合わせてアプリのエクスペリエンスをカスタマイズできます。 また、サード パーティのアプリ マーケティング プロバイダーを使っている場合は、プロバイダーにデータを送ることができます。

これらの API は、ユーザーがキャンペーン ID が埋め込まれた URL をクリックし、アプリの Microsoft Store のページを閲覧し、Store 登録情報ページから離れることなくアプリを取得する場合にのみキャンペーン ID 文字列を返します。 ユーザーがこのページから離れ、後で戻ってアプリを取得する場合、これらの API ではコンバージョンとして認められません。

アプリが対象とする Windows のバージョンに応じて、使用する API は異なります。

  • Windows 10 バージョン 1607 以降: Windows.Services.Store 名前空間の StoreContext クラスを使います。 この API を使用するときは、認識されている Microsoft アカウントを使ってユーザーがサインインしているかどうかに関係なく、条件を満たしている取得についてカスタム キャンペーン ID を取得できます。

  • Windows 10 バージョン 1511 以前の場合: Windows.ApplicationModel.Store名前空間の CurrentApp クラスを使います。 この API を使用するときは、認識されている Microsoft アカウントを使ってユーザーがサインインしている場合にのみ、条件を満たしている取得についてカスタム キャンペーン ID を取得できます。

注意

Windows.ApplicationModel.Store 名前空間は、Windows 10またはWindows 11のすべてのバージョンで使用できますが、アプリがWindows 10バージョン 1607 以降を対象とする場合は、Windows.Services.Store 名前空間で API を使用することをお勧めします。 これらの名前空間の違いについて詳しくは、「アプリ内購入と試用版」をご覧ください。 次のコード例は、同じプロジェクトで両方の API を使用するコードを構築する方法を示しています。

コードの例

次のコード例は、カスタム キャンペーン ID を取得する方法を示しています。 この例では、バージョン アダプティブ コードを使用することによって、Windows.Services.Store 名前空間と Windows.ApplicationModel.Store 名前空間の両方の API のセットを使用しています。 このプロセスに従うことで、コードは任意のバージョンのWindows 10またはWindows 11で実行できます。 このコードを使用するには、プロジェクトのターゲット OS のバージョンが、Windows 10 Anniversary Edition (10.0、ビルド 14394) 以降である必要があります。ただし、最小 OS バージョンは以前のバージョンにすることができます。

// This example assumes the code file has using statements for
// System.Linq, System.Threading.Tasks, Windows.Data.Json,
// and Windows.Services.Store.
public async Task<string> GetCampaignId()
{
    // Use APIs in the Windows.Services.Store namespace if they are available
    // (the app is running on a device with Windows 10, version 1607, or later).
    if (Windows.Foundation.Metadata.ApiInformation.IsTypePresent(
         "Windows.Services.Store.StoreContext"))
    {
        StoreContext context = StoreContext.GetDefault();

        // Try to get the campaign ID for users with a recognized Microsoft account.
        StoreProductResult result = await context.GetStoreProductForCurrentAppAsync();
        if (result.Product != null)
        {
            StoreSku sku = result.Product.Skus.FirstOrDefault(s => s.IsInUserCollection);

            if (sku != null)
            {
                return sku.CollectionData.CampaignId;
            }
        }

        // Try to get the campaign ID from the license data for users without a
        // recognized Microsoft account.
        StoreAppLicense license = await context.GetAppLicenseAsync();
        JsonObject json = JsonObject.Parse(license.ExtendedJsonData);
        if (json.ContainsKey("customPolicyField1"))
        {
            return json["customPolicyField1"].GetString();
        }

        // No campaign ID was found.
        return String.Empty;
    }
    // Fall back to using APIs in the Windows.ApplicationModel.Store namespace instead
    // (the app is running on a device with Windows 10, version 1577, or earlier).
    else
    {
#if DEBUG
        return await Windows.ApplicationModel.Store.CurrentAppSimulator.GetAppPurchaseCampaignIdAsync();
#else
        return await Windows.ApplicationModel.Store.CurrentApp.GetAppPurchaseCampaignIdAsync() ;
#endif
    }
}

このコードは、次の処理を実行します。

  1. まず、現在のデバイスで Windows.Services.Store 名前空間の StoreContext クラスが利用可能かどうか (つまり、デバイスで Windows 10 バージョン1607 以降が実行されているかどうか) を確認します。 利用可能な場合、コードはこのクラスを使って処理を進めます。

  2. 次に、現在のユーザーが認識されている Microsoft アカウントを使っている場合は、カスタム キャンペーン ID の取得を試行します。 これを行うために、コードは、現在のアプリの SKU を表す StoreSku オブジェクトを取得した後、CampaignId プロパティにアクセスしてキャンペーン ID (利用可能な場合) を取得します。

  3. 次に、コードは、現在のユーザーが認識されている Microsoft アカウントを使っていない場合のキャンペーン ID の取得を試行します。 この場合、キャンペーン ID はアプリのライセンスに埋め込まれています。 コードは、GetAppLicenseAsync メソッドを使用してライセンスを取得した後、ライセンスの JSON コンテンツを解析して customPolicyField1 というキーの値を取得します。 この値にキャンペーン ID が含まれています。

  4. Windows.Services.Store 名前空間の StoreContext クラスを使用できない場合、コードは、Windows.ApplicationModel.Store 名前空間の GetAppPurchaseCampaignIdAsync メソッドを使用してカスタム キャンペーン ID を取得するためにフォールバックします (この名前空間は、Windows 10またはWindows 11のすべてのバージョンで使用できます)。 このメソッドを使用するときは、ユーザーが正式な Microsoft アカウントを持っている場合にのみ、条件を満たしている取得についてカスタム キャンペーン ID を取得できることに注意してください。

プロキシ ファイルで Windows.ApplicationModel.Store 名前空間のキャンペーン ID を指定します。

Windows.ApplicationModel.Store 名前空間には CurrentAppSimulator が含まれています。これは、ストアにアプリを提出する前に、ストアの操作をシミュレートしてコードをテストするための特別なクラスです。 このクラスは、Windows.StoreProxy.xml ファイルという名前のローカル ファイルからデータを取得します。 前のコード例は、プロジェクトのデバッグおよび非デバッグ コードに CurrentApp と CurrentAppSimulator の両方を含める方法を示しています。 デバッグ環境でこのコードをテストするには、次の例のように、開発用コンピューターの WindowsStoreProxy.xml ファイルに AppPurchaseCampaignId 要素を追加します。 アプリを実行すると、GetAppPurchaseCampaignIdAsync メソッドは常にこの値を返します。

<CurrentApp>
    ...
    <AppPurchaseCampaignId>your custom campaign ID</AppPurchaseCampaignId>
</CurrentApp>

Windows.Services.Store 名前空間には、テスト中にライセンス情報をシミュレートするために使用できるクラスが用意されていません。 代わりに、アプリをストアに公開し、そのアプリを開発用デバイスにダウンロードして、そのライセンスをテストに使用する必要があります。 詳しくは、「アプリ内購入と試用版」をご覧ください。

カスタム キャンペーンをテストする

カスタム キャンペーンの URL を宣伝する前に、次の手順でカスタム キャンペーンをテストすることをお勧めします。

  1. テストに使用するデバイスで Microsoft アカウントにサインインします。

  2. カスタム キャンペーンの URL をクリックします。 アプリのページに移動することを確認し、UWP アプリまたはブラウザーのページを閉じます。

  3. さらに URL を数回クリックします。アプリのページに移動した後は、毎回 UWP アプリまたはブラウザーのページを閉じます。 アプリのページに移動したいずれかのときに、アプリを取得してコンバージョンを生成します。 URL をクリックした合計回数を覚えておきます。

  4. [取得] レポートの [キャンペーン ID ごとのアプリ ページ ビューとコンバージョン] グラフと [キャンペーンのコンバージョン合計] グラフで、予想されるページ ビュー数とコンバージョン数が示されるかどうかを確認します。また、アプリのコードをテストして、上記の API を使ってキャンペーン ID が正しく取得されるかどうかを確認します。