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:
|
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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per