Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Usa questi metodi nell'API promozioni di Microsoft Store per selezionare gli utenti, le aree geografiche e i tipi di inventario che vuoi assegnare a ogni riga di recapito in una campagna pubblicitaria promozionale. I profili di destinazione possono essere creati e riutilizzati in più linee di distribuzione.
Per altre informazioni sulla relazione tra profili di destinazione e campagne pubblicitarie, linee di recapito e creatività, vedi Eseguire campagne pubblicitarie usando i servizi di Microsoft Store.
Prerequisiti
Per usare questi metodi, è prima necessario eseguire le operazioni seguenti:
- Se non l'hai già fatto, completa tutti i prerequisiti e dell'API delle 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, si hanno 60 minuti per usarlo 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 |
|---|---|---|
| INSERISCI | https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile |
Crea un nuovo profilo di destinazione. |
| INSERIRE | https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/{targetingProfileId} |
Modifica il profilo di destinazione specificato da targetingProfileId. |
| OTTIENI | https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/{targetingProfileId} |
Ottiene il profilo di destinazione specificato da targetingProfileId. |
Intestazione
| Intestazione | TIPO | Descrizione |
|---|---|---|
| Autorizzazione | corda | Obbligatorio. Il token di accesso di Azure AD nel formato Bearer<token>. |
| ID di tracciamento | Identificatore Unico Globale (GUID) | Opzionale. ID che tiene traccia del flusso di chiamata. |
Testo della richiesta
I metodi POST e PUT richiedono un corpo di richiesta JSON con i campi obbligatori di un oggetto profilo di targeting e gli eventuali campi aggiuntivi che si desidera impostare o modificare.
Esempi di richiesta
Nell'esempio seguente viene illustrato come chiamare il metodo POST per creare un profilo di destinazione.
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 di destinazione.
GET https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/310023951 HTTP/1.1
Authorization: Bearer <your access token>
Risposta
Questi metodi restituiscono un corpo della risposta JSON con un oggetto profilo di destinazione che contiene informazioni sul profilo di destinazione creato, aggiornato o recuperato. Nell'esempio seguente viene illustrato il contenuto 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
]
}
}
Destinazione dell'oggetto profilo
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 | Impostazione predefinita | Obbligatorio per il metodo POST |
|---|---|---|---|---|---|
| Id | numero intero | ID del profilo di destinazione. | Sì | NO | |
| nome | corda | Nome del profilo di destinazione. | NO | Sì | |
| tipo di targeting | corda | Uno dei valori seguenti:
|
NO | Automobile | Sì |
| età | elenco | Uno o più numeri interi che identificano gli intervalli di età degli utenti di destinazione. Per un elenco completo dei numeri interi, vedere valori di età nell'articolo. | NO | nullo | NO |
| sesso | elenco | Uno o più numeri interi che identificano i sessi degli utenti di destinazione. Per un elenco completo dei numeri interi, vedere valori di genere in questo articolo. | NO | nullo | NO |
| paese | elenco | Uno o più numeri interi che identificano i codici paese degli utenti di destinazione. Per un elenco completo dei numeri, vedere i valori di codice paese in questo articolo. | NO | nullo | NO |
| Versione del sistema operativo | elenco | Uno o più numeri interi che identificano le versioni del sistema operativo degli utenti di destinazione. Per un elenco completo dei numeri interi, vedere valori di versione del sistema operativo in questo articolo. | NO | nullo | NO |
| Tipo di dispositivo | elenco | Uno o più numeri interi che identificano i tipi di dispositivo degli utenti di destinazione. Per un elenco completo dei numeri interi, vedere Valori del tipo di dispositivo in questo articolo. | NO | nullo | NO |
| tipo di fornitura | elenco | Uno o più numeri interi che identificano il tipo di inventario in cui verranno visualizzati gli annunci della campagna. Per un elenco completo di numeri interi, consultare "Valori di tipo di fornitura" in questo articolo. | NO | nullo | NO |
Valori di età
Il campo age nell'oggetto TargetingProfile contiene uno o più valori interi seguenti che identificano gli intervalli di età degli utenti di destinazione.
| Valore intero per il campo età | 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 | 50 e oltre |
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 Bearer<token>.
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 di genere
Il campo genere nell'oggetto TargetingProfile contiene uno o più dei seguenti valori interi che identificano i generi degli utenti da prendere di mira.
| Valore intero per il campo sesso | Sesso 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 Bearer<token>.
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 della versione del sistema operativo
Il campo osVersion oggetto TargetingProfile contiene uno o più dei valori interi seguenti che identificano le versioni del sistema operativo degli utenti di destinazione.
| 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 Bearer<token>.
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 del tipo di dispositivo
Il campo deviceType nell'oggetto TargetingProfile contiene uno o più valori interi seguenti che identificano i tipi di dispositivo degli utenti di destinazione.
| Valore intero del campo deviceType | Tipo di dispositivo corrispondente | Descrizione |
|---|---|---|
| 710 | Finestre | Rappresenta i dispositivi che eseguono una versione desktop di Windows 11, Windows 10 o Windows 8.x. |
| 711 | Telefono | 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 Bearer<token>.
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 del tipo di fornitura
Il campo supplyType nell'oggetto TargetingProfile contiene uno o più numeri interi tra i seguenti, che identificano il tipo di inventario in cui gli annunci della campagna verranno visualizzati.
| Valore intero per il campo supplyType | Tipo di fornitura corrispondente | Descrizione |
|---|---|---|
| 11470 | Applicazione | Questo si riferisce agli annunci visualizzati solo nelle app. |
| 11471 | Universale | Questo 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 Bearer<token>.
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 del codice paese
Il campo paese nell'oggetto TargetingProfile contiene uno o più dei seguenti numeri interi che identificano i codici paese ISO 3166-1 alfa-2 degli utenti da prendere di mira.
| Valore intero per il campo del paese |
Codice paese corrispondente |
|---|---|
| 1 | Stati Uniti |
| 2 | AU |
| 3 | A |
| 4 | ESSERE |
| 5 | BR |
| 6 | CA |
| 7 | DK |
| 8 | FI |
| 9 | FR |
| 10 | Germania |
| 11 | GR |
| 12 | Hong Kong |
| 13 | IN |
| 14 | Internet Explorer |
| 15 | Tecnologia dell'informazione |
| 16 | JP |
| 17 | Lussemburgo |
| 18 | Messico |
| 19 | Paesi Bassi |
| 20 | NZ |
| 21 | NO |
| 22 | PL |
| 23 | PT |
| 24 | SG |
| 25 | ES |
| 26 | SE |
| 27 | CH |
| 28 | Taiwan |
| 29 | GB |
| 30 | Russia |
| 31 | CL |
| 32 | Monossido di carbonio |
| 33 | CZ |
| 34 | HU |
| 35 | Sudafrica |
| 36 | KR |
| 37 | Cina |
| 38 | RO |
| 39 | Turchia |
| 40 | SK |
| 41 | IL |
| 42 | Documento d'identità |
| 43 | Realtà Aumentata |
| 44 | MIO |
| 45 | PH |
| 46 | PE |
| 47 | UA |
| 48 | Æ |
| 49 | ESIMO |
| 50 | Quoziente Intellettivo (QI) |
| 51 | VN |
| 52 | CR |
| 53 | Venezia |
| 54 | Garanzia di Qualità |
| 55 | Sì |
| 56 | BG |
| 57 | LT |
| 58 | RS |
| 59 | HR |
| 60 | HR |
| 61 | LV |
| 62 | EE |
| 63 | Stato Islamico |
| 64 | KZ |
| 65 | SA |
| 67 | ALE |
| 68 | DZ |
| 70 | AO |
| 72 | di mattina |
| 73 | AZ |
| 74 | B |
| 75 | BD |
| 76 | BB |
| 77 | DA |
| 81 | BO |
| 82 | BA |
| 83 | BW |
| 87 | KH |
| 88 | cm |
| 94 | CD |
| 95 | CI |
| 96 | CY |
| 99 | FARE |
| 100 | CE |
| 101 | Ad esempio |
| 102 | SV |
| 107 | FJ |
| 108 | GA |
| 110 | GE |
| 111 | GH |
| 114 | Gran Turismo |
| 118 | Alta Tensione |
| 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 | MAMMA |
| 147 | MZ |
| 148 | NA |
| 150 | NP |
| 151 | NI |
| 153 | NG |
| 154 | OM |
| 155 | PK |
| 157 | Pennsylvania |
| 159 | PY |
| 167 | SN |
| 172 | LK |
| 176 | TZ |
| 180 | TT |
| 181 | TN |
| 184 | Uganda |
| 185 | UY |
| 186 | UZ |
| 189 | ZM |
| 190 | ZW |
| 219 | Dottore in Medicina |
| 224 | P.S. |
| 225 | RI |
| 246 | Relazioni Pubbliche |
Per ottenere i valori supportati per il campo paese programmaticamente, è possibile chiamare il seguente metodo GET. Per l'intestazione Authorization, passare il token di accesso di Azure AD nel formato Bearer<token>.
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"
}
}
}