Abrufen von gezielten Angeboten

  • Artikel

Verwenden Sie diese Methode, um die Zielangebote abzurufen, die für den aktuellen Benutzer verfügbar sind, je nachdem, ob der Benutzer Teil des Kundensegments für das Zielangebot ist oder nicht. Weitere Informationen finden Sie unter Verwalten von Zielangeboten mithilfe von Store-Diensten.

Voraussetzungen

Um diese Methode verwenden zu können, müssen Sie zunächst ein Microsoft-Kontotoken für den aktuell angemeldeten Benutzer Ihrer App abrufen. Sie müssen dieses Token im Anforderungsheader Authorization für diese Methode übergeben. Dieses Token wird vom Store verwendet, um gezielte Angebote für den aktuellen Benutzer abzurufen.

Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET https://manage.devcenter.microsoft.com/v2.0/my/storeoffers/user

Anforderungsheader

Header type BESCHREIBUNG
Authorization Zeichenfolge Erforderlich. Das Microsoft-Kontotoken für den aktuellen angemeldeten Benutzer Ihrer App im Format Bearertoken<>.

Anforderungsparameter

Diese Methode verfügt über keinen URI oder Abfrageparameter.

Anforderungsbeispiel

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

Antwort

Diese Methode gibt einen JSON-formatierten Antworttext zurück, der ein Array von Objekten mit den folgenden Feldern enthält. Jedes Objekt im Array stellt die Zielangebote dar, die für den angegebenen Benutzer als Teil eines bestimmten Kundensegments verfügbar sind.

Feld Typ BESCHREIBUNG
offers array Ein Array von Produkt-IDs für die Add-Ons, die den Zielangeboten zugeordnet sind, die für den aktuellen Benutzer verfügbar sind. Diese Produkt-IDs werden auf der Seite Gezielte Angebote für Ihre App im Partner Center angegeben.
trackingId Zeichenfolge Eine GUID, die Sie optional verwenden können, um das Zielangebot in Ihrem eigenen Code oder Ihren eigenen Diensten nachzuverfolgen.

Beispiel

Das folgende Beispiel zeigt ein Beispiel für einen JSON-Antworttext für diese Anforderung.

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