Gestire i profili di targeting

Usare questi metodi nell'API Promozioni di Microsoft Store per selezionare gli utenti, le aree geografiche e i tipi di inventario da assegnare a ogni riga di recapito in una campagna pubblicitaria promozionale. I profili mirati possono essere creati e riutilizzati in più righe di recapito.

Per altre informazioni sulla relazione tra profili mirati e campagne pubblicitarie, linee di recapito e creatività, vedere Eseguire campagne pubblicitarie usando i servizi di Microsoft Store.

Prerequisiti

Per usare questi metodi, è prima di tutto necessario eseguire queste operazioni:

• Se non è già stato fatto, completare tutti i prerequisiti per l'API Promozioni di Microsoft Store.
• Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questi metodi. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.

Richiesta

Questi metodi hanno gli URI seguenti.

Tipo di metodo	URI della richiesta	Descrizione
POST	https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile	Crea un nuovo profilo mirato.
PUT	https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/{targetingProfileId}	Modifica il profilo mirato specificato da targetingProfileId.
GET	https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/{targetingProfileId}	Ottiene il profilo mirato specificato da targetingProfileId.

Intestazione

Intestazione	Type	Descrizione
Autorizzazione	stringa	Obbligatorio. Token di accesso di Azure AD nel formato Token di<connessione>.
ID tracciabilità	GUID	(Facoltativo). ID che tiene traccia del flusso di chiamata.

Corpo della richiesta

I metodi POST e PUT richiedono un corpo della richiesta JSON con i campi obbligatori di un oggetto Profilo mirato ed eventuali campi aggiuntivi da impostare o modificare.

Esempi di richiesta

Nell'esempio seguente viene illustrato come chiamare il metodo POST per creare un profilo mirato.

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

Nell'esempio seguente viene illustrato come chiamare il metodo GET per recuperare un profilo mirato.

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

Response

Questi metodi restituiscono un corpo della risposta JSON con un oggetto Profilo mirato che contiene informazioni sul profilo mirato creato, aggiornato o recuperato. Nell'esempio seguente viene illustrato un corpo della risposta per questi metodi.

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

Oggetto profilo mirato

I corpi di richiesta e risposta per questi metodi contengono i campi seguenti. Questa tabella mostra quali campi sono di sola lettura (ovvero non possono essere modificati nel metodo PUT) e quali campi sono necessari nel corpo della richiesta per il metodo POST.

Campo	Tipo	Descrizione	Sola lettura	Predefinita	Obbligatorio per POST
ID.	integer	ID del profilo mirato.	Sì		No
name	stringa	Nome del profilo mirato.	No		Sì
targetingType	stringa	Uno dei valori seguenti: Automatico: specificare questo valore per consentire a Microsoft di scegliere il profilo mirato in base alle impostazioni per l'app nel Centro per i partner. Manuale: specificare questo valore per definire il proprio profilo mirato.	No	Automatico	Sì
età	array	Uno o più numeri interi che identificano gli intervalli di età degli utenti interessati. Per un elenco completo dei numeri interi, vedere Valori relativi all'età in questo articolo.	No	Null	No
sesso	array	Uno o più numeri interi che identificano il genere degli utenti interessati. Per un elenco completo dei numeri interi, vedere Valori relativi al genere in questo articolo.	No	Null	No
country	array	Uno o più numeri interi che identificano i prefissi internazionali degli utenti interessati. Per un elenco completo dei numeri interi, vedere Valori relativi al prefisso internazionale in questo articolo.	No	Null	No
osVersion	array	Uno o più numeri interi che identificano le versioni del sistema operativo degli utenti interessati. Per un elenco completo dei numeri interi, vedere Valori relativi alle versioni del sistema operativo in questo articolo.	No	Null	No
deviceType	array	Uno o più numeri interi che identificano i tipi di dispositivo degli utenti interessati. Per un elenco completo dei numeri interi, vedere Valori relativi ai tipi di dispositivo in questo articolo.	No	Null	No
supplyType	array	Uno o più numeri interi che identificano il tipo di inventario in cui verranno visualizzati gli annunci della campagna. Per un elenco completo dei numeri interi, vedere Valori relativi al tipo di inventario in questo articolo.	No	Null	No

Valori relativi all'età

Il campo age nell'oggetto TargetingProfile contiene uno o più dei valori interi seguenti che identificano gli intervalli di età degli utenti interessati.

Valore intero per il campo age	Intervallo di età corrispondente
651	Da 13 a 17
652	Da 18 a 24
653	Da 25 a 34
654	Da 35 a 49
655	Più di 50

Per ottenere i valori supportati per il campo age a livello di codice, è possibile chiamare il metodo GET seguente. Per l'intestazione Authorization, passare il token di accesso di Azure AD nel formato Token di<connessione>.

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

Nell'esempio seguente viene illustrato il corpo della risposta per questo metodo.

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

Valori relativi al genere

Il campo gender nell'oggetto TargetingProfile contiene uno o più dei valori interi seguenti che identificano il genere degli utenti interessati.

Valore intero per il campo gender	Genere corrispondente
700	Maschio
701	Femmina

Per ottenere i valori supportati per il campo gender a livello di codice, è possibile chiamare il metodo GET seguente. Per l'intestazione Authorization, passare il token di accesso di Azure AD nel formato Token di<connessione>.

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

Nell'esempio seguente viene illustrato il corpo della risposta per questo metodo.

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

Valori relativi alle versioni del sistema operativo

Il campo osVersion nell'oggetto TargetingProfile contiene uno o più dei valori interi seguenti che identificano le versioni del sistema operativo degli utenti interessati.

Valore intero per il campo osVersion	Versione corrispondente del sistema operativo
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

Per ottenere i valori supportati per il campo osVersion a livello di codice, è possibile chiamare il metodo GET seguente. Per l'intestazione Authorization, passare il token di accesso di Azure AD nel formato Token di<connessione>.

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

Nell'esempio seguente viene illustrato il corpo della risposta per questo metodo.

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

Valori relativi ai tipi di dispositivo

Il campo deviceType nell'oggetto TargetingProfile contiene uno o più dei valori interi seguenti che identificano i tipi di dispositivo degli utenti interessati.

Valore intero per il campo deviceType	Tipo di dispositivo corrispondente	Descrizione
710	Windows	Rappresenta i dispositivi che eseguono una versione desktop di Windows 11, Windows 10 o Windows 8.x.
711	il numero	Rappresenta i dispositivi che eseguono Windows 10 Mobile, Windows Phone 8.x o Windows Phone 7.x.

Per ottenere i valori supportati per il campo deviceType a livello di codice, è possibile chiamare il metodo GET seguente. Per l'intestazione Authorization, passare il token di accesso di Azure AD nel formato Token di<connessione>.

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

Nell'esempio seguente viene illustrato il corpo della risposta per questo metodo.

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

Valori relativi al tipo di inventario

Il campo supplyType nell'oggetto TargetingProfile contiene uno o più dei numeri interi seguenti che identificano il tipo di inventario in cui verranno visualizzati gli annunci della campagna.

Valore intero per il campo supplyType	Tipo di inventario corrispondente	Descrizione
11470	App	Si riferisce agli annunci visualizzati solo nelle app.
11471	Universale	Si riferisce agli annunci visualizzati nelle app, sul Web e su e altre superfici di visualizzazione.

Per ottenere i valori supportati per il campo supplyType a livello di codice, è possibile chiamare il metodo GET seguente. Per l'intestazione Authorization, passare il token di accesso di Azure AD nel formato Token di<connessione>.

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

Nell'esempio seguente viene illustrato il corpo della risposta per questo metodo.

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

Valori relativi al prefisso internazionale

Il campo country nell'oggetto TargetingProfile contiene uno o più dei seguenti numeri interi che identificano i prefissi internazionali ISO 3166-1 alfa-2 degli utenti interessati.

Valore intero per il campo country	Prefisso internazionale corrispondente
1	Stati Uniti
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	Internet Explorer
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	Domande e risposte
55	SI
56	BG
57	LT
58	RS
59	HR
60	HR
61	LV
62	EE
63	IS
64	KZ
65	SA
67	AL
68	DZ
70	AO
72	Mattina
73	AZ
74	BS
75	BD
76	BB
77	BY
81	BO
82	BA
83	BW
87	KH
88	MC
94	CD
95	CI
96	CY
99	DO
100	EC
101	EG
102	SV
107	FJ
108	Disponibilità generale
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	N/D
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

Per ottenere i valori supportati per il campo country a livello di codice, è possibile chiamare il metodo GET seguente. Per l'intestazione Authorization, passare il token di accesso di Azure AD nel formato Token di<connessione>.

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

Nell'esempio seguente viene illustrato il corpo della risposta per questo metodo.

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

Argomenti correlati

• Eseguire campagne pubblicitarie con i servizi di Microsoft Store
• Gestire campagne pubblicitarie
• Gestire le linee di recapito per le campagne pubblicitarie
• Gestire la creatività per le campagne pubblicitarie
• Ottenere i dati sulle prestazioni delle campagne pubblicitarie