Создание настраиваемой кампании по продвижению приложений

Помимо создания рекламной кампании для вашего приложения, которая будет запускаться в приложениях Windows, вы также можете продвигать ваше приложение, используя другие каналы. Например, вы можете повысить уровень приложения с помощью стороннего поставщика маркетинга приложений или опубликовать ссылки на приложение на сайтах социальных сетей. Эти действия называются пользовательскими кампаниями.

Если вы запускаете пользовательские кампании для приложения, вы можете отслеживать относительную производительность каждой кампании, создавая другой URL-адрес для каждой пользовательской кампании, где каждый URL-адрес содержит другой идентификатор кампании. Когда клиент под управлением Windows 10 щелкает URL-адрес, содержащий идентификатор кампании, корпорация Майкрософт связывает щелчк с соответствующей пользовательской кампанией и делает эти данные доступными для вас в Центре партнеров.

Существует два основных типа данных, связанных с пользовательскими кампаниями: просмотры страницы списка приложений в Магазине и преобразования. Преобразование — это приобретение приложения, которое является результатом того, что клиент просматривает страницу в Магазине приложений с URL-адреса, включающего пользовательский идентификатор кампании. Дополнительные сведения о преобразованиях см. в разделе "Общие сведения о том, как приобретение приложений квалифицируется как преобразования в этом разделе".

Вы можете получить пользовательские данные о производительности кампании для приложения следующими способами:

• Вы можете просматривать данные о просмотрах страниц и конверсиях для вашего приложения или надстройки из диаграмм просмотров страниц приложения и конверсий по идентификатору кампании и итоговых конверсий кампаний в отчете о приобретении.
• Если ваше приложение является приложением универсальной платформы Windows (UWP), вы можете использовать API в пакете SDK для Windows программным способом для получения пользовательского идентификатора кампании, который привел к преобразованию.

Пример сценария пользовательской кампании

Рассмотрим разработчика игр, которая завершила создание новой игры и хотела бы продвигать её среди игроков своих существующих игр. Она публикует объявление о новом выпуске игры на своей странице Facebook, включая ссылку на список магазина игры. Многие из ее игроков также подписаны на нее в Twitter, поэтому она также публикует объявление со ссылкой на страницу игры в магазине.

Чтобы отслеживать успех каждого из этих каналов продвижения, разработчик создает два варианта URL-адреса в списке магазина игры:

• URL-адрес, который она будет публиковать на своей странице Facebook, включает настраиваемый идентификатор кампании my-facebook-campaign

• URL-адрес, который она будет публиковать в Twitter включает пользовательский идентификатор кампании my-twitter-campaign

По мере того как ее подписчики Facebook и Twitter щелкают URL-адреса, Корпорация Майкрософт отслеживает каждый щелчк и связывает его с соответствующей пользовательской кампанией. Последующие квалифицированные приобретения игры и любые покупки дополнений связаны с пользовательской кампанией и учитываются как конверсии.

Общие сведения о том, как приобретения считаются преобразованиями

Пользовательская кампания сгенерировала конверсию, полученную в результате того, что клиент переходит по URL, который продвигается через пользовательскую кампанию. Существуют различные сценарии, по которым действия квалифицируются как конверсии в отчетах о приобретениях: просмотры страниц приложения , конверсии по идентификатору кампании, общие конверсии кампаний на диаграммах и квалификация как конверсия при программном получении идентификатора кампании.

Квалификация преобразований в отчете о приобретениях

Следующие сценарии засчитываются как конверсии для просмотров страниц приложения и конверсий по идентификатору кампании и графиков общих конверсий кампании в отчете "Приобретения".

• Клиент с распознанной учетной записью Майкрософт или без нее щелкает URL-адрес приложения, содержащий пользовательский идентификатор кампании, и перенаправляется в список Магазина для приложения. Затем тот же клиент приобретает приложение в течение 24 часов после того, как впервые щелкнул URL-адрес Microsoft Store с пользовательским идентификатором кампании.

• Если клиент получает приложение на устройстве, отличном от того, на котором он щелкнул URL-адрес с пользовательским идентификатором кампании, преобразование будет считаться только в том случае, если клиент вошел с той же учетной записью Майкрософт, что и при щелчке URL-адреса.

Квалификация преобразований при программном получении идентификатора кампании

Чтобы считаться преобразованием при автоматическом получении идентификатора кампании, связанного с приложением, необходимо выполнить следующие условия:

• На устройстве под управлением Windows 10 версии 1607 или более поздней версии: клиент (при входе в распознаваемую учетную запись Майкрософт или нет) щелкает URL-адрес, содержащий пользовательский идентификатор кампании и перенаправляется на страницу описания Магазина для приложения. Клиент получает приложение при просмотре списка в Магазине в результате нажатия URL-адреса.

• На устройстве под управлением Windows 10 версии 1511 или более ранних версий: клиент (который должен войти с распознанной учетной записью Майкрософт) щелкает URL-адрес, содержащий пользовательский идентификатор кампании и перенаправляется на страницу описания Магазина для приложения. Клиент получает приложение при просмотре списка в Магазине в результате нажатия URL-адреса. В этих версиях Windows 10 или Windows 11 пользователь должен быть авторизован с помощью учетной записи Майкрософт, чтобы приобретение засчитывалось как конверсия при программном извлечении идентификатора кампании.

Добавьте пользовательский идентификатор кампании в URL-адрес страницы Microsoft Store вашего приложения

Чтобы создать URL-адрес страницы Microsoft Store для вашего приложения с пользовательским идентификатором кампании:

1. Создайте строку идентификатора для пользовательской кампании. Эта строка может содержать до 100 символов, хотя мы рекомендуем определить идентификаторы коротких кампаний, которые легко идентифицируются.

2. Получите ссылку для страницы вашего приложения в магазине в формате HTML или протокола.

   • Используйте HTML-URL-адрес, если вы хотите, чтобы клиенты могли перейти к веб-списку Магазина на основе вашего приложения в браузере в любой операционной системе. На устройствах с Windows приложение Магазина также запустит и отобразит описание вашего приложения. Этот URL-адрес имеет формат https://apps.microsoft.com/detail/*your app ID*. Например, URL-адрес HTML для Skype https://apps.microsoft.com/detail/9wzdncrfj364. URL-адрес можно найти на странице удостоверения в приложении .

   • Используйте формат протокола, если вы продвигаете приложение из других приложений Windows, работающих на устройстве или компьютере с установленным приложением UWP, или когда вы знаете, что ваши клиенты находятся на устройстве, поддерживающем Microsoft Store. Эта ссылка перейдет непосредственно в список Магазина вашего приложения без открытия браузера. Этот URL-адрес имеет формат ms-windows-store://pdp/?PRODUCTID=*your app id*. Например, URL-адрес протокола для Skype ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364.

3. Добавьте следующую строку в конец URL-адреса приложения:

   • Для URL-адреса формата HTML добавьте ?cid=*my custom campaign ID*. Например, если Skype вводит идентификатор кампании со значением custom_campaign, новый URL-адрес, включая идентификатор кампании, будет: https://apps.microsoft.com/detail/9wzdncrfj364?cid=custom_campaign

   • Для URL-адреса формата протокола добавьте &cid=*my custom campaign ID*. Например, если Skype вводит идентификатор кампании со значением custom_campaign, новый URL-адрес протокола, включая идентификатор кампании, будет: ms-windows-store://pdp/?PRODUCTID=9wzdncrfj364&cid=custom_campaign

Программное получение пользовательского идентификатора кампании для приложения

Если приложение является приложением UWP, вы можете программно получить пользовательский идентификатор кампании, связанный с приобретением приложения, с помощью API в пакете SDK для Windows. Эти API позволяют реализовать множество сценариев аналитики и монетизации. Например, вы можете узнать, приобрел ли текущий пользователь приложение после обнаружения его через кампанию Facebook, а затем настроить интерфейс приложения соответствующим образом. Кроме того, если вы используете стороннего поставщика маркетинга приложений, вы можете отправить данные обратно поставщику.

Эти API возвращают строку идентификатора кампании только в том случае, если клиент щелкнул URL-адрес с внедренным идентификатором кампании, просмотрил страницу Microsoft Store для вашего приложения, а затем получает приложение, не покидая страницу списка в Магазине. Если пользователь покидает страницу, а затем возвращает и получает приложение, это не будет считаться преобразованием при использовании этих API.

Существуют различные API для использования в зависимости от версии Windows, на которую предназначено ваше приложение:

• Windows 10 версии 1607 или более поздней версии: используйте класс StoreContext в пространстве имен Windows.Services.Store . При использовании этого API можно получить пользовательские идентификаторы кампании для любых квалифицированных приобретений, независимо от того, использует ли пользователь зарегистрированную учетную запись Майкрософт.

• Windows 10 версии 1511 или более ранней версии: используйте класс CurrentApp в пространстве имен Windows.ApplicationModel.Store . При использовании этого API можно получить только идентификаторы пользовательских кампаний для квалифицированных приобретений, где пользователь вошел в систему с учетной записью Microsoft.

Пример кода

В следующем примере кода показано, как получить пользовательский идентификатор кампании. В этом примере используются оба набора API в пространствах имен Windows.Services.Store и Windows.ApplicationModel.Store с помощью адаптивногокода версии. Следуя этому процессу, код может выполняться в любой версии Windows 10 или Windows 11. Чтобы использовать этот код, целевая версия ОС проекта должна быть юбилейной версией Windows 10 (10.0; Сборка 14394) или более поздняя, хотя минимальная версия ОС может быть более ранней.

// 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. Во-первых, он проверяет, доступен ли класс StoreContext в пространстве имен Windows.Services.Store на текущем устройстве (это означает, что устройство работает под управлением Windows 10, версии 1607 или более поздней). Если да, код переходит к использованию этого класса.

2. Затем он пытается получить пользовательский идентификатор кампании для случая, когда текущий пользователь имеет распознаваемую учетную запись Майкрософт. Для этого код получает объект StoreSku , представляющий текущий номер SKU приложения, а затем получает доступ к свойству CampaignId для получения идентификатора кампании, если он доступен.

3. Затем код пытается получить идентификатор кампании для случая, когда текущий пользователь не имеет распознанной учетной записи Майкрософт. В этом случае идентификатор кампании внедряется в лицензию приложения. Код извлекает лицензию с помощью метода GetAppLicenseAsync , а затем анализирует содержимое JSON лицензии для значения ключа с именем customPolicyField1. Это значение содержит идентификатор кампании.

4. Если класс StoreContext в пространстве имен Windows.Services.Store недоступен, код возвращается к использованию метода GetAppPurchaseCampaignIdAsync в пространстве имен Windows.ApplicationModel.Store для получения пользовательского идентификатора кампании (это пространство имен доступно во всех версиях Windows 10 или Windows 11). Обратите внимание, что при использовании этого метода можно получить только идентификаторы пользовательских кампаний для получения квалифицированных приобретений , где у пользователя есть распознанная учетная запись Майкрософт.

Укажите идентификатор кампании в прокси-файле для пространства имен Windows.ApplicationModel.Store

Пространство имен Windows.ApplicationModel.Store включает CurrentAppSimulator, специальный класс, который имитирует операции Магазина для тестирования кода перед отправкой приложения в Магазин. Этот класс извлекает данные из локального файла с именем Windows.StoreProxy.xml файла. В предыдущем примере кода показано, как использовать одновременно CurrentApp и CurrentAppSimulator в коде для отладки и обычном коде в проекте. Чтобы протестировать этот код в среде отладки, добавьте элемент AppPurchaseCampaignId в файл WindowsStoreProxy.xml на компьютере разработки, как показано в следующем примере. При запуске приложения метод GetAppPurchaseCampaignIdAsync всегда возвращает это значение.

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

Пространство имен Windows.Services.Store не предоставляет класс, который можно использовать для имитации сведений о лицензии во время тестирования. Вместо этого необходимо опубликовать приложение в Магазине и скачать это приложение на устройство разработки, чтобы использовать ее лицензию для тестирования. Дополнительные сведения см. в разделе "Покупки в приложении" и пробные версии.

Тестирование настраиваемой кампании

Перед продвижением пользовательского URL-адреса кампании рекомендуется протестировать настраиваемую кампанию, выполнив следующие действия.

1. Войдите в учетную запись Майкрософт на устройстве, которое вы используете для тестирования.

2. Щелкните URL-адрес пользовательской кампании. Убедитесь, что вы перейдете на страницу приложения, а затем закройте приложение UWP или страницу браузера.

3. Щелкните URL-адрес еще несколько раз, закрывая приложение UWP или страницу браузера после каждого посещения страницы приложения. При одном из посещений страницы вашего приложения скачайте или приобретите приложение, чтобы совершить конверсию. Подсчитывайте общее количество раз, когда вы щелкали URL-адрес.

4. Убедитесь, что ожидаемые просмотры страниц и конверсии отображаются в диаграммах Просмотры и конверсии страниц приложения по идентификатору кампании и Общие конверсии кампании в отчете "Приобретения", а также протестируйте код вашего приложения, чтобы удостовериться, что он может успешно получить идентификатор кампании с помощью описанных выше API.