Управление целевыми предложениями с помощью служб Магазина
Если вы создаете целевое предложение на странице Привлечение > целевых предложений для своего приложения в Центре партнеров, используйте API целевых предложений Microsoft Store в коде приложения, чтобы получить сведения, которые помогут вам реализовать интерфейс приложения для целевого предложения. Дополнительные сведения о целевых предложениях и способах их создания на информационной панели см. в разделе Использование целевых предложений для повышения вовлеченности и количества конверсий.
API целевых предложений представляет собой простой API REST, который можно использовать для получения целевых предложений, которые доступны для текущего пользователя, в зависимости от того, является ли пользователь частью клиентского сегмента для целевого предложения. Для использования этого API в коде приложения выполните следующие действия:
- Получите маркер учетной записи Майкрософт для текущего пользователя приложения, который вошел в систему.
- Получите целевые предложения для текущего пользователя.
- Реализация возможности покупки из приложения для надстройки, связанной с использованием одного из целевых предложений. Дополнительные сведения о реализации покупок из приложений см. в этой статье.
Полный пример кода, демонстрирующий все эти действия, см. в примере кода в конце данной статьи. Все эти действия более подробно описаны в следующих разделах.
Получите маркер учетной записи Майкрософт для текущего пользователя
В коде приложения получите маркер учетной записи Майкрософт (MSA) для текущего пользователя, вошедшего в систему. Необходимо передать этот маркер в заголовок запроса Authorization
для API целевых предложений Microsoft Store. Этот маркер используется в Store для получения целевых предложений, которые доступны для текущего пользователя.
Чтобы получить маркер MSA, используйте класс WebAuthenticationCoreManager для запроса маркера с помощью области devcenter_implicit.basic,wl.basic
. В следующем примере показано, как это сделать. В этом примере приведен фрагмент из полного примера, и он требует использования инструкций, которые содержатся в полном примере.
private async Task<string> GetMicrosoftAccountTokenAsync()
{
var msaProvider = await WebAuthenticationCoreManager.FindAccountProviderAsync(
"https://login.microsoft.com", "consumers");
WebTokenRequest request = new WebTokenRequest(msaProvider, "devcenter_implicit.basic,wl.basic");
WebTokenRequestResult result = await WebAuthenticationCoreManager.RequestTokenAsync(request);
if (result.ResponseStatus == WebTokenRequestStatus.Success)
{
return result.ResponseData[0].Token;
}
else
{
return string.Empty;
}
}
Дополнительные сведения о получении маркеров MSA см. в разделе Диспетчер учетных записей в Интернете.
Получение целевых предложений для текущего пользователя
После получения маркера MSA для текущего пользователя вызовите метод GET URI https://manage.devcenter.microsoft.com/v2.0/my/storeoffers/user
для получения целевых предложений, доступных для текущего пользователя. Дополнительные сведения об этом методе REST см. в разделе Получение целевых предложений.
Этот метод возвращает ИД продуктов для надстроек, связанных с целевыми предложениями, доступными для текущего пользователя. С помощью этих сведений вы можете показать пользователю одно или несколько целевых предложений как покупку из приложения.
В примере ниже показано, как получить целевые предложения для текущего пользователя. Этот пример представляет собой фрагмент полного примера. Он требует библиотеку Json.NET от Newtonsoft, а также дополнительные классы и инструкции using, которые содержатся в полном примере.
private async Task<List<TargetedOfferData>> GetTargetedOffersForUserAsync(string msaToken)
{
if (string.IsNullOrEmpty(msaToken))
{
System.Diagnostics.Debug.WriteLine("Microsoft Account token is null or empty.");
return null;
}
HttpClient httpClientGetOffers = new HttpClient();
httpClientGetOffers.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", msaToken);
List<TargetedOfferData> availableOfferData = null;
try
{
string getOffersResponse = await httpClientGetOffers.GetStringAsync(new Uri(storeOffersUri));
availableOfferData =
Newtonsoft.Json.JsonConvert.DeserializeObject<List<TargetedOfferData>>(getOffersResponse);
}
catch (Exception ex)
{
System.Diagnostics.Debug.WriteLine(ex.Message);
}
return availableOfferData;
}
Полный пример кода
В следующем примере кода показаны следующие задачи:
- Получение маркера MSA для текущего пользователя.
- Получение всех целевых предложений для текущего пользователя с помощью метода Получение целевого предложения.
- Приобретите надстройку, которая связана с целевым предложением.
Для этого примера требуется библиотека Json.NET от Newtonsoft. В примере эта библиотека используется для сериализации и десериализации данных формата JSON.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Net.Http;
using System.Net.Http.Headers;
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using Windows.Services.Store;
using Windows.Security.Authentication.Web.Core;
namespace DocumenationExamples
{
public class TargetedOffersExample
{
private const string storeOffersUri = "https://manage.devcenter.microsoft.com/v2.0/my/storeoffers/user";
private const string jsonMediaType = "application/json";
private static string[] productKinds = { "Durable", "Consumable", "UnmanagedConsumable" };
private static StoreContext storeContext = StoreContext.GetDefault();
public async void DemonstrateTargetedOffers()
{
// Get the Microsoft Account token for the current user.
string msaToken = await GetMicrosoftAccountTokenAsync();
if (string.IsNullOrEmpty(msaToken))
{
System.Diagnostics.Debug.WriteLine("Microsoft Account token could not be retrieved.");
return;
}
// Get the targeted Store offers for the current user.
List<TargetedOfferData> availableOfferData =
await GetTargetedOffersForUserAsync(msaToken);
if (availableOfferData == null || availableOfferData.Count == 0)
{
System.Diagnostics.Debug.WriteLine("There was an error retrieving targeted offers," +
"or there are no targeted offers available for the current user.");
return;
}
// Get the product ID of the add-on that is associated with the first available offer
// in the response data.
TargetedOfferData offerData = availableOfferData[0];
string productId = offerData.Offers[0];
// Get the Store ID of the add-on that has the matching product ID, and then purchase the add-on.
List<String> filterList = new List<string>(productKinds);
StoreProductQueryResult queryResult = await storeContext.GetAssociatedStoreProductsAsync(filterList);
foreach (KeyValuePair<string, StoreProduct> result in queryResult.Products)
{
if (result.Value.InAppOfferToken == productId)
{
await PurchaseOfferAsync(result.Value.StoreId);
return;
}
}
System.Diagnostics.Debug.WriteLine("No add-on with the specified product ID could be found " +
"for the current app.");
return;
}
private async Task<string> GetMicrosoftAccountTokenAsync()
{
var msaProvider = await WebAuthenticationCoreManager.FindAccountProviderAsync(
"https://login.microsoft.com", "consumers");
WebTokenRequest request = new WebTokenRequest(msaProvider, "devcenter_implicit.basic,wl.basic");
WebTokenRequestResult result = await WebAuthenticationCoreManager.RequestTokenAsync(request);
if (result.ResponseStatus == WebTokenRequestStatus.Success)
{
return result.ResponseData[0].Token;
}
else
{
return string.Empty;
}
}
private async Task<List<TargetedOfferData>> GetTargetedOffersForUserAsync(string msaToken)
{
if (string.IsNullOrEmpty(msaToken))
{
System.Diagnostics.Debug.WriteLine("Microsoft Account token is null or empty.");
return null;
}
HttpClient httpClientGetOffers = new HttpClient();
httpClientGetOffers.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", msaToken);
List<TargetedOfferData> availableOfferData = null;
try
{
string getOffersResponse = await httpClientGetOffers.GetStringAsync(new Uri(storeOffersUri));
availableOfferData =
Newtonsoft.Json.JsonConvert.DeserializeObject<List<TargetedOfferData>>(getOffersResponse);
}
catch (Exception ex)
{
System.Diagnostics.Debug.WriteLine(ex.Message);
}
return availableOfferData;
}
private async Task PurchaseOfferAsync(string storeId)
{
if (string.IsNullOrEmpty(storeId))
{
System.Diagnostics.Debug.WriteLine("storeId is null or empty.");
return;
}
// Purchase the add-on for the current user. Typically, a game or app would first show
// a UI that prompts the user to buy the add-on; for simplicity, this example
// simply purchases the add-on.
StorePurchaseResult result = await storeContext.RequestPurchaseAsync(storeId);
// Capture the error message for the purchase operation, if any.
string extendedError = string.Empty;
if (result.ExtendedError != null)
{
extendedError = result.ExtendedError.Message;
}
switch (result.Status)
{
case StorePurchaseStatus.AlreadyPurchased:
System.Diagnostics.Debug.WriteLine("The user has already purchased the product.");
break;
case StorePurchaseStatus.Succeeded:
System.Diagnostics.Debug.WriteLine("The purchase was successful.");
break;
case StorePurchaseStatus.NotPurchased:
System.Diagnostics.Debug.WriteLine("The purchase did not complete. " +
"The user may have cancelled the purchase. ExtendedError: " + extendedError);
break;
case StorePurchaseStatus.NetworkError:
System.Diagnostics.Debug.WriteLine("The purchase was unsuccessful due to a network error. " +
"ExtendedError: " + extendedError);
break;
case StorePurchaseStatus.ServerError:
System.Diagnostics.Debug.WriteLine("The purchase was unsuccessful due to a server error. " +
"ExtendedError: " + extendedError);
break;
default:
System.Diagnostics.Debug.WriteLine("The purchase was unsuccessful due to an unknown error. " +
"ExtendedError: " + extendedError);
break;
}
}
}
public class TargetedOfferData
{
[JsonProperty(PropertyName = "offers")]
public IList<string> Offers { get; } = new List<string>();
[JsonProperty(PropertyName = "trackingId")]
public string TrackingId { get; set; }
}
}
Связанные темы
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по