Códigos de ubicación geográfica
Los datos de ubicaciones geográficas se pueden usar para la segmentación de ubicación, por ejemplo, mostrar anuncios a personas de un país o región específicos, estado o provincia, condado, área metropolitana (Área del mercado de Microsoft en el Estados Unidos), código postal o ciudad. Puede llamar a la operación GetGeoLocationsFileUrl para obtener una dirección URL de archivo temporal que se puede usar para descargar los datos de ubicaciones geográficas más recientes. También puede obtener los datos de ubicaciones del Portal para desarrolladores de Microsoft Advertising. Debe iniciar sesión en el portal para desarrolladores con un usuario de cuenta Microsoft que tenga credenciales de Microsoft Advertising.
Nota:
Como procedimiento recomendado, debe descargar el archivo en lugar de abrirlo directamente a través de una aplicación como Microsoft Excel. Si ve los datos de ubicaciones en un editor de texto, asegúrese de usar la codificación UTF-8 en lugar de ANSI; de lo contrario, algunos caracteres no se mostrarán con precisión.
Para ver ejemplos de código que muestran cómo descargar los códigos de ubicaciones geográficas, vea Ejemplo de código de ubicaciones geográficas.
Formato de archivo de códigos de ubicación
El archivo de valores separados por comas (CSV) contiene datos organizados en los siguientes encabezados de columna no localizados. Solo el nombre para mostrar de Bing se localiza en función de la dirección URL del archivo usada anteriormente.
Importante
Las nuevas columnas se pueden agregar en cualquier momento, por lo que la implementación debe omitir columnas desconocidas.
El orden de las ubicaciones no está garantizado, por lo que no debe tomar dependencias en ningún criterio de ordenación de columna o jerarquía percibido.
Formato de archivo versión 2.0
Si especificó Version como 2.0 al llamar a la operación GetGeoLocationsFileUrl , los siguientes datos están disponibles en el archivo descargado. Bing Ads API solo admite actualmente la versión 2.0 del formato de archivo.
| Nombre de columna | Descripción |
|---|---|
| Id. de ubicación | Identificador único del sistema de Microsoft Advertising para la ubicación. Debe usar este valor para establecer el criterio de ubicación. |
| Nombre para mostrar de Bing | Nombre opcional que puede usar para mostrar los datos de ubicaciones, por ejemplo, para los usuarios de la aplicación. Las barras verticales se usan para separar los componentes de ubicación de más a menos específicos. Por ejemplo, dado Seattle|Washington|Estados Unidos el componente más específico es la ciudad de Seattle dentro del estado de Washington del Estados Unidos. Varios identificadores de ubicación pueden tener el mismo nombre para mostrar. No debe usar el nombre para mostrar para nada distinto de la presentación, por ejemplo, no suponga ninguna jerarquía ni tome dependencias en el nombre para mostrar. |
| Tipo de ubicación | Determina el subtipo de ubicación (por ejemplo, Ciudad, Condado, País, MetroArea, Código Postal o Estado) que corresponde a la columna Id. de ubicación. Las ubicaciones del vecindario están próximamente. Los nuevos subtipos de ubicación se pueden agregar en cualquier momento. En raras ocasiones, el tipo de ubicación cambiará para un identificador de ubicación determinado. |
| Reemplaza | Reservado para uso futuro para indicar qué ubicación o ubicaciones se reemplazan por la ubicación de esta fila. |
| Estado | Indica si la ubicación de esta fila está activa, pendiente de desuso o en desuso. - Activo: puede seleccionar como destino o excluir la ubicación. - En desuso pendiente: el motor de entrega sigue usando la ubicación para la selección de destino o exclusiones; sin embargo, la ubicación quedará en desuso en los próximos 30 días. - En desuso: el criterio de ubicación ya no se usa para la selección de destino o las exclusiones. Los criterios de ubicación en desuso se pueden recuperar a través de la API de Bing Ads, por ejemplo, GetCampaignCriterionsByIds, pero no se pueden agregar ni actualizar criterios de ubicación en desuso. Considere la posibilidad de llamar a la operación GetGeoLocationsFileUrl una o dos veces al mes para determinar si el contenido del archivo ha cambiado, por ejemplo, el estado. No es necesario descargar todo el archivo a menos que el valor Devuelto LastModifiedTimeUtc haya cambiado desde la última vez que sincronizó los datos de ubicaciones. |
| Id. de ubicación de AdWords | El identificador de ubicación de Google Ads que coincide con el más cercano al identificador de ubicación geográfica de Microsoft Advertising. Puede usarlo para asignar ubicaciones de Microsoft Advertising a las ubicaciones estimadas de Google Ads. Este valor es una estimación heurística que se puede usar para asignar ubicaciones geográficas de Google Ads y Microsoft Advertising. El campo está vacío si la ubicación no se ha asignado. |
Códigos de país
En algunos contextos, la API requiere una cadena de código de país, por ejemplo, para la dirección de negocio de un objeto AdvertiserAccount . Microsoft Advertising admite los siguientes códigos de país.
| Country Code | Nombre de país o región |
|---|---|
| AF | Afganistán |
| AL | Albania |
| DZ | Argelia |
| AS | Samoa Americana |
| ANUNCIO | Andorra |
| AO | Angola |
| AI | Anguila |
| AQ | Antártida |
| AG | Antigua y Barbuda |
| AR | Argentina |
| SOY | Armenia |
| AW | Aruba |
| AU | Australia |
| AT | Austria |
| AZ | Azerbaiyán |
| BS | Bahamas, El |
| BH | Baréin |
| BD | Bangladesh |
| BB | Barbados |
| POR | Belarús |
| SER | Bélgica |
| BZ | Belice |
| BJ | Benín |
| BM | Bermudas |
| BT | Bután |
| BO | Bolivia |
| UN | Bonaire, Curaçao, Saba, Sint Eustatius, Sint Maarten |
| BA | Bosnia y Herzegovina |
| BW | Botsuana |
| BR | Brasil |
| BN | Brunéi |
| BG | Bulgaria |
| BF | Burkina Faso |
| BI | Burundi |
| VC | Cabo Verde |
| KH | Camboya |
| CM | Camerún |
| CA | Canada |
| KY | Islas Caimán |
| CF | República Centroafricana |
| TD | Chad |
| CL | Chile |
| CN | China |
| CX | Isla de Navidad |
| CC | Islas Cocos |
| CO | Colombia |
| KM | Comoras |
| CG | Congo |
| CD | Congo (RDC) |
| CK | Islas Cook |
| CR | Costa Rica |
| CI | Côte d'Ivoire |
| HR | Croacia |
| CY | Chipre |
| CZ | Chequia |
| DK | Dinamarca |
| DJ | Yibuti |
| DM | Dominica |
| HACER | República Dominicana |
| CE | Ecuador |
| EG | Egipto |
| SV | El Salvador |
| GQ | Guinea Ecuatorial |
| EMERGENCIA | Eritrea |
| EE | Estonia |
| ET | Etiopía |
| FK | Islas Malvinas |
| FO | Islas Feroe |
| FJ | Islas Fiji |
| FI | Finlandia |
| FR | Francia |
| GF | Guayana Francesa |
| PF | Polinesia Francesa |
| GA | Gabón |
| GM | Gambia, el |
| GE | Georgia |
| DE | Alemania |
| GH | Ghana |
| GI | Gibraltar |
| GR | Grecia |
| GL | Groenlandia |
| GD | Granada |
| GP | Guadalupe |
| GU | Guam |
| Gt | Guatemala |
| GN | Guinea |
| GW | Guinea-Bisáu |
| GY | Guyana |
| HT | Haití |
| HN | Honduras |
| HK | RAE de Hong Kong |
| HU | Hungría |
| ES | Islandia |
| EN | India |
| Id. | Indonesia |
| IQ | Irak |
| IE | Irlanda |
| IL | Israel |
| TI | Italia |
| JM | Jamaica |
| JP | Japón |
| JO | Jordania |
| KZ | Kazajistán |
| KE | Kenia |
| KI | Kiribati |
| KR | Corea |
| KW | Kuwait |
| KG | Kirguistán |
| LA | Laos |
| LV | Letonia |
| LB | Líbano |
| LS | Lesoto |
| LR | Liberia |
| LY | Libia |
| LI | Liechtenstein |
| LT | Lituania |
| LU | Luxemburgo |
| MO | Macao SAR |
| MK | Macedonia del Norte, Ex República Yugoslava de |
| MG | Madagascar |
| MW | Malaui |
| MI | Malasia |
| MV | Maldivas |
| ML | Mali |
| MT | Malta |
| MH | Islas Marshall |
| MQ | Martinica |
| SR | Mauritania |
| MU | Mauricio |
| YT | Mayotte |
| MX | México |
| FM | Micronesia |
| MD | Moldova |
| MC | Mónaco |
| MN | Mongolia |
| YO | Montenegro |
| SRA | Montserrat |
| MA | Marruecos |
| MZ | Mozambique |
| MM | Myanmar |
| ND | Namibia |
| NR | Nauru |
| NP | Nepal |
| NL | Países Bajos |
| NC | Nueva Caledonia |
| NZ | Nueva Zelanda |
| NI | Nicaragua |
| NE | Níger |
| NG | Nigeria |
| NU | Niue |
| NF | Isla Norfolk |
| MP | Islas Marianas del Norte |
| NO | Noruega |
| OM | Omán |
| PK | Pakistán |
| PW | Palaos |
| PS | Autoridad Nacional Palestina |
| PA | Panamá |
| PG | Papúa-Nueva Guinea |
| PY | Paraguay |
| PE | Perú |
| PH | Filipinas |
| PN | Islas Pitcairn |
| PL | Polonia |
| PT | Portugal |
| PR | Puerto Rico |
| QA | Qatar |
| RE | Reunión |
| RO | Rumanía |
| RU | Rusia |
| RW | Ruanda |
| SH | Santa Elena |
| KN | San Cristóbal y Nieves |
| LC | Santa Lucía |
| PM | San Pedro y Miquelón |
| VC | San Vicente y las Granadinas |
| WS | Samoa |
| SM | San Marino |
| ST | Santo Tomé y Príncipe |
| SA | Arabia Saudí |
| SN | Senegal |
| RS | Serbia |
| SC | Seychelles |
| SL | Sierra Leona |
| SG | Singapur |
| SK | Eslovaquia |
| SI | Eslovenia |
| SB | Islas Salomón |
| Así que | Somalia |
| ZA | Sudáfrica |
| ES | España |
| LK | Sri Lanka |
| SR | Surinam |
| SZ | Suazilandia |
| SE | Suecia |
| CH | Suiza |
| TW | Taiwán |
| TJ | Tayikistán |
| TZ | Tanzania |
| TH | Tailandia |
| TL | Timor-Leste |
| TG | Togo |
| TK | Tokelau |
| PARA | Tonga |
| TT | Trinidad y Tobago |
| TN | Túnez |
| TR | Türkiye |
| TM | Turkmenistán |
| TC | Islas Turcas y Caicos |
| TV | Tuvalu |
| UG | Uganda |
| UA | Ucrania |
| AE | Emiratos Árabes Unidos |
| GB | Reino Unido |
| EE. UU. | Estados Unidos |
| UY | Uruguay |
| UZ | Uzbekistán |
| VU | Vanuatu |
| VA | Ciudad del Vaticano |
| VE | Venezuela |
| VN | Vietnam |
| VG | Islas Vírgenes Británicas |
| VI | Islas Vírgenes, Estados Unidos |
| WF | Wallis y Futuna |
| VOSOTROS | Yemen |
| ZM | Zambia |
| ZW | Zimbabue |