Partager via


Codes d’emplacement géographique

Les données des emplacements géographiques peuvent être utilisées pour le ciblage de localisation, par exemple, afficher des publicités à des personnes d’un pays/région, d’un état/d’une province, d’un comté, d’une zone de métro (zone de marché Microsoft dans le États-Unis), d’un code postal ou d’une ville spécifique. Vous pouvez appeler l’opération GetGeoLocationsFileUrl pour obtenir une URL de fichier temporaire qui peut être utilisée pour télécharger les dernières données d’emplacements géographiques. Vous pouvez également obtenir les données d’emplacement à partir du portail des développeurs Microsoft Advertising. Vous devez être connecté au portail des développeurs avec un utilisateur de compte Microsoft disposant d’informations d’identification Microsoft Advertising.

Remarque

Il est recommandé de télécharger le fichier au lieu de l’ouvrir directement via une application telle que Microsoft Excel. Si vous affichez les données des emplacements dans un éditeur de texte, veillez à utiliser l’encodage UTF-8 au lieu d’ANSI, sinon certains caractères ne seront pas affichés avec précision.

Pour obtenir des exemples de code qui montrent comment télécharger les codes des emplacements géographiques, consultez Exemple de code d’emplacements géographiques.

Format de fichier codes d’emplacement

Le fichier de valeurs séparées par des virgules (CSV) contient des données organisées dans les en-têtes de colonnes non localisées suivants. Seul le nom d’affichage Bing est localisé en fonction de l’URL de fichier utilisée ci-dessus.

Importante

De nouvelles colonnes peuvent être ajoutées à tout moment, de sorte que votre implémentation doit ignorer les colonnes inconnues.

L’ordre des emplacements n’étant pas garanti, vous ne devez pas prendre de dépendances sur l’ordre ou la hiérarchie de tri des colonnes perçus.

Format de fichier version 2.0

Si vous avez spécifié version 2.0 lors de l’appel de l’opération GetGeoLocationsFileUrl , les données suivantes sont disponibles dans le fichier téléchargé. Actuellement, l’API Bing Ads prend uniquement en charge le format de fichier version 2.0.

Nom de colonne Description
ID d’emplacement Identificateur système Microsoft Advertising unique pour l’emplacement. Vous devez utiliser cette valeur pour définir le critère d’emplacement.
Nom d’affichage Bing Nom facultatif que vous pouvez utiliser pour afficher les données d’emplacements, par exemple pour les utilisateurs de votre application. Les barres verticales sont utilisées pour séparer les composants d’emplacement du plus spécifique au moins spécifique. Par exemple, Seattle|Washington |États-Unis le composant le plus spécifique est la ville de Seattle dans l’état de Washington du États-Unis.

Plusieurs ID d’emplacement peuvent avoir le même nom d’affichage. Vous ne devez pas utiliser le nom d’affichage pour autre chose que la présentation. Par exemple, ne supposez aucune hiérarchie ou prenez des dépendances sur le nom d’affichage.
Type d'emplacement Détermine le sous-type d’emplacement (par exemple, City, County, Country, MetroArea, PostalCode ou State) qui correspond à la colonne Id d’emplacement.

Les lieux de voisinage sont bientôt disponibles.

De nouveaux sous-types d’emplacement peuvent être ajoutés à tout moment. Le type d’emplacement change rarement pour un ID d’emplacement donné.
Remplace Réservé à une utilisation ultérieure pour indiquer quel(s) emplacement(s) sont remplacés par l’emplacement dans cette ligne.
Statut Indique si l’emplacement dans cette ligne est actif, en attente de dépréciation ou déconseillé.

- Actif : vous pouvez cibler ou exclure l’emplacement.
- Dépréciation en attente : l’emplacement est toujours utilisé par le moteur de livraison pour le ciblage ou les exclusions ; toutefois, l’emplacement sera déconseillé dans les 30 prochains jours.
- Déconseillé : le critère d’emplacement n’est plus utilisé pour le ciblage ou les exclusions. Les critères d’emplacement déconseillés peuvent toujours être récupérés via l’API Bing Ads, par exemple , GetCampaignCriterionsByIds, mais vous ne pouvez pas ajouter ou mettre à jour des critères d’emplacement déconseillés. Envisagez d’appeler l’opération GetGeoLocationsFileUrl une ou deux fois par mois pour déterminer si le contenu du fichier a changé, par exemple, status. Vous n’avez pas besoin de télécharger l’intégralité du fichier, sauf si la valeur LastModifiedTimeUtc retournée a changé depuis la dernière synchronisation des données d’emplacements.
ID d’emplacement AdWords ID d’emplacement Google Ads qui correspond le plus proche de l’ID d’emplacement géographique Microsoft Advertising. Vous pouvez l’utiliser pour mapper les emplacements Microsoft Advertising aux emplacements Google Ads estimés.

Cette valeur est une estimation heuristique qui peut être utilisée pour le mappage des emplacements géographiques Google Ads et Microsoft Advertising. Le champ est vide si l’emplacement n’a pas été mappé.

Codes pays

Dans certains contextes, l’API nécessite une chaîne de code de pays, par exemple, pour l’adresse professionnelle d’un objet AdvertiserAccount . Les codes de pays suivants sont pris en charge par Microsoft Advertising.

Country Code Nom du pays/de la région
AF Afghanistan
AL Albanie
DZ Algérie
AS Samoa américaines
AD Andorre
AO Angola
IA Anguilla
AQ Antarctique
AG Antigua-et-Barbuda
AR Argentine
SUIS Arménie
AW Aruba
AU Australie
AT Autriche
AZ Azerbaïdjan
BS Bahamas, Le
BH Bahreïn
BD Bangladesh
BB Barbade
BY Bélarus
BVE Belgique
BZ Bélize
BJ Bénin
BM Bermudes
BT Bhoutan
BO Bolivie
UN Bonaire, Curaçao, Saba, Saint-Eustache, Saint-Martin
BA Bosnie-Herzégovine
BW Botswana
BR Brésil
BN Brunei
BG Bulgarie
BF Burkina Faso
BI Burundi
VC Cabo Verde
KH Cambodge
CM Cameroun
CA Canada
KY Îles Cayman
CF République centrafricaine
TD Tchad
CL Chili
CN Chine
CX Île Christmas
Cc Île Cocos (Keeling)
CO Colombie
KM Comores
CG Congo
CD Congo (RDC)
CK Îles Cook
CR Costa Rica
CI Côte d'Ivoire
HR Croatie
CY Chypre
CZ République tchèque
DK Danemark
DJ Djibouti
DM Dominique
FAIRE République dominicaine
CE Équateur
EG Égypte
ED El Salvador
GQ Guinée Équatoriale
ER Érythrée
EE Estonie
ET Éthiopie
FK Falkand (îles)
FO Îles Féroé
FJ Îles Fidji
FI Finlande
FR France
GF Guyane française
PF Polynésie française
Disponible Gabon
GM Gambie,
GE Géorgie
DE Allemagne
GH Ghana
GI Gibraltar
GR Grèce
GL Groenland
GD Grenade
GP Guadeloupe
GU Guam
Gt Guatemala
GN Guinée
GW Guinée-Bissau
GY Guyane
HT Haïti
HN Honduras
HK Hong Kong (SAR)
HU Hongrie
EST Islande
DANS Inde
ID Indonésie
IQ Irak
IE Irlande
IL Israël
Professionnels de l’informatique Italie
JM Jamaïque
JP Japon
JO Jordanie
KZ Kazakhstan
KE Kenya
KI Kiribati
KR Corée
KW Koweït
KG Kirghizstan
LA Laos
LV Lettonie
LB Liban
LS Lesotho
LR Libéria
LY Libye
LI Liechtenstein
LT Lituanie
LU Luxembourg
MO Macao (R.S.)
MK Macédoine du Nord, ex-République yougoslave de
MG Madagascar
MW Malawi
MON Malaisie
MV Maldives
ML Mali
MT Malte
MH Îles Marshall
MQ Martinique
M Mauritanie
MU Île Maurice
YT Mayotte
MX Mexique
FM Micronésie
MD Moldova
MC Monaco
MN Mongolie
MOI Monténégro
MS Montserrat
MA Maroc
MZ Mozambique
MM Birmanie
N/A Namibie
NR Nauru
NP Népal
NL Pays-Bas
NC Nouvelle-Calédonie
NZ Nouvelle-Zélande
NI Nicaragua
NE Niger
NG Nigéria
NU Niue
NF Île Norfolk
MP Îles Mariannes du Nord
NON Norvège
OM Oman
PK Pakistan
PW Palaos
PS Autorité palestinienne
PA Panama
PG Papouasie-Nouvelle-Guinée
PY Paraguay
PE Pérou
PH Philippines
PN Pitcairn (îles)
PL Pologne
PT Portugal
PR Porto Rico
QA Qatar
RE La Réunion
RO Roumanie
RU Russie
RW Rwanda
SH Sainte-Hélène, Ascension et Tristan da Cunha
KN Saint-Christophe-et-Nevis
LC Sainte-Lucie
PM Saint-Pierre-et-Miquelon
VC Saint-Vincent-et-les-Grenadines
WS État indépendant des Samoa
SM Saint-Marin
ST Sao Tomé-et-Príncipe
SA Arabie Saoudite
SN Sénégal
RS Serbie
SC Seychelles
SL Sierra Leone
SG Singapour
SK Slovaquie
SI Slovénie
SB Îles Salomon
SO Somalie
ZA Afrique du Sud
ES Espagne
LK Sri Lanka
SR Suriname
SZ Eswatini
SE Suède
CH Suisse
TW Taïwan
TJ Tadjikistan
TZ Tanzanie
E Thaïlande
TL Timor-Leste
TG Togo
TK Tokelau
TO Tonga
TT Trinité-et-Tobago
TN Tunisie
TR Turquie
TM Turkménistan
TC Îles Turks et Caicos
TV Tuvalu
UG Ouganda
UA Ukraine
AE Émirats arabes unis
GO Royaume-Uni
US États-Unis
UY Uruguay
UZ Ouzbékistan
VU Vanuatu
VA État de la Cité du Vatican
VE Venezuela
VN Vietnam
VG Îles Vierges, Britannique
VI Îles Vierges, États-Unis
WF Wallis et Futuna
VOUS Yémen
ZM Zambie
ZW Zimbabwe

Voir aussi

Afficher des publicités à votre public cible