대상 프로필 관리

2025-06-10

Microsoft Store 프로모션 API에서 이러한 방법을 사용하여 홍보 광고 캠페인의 각 배달 라인에 대상으로 지정할 사용자, 지역 및 인벤토리 유형을 선택합니다. 대상 프로필은 여러 배달 라인에서 만들고 다시 사용할 수 있습니다.

타겟팅 프로필과 광고 캠페인, 배달 라인 및 크리에이티브 간의 관계에 대한 자세한 내용은 Microsoft Store 서비스사용하여 광고 캠페인 실행을 참조하세요.

필수 조건

이러한 메서드를 사용하려면 먼저 다음을 수행해야 합니다.

아직 완료하지 않았다면, Microsoft Store 프로모션 API를 위한 모든 필수 구성 요소를 완료하세요.
이러한 메서드에 대한 요청 헤더에 사용할 Azure AD 액세스 토큰 가져옵니다. 액세스 토큰을 받은 후 60분 이내에 사용해야 합니다. 그렇지 않으면 만료됩니다. 토큰이 만료되면 새 토큰을 가져올 수 있습니다.

요청

이러한 메서드에는 다음 URI가 있습니다.

메서드 형식	URI 요청	설명
게시하기	`https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile`	새 대상 지정 프로필을 만듭니다.
놓다	`https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/{targetingProfileId}`	targetingProfileId지정한 대상 지정 프로필을 편집합니다.
가져오기	`https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/{targetingProfileId}`	지정된 targetingProfileId의 대상 프로필을 가져옵니다.

헤더	유형	설명
승인	문자열	필수 사항입니다. Azure AD 액세스 토큰은 Bearer<token> 형식입니다.
추적 번호	GUID	선택 사항입니다. 호출 흐름을 추적하는 ID입니다.

요청 메시지 본문

POST 및 PUT 메서드에는 Targeting 프로필 개체의 필수 필드와 설정하거나 변경하려는 추가 필드가 있는 JSON 요청 본문이 필요합니다.

요청 예제

다음 예제에서는 POST 메서드를 호출하여 대상 프로필을 만드는 방법을 보여 줍니다.

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 메서드를 호출하여 대상 프로필을 검색하는 방법을 보여 줍니다.

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

응답

이러한 메서드는 생성, 업데이트 또는 검색된 대상 지정 프로필에 대한 정보가 포함된 대상 지정 프로필 개체를 사용하여 JSON 응답 본문을 반환합니다. 다음 예제에서는 이러한 메서드에 대한 응답 본문을 보여 줍니다.

{
  "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
    ]
  }
}

대상 프로필 개체

이러한 메서드에 대한 요청 및 응답 본문에는 다음 필드가 포함됩니다. 다음 표에서는 읽기 전용인 필드(PUT 메서드에서 변경할 수 없음) 및 POST 메서드에 대한 요청 본문에 필요한 필드를 보여 줍니다.

분야	유형	설명	읽기 전용	기본값	POST 요청에 필요합니다
아이디	정수	대상 프로필의 ID입니다.	예		아니오
이름	문자열	대상 지정 프로필의 이름입니다.	아니오		예
타겟 유형	문자열	다음 값 중 하나입니다. 자동: Microsoft가 파트너 센터의 앱 설정에 따라 대상 프로필을 선택할 수 있도록 이 값을 지정합니다. 수동: 사용자 고유의 대상 프로필을 정의하려면 이 값을 지정합니다.	아니오	자동차	예
연령	배열	대상으로 지정할 사용자의 연령 범위를 식별하는 하나 이상의 정수입니다. 정수의 전체 목록은 이 문서의 Age 값을 참조하세요.	아니오	영	아니오
성별	배열	대상으로 지정할 사용자의 성별을 식별하는 하나 이상의 정수입니다. 정수의 전체 목록은 이 문서의 Gender 값을 참조하세요.	아니오	영	아니오
국가	배열	대상으로 지정할 사용자의 국가 코드를 식별하는 하나 이상의 정수입니다. 정수의 전체 목록은 이 문서의 국가 코드 값을 참조하세요.	아니오	영	아니오
운영체제 버전	배열	대상으로 지정할 사용자의 OS 버전을 식별하는 하나 이상의 정수입니다. 정수 목록은 이 문서의 OS 버전 값을 참조하세요.	아니오	영	아니오
디바이스 유형	배열	대상으로 지정할 사용자의 디바이스 유형을 식별하는 하나 이상의 정수입니다. 정수의 전체 목록은 이 문서의 디바이스 유형 값을 참조하세요.	아니오	영	아니오
공급 유형	배열	캠페인 광고가 표시되는 인벤토리 유형을 식별하는 하나 이상의 정수입니다. 정수의 전체 목록은 이 문서의 공급 유형 값을 참조하세요.	아니오	영	아니오

연령 값

TargetingProfile 개체의 연령 필드에는 대상으로 지정할 사용자의 연령 범위를 식별하는 다음 정수 중 하나 이상이 포함됩니다.

연령 필드의 정수 값	해당 연령 범위
651	13-17
652	18세에서 24세
653	25-34
654	35~49
655	50 이상

프로그래밍 방식으로 연령 필드에 대해 지원되는 값을 얻으려면 다음 GET 메서드를 호출할 수 있습니다. Authorization 헤더에 대해 Azure AD 액세스 토큰을 전달할 때는 Bearer<토큰>형식으로 전달합니다.

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

다음 예제에서는이 메서드에 대 한 응답 본문을 보여 줍니다.

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

성별 값

TargetingProfile 개체의 성별 필드에는 대상으로 지정할 사용자의 성별을 식별하는 다음 정수 중 하나 이상이 포함됩니다.

성별 필드의 정수 값	해당 성별
700	남성
701	여성

프로그래밍 방식으로 성별 필드에 지원되는 값을 얻으려면 다음 GET 메서드를 호출할 수 있습니다. Authorization 헤더에 대해 Azure AD 액세스 토큰을 전달할 때는 Bearer<토큰>형식으로 전달합니다.

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

다음 예제에서는이 메서드에 대 한 응답 본문을 보여 줍니다.

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

OS 버전 값

TargetingProfile 개체의 osVersion 필드에는 대상으로 지정할 사용자의 OS 버전을 식별하는 다음 정수 중 하나 이상이 포함되어 있습니다.

osVersion 필드의 정수 값	해당 OS 버전
500	Windows Phone 7
501	Windows Phone 7.1
502	Windows Phone 7.5
503	Windows Phone 7.8
504	Windows Phone 8.0
505	Windows Phone 8.1
506	Windows 8.0
507	Windows 8.1
508	Windows 10
509	Windows 10 Mobile
510	Windows 11

프로그래밍 방식으로 osVersion 필드에 지원되는 값을 얻으려면 다음 GET 메서드를 호출할 수 있습니다. Authorization 헤더에 대해 Azure AD 액세스 토큰을 전달할 때는 Bearer<토큰>형식으로 전달합니다.

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

다음 예제에서는이 메서드에 대 한 응답 본문을 보여 줍니다.

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

디바이스 유형 값

TargetingProfile 개체의 deviceType 필드에는 대상으로 지정할 사용자의 디바이스 유형을 식별하는 다음 정수 중 하나 이상이 포함되어 있습니다.

deviceType 필드의 정수 값	해당 디바이스 유형	설명
710	윈도우즈	이는 데스크톱 버전의 Windows 11, Windows 10 또는 Windows 8.x를 실행하는 디바이스를 나타냅니다.
711	휴대폰	Windows 10 Mobile, Windows Phone 8.x 또는 Windows Phone 7.x를 실행하는 디바이스를 나타냅니다.

프로그래밍 방식으로 deviceType 필드에 지원되는 값을 얻으려면 다음 GET 메서드를 호출할 수 있습니다. Authorization 헤더에 대해 Azure AD 액세스 토큰을 전달할 때는 Bearer<토큰>형식으로 전달합니다.

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

다음 예제에서는이 메서드에 대 한 응답 본문을 보여 줍니다.

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

공급 유형 값

TargetingProfile 개체의 supplyType 필드에는 캠페인 광고가 표시될 인벤토리 유형을 식별하는 다음 정수 중 하나 이상이 포함되어 있습니다.

supplyType 필드의 정수 값	해당 공급 유형	설명
11470	애플리케이션	이는 앱에만 표시되는 광고를 의미합니다.
11471	보편적	앱, 웹 및 기타 디스플레이 화면에 표시되는 광고를 나타냅니다.

프로그래밍 방식으로 supplyType 필드에 대해 지원되는 값을 얻으려면 다음 GET 메서드를 호출할 수 있습니다. Authorization 헤더에 대해 Azure AD 액세스 토큰을 전달할 때는 Bearer<토큰>형식으로 전달합니다.

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

다음 예제에서는이 메서드에 대 한 응답 본문을 보여 줍니다.

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

국가 코드 값

TargetingProfile 개체의 국가 필드에는 대상으로 지정할 사용자의 ISO 3166-1 alpha-2 국가 코드를 식별하는 다음 정수 중 하나 이상이 포함되어 있습니다.

국가 필드의 정수 값	해당 국가 코드
1	미국
2	AU
3	에
4	존재하다
5	브라질
6	캘리포니아
7	DK
8 (여덟)	FI
9	FR(프랑스)
10	독일
11	GR
12	홍콩
13	인도
14	인터넷 익스플로러
15	정보기술
16	일본
17	LU
18	멕시코
19	네덜란드
20	뉴질랜드
21	아니오
22 (이십이)	PL
23	피지컬 트레이닝(PT)
24	에스지
이십오 (25)	ES
26	SE
27	채널
28	TW
이십구	기가바이트
30	루(RU)
31	CL
32	일산화탄소
33	CZ
34	HU(HU)
35	ZA(남아프리카 공화국)
36	KR
37	중국
38	RO(RO)
39	TR
40	SK (주)
41	il(일리노이)
42	아이디
43	아칸소
44	나의
45	PH
46	체육(PE)
47	UA
48	AE
49	목요일
50	지능 지수 (IQ)
51	VN
52	CR
53	가상 환경 (VE)
54	품질 보증 (QA)
55	국제 단위계
56	BG
57	LT
58	알에스
59	인사관리
60 (육십)	인사관리
61	LV
62	EE
63	아이에스 (IS)
64	KZ
65	SA
67	알 (AL)
68	DZ
70	아오
72	오전
73	애리조나
74	모텔
75	BD
76	BB(BB)
77	에 의해
81	보
82	학사
83	BW
87	KH
88	센티미터
94	시디
95	기업 아이덴티티 (CI)
96	CY
99	하기
100	EC (유럽 연합 집행위원회)
101	예
102	SV
107	FJ
108	미국 조지아주
110	GE(GE)
111	GH
114	GT(20
118	HT
119	HN
백이십	JM
121	조
122	애
124	kW
125 (일백이십오)	킬로그램
126	로스앤젤레스
127	파운드
133	MK
135	메가와트
138	마운트
141	뮤
145	저
146	매사추세츠
147	MZ
148	NA
백오십	NP (추가 설명 필요 시 한국어 번역)
151	NI
153	엔지 (NG)
154	옴
155	PK (한국어)
157	PA
159	파이썬 (PY)
167	SN
172	LK
176	TZ (추가 설명이 필요하거나 컨텍스트에 따라 해석이 달라질 수 있음)
180	TT
181	테네시
184	UG(UG)
185	UY
186	UZ
189	ZM
190	ZW
219	메릴랜드
224	PS
225	답장
246	홍보 및 대외 관계

프로그래밍 방식으로 국가 필드에 지원되는 값을 얻으려면 다음 GET 메서드를 호출할 수 있습니다. Authorization 헤더에 대해 Azure AD 액세스 토큰을 전달할 때는 Bearer<토큰>형식으로 전달합니다.

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

다음 예제에서는이 메서드에 대 한 응답 본문을 보여 줍니다.

{
  "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"
    }
  }
}

다음을 통해 공유

대상 프로필 관리

필수 조건

요청

헤더

요청 메시지 본문

요청 예제

응답

대상 프로필 개체

연령 값

성별 값

OS 버전 값

디바이스 유형 값

공급 유형 값

국가 코드 값

관련 항목

피드백

추가 리소스