Codici di posizione geografica
I dati sulle posizioni geografiche possono essere usati per la destinazione della posizione, ad esempio per mostrare annunci a persone in un paese/area geografica specifico, stato/provincia, contea, area metropolitana (Area del mercato Microsoft nel Stati Uniti), codice postale o città. È possibile chiamare l'operazione GetGeoLocationsFileUrl per ottenere un URL di file temporaneo che può essere usato per scaricare i dati delle posizioni geografiche più recenti. È anche possibile ottenere i dati delle posizioni dal portale per sviluppatori di Microsoft Advertising. È necessario accedere al portale per sviluppatori con un utente dell'account Microsoft con credenziali di Microsoft Advertising.
Nota
Come procedura consigliata è consigliabile scaricare il file anziché aprirlo direttamente tramite un'applicazione come Microsoft Excel. Se si visualizzano i dati delle posizioni 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 posizioni geografiche, vedere Esempio di codice delle posizioni geografiche.
Formato file dei codici di posizione
Il file CSV (Comma Separated Value) contiene dati organizzati nelle intestazioni di colonna non localizzate seguenti. Solo il nome visualizzato Bing viene localizzato a seconda dell'URL del file usato in precedenza.
Importante
È possibile aggiungere nuove colonne in qualsiasi momento, quindi l'implementazione deve ignorare le colonne sconosciute.
L'ordine delle posizioni non è garantito, quindi non è consigliabile accettare dipendenze da qualsiasi ordinamento di colonna o gerarchia percepita.
Formato file versione 2.0
Se è stato specificato Version come 2.0 quando si chiama l'operazione GetGeoLocationsFileUrl , i dati seguenti sono disponibili nel file scaricato. Bing Ads'API attualmente supporta solo il formato di file versione 2.0.
| Column Name | Descrizione |
|---|---|
| ID percorso | Identificatore univoco del sistema Microsoft Advertising per la posizione. È necessario utilizzare questo valore per impostare il criterio di posizione. |
| Nome visualizzato Bing | Nome facoltativo che è possibile usare per visualizzare i dati delle posizioni, ad esempio per gli utenti dell'applicazione. Le barre verticali vengono usate per separare i componenti di posizione dalla più alla meno specifica. Ad esempio, dato Seattle|Washington|Stati Uniti il componente più specifico è la città di Seattle all'interno dello stato di Washington del Stati Uniti. Più ID percorso possono avere lo stesso nome visualizzato. Non è necessario usare il nome visualizzato per elementi diversi dalla presentazione, ad esempio non si presuppone alcuna gerarchia o non si accettano dipendenze dal nome visualizzato. |
| Tipo di posizione | Determina il sottotipo di posizione (ad esempio, Città, Contea, Paese, MetroArea, PostalCode o Stato) che corrisponde alla colonna Id posizione. Le località del quartiere saranno presto disponibili. È possibile aggiungere nuovi sottotipi di posizione in qualsiasi momento. Raramente il tipo di posizione cambia per un DETERMINATO ID posizione. |
| Sostituisce | Riservato per l'uso futuro per indicare la posizione o le posizioni sostituite dalla posizione in questa riga. |
| Stato | Indica se il percorso in questa riga è attivo, in sospeso o deprecato. - Attivo: è possibile impostare come destinazione o escludere la posizione. - Deprecation in sospeso: il percorso viene ancora usato dal motore di recapito per la destinazione o le esclusioni; tuttavia, il percorso verrà deprecato entro i prossimi 30 giorni. - Deprecato: il criterio di posizione non viene più usato per la destinazione o le esclusioni. I criteri di posizione deprecati possono comunque essere recuperati tramite l'API Bing Ads, ad esempio GetCampaignCriterionsByIds, ma non è possibile aggiungere o aggiornare i 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 stato modificato dall'ultima sincronizzazione dei dati delle posizioni. |
| ID percorso AdWords | ID posizione di Google Ads che corrisponde più vicino all'ID posizione geografica di Microsoft Advertising. Puoi usarlo per eseguire il mapping delle posizioni di Microsoft Advertising alle località di Google Ads stimate. Questo valore è una stima euristica che può essere usata 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 di 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 |
| ALE | Albania |
| DZ | Algeria |
| COME | Samoa americane |
| ANNUNCIO | Andorra |
| AO | Angola |
| Intelligenza artificiale | Anguilla |
| AQ | Antartide |
| ARGENTUM | Antigua e Barbuda |
| AR | Argentina |
| SONO | Armenia |
| AW | Aruba |
| AU | Australia |
| AT | Austria |
| AZ | Azerbaigian |
| B | Bahamas, Il |
| BH | Bahrein |
| BD | Bangladesh |
| BB | Barbados |
| PRESSO | Bielorussia |
| ESSERE | Belgio |
| BZ | Belize |
| BJ | Benin |
| BM | Bermuda |
| BT | Bhutan |
| BO | Bolivia |
| UN | Bonaire, Curaçao, Saba, Sint Eustatius, Sint Maarten |
| BA | Bosnia ed Erzegovina |
| BW | Botswana |
| BR | Brasile |
| BN | Brunei |
| BG | Bulgaria |
| BF | Burkina Faso |
| BI | Burundi |
| CV | Cabo Verde |
| KH | Cambogia |
| CENTIMETRO | Camerun |
| CA | Canada |
| KY | Isole Cayman |
| CFR | Repubblica Centrafricana |
| TD | Ciad |
| CL | Cile |
| CN | Cina |
| CX | Isola Christmas |
| CC | Isole Cocos (Keeling) |
| CO | Colombia |
| CHILOMETRO | 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 |
| DJ | Gibuti |
| DECIMETRO | Dominica |
| FARE | Repubblica dominicana |
| CE | Ecuador |
| Ad esempio | Egitto |
| SV | El Salvador |
| GQ | Guinea Equatoriale |
| ER | Eritrea |
| EE | Estonia |
| ET | Etiopia |
| FK | Isole Falkland |
| FO | Isole Fær Øer |
| FJ | Isole 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 |
| GP | Guadalupa |
| GU | Guam |
| GT | Guatemala |
| GN | Guinea |
| GW | Guinea-Bissau |
| GY | 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 SAR |
| MK | Macedonia del Nord, ex Repubblica Jugoslava di Macedonia |
| MG | Madagascar |
| MW | Malawi |
| MIO | Malaysia |
| MV | Maldive |
| ML | Mali |
| MT | Malta |
| MH | Isole Marshall |
| MQ | Martinica |
| SIGNOR | Mauritania |
| MU | Mauritius |
| YT | Mayotte |
| MX | Messico |
| FM | Micronesia |
| MD | Moldova |
| MC | Monaco |
| MN | Mongolia |
| ME | Montenegro |
| MS | Montserrat |
| MAMMA | Marocco |
| MZ | Mozambico |
| MILLIMETRO | Myanmar |
| ND | Namibia |
| NR | Nauru |
| NP | Nepal |
| NL | Paesi Bassi |
| NC | Nuova Caledonia |
| NZ | Nuova Zelanda |
| NI | Nicaragua |
| NE | Niger |
| NG | Nigeria |
| NU | Niue |
| NF | Isola Norfolk |
| MP | Isole Marianne settentrionali |
| NO | Norvegia |
| OM | Oman |
| PK | Pakistan |
| Prigioniero di guerra | Palau |
| PS | Autorità Palestinese |
| BABBO | Panamá |
| PG | Papua Nuova Guinea |
| PY | Paraguay |
| PE | Perù |
| PH | Filippine |
| PN | Isole Pitcairn |
| PL | Polonia |
| PT | Portogallo |
| PR | Portorico |
| QA | Qatar |
| RI | Riunione |
| RO | Romania |
| RU | Russia |
| RW | Ruanda |
| ZITTO | Sant'Elena |
| KN | Saint Kitts e Nevis |
| LC | Saint Lucia |
| PM | Saint-Pierre e Miquelon |
| VC | Saint Vincent e Grenadine |
| WS | Samoa |
| SM | San Marino |
| SAN | Sao Tomé e Príncipe |
| SA | Arabia Saudita |
| SN | Senegal |
| RS | Serbia |
| SC | Seychelles |
| SL | Sierra Leone |
| SG | Singapore |
| SK | Slovacchia |
| SI | Slovenia |
| SB | 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 |
| ESIMO | 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 |
| TV | Tuvalu |
| UG | Uganda |
| UA | Ucraina |
| Æ | 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, Stati Uniti |
| WF | Wallis e Futuna |
| VOI | Yemen |
| ZM | Zambia |
| ZW | Zimbabwe |