Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
I dati sulle località geografiche possono essere usati per il targeting della località, ad esempio per mostrare gli annunci alle persone di un paese/area geografica, stato/provincia, contea, area metropolitana (Microsoft Market Area negli Stati Uniti), codice postale o città specifica. È possibile chiamare l'operazione GetGeoLocationsFileUrl per ottenere un URL del file temporaneo che può essere usato per scaricare i dati più recenti delle località geografiche.
Nota
A partire dal 31 maggio 2025, la pagina del portale per sviluppatori verrà deprecata e sostituita con una nuova versione qui. Aggiorna i segnalibri e inizia a usare la nuova pagina per evitare interruzioni. Per domande o assistenza, contatta il supporto tecnico.
È inoltre possibile ottenere i dati relativi alle località dal portale per sviluppatori di Microsoft Advertising. È necessario aver effettuato l'accesso al portale per sviluppatori con un utente con account Microsoft che disponga di credenziali di Microsoft Advertising.
Nota
Come procedura consigliata, è consigliabile scaricare il file invece di aprirlo direttamente tramite un'applicazione come Microsoft Excel. Se si visualizzano i dati sulle località in un editor di testo, assicurarsi di usare la codifica UTF-8 anziché ANSI, altrimenti alcuni caratteri non verranno visualizzati in modo accurato.
Per esempi di codice che illustrano come scaricare i codici delle località geografiche, vedere Esempio di codice delle località geografiche.
Formato file codici località
Il file con valori delimitati da virgole (CSV) contiene dati organizzati nelle intestazioni di colonna non localizzate seguenti. Solo il nome visualizzato di Bing è localizzato, a seconda dell'URL del file usato in precedenza.
Importante
Nuove colonne possono essere aggiunte in qualsiasi momento, quindi l'implementazione deve ignorare le colonne sconosciute.
L'ordine delle posizioni non è garantito, quindi non si devono accettare dipendenze da alcun ordinamento o gerarchia di colonna percepito.
Formato di file versione 2.0
Se è stata specificata la versione come 2.0 quando si chiama l'operazione GetGeoLocationsFileUrl , nel file scaricato sono disponibili i dati seguenti. L'API di Bing Ads attualmente supporta solo la versione 2.0 del formato di file.
| Column Name | Descrizione |
|---|---|
| ID località | Identificatore univoco del sistema Microsoft Advertising per la località. È necessario usare questo valore per impostare il criterio di posizione. |
| Nome visualizzato Bing | Nome facoltativo che è possibile usare per visualizzare i dati relativi alle posizioni, ad esempio agli utenti dell'applicazione. Le barre verticali vengono usate per separare i componenti di posizione dal più specifico al meno specifico. Ad esempio, dato che Seattle|Washington|Stati Uniti la componente più specifica è la città di Seattle all'interno dello stato di Washington degli Stati Uniti. Più ID località possono avere lo stesso nome visualizzato. Non usare il nome visualizzato per nient'altro che per la presentazione, ad esempio non assumere alcuna gerarchia o assumere dipendenze dal nome visualizzato. |
| Tipo di posizione | Determina il sottotipo di località (ad esempio, Città, Contea, Paese, MetroArea, CAP o Stato) che corrisponde alla colonna ID località. Le sedi dei quartieri arriveranno presto. È possibile aggiungere nuovi sottotipi di località in qualsiasi momento. Il tipo di località cambia raramente per un determinato ID località. |
| Sostituisce | Riservato a un uso futuro per indicare quale o più posizioni vengono sostituite dalla posizione in questa riga. |
| Stato | Indica se la posizione in questa riga è attiva, in attesa di deprecazione o deprecata. - Attivo: è possibile scegliere come target o escludere la posizione. - Deprecazione in sospeso: la posizione è ancora utilizzata dal motore di distribuzione per il targeting o le esclusioni; Tuttavia, la posizione verrà deprecata entro i prossimi 30 giorni. - Deprecato: il criterio di posizione non viene più utilizzato per il targeting o le esclusioni. I criteri di posizione deprecati possono ancora essere recuperati tramite l'API di Bing Ads, ad esempio GetCampaignCriterionsByIds, ma non è possibile aggiungere o aggiornare criteri di posizione deprecati. È consigliabile chiamare l'operazione GetGeoLocationsFileUrl una o due volte al mese per determinare se il contenuto del file è stato modificato, ad esempio lo stato. Non è necessario scaricare l'intero file a meno che il valore LastModifiedTimeUtc restituito non sia cambiato dall'ultima volta in cui sono stati sincronizzati i dati dei percorsi. |
| ID località AdWords | L'ID località di Google Ads che corrisponde di più all'ID località geografica di Microsoft Advertising. È possibile utilizzare questo pulsante per eseguire il mapping delle località di Microsoft Advertising alle località stimate di Google Ads. Questo valore è una stima euristica che può essere utilizzata per il mapping delle posizioni geografiche di Google Ads e Microsoft Advertising. Il campo è vuoto se la posizione non è stata mappata. |
Codici paese
In alcuni contesti l'API richiede una stringa con codice paese, ad esempio per l'indirizzo aziendale di un oggetto AdvertiserAccount . I codici paese seguenti sono supportati da Microsoft Advertising.
| Country Code | Nome paese/area geografica |
|---|---|
| AF | Afghanistan |
| AL | Albania |
| DZ | Algeria |
| COME | Samoa americane |
| ANNUNCIO | Andorra |
| AO | Angola |
| Intelligenza artificiale | Anguilla |
| AQ | Antartide |
| AG | Antigua e Barbuda |
| AR | Argentina |
| AM | Armenia |
| AW | Aruba |
| AU | Australia |
| AT | Austria |
| AZ | Azerbaigian |
| BS | Bahamas |
| BH | Bahrein |
| BD | Bangladesh |
| BB | Barbados |
| DI | Bielorussia |
| BE | Belgio |
| BZ | Belize |
| BJ | Benin |
| BM (BM) | Bermuda |
| BT | Bhutan |
| BO | Bolivia |
| UN | Bonaire, Curaçao, Saba, Sint Eustatius, Sint Maarten |
| BA | Bosnia ed Erzegovina |
| BW (Inglese) | Botswana |
| BR | Brasile |
| BN | Brunei |
| BG | Bulgaria |
| BF | Burkina Faso |
| BI | Burundi |
| Curriculum vitae | Cabo Verde |
| KH | Cambogia |
| CM | Camerun |
| CA | Canada |
| KY | Isole Cayman |
| CF | Repubblica Centrafricana |
| TD | Ciad |
| CL | Cile |
| NC | Cina |
| CX | Isola Christmas |
| CC | Isole Cocos (Keeling) |
| CO | Colombia |
| KM | Comore |
| CG | Congo |
| CD | Congo (DRC) |
| CK | Isole Cook |
| CR | Costa Rica |
| CI | Côte d'Ivoire |
| Risorse umane | Croazia |
| CY | Cipro |
| CZ | Repubblica Ceca |
| DK | Danimarca |
| Alessio | Gibuti |
| DM | Dominica |
| FARE | Repubblica dominicana |
| CE | Ecuador |
| EG | Egitto |
| Valentina | El Salvador |
| GQ | Guinea Equatoriale |
| ER | Eritrea |
| EE | Estonia |
| ET | Etiopia |
| FK | Isole Falkland |
| FO | Isole Fær Øer |
| FJ | Figi |
| FI | Finlandia |
| FR | Francia |
| GF | Guyana francese |
| PF | Polinesia francese |
| GA | Gabon |
| GM | Gambia, Il |
| GE | Georgia |
| DE | Germania |
| GH | Ghana |
| GI | Gibilterra |
| GR | Grecia |
| GL | Groenlandia |
| GD | Grenada |
| Criteri di gruppo | Guadalupa |
| GU | Guam |
| GT | Guatemala |
| GN | Guinea |
| GW | Guinea-Bissau |
| OGGETTO GEOGRAFICO | Guyana |
| HT | Haiti |
| HN | Honduras |
| HK | RAS di Hong Kong |
| HU | Ungheria |
| Sicurezza informazioni | Islanda |
| IN | India |
| ID | Indonesia |
| IQ | Iraq |
| IE | Irlanda |
| IL | Israele |
| IT | Italia |
| JM | Giamaica |
| JP | Giappone |
| JO | Giordania |
| KZ | Kazakistan |
| KE | Kenya |
| KI | Kiribati |
| KR | Corea |
| KW | Kuwait |
| KG | Kirghizistan |
| LA | Laos |
| LV | Lettonia |
| LB | Libano |
| LS | Lesotho |
| LR | Liberia |
| LY | Libia |
| LI | Liechtenstein |
| LT | Lituania |
| LU | Lussemburgo |
| MO | Macao - R.A.S. |
| MK | Macedonia del Nord, ex Repubblica iugoslava di Macedonia del Nord |
| MG | Madagascar |
| MW | Malawi |
| MIO | Malaysia |
| MV | Maldive |
| ML | Mali |
| MT | Malta |
| MH | Isole Marshall |
| MQ | Martinica |
| MR | Mauritania |
| MU | Mauritius |
| YT | Mayotte |
| MX | Messico |
| FM | Micronesia |
| Amministratore Delegato | Moldova |
| MC | Monaco |
| MN | Mongolia |
| IO | Montenegro |
| Manoscritto | Montserrat |
| MA | Marocco |
| MZ | Mozambico |
| MM | Myanmar |
| ND | Namibia |
| NR | Nauru |
| NP | Nepal |
| NL | Paesi Bassi |
| NC | Nuova Caledonia |
| Nuova Zelanda | Nuova Zelanda |
| NI | Nicaragua |
| NE | Niger |
| NG | Nigeria |
| NU | Niue |
| NF | Isola Norfolk |
| MP | Isole Marianne settentrionali |
| NO | Norvegia |
| OM | Oman |
| PK | Pakistan |
| PW | Palau |
| PS | Autorità Palestinese |
| PA | Panamá |
| PG | Papua Nuova Guinea |
| Anno precedente | Paraguay |
| PE | Perù |
| PH | Filippine |
| PN | Isole Pitcairn |
| PL | Polonia |
| PT | Portogallo |
| Pubbliche relazioni | Portorico |
| Domande e risposte | Qatar |
| RE | Riunione |
| RO | Romania |
| RU | Russia |
| RW | Ruanda |
| SH | Sant'Elena |
| KN | Saint Kitts e Nevis |
| LC | Saint Lucia |
| Ore | Saint-Pierre e Miquelon |
| VC | Saint Vincent e Grenadine |
| WS | Samoa |
| S.M. | San Marino |
| ST | São Tomé e Príncipe |
| SA (SA) | Arabia Saudita |
| SN | Senegal |
| RS | Serbia |
| S.C. | Seychelles |
| SL | Sierra Leone |
| SG | Singapore |
| SK | Slovacchia |
| SI | Slovenia |
| S.B. | Isole Salomone |
| COSÌ | Somalia |
| ZA | Sudafrica |
| ES | Spagna |
| LK | Sri Lanka |
| SR | Suriname |
| SZ | Swaziland |
| SE | Svezia |
| CH | Svizzera |
| TW | Taiwan |
| TJ | Tagikistan |
| TZ | Tanzania |
| IL | Thailandia |
| TL | Timor Est |
| TG | Togo |
| TK | Tokelau |
| A | Tonga |
| TT | Trinidad e Tobago |
| TN | Tunisia |
| TR | Turchia |
| TM | Turkmenistan |
| TC | Isole Turks e Caicos |
| Televisore | Tuvalu |
| UG | Uganda |
| UA | Ucraina |
| AE | Emirati Arabi Uniti |
| GB | Regno Unito |
| IT | Stati Uniti |
| UY | Uruguay |
| UZ | Uzbekistan |
| VU | Vanuatu |
| VA | Città del Vaticano |
| VE | Venezuela |
| VN | Vietnam |
| VG | Isole Vergini Britanniche |
| VI | Isole Vergini Americane |
| Telefono | Wallis e Futuna |
| SÌ | Yemen |
| ZM | Zambia |
| ZW | Zimbabwe |