대상 제품 가져오기Get targeted offers

이 메서드를 사용하여 사용자가 대상 제품의 고객 세그먼트에 포함되는지 여부에 따라 현재 사용자에게 제공되는 대상 제품을 가져옵니다.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. 자세한 내용은 스토어 서비스를 사용하여 대상 제품 관리를 참조하세요.For more information, see Manage targeted offers using Store services.

필수 구성 요소Prerequisites

이 메서드를 사용하려면 먼저 현재 앱에 로그인한 사용자의 Microsoft 계정 토큰을 획득해야 합니다.To use this method, you need to first obtain a Microsoft Account token for the current signed-in user of your app. 이 메서드의 Authorization 요청 헤더에 이 토큰을 전달해야 합니다.You must pass this token in the Authorization request header for this method. 이 토큰은 Microsoft Store에서 현재 사용자의 대상 제품을 가져오는 데 사용됩니다.This token is used by the Store to get targeted offers for the current user.

요청Request

요청 구문Request syntax

메서드Method 요청 URIRequest URI
GETGET https://manage.devcenter.microsoft.com/v2.0/my/storeoffers/user

요청 헤더Request header

헤더Header 형식Type 설명Description
권한 부여Authorization 문자열string 필수.Required. 폼에서 앱의 현재 로그인 한 사용자에 대 한 Microsoft 계정 토큰 전달자 < 토큰>합니다.The Microsoft Account token for the current signed-in user of your app in the form Bearer <token>.

요청 매개 변수Request parameters

이 메서드에는 URI 또는 쿼리 매개 변수가 없습니다.This method has no URI or query parameters.

요청 예제Request example

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

응답Response

이 메서드는 다음 필드가 포함된 개체 배열이 들어 있는 JSON 형식의 응답 본문을 반환합니다.This method returns a JSON-formatted response body that contains an array of objects with the following fields. 배열의 각 개체는 특정 고객 세그먼트의 일부로 지정된 사용자에게 제공되는 대상 제품을 나타냅니다.Each object in the array represents the targeted offers that are available for the specified user as part of a particular customer segment.

필드Field 형식Type 설명Description
offersoffers 배열array 현재 사용자에게 제공되는 대상 제품과 연결된 추가 기능에 대한 제품 ID의 배열입니다.An array of product IDs for the add-ons that are associated with the targeted offers that are available for the current user. 이러한 제품 Id에 지정 된 된 제품을 대상으로 파트너 센터에서 앱에 대 한 페이지입니다.These product IDs are specified in the Targeted offers page for your app in Partner Center.
trackingIdtrackingId 문자열string 코드나 서비스에서 대상 제품을 추적하기 위해 선택적으로 사용할 수 있는 GUID입니다.A GUID that you can optionally use to keep track of the targeted offer in your own code or services.

Example

다음 예제에서는 이 요청에 대한 예제 JSON 응답 본문을 보여 줍니다.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"
  }
]