Abrufen von gezielten AngebotenGet targeted offers

Verwenden Sie diese Methode, um die gezielten Angebote abzurufen, die für den aktuellen Benutzer verfügbar sind – basierend darauf, ob der Benutzer zum Kundensegment für das gezielte Angebot gehört.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. Weitere Informationen finden Sie unter Verwalten gezielter Angebote mithilfe von Store-Diensten.For more information, see Manage targeted offers using Store services.

VoraussetzungenPrerequisites

Um diese Methode zu verwenden, müssen Sie zunächst ein Microsoft-Kontotoken abrufen, und zwar für den aktuell angemeldeten Benutzer Ihrer App.To use this method, you need to first obtain a Microsoft Account token for the current signed-in user of your app. Sie müssen bei dieser Methode das Token an den Authorization-Anforderungsheader übergeben.You must pass this token in the Authorization request header for this method. Dieses Token wird vom Store verwendet, um gezielte Angebote für den aktuellen Benutzer abzurufen.This token is used by the Store to get targeted offers for the current user.

AnfordernRequest

AnforderungssyntaxRequest syntax

MethodeMethod Anforderungs-URIRequest URI
GETGET https://manage.devcenter.microsoft.com/v2.0/my/storeoffers/user

AnforderungsheaderRequest header

HeaderHeader TypType BeschreibungDescription
AutorisierungAuthorization stringstring Erforderlich.Required. Das Microsoft-Account-Token für den aktuellen angemeldeten Benutzer Ihrer App in der Form Bearer < token>.The Microsoft Account token for the current signed-in user of your app in the form Bearer <token>.

AnforderungsparameterRequest parameters

Diese Methode hat keinen URI oder Anforderungsparameter.This method has no URI or query parameters.

AnforderungsbeispielRequest example

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

AntwortResponse

Diese Methode gibt einen Antworttext im JSON-Format zurück, der ein Array mit Objekten und den folgenden Feldern enthält.This method returns a JSON-formatted response body that contains an array of objects with the following fields. Jedes Objekt im Array stellt gezielte Angebote dar, die für den angegebenen Kunden im Rahmen eines bestimmten Kundensegments verfügbar sind.Each object in the array represents the targeted offers that are available for the specified user as part of a particular customer segment.

FeldField TypType BeschreibungDescription
Angeboteoffers arrayarray Ein Array mit Produkt-IDs für die Add-Ons, die den gezielten Angeboten zugeordnet sind, die für den aktuellen Benutzer verfügbar sind.An array of product IDs for the add-ons that are associated with the targeted offers that are available for the current user. Diese Produkt-IDs werden angegeben, der Ziel Angebote für Ihre app im Partner Center.These product IDs are specified in the Targeted offers page for your app in Partner Center.
trackingIdtrackingId stringstring Eine GUID, mit der Sie optional das gezielte Angebot in Ihrem eigenen Code oder Diensten nachverfolgen können.A GUID that you can optionally use to keep track of the targeted offer in your own code or services.

BeispielExample

Das folgende Beispiel zeigt ein Beispiel für einen JSON-Antworttext für diese Anforderung.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"
  }
]