Obtener ofertas dirigidasGet targeted offers

Usa este método para obtener las ofertas dirigidas que están disponibles para el usuario actual, en función de si el usuario es parte del segmento de cliente para la oferta dirigida o no.Use this method to get the targeted offers that are available for the current user, based on whether or not the user is part of the customer segment for the targeted offer. Para obtener más información, consulta Administrar ofertas dirigidas usando los servicios de la Store.For more information, see Manage targeted offers using Store services.

Requisitos previosPrerequisites

Para usar este método, primero debes obtener un token de cuenta de Microsoft para el usuario que inició sesión actualmente en la aplicación.To use this method, you need to first obtain a Microsoft Account token for the current signed-in user of your app. Debes pasar este token en el encabezado de la solicitud Authorization para este método.You must pass this token in the Authorization request header for this method. La Store usa este token para obtener las ofertas dirigidas para el usuario actual.This token is used by the Store to get targeted offers for the current user.

SolicitudRequest

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET https://manage.devcenter.microsoft.com/v2.0/my/storeoffers/user

Encabezado de la solicitudRequest header

EncabezadoHeader TipoType DescripciónDescription
AutorizaciónAuthorization stringstring Obligatorio.Required. El token Account de Microsoft para el usuario que inició sesión actual de la aplicación en el formulario portador < token>.The Microsoft Account token for the current signed-in user of your app in the form Bearer <token>.

Parámetros de solicitudRequest parameters

Este método no tiene parámetros de URI ni de consulta.This method has no URI or query parameters.

Ejemplo de solicitudRequest example

GET https://manage.devcenter.microsoft.com/v2.0/my/storeoffers/user HTTP/1.1
Authorization: Bearer <Microsoft Account token>

RespuestaResponse

Este método devuelve un cuerpo de respuesta en formato JSON que contiene una matriz de objetos con los siguientes campos.This method returns a JSON-formatted response body that contains an array of objects with the following fields. Cada objeto en la matriz representa las ofertas dirigidas que están disponibles para el usuario especificado como parte de un segmento de cliente en particular.Each object in the array represents the targeted offers that are available for the specified user as part of a particular customer segment.

CampoField TipoType DescripciónDescription
ofertasoffers arrayarray Una matriz de identificadores de producto para los complementos que están asociados con las ofertas dirigidas que están disponibles para el usuario actual.An array of product IDs for the add-ons that are associated with the targeted offers that are available for the current user. Estos identificadores de producto se especifican en el destino ofertas página de la aplicación en el centro de partners.These product IDs are specified in the Targeted offers page for your app in Partner Center.
trackingIdtrackingId stringstring Un GUID que, opcionalmente, puedes utilizar para realizar un seguimiento de la oferta dirigida en tu propio código o servicios.A GUID that you can optionally use to keep track of the targeted offer in your own code or services.

EjemploExample

En el ejemplo siguiente se muestra el cuerpo de una respuesta JSON de ejemplo realizada para esta solicitud.The following example demonstrates an example JSON response body for this request.

[
  {
    "offers": [
      "10x gold coins",
      "100x gold coins"
    ],
    "trackingId": "5de5dd29-6dce-4e68-b45e-d8ee6c2cd203"
  }
]