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 |