Verwalten von Zielgruppenprofilen

Artikel
09/07/2023

Verwenden Sie diese Methoden in der Microsoft Store-Werbungs-API, um die Benutzer, Regionen und Bestandstypen auszuwählen, die Sie für jede Lieferposition in einer Werbeanzeigekampagne festlegen möchten. Zielprofile können über mehrere Lieferpositionen hinweg erstellt und wiederverwendet werden.

Weitere Informationen zur Beziehung zwischen Zielgruppenprofilen und Anzeigenkampagnen, Lieferpositionen und Werbemittel finden Sie unter Ausführen von Anzeigenkampagnen mit Microsoft Store-Diensten.

Voraussetzungen

Um diese Methoden zu verwenden, müssen Sie zuerst folgendes tun:

Falls noch nicht geschehen, erfüllen Sie alle Voraussetzungen für die Microsoft Store-Werbungs-API.
Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.

Anforderung

Diese Methoden weisen die folgenden URIs auf.

Methodentyp	Anforderungs-URI	Beschreibung
POST	`https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile`	Erstellt ein neues Zielprofil.
PUT	`https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/{targetingProfileId}`	Bearbeitet das durch targetingProfileIdangegebene Zielprofil.
GET	`https://manage.devcenter.microsoft.com/v1.0/my/promotion/targeting-profile/{targetingProfileId}`	Ruft das durch targetingProfileIdangegebene Zielprofil ab.

Header	type	BESCHREIBUNG
Authorization	Zeichenfolge	Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>.
Nachverfolgungs-ID	GUID	Optional. Eine ID, die den Anruffluss nachverfolgt.

Anforderungstext

Die POST- und PUT-Methoden erfordern einen JSON-Anforderungstext mit den erforderlichen Feldern eines Targeting-Profilobjekts und allen zusätzlichen Feldern, die Sie festlegen oder ändern möchten.

Beispiele für Anforderungen

Im folgenden Beispiel wird veranschaulicht, wie die POST-Methode aufgerufen wird, um ein Zielprofil zu erstellen.

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

Im folgenden Beispiel wird veranschaulicht, wie die GET-Methode aufgerufen wird, um ein Zielprofil abzurufen.

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

Antwort

Diese Methoden geben einen JSON-Antworttext mit einem Targeting-Profilobjekt zurück, das Informationen zum erstellten, aktualisierten oder abgerufenen Zielprofil enthält. Im folgenden Beispiel wird ein Antworttext für diese Methoden veranschaulicht.

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

Zielprofilobjekt

Die Anforderungs- und Antworttexte für diese Methoden enthalten die folgenden Felder. Diese Tabelle zeigt, welche Felder schreibgeschützt sind (d. h., sie können nicht in der PUT-Methode geändert werden) und welche Felder im Anforderungstext für die POST-Methode erforderlich sind.

Feld	Typ	Beschreibung	Schreibgeschützt	Standard	Erforderlich für POST
id	integer	Die ID des Zielprofils.	Ja		Nein
name	Zeichenfolge	Der Name des Zielprofils.	Nein		Ja
targetingType	Zeichenfolge	Einer der folgenden Werte: Auto: Geben Sie diesen Wert an, damit Microsoft das Zielprofil basierend auf den Einstellungen für Ihre App im Partner Center auswählen kann. Manuell: Geben Sie diesen Wert an, um Ihr eigenes Zielprofil zu definieren.	Nein	Automatisch	Ja
age	array	Eine oder mehrere ganze Zahlen, die die Altersbereiche der Benutzer identifizieren, die als Ziel verwendet werden sollen. Eine vollständige Liste der ganzzahligen Zahlen finden Sie in diesem Artikel unter Alterswerte.	Nein	null	Nein
gender	array	Eine oder mehrere ganze Zahlen, die die Geschlechter der Benutzer identifizieren, die als Ziel verwendet werden sollen. Eine vollständige Liste der ganzen Zahlen finden Sie in diesem Artikel unter Geschlechterwerte.	Nein	null	Nein
country	array	Eine oder mehrere ganze Zahlen, die die Landeskennzahlen der Benutzer identifizieren, die als Ziel festgelegt werden sollen. Eine vollständige Liste der ganzen Zahlen finden Sie in diesem Artikel unter Landeskennzahlwerte.	Nein	null	Nein
osVersion	array	Eine oder mehrere ganze Zahlen, die die Betriebssystemversionen der Benutzer identifizieren, die als Ziel verwendet werden sollen. Eine vollständige Liste der ganzen Zahlen finden Sie in diesem Artikel unter Betriebssystemversionswerte.	Nein	null	Nein
deviceType	array	Eine oder mehrere ganze Zahlen, die die Gerätetypen der Benutzer identifizieren, die als Ziel verwendet werden sollen. Eine vollständige Liste der ganzen Zahlen finden Sie unter Gerätetypwerte in diesem Artikel.	Nein	null	Nein
supplyType	array	Mindestens eine ganze Zahl, die den Bestandstyp angibt, in dem die Anzeigen der Kampagne angezeigt werden. Eine vollständige Liste der ganzen Zahlen finden Sie unter Liefertypwerte in diesem Artikel.	Nein	null	Nein

Alterswerte

Das Feld Alter im Objekt TargetingProfile enthält eine oder mehrere der folgenden ganzen Zahlen, die die Altersbereiche der Benutzer identifizieren, die als Ziel verwendet werden sollen.

Ganzzahliger Wert für das Feld Alter	Entsprechende Altersspanne
651	13 bis 17
652	18 bis 24
653	25 bis 34
654	35 bis 49
655	50 und älter

Um die unterstützten Werte für das Feld Alter programmgesteuert abzurufen, können Sie die folgende GET-Methode aufrufen. Übergeben Sie für den Header Authorization Ihr Azure AD-Zugriffstoken im Formular Bearer<-Token>.

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

Das folgende Beispiel zeigt den Antworttext für diese Methode.

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

Geschlechterwerte

Das Feld Geschlecht im Objekt TargetingProfile enthält eine oder mehrere der folgenden ganzen Zahlen, die die Geschlechter der Benutzer identifizieren sollen.

Ganzzahliger Wert für das Feld Gender	Entsprechendes Geschlecht
700	Male
701	Weiblich

Um die unterstützten Werte für das Feld Geschlecht programmgesteuert abzurufen, können Sie die folgende GET-Methode aufrufen. Übergeben Sie für den Header Authorization Ihr Azure AD-Zugriffstoken im Formular Bearer<-Token>.

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

Das folgende Beispiel zeigt den Antworttext für diese Methode.

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

Betriebssystemversionswerte

Das Feld osVersion im Objekt TargetingProfile enthält eine oder mehrere der folgenden ganzen Zahlen, die die Betriebssystemversionen der Benutzer identifizieren sollen.

Ganzzahliger Wert für das Feld osVersion	Entsprechende Betriebssystemversion
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

Um die unterstützten Werte für das Feld osVersion programmgesteuert abzurufen, können Sie die folgende GET-Methode aufrufen. Übergeben Sie für den Header Authorization Ihr Azure AD-Zugriffstoken im Formular Bearer<-Token>.

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

Das folgende Beispiel zeigt den Antworttext für diese Methode.

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

Gerätetypwerte

Das Feld deviceType im Objekt TargetingProfile enthält eine oder mehrere der folgenden ganzen Zahlen, die die Gerätetypen der Benutzer identifizieren, die als Ziel verwendet werden sollen.

Ganzzahliger Wert für das Feld deviceType	Entsprechender Gerätetyp	Beschreibung
710	Windows	Dies stellt Geräte dar, auf denen eine Desktopversion von Windows 11, Windows 10 oder Windows 8.x ausgeführt wird.
711	Telefonnummer	Dies stellt Geräte dar, auf denen Windows 10 Mobile, Windows Phone 8.x oder Windows Phone 7.x ausgeführt wird.

Um die unterstützten Werte für das Feld deviceType programmgesteuert abzurufen, können Sie die folgende GET-Methode aufrufen. Übergeben Sie für den Header Authorization Ihr Azure AD-Zugriffstoken im Formular Bearer<-Token>.

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

Das folgende Beispiel zeigt den Antworttext für diese Methode.

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

Liefertypwerte

Das Feld supplyType im Objekt TargetingProfile enthält eine oder mehrere der folgenden ganzen Zahlen, die den Typ des Inventars identifizieren, in dem die Anzeigen der Kampagne angezeigt werden.

Ganzzahliger Wert für das Feld supplyType	Entsprechender Versorgungstyp	Beschreibung
11470	App	Dies bezieht sich auf Anzeigen, die nur in Apps angezeigt werden.
11471	Universell	Dies bezieht sich auf Anzeigen, die in Apps, im Web und auf anderen Anzeigeflächen angezeigt werden.

Um die unterstützten Werte für das Feld supplyType programmgesteuert abzurufen, können Sie die folgende GET-Methode aufrufen. Übergeben Sie für den Header Authorization Ihr Azure AD-Zugriffstoken im Formular Bearer<-Token>.

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

Das folgende Beispiel zeigt den Antworttext für diese Methode.

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

Landeskennzahlwerte

Das Feld Land im Objekt TargetingProfile enthält eine oder mehrere der folgenden ganzen Zahlen, die die Landeskennzahlen der Benutzer nach ISO 3166-1 alpha-2 identifizieren, die als Ziel verwendet werden sollen.

Ganzzahliger Wert für das Feld Land	Entsprechende Landeskennzahl
1	US
2	AU
3	AT
4	BE
5	BR
6	CA
7	DK
8	FI
9	BV
10	DE
11	GR
12	HK
13	IN
14	IE
15	IT-Abteilung
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	FA
55	SI
56	BG
57	LT
58	WV
59	Personalverwaltung
60	Personalverwaltung
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	Allgemein verfügbar
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	NI
147	MZ
148	Nicht verfügbar
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

Um die unterstützten Werte für das Feld Land programmgesteuert abzurufen, können Sie die folgende GET-Methode aufrufen. Übergeben Sie für den Header Authorization Ihr Azure AD-Zugriffstoken im Formular Bearer<-Token>.

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

Das folgende Beispiel zeigt den Antworttext für diese Methode.

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

Share via

Verwalten von Zielgruppenprofilen

Voraussetzungen

Anforderung

Header

Anforderungstext

Beispiele für Anforderungen

Antwort

Zielprofilobjekt

Alterswerte

Geschlechterwerte

Betriebssystemversionswerte

Gerätetypwerte

Liefertypwerte

Landeskennzahlwerte

Feedback

Feedback

Zusätzliche Ressourcen

Share via

Verwalten von Zielgruppenprofilen

Voraussetzungen

Anforderung

Header

Anforderungstext

Beispiele für Anforderungen

Antwort

Zielprofilobjekt

Alterswerte

Geschlechterwerte

Betriebssystemversionswerte

Gerätetypwerte

Liefertypwerte

Landeskennzahlwerte

Zugehörige Themen

Feedback

Feedback

Zusätzliche Ressourcen