Obtenir des offres cibléesGet targeted offers

Suivez cette méthode afin d’obtenir les offres ciblées disponibles pour l’utilisateur actuel, basée sur le fait que l’utilisateur fasse partie ou non du segment de clientèle pour l’offre ciblée.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. Pour plus d’informations, consultez Gérer les offres ciblées à l’aide des services du Windows Store.For more information, see Manage targeted offers using Store services.

Conditions préalablesPrerequisites

Pour utiliser cette méthode, vous devez tout d’abord obtenir un jeton de compte Microsoft pour l’utilisateur actuel connecté de votre application.To use this method, you need to first obtain a Microsoft Account token for the current signed-in user of your app. Vous devez transmettre ce jeton dans l’en-tête de requête Authorization de cette méthode.You must pass this token in the Authorization request header for this method. Ce jeton est utilisé par le Microsoft Store pour obtenir des offres ciblées pour l’utilisateur actuel.This token is used by the Store to get targeted offers for the current user.

RequêteRequest

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
GETGET https://manage.devcenter.microsoft.com/v2.0/my/storeoffers/user

En-tête de requêteRequest header

En-têteHeader TypeType DescriptionDescription
AuthorizationAuthorization chaînestring Obligatoire.Required. Le jeton Account Microsoft pour l’utilisateur connecté actuel de votre application sous la forme PORTEUR < jeton>.The Microsoft Account token for the current signed-in user of your app in the form Bearer <token>.

Paramètres de la requêteRequest parameters

Cette méthode ne possède aucun paramètre de requête ou d’URI.This method has no URI or query parameters.

Exemple de requêteRequest example

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

RéponseResponse

Cette méthode retourne un corps de réponse au format JSON qui contient un tableau d’objets avec les champs suivants.This method returns a JSON-formatted response body that contains an array of objects with the following fields. Chaque objet dans le tableau représente les offres ciblées qui sont disponibles pour l’utilisateur spécifié, dans le cadre d’un segment de clients particulier.Each object in the array represents the targeted offers that are available for the specified user as part of a particular customer segment.

ChampField TypeType DescriptionDescription
offersoffers tableauarray Un tableau des ID produit des extensions qui sont associées aux offres ciblées, disponibles pour l’utilisateur actuel.An array of product IDs for the add-ons that are associated with the targeted offers that are available for the current user. Ces ID de produit sont spécifiés dans le ciblés offres page de votre application dans le centre de partenaires.These product IDs are specified in the Targeted offers page for your app in Partner Center.
trackingIdtrackingId chaînestring Un GUID que vous pouvez éventuellement utiliser pour assurer le suivi de l’offre ciblée dans votre propre code ou vos services.A GUID that you can optionally use to keep track of the targeted offer in your own code or services.

ExempleExample

L’exemple suivant représente un corps de réponse JSON pour cette requête.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"
  }
]