Gérer les profils de ciblage

Article
09/02/2023

Utilisez ces méthodes dans l’API de promotions du Microsoft Store pour sélectionner les utilisateurs, les zones géographiques et les types d’inventaire que vous souhaitez cibler pour chaque ligne de distribution dans une campagne publicitaire promotionnelle. Les profils de ciblage peuvent être créés et réutilisés sur plusieurs lignes de livraison.

Pour plus d’informations sur la relation entre le ciblage des profils et les campagnes publicitaires, les lignes de distribution et les créations, consultez Exécuter des campagnes publicitaires à l’aide des services du Microsoft Store.

Prerequisites

Pour utiliser ces méthodes, vous devez d’abord effectuer les opérations suivantes :

Si ce n’est pas déjà fait, remplissez toutes les conditions préalables relatives à l’API d’analyse du Windows Store.
Obtenir un jeton d’accès Azure AD à utiliser dans l’en-tête de requête pour ces méthodes. Une fois que vous avez récupéré le jeton d’accès, vous avez 60 minutes pour l’utiliser avant qu’il n’expire. Une fois le jeton expiré, vous pouvez en obtenir un nouveau.

Demande

Ces méthodes ont les URI suivants.

Type de méthode	URI de requête	Description
POST	`https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile`	Crée un profil de ciblage.
PUT	`https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/{targetingProfileId}`	Modifie le profil de ciblage spécifié par targetingProfileId.
GET	`https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/{targetingProfileId}`	Obtient le profil de ciblage spécifié par targetingProfileId.

En-tête	Type	Description
Autorisation	string	Obligatoire. Jeton d’accès Azure AD au format porteur<jeton>.
ID de suivi	GUID	Facultatif. ID qui effectue le suivi du flux d’appels.

Corps de la demande

Les méthodes POST et PUT nécessitent un corps de requête JSON avec les champs obligatoires d’un objet de profil de ciblage et tous les champs supplémentaires que vous souhaitez définir ou modifier.

Exemples de requête

L’exemple suivant montre comment appeler la méthode POST pour créer un profil de ciblage.

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

L’exemple suivant montre comment appeler la méthode GET pour récupérer un profil de ciblage.

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

Response

Ces méthodes retournent un corps de réponse JSON avec un objet de profil de ciblage qui contient des informations sur le profil de ciblage créé, mis à jour ou récupéré. L’exemple suivant illustre un corps de réponse pour ces méthodes.

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

Ciblage de l’objet de profil

Les corps de requête et de réponse pour ces méthodes contiennent les champs suivants. Ce tableau indique quels champs sont en lecture seule (ce qui signifie qu’ils ne peuvent pas être modifiés dans la méthode PUT) et quels champs sont requis dans le corps de la demande pour la méthode POST.

Champ	Type	Description	Lecture seule	Default	Obligatoire pour POST
id	integer	ID du profil de ciblage.	Oui		Non
nom	string	Nom du profil de ciblage.	Non		Oui
targetingType	string	Une des valeurs suivantes : Auto : spécifiez cette valeur pour permettre à Microsoft de choisir le profil de ciblage en fonction des paramètres de votre application dans l’Espace partenaires. Manuel : spécifiez cette valeur pour définir votre propre profil de ciblage.	Non	Automatique	Oui
age	tableau	Un ou plusieurs entiers qui identifient les plages d’âge des utilisateurs à cibler. Pour obtenir la liste complète des entiers, consultez Valeurs d’âge dans cet article.	Non	null	Non
sexe	tableau	Un ou plusieurs entiers qui identifient les sexes des utilisateurs à cibler. Pour obtenir la liste complète des entiers, consultez valeurs de genre dans cet article.	Non	null	Non
country	tableau	Un ou plusieurs entiers qui identifient les codes de pays des utilisateurs à cibler. Pour obtenir la liste complète des entiers, consultez valeurs de code pays dans cet article.	Non	null	Non
osVersion	tableau	Un ou plusieurs entiers qui identifient les versions du système d’exploitation des utilisateurs à cibler. Pour obtenir la liste complète des entiers, consultez valeurs de version du système d’exploitation dans cet article.	Non	null	Non
deviceType	tableau	Un ou plusieurs entiers qui identifient les types d’appareils des utilisateurs à cibler. Pour obtenir la liste complète des entiers, consultez valeurs de type appareil dans cet article.	Non	null	Non
supplyType	tableau	Un ou plusieurs entiers qui identifient le type d’inventaire dans lequel les publicités de la campagne seront affichées. Pour obtenir la liste complète des entiers, consultez Valeurs de type Fournir dans cet article.	Non	null	Non

Valeurs d’âge

Le champ age dans l’objet TargetingProfile contient un ou plusieurs des entiers suivants qui identifient les plages d’âge des utilisateurs à cibler.

Valeur entière pour le champ d’âge	Tranche d’âge correspondante
651	13 à 17
652	18 à 24
653	25 à 34
654	35 à 49
655	50 et versions ultérieures

Pour obtenir les valeurs prises en charge pour le champ âge par programmation, vous pouvez appeler la méthode GET suivante. Pour l’en-tête Authorization , transmettez votre jeton d’accès Azure AD sous la forme porteur<jeton>.

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

L’exemple suivant montre le corps de la réponse pour cette méthode.

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

Valeurs de genre

Le champ genre dans l’objet TargetingProfile contient un ou plusieurs des entiers suivants qui identifient les plages d’âge des utilisateurs à cibler.

Valeur entière pour le champ genre	Genre correspondant
700	Homme
701	Femme

Pour obtenir les valeurs prises en charge pour le champ genre par programmation, vous pouvez appeler la méthode GET suivante. Pour l’en-tête Authorization , transmettez votre jeton d’accès Azure AD sous la forme porteur<jeton>.

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

L’exemple suivant montre le corps de la réponse pour cette méthode.

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

Valeurs de version du système d’exploitation

Le champ osVersion dans l’objet TargetingProfile contient un ou plusieurs des entiers suivants qui identifient les versions du système d’exploitation des utilisateurs à cibler.

Valeur entière du champ osVersion	Version du système d’exploitation correspondante
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

Pour obtenir les valeurs prises en charge pour le champ osVersion par programmation, vous pouvez appeler la méthode GET suivante. Pour l’en-tête Authorization , transmettez votre jeton d’accès Azure AD sous la forme porteur<jeton>.

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

L’exemple suivant montre le corps de la réponse pour cette méthode.

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

Valeurs de type d’appareil

Le champ deviceType de l’objet TargetingPro file contient un ou plusieurs des entiers suivants qui identifient les types d’appareils des utilisateurs à cibler.

Valeur entière pour le champ deviceType	Type d’appareil correspondant	Description
710	Windows	Il représente les appareils exécutant une version de bureau de Windows 11, Windows 10 ou Windows 8.x.
711	Téléphone	Cela représente les appareils exécutant Windows 10 Mobile, Windows Phone 8.x ou Windows Phone 7.x.

Pour obtenir les valeurs prises en charge pour le champ deviceType par programmation, vous pouvez appeler la méthode GET suivante. Pour l’en-tête Authorization , transmettez votre jeton d’accès Azure AD sous la forme porteur<jeton>.

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

L’exemple suivant montre le corps de la réponse pour cette méthode.

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

Valeurs de type d’approvisionnement

Le champ supplyType de l’objet TargetingProfile contient un ou plusieurs des entiers suivants qui identifient le type d’inventaire dans lequel les annonces de la campagne seront affichées.

Valeur entière pour le champ supplyType	Type d’approvisionnement correspondant	Description
11470	Application	Cela fait référence aux annonces qui s’affichent uniquement dans les applications.
11471	Universal	Cela fait référence aux annonces qui apparaissent dans les applications, sur le Web et sur d’autres surfaces d’affichage.

Pour obtenir les valeurs prises en charge pour le champ supplyType par programmation, vous pouvez appeler la méthode GET suivante. Pour l’en-tête Authorization , transmettez votre jeton d’accès Azure AD sous la forme porteur<jeton>.

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

L’exemple suivant montre le corps de la réponse pour cette méthode.

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

Valeurs de code de pays

Le champ pays dans l’objet TargetingProfile contient un ou plusieurs des entiers suivants qui identifient les codes de pays iso 3166-1 alpha-2 ISO 3166-1 alpha-2 des utilisateurs à cibler.

Valeur entière pour le champ de pays	Code de pays correspondant
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	Internet Explorer
15	INFORMATIQUE
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	Go
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	MJ
50	IQ
51	VN
52	CR
53	VE
54	Questions et réponses
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	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	N/A
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

Pour obtenir les valeurs prises en charge pour le champ pays par programmation, vous pouvez appeler la méthode GET suivante. Pour l’en-tête Authorization , transmettez votre jeton d’accès Azure AD sous la forme porteur<jeton>.

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

L’exemple suivant montre le corps de la réponse pour cette méthode.

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

Partager via

Gérer les profils de ciblage

Prerequisites

Demande

En-tête

Corps de la demande

Exemples de requête

Response

Ciblage de l’objet de profil

Valeurs d’âge

Valeurs de genre

Valeurs de version du système d’exploitation

Valeurs de type d’appareil

Valeurs de type d’approvisionnement

Valeurs de code de pays

Commentaires

Ressources supplémentaires

Partager via

Gérer les profils de ciblage

Prerequisites

Demande

En-tête

Corps de la demande

Exemples de requête

Response

Ciblage de l’objet de profil

Valeurs d’âge

Valeurs de genre

Valeurs de version du système d’exploitation

Valeurs de type d’appareil

Valeurs de type d’approvisionnement

Valeurs de code de pays

Rubriques connexes

Commentaires

Ressources supplémentaires