타기팅 프로필 관리Manage targeting profiles

Microsoft Store 프로모션 API에서 이 메서드를 사용하여 홍보용 광고 캠페인에서 각 배달 라인의 대상으로 지정할 사용자, 지역 및 인벤토리 유형을 선택합니다.Use these methods in the Microsoft Store promotions API to select the users, geographies and inventory types that you want to target for each delivery line in a promotional ad campaign. 다수의 배달 라인에 대해 타기팅 프로필을 만들고 다시 사용할 수 있습니다.Targeting profiles can be created and reused across multiple delivery lines.

타기팅 프로필과 광고 캠페인, 배달 라인 및 크리에이티브 간의 관계에 대한 자세한 내용은 Microsoft Store 서비스를 사용하여 광고 캠페인 실행을 참조하세요.For more information about the relationship between targeting profiles and ad campaigns, delivery lines, and creatives, see Run ad campaigns using Microsoft Store services.

필수 구성 요소Prerequisites

이 메서드를 사용하려면 먼저 다음 작업을 완료해야 합니다.To use these methods, you need to first do the following:

  • 아직 완료하지 않은 경우 Microsoft Store 프로모션 API의 필수 조건을 모두 완료합니다.If you have not done so already, complete all the prerequisites for the Microsoft Store promotions API.
  • 이 메서드의 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져옵니다.Obtain an Azure AD access token to use in the request header for these methods. 액세스 토큰을 얻은 후 만료되기 전에 60분 동안 사용할 수 있습니다.After you obtain an access token, you have 60 minutes to use it before it expires. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.After the token expires, you can obtain a new one.

요청Request

이 메서드에는 다음 URI가 있습니다.These methods have the following URIs.

메서드 유형Method type 요청 URIRequest URI 설명Description
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile 새 타기팅 프로필을 만듭니다.Creates a new targeting profile.
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/{targetingProfileId} targetingProfileId에서 지정한 타기팅 프로필을 편집합니다.Edits the targeting profile specified by targetingProfileId.
GETGET https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/{targetingProfileId} targetingProfileId에서 지정한 타기팅 프로필을 가져옵니다.Gets the targeting profile specified by targetingProfileId.
헤더Header 형식Type 설명Description
권한 부여Authorization 문자열string 필수.Required. 폼에서 Azure AD 액세스 토큰 전달자 < 토큰>합니다.The Azure AD access token in the form Bearer <token>.
추적 IDTracking ID GUIDGUID 선택 사항.Optional. 호출 흐름을 추적하는 ID입니다.An ID that tracks the call flow.

요청 본문Request body

POST 및 PUT 메서드는 타기팅 프로필 개체의 필수 필드 및 설정하거나 변경하려는 추가 필드가 있는 JSON 요청 본문이 필요합니다.The POST and PUT methods require a JSON request body with the required fields of a Targeting profile object and any additional fields you want to set or change.

요청 예제Request examples

다음 예시에서는 POST 메서드를 호출하여 타기팅 프로필을 만드는 방법을 보여줍니다.The following example demonstrates how to call the POST method to create a targeting profile.

POST https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile HTTP/1.1
Authorization: Bearer <your access token>

{
    "name": "Contoso App Campaign - Targeting Profile 1",
    "targetingType": "Manual",
    "age": [
      651,
      652],
    "gender": [
      700
    ],
    "country": [
      11,
      12
    ],
    "osVersion": [
      504
    ],
    "deviceType": [
      710
    ],
    "supplyType": [
      11470
    ]
}

다음 예시에서는 GET 메서드를 호출하여 타기팅 프로필을 검색하는 방법을 보여줍니다.The following example demonstrates how to call the GET method to retrieve a targeting profile.

GET https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/310023951  HTTP/1.1
Authorization: Bearer <your access token>

응답Response

이러한 메서드는 만들거나 업데이트하거나 검색한 타기팅 프로필에 대한 정보가 포함된 타기팅 프로필 개체가 있는 JSON 응답 본문을 반환합니다.These methods return a JSON response body with a Targeting profile object that contains information about the targeting profile that was created, updated, or retrieved. 다음 예시에서는 이 메서드에 대한 응답 본문을 보여줍니다.The following example demonstrates a response body for these methods.

{
  "Data": {
    "id": 310021746,
    "name": "Contoso App Campaign - Targeting Profile 1",
    "targetingType": "Manual",
    "age": [
      651,
      652
    ],
    "gender": [
      700
    ],
    "country": [
      6,
      13,
      29
    ],
    "osVersion": [
      504,
      505,
      506,
      507,
      508
    ],
    "deviceType": [
      710,
      711
    ],
    "supplyType": [
      11470
    ]
  }
}

타기팅 프로필 개체Targeting profile object

이 메서드에 대한 요청 및 응답 본문은 다음 필드를 포함합니다.The request and response bodies for these methods contain the following fields. 이 표에서는 읽기 전용(PUT 메서드에서 변경할 수 없음을 의미) 필드와 POST 메서드에 대한 요청 본문에서 필요한 필드가 어떤 것인지 보여줍니다.This table shows which fields are read-only (meaning that they cannot be changed in the PUT method) and which fields are required in the request body for the POST method.

필드Field 형식Type 설명Description 읽기 전용Read only 기본값Default POST에 필요한지 여부Required for POST
idid 정수integer 타기팅 프로필의 ID입니다.The ID of the targeting profile. Yes 아니오No
namename 문자열string 대상 프로필의 이름입니다.The name of the targeting profile. 아니오No Yes
targetingTypetargetingType 문자열string 다음 값 중 하나입니다.One of the following values:
  • 자동: Microsoft 파트너 센터에서 앱에 대 한 설정에 따라 대상 프로필을 선택할 수 있도록이 값을 지정 합니다.Auto: Specify this value to allow Microsoft to choose the targeting profile based on the settings for your app in Partner Center.
  • 수동: 사용자 프로필을 대상으로 지정 하려면이 값을 지정 합니다.Manual: Specify this value to define your own targeting profile.
아니오No 자동Auto Yes
ageage 배열array 대상으로 지정할 사용자의 연령대를 식별하는 하나 이상의 정수입니다.One or more integers that identify the age ranges of the users to target. 정수의 전체 목록을 보려면 이 문서에 있는 연령 값을 참조하세요.For a complete list of integers, see Age values in this article. 아니오No nullnull 아니오No
gendergender 배열array 대상으로 지정할 사용자의 성별을 식별하는 하나 이상의 정수입니다.One or more integers that identify the genders of the users to target. 정수의 전체 목록을 보려면 이 문서에 있는 성별 값을 참조하세요.For a complete list of integers, see Gender values in this article. 아니오No nullnull 아니오No
countrycountry 배열array 대상으로 지정할 사용자의 국가 코드를 식별하는 하나 이상의 정수입니다.One or more integers that identify the country codes of the users to target. 정수의 전체 목록을 보려면 이 문서에 있는 국가 코드 값을 참조하세요.For a complete list of integers, see Country code values in this article. 아니오No nullnull 아니오No
osVersionosVersion 배열array 대상으로 지정할 사용자의 OS 버전을 식별하는 하나 이상의 정수입니다.One or more integers that identify the OS versions of the users to target. 정수의 전체 목록을 보려면 이 문서에 있는 OS 버전 값을 참조하세요.For a complete list of integers, see OS version values in this article. 아니오No nullnull 아니오No
deviceTypedeviceType 배열array 대상으로 지정할 사용자의 장치 유형을 식별하는 하나 이상의 정수입니다.One or more integers that identify the device types of the users to target. 정수의 전체 목록을 보려면 이 문서에 있는 장치 유형 값을 참조하세요.For a complete list of integers, see Device type values in this article. 아니오No nullnull 아니오No
supplyTypesupplyType 배열array 캠페인의 광고가 표시될 인벤토리 유형을 식별하는 하나 이상의 정수입니다.One or more integers that identify the type of inventory where the campaign's ads will be shown. 정수의 전체 목록을 보려면 이 문서에 있는 제공 유형 값을 참조하세요.For a complete list of integers, see Supply type values in this article. 아니오No nullnull 아니오No

연령 값Age values

TargetingProfile 개체의 age 필드에는 대상으로 지정할 사용자의 연령대를 식별하는 다음과 같은 정수 중 하나 이상이 포함되어 있습니다.The age field in the TargetingProfile object contains one or more of the following integers that identify the age ranges of the users to target.

age 필드의 정수 값Integer value for age field 해당 연령대Corresponding age range
651651 13~1713 to 17
652652 18~2418 to 24
653653 25~3425 to 34
654654 35~4935 to 49
655655 50 이상50 and above

age 필드에 지원되는 값을 프로그래밍 방식으로 가져오려면 다음과 같이 GET 메서드를 호출하면 됩니다.To get the supported values for the age field programmatically, you can call the following GET method. 에 대 한 합니다 Authorization 헤더 형태로 Azure AD 액세스 토큰을 전달 전달자 < 토큰>합니다.For the Authorization header, pass your Azure AD access token in the form Bearer <token>.

GET https://manage.devcenter.microsoft.com/v1.0/my/promotion/reference/age
Authorization: Bearer <your access token>

다음 예시에서는 이 메서드에 대한 응답 본문을 보여줍니다.The following example shows the response body for this method.

{
  "Data": {
    "Age": {
      "651": "Age13To17",
      "652": "Age18To24",
      "653": "Age25To34",
      "654": "Age35To49",
      "655": "Age50AndAbove"
    }
  }
}

성별 값Gender values

TargetingProfile 개체의 gender 필드에는 대상으로 지정할 사용자의 성별을 식별하는 다음과 같은 정수 중 하나 이상이 포함되어 있습니다.The gender field in the TargetingProfile object contains one or more of the following integers that identify the genders of the users to target.

gender 필드의 정수 값Integer value for gender field 해당 성별Corresponding gender
700700 남성Male
701701 여성Female

gender 필드에 지원되는 값을 프로그래밍 방식으로 가져오려면 다음과 같이 GET 메서드를 호출하면 됩니다.To get the supported values for the gender field programmatically, you can call the following GET method. 에 대 한 합니다 Authorization 헤더 형태로 Azure AD 액세스 토큰을 전달 전달자 < 토큰>합니다.For the Authorization header, pass your Azure AD access token in the form Bearer <token>.

GET https://manage.devcenter.microsoft.com/v1.0/my/promotion/reference/gender
Authorization: Bearer <your access token>

다음 예시에서는 이 메서드에 대한 응답 본문을 보여줍니다.The following example shows the response body for this method.

{
  "Data": {
    "Gender": {
      "700": "Male",
      "701": "Female"
    }
  }
}

OS 버전 값OS version values

TargetingProfile 개체의 osVersion 필드에는 대상으로 지정할 사용자의 OS 버전을 식별하는 다음과 같은 정수 중 하나 이상이 포함되어 있습니다.The osVersion field in the TargetingProfile object contains one or more of the following integers that identify the OS versions of the users to target.

osVersion 필드의 정수 값Integer value for osVersion field 해당 OS 버전Corresponding OS version
500500 Windows Phone 7Windows Phone 7
501501 Windows Phone 7.1Windows Phone 7.1
502502 Windows Phone 7.5Windows Phone 7.5
503503 Windows Phone 7.8Windows Phone 7.8
504504 Windows Phone 8.0Windows Phone 8.0
505505 Windows Phone 8.1Windows Phone 8.1
506506 Windows 8.0Windows 8.0
507507 Windows 8.1Windows 8.1
508508 Windows 10Windows 10
509509 Windows 10 MobileWindows 10 Mobile

osVersion 필드에 지원되는 값을 프로그래밍 방식으로 가져오려면 다음과 같이 GET 메서드를 호출하면 됩니다.To get the supported values for the osVersion field programmatically, you can call the following GET method. 에 대 한 합니다 Authorization 헤더 형태로 Azure AD 액세스 토큰을 전달 전달자 < 토큰>합니다.For the Authorization header, pass your Azure AD access token in the form Bearer <token>.

GET https://manage.devcenter.microsoft.com/v1.0/my/promotion/reference/osversion
Authorization: Bearer <your access token>

다음 예시에서는 이 메서드에 대한 응답 본문을 보여줍니다.The following example shows the response body for this method.

{
  "Data": {
    "OsVersion": {
      "500": "WindowsPhone70",
      "501": "WindowsPhone71",
      "502": "WindowsPhone75",
      "503": "WindowsPhone78",
      "504": "WindowsPhone80",
      "505": "WindowsPhone81",
      "506": "Windows80",
      "507": "Windows81",
      "508": "Windows10",
      "509": "WindowsPhone10"
    }
  }
}

디바이스 유형 값Device type values

TargetingProfile 개체의 deviceType 필드에는 대상으로 지정할 사용자의 디바이스 유형을 식별하는 다음과 같은 정수 중 하나 이상이 포함되어 있습니다.The deviceType field in the TargetingProfile object contains one or more of the following integers that identify the device types of the users to target.

deviceType 필드의 정수 값Integer value for deviceType field 해당 디바이스 유형Corresponding device type 설명Description
710710 WindowsWindows 이것은 데스크톱 버전 Windows 10 또는 Windows 8.x를 실행하는 디바이스를 나타냅니다.This represents devices running a desktop version of Windows 10 or Windows 8.x.
711711 전화Phone 이것은 Windows 10 Mobile, Windows Phone 8.x 또는 Windows Phone 7.x를 실행하는 디바이스를 나타냅니다.This represents devices running Windows 10 Mobile, Windows Phone 8.x, or Windows Phone 7.x.

deviceType 필드에 지원되는 값을 프로그래밍 방식으로 가져오려면 다음과 같이 GET 메서드를 호출하면 됩니다.To get the supported values for the deviceType field programmatically, you can call the following GET method. 에 대 한 합니다 Authorization 헤더 형태로 Azure AD 액세스 토큰을 전달 전달자 < 토큰>합니다.For the Authorization header, pass your Azure AD access token in the form Bearer <token>.

GET https://manage.devcenter.microsoft.com/v1.0/my/promotion/reference/devicetype
Authorization: Bearer <your access token>

다음 예시에서는 이 메서드에 대한 응답 본문을 보여줍니다.The following example shows the response body for this method.

{
  "Data": {
    "DeviceType": {
      "710": "Windows",
      "711": "Phone"
    }
  }
}

유형 값을 제공Supply type values

TargetingProfile 개체의 supplyType 필드에는 캠페인의 광고가 표시될 인벤토리 유형을 식별하는 다음과 같은 정수 중 하나 이상이 포함되어 있습니다.The supplyType field in the TargetingProfile object contains one or more of the following integers that identify the type of inventory where the campaign's ads will be shown.

supplyType 필드의 정수 값Integer value for supplyType field 해당하는 제공 형식Corresponding supply type 설명Description
1147011470 App 이것은 앱에만 표시되는 광고를 가리킵니다.This refers to ads that appear in apps only.
1147111471 범용Universal 이것은 앱, 웹 및 기타 디스플레이 화면에 표시되는 광고를 가리킵니다.This refers to ads that appear in apps, on the Web, and on and other display surfaces.

supplyType 필드에 지원되는 값을 프로그래밍 방식으로 가져오려면 다음과 같이 GET 메서드를 호출하면 됩니다.To get the supported values for the supplyType field programmatically, you can call the following GET method. 에 대 한 합니다 Authorization 헤더 형태로 Azure AD 액세스 토큰을 전달 전달자 < 토큰>합니다.For the Authorization header, pass your Azure AD access token in the form Bearer <token>.

GET https://manage.devcenter.microsoft.com/v1.0/my/promotion/reference/supplytype
Authorization: Bearer <your access token>

다음 예시에서는 이 메서드에 대한 응답 본문을 보여줍니다.The following example shows the response body for this method.

{
  "Data": {
    "SupplyType": {
      "11470": "App",
      "11471": "Universal"
    }
  }
}

국가 코드 값Country code values

TargetingProfile 개체의 country 필드에는 대상으로 지정할 사용자의 ISO 3166-1 alpha-2 국가 코드를 식별하는 다음과 같은 정수 중 하나 이상이 포함되어 있습니다.The country field in the TargetingProfile object contains one or more of the following integers that identify the ISO 3166-1 alpha-2 country codes of the users to target.

country 필드의 정수 값Integer value for country field 해당 국가 코드Corresponding country code
11 미국US
22 AUAU
33 ATAT
44 BEBE
55 BRBR
66 CACA
77 DKDK
88 FIFI
99 FRFR
1010 DEDE
1111 GRGR
1212 HKHK
1313 ININ
1414 IEIE
1515 ITIT
1616 JPJP
1717 LULU
1818 MXMX
1919 NLNL
2020 NZNZ
2121 아니요NO
2222 PLPL
2323 PTPT
2424 SGSG
2525 ESES
2626 SESE
2727 CHCH
2828 TWTW
2929 GBGB
3030 RURU
3131 CLCL
3232 COCO
3333 CZCZ
3434 HUHU
3535 ZAZA
3636 KRKR
3737 CNCN
3838 RORO
3939 TRTR
4040 SKSK
4141 ILIL
4242 IDID
4343 ARAR
4444 MYMY
4545 PHPH
4646 PEPE
4747 UAUA
4848 AEAE
4949 THTH
5050 IQIQ
5151 VNVN
5252 CRCR
5353 VEVE
5454 QAQA
5555 SISI
5656 BGBG
5757 LTLT
5858 RSRS
5959 HRHR
6060 HRHR
6161 LVLV
6262 EEEE
6363 ISIS
6464 KZKZ
6565 SASA
6767 ALAL
6868 DZDZ
7070 AOAO
7272 AMAM
7373 AZAZ
7474 BSBS
7575 BDBD
7676 BBBB
7777 BYBY
8181 BOBO
8282 BABA
8383 BWBW
8787 KHKH
8888 CMCM
9494 CDCD
9595 CICI
9696 CYCY
9999 DODO
100100 ECEC
101101 EGEG
102102 SVSV
107107 FJFJ
108108 GAGA
110110 GEGE
111111 GHGH
114114 GTGT
118118 HTHT
119119 HNHN
120120 JMJM
121121 JOJO
122122 KEKE
124124 KWKW
125125 KGKG
126126 LALA
127127 LBLB
133133 MKMK
135135 MWMW
138138 MTMT
141141 MUMU
145145 MEME
146146 MAMA
147147 MZMZ
148148 해당 없음NA
150150 NPNP
151151 NINI
153153 NGNG
154154 OMOM
155155 PKPK
157157 PAPA
159159 PYPY
167167 SNSN
172172 LKLK
176176 TZTZ
180180 TTTT
181181 TNTN
184184 UGUG
185185 UYUY
186186 UZUZ
189189 ZMZM
190190 ZWZW
219219 MDMD
224224 PSPS
225225 RERE
246246 PRPR

country 필드에 지원되는 값을 프로그래밍 방식으로 가져오려면 다음과 같이 GET 메서드를 호출하면 됩니다.To get the supported values for the country field programmatically, you can call the following GET method. 에 대 한 합니다 Authorization 헤더 형태로 Azure AD 액세스 토큰을 전달 전달자 < 토큰>합니다.For the Authorization header, pass your Azure AD access token in the form Bearer <token>.

GET https://manage.devcenter.microsoft.com/v1.0/my/promotion/reference/country
Authorization: Bearer <your access token>

다음 예시에서는 이 메서드에 대한 응답 본문을 보여줍니다.The following example shows the response body for this method.

{
  "Data": {
    "Country": {
      "1": "US",
      "2": "AU",
      "3": "AT",
      "4": "BE",
      "5": "BR",
      "6": "CA",
      "7": "DK",
      "8": "FI",
      "9": "FR",
      "10": "DE",
      "11": "GR",
      "12": "HK",
      "13": "IN",
      "14": "IE",
      "15": "IT",
      "16": "JP",
      "17": "LU",
      "18": "MX",
      "19": "NL",
      "20": "NZ",
      "21": "NO",
      "22": "PL",
      "23": "PT",
      "24": "SG",
      "25": "ES",
      "26": "SE",
      "27": "CH",
      "28": "TW",
      "29": "GB",
      "30": "RU",
      "31": "CL",
      "32": "CO",
      "33": "CZ",
      "34": "HU",
      "35": "ZA",
      "36": "KR",
      "37": "CN",
      "38": "RO",
      "39": "TR",
      "40": "SK",
      "41": "IL",
      "42": "ID",
      "43": "AR",
      "44": "MY",
      "45": "PH",
      "46": "PE",
      "47": "UA",
      "48": "AE",
      "49": "TH",
      "50": "IQ",
      "51": "VN",
      "52": "CR",
      "53": "VE",
      "54": "QA",
      "55": "SI",
      "56": "BG",
      "57": "LT",
      "58": "RS",
      "59": "HR",
      "60": "BH",
      "61": "LV",
      "62": "EE",
      "63": "IS",
      "64": "KZ",
      "65": "SA",
      "67": "AL",
      "68": "DZ",
      "70": "AO",
      "72": "AM",
      "73": "AZ",
      "74": "BS",
      "75": "BD",
      "76": "BB",
      "77": "BY",
      "81": "BO",
      "82": "BA",
      "83": "BW",
      "87": "KH",
      "88": "CM",
      "94": "CD",
      "95": "CI",
      "96": "CY",
      "99": "DO",
      "100": "EC",
      "101": "EG",
      "102": "SV",
      "107": "FJ",
      "108": "GA",
      "110": "GE",
      "111": "GH",
      "114": "GT",
      "118": "HT",
      "119": "HN",
      "120": "JM",
      "121": "JO",
      "122": "KE",
      "124": "KW",
      "125": "KG",
      "126": "LA",
      "127": "LB",
      "133": "MK",
      "135": "MW",
      "138": "MT",
      "141": "MU",
      "145": "ME",
      "146": "MA",
      "147": "MZ",
      "148": "NA",
      "150": "NP",
      "151": "NI",
      "153": "NG",
      "154": "OM",
      "155": "PK",
      "157": "PA",
      "159": "PY",
      "167": "SN",
      "172": "LK",
      "176": "TZ",
      "180": "TT",
      "181": "TN",
      "184": "UG",
      "185": "UY",
      "186": "UZ",
      "189": "ZM",
      "190": "ZW",
      "219": "MD",
      "224": "PS",
      "225": "RE",
      "246": "PR"
    }
  }
}