Códigos de Localização Geográfica
Os dados de localizações geográficas podem ser utilizados para o Destino da Localização, por exemplo, mostrar anúncios a pessoas num país/região específico, distrito, concelho, área metropolitana (Área de Mercado da Microsoft no Estados Unidos), código postal ou cidade. Pode chamar a operação GetGeoLocationsFileUrl para obter um URL de ficheiro temporário que pode ser utilizado para transferir os dados de localizações geográficas mais recentes. Também pode obter os dados de localizações a partir do Portal do Programador do Microsoft Advertising. Tem de ter sessão iniciada no portal do programador com um utilizador da conta Microsoft que tenha credenciais do Microsoft Advertising.
Nota
Como melhor prática, deve transferir o ficheiro em vez de o abrir diretamente através de uma aplicação como o Microsoft Excel. Se vir os dados de localizações num editor de texto, certifique-se de que utiliza a codificação UTF-8 em vez de ANSI. Caso contrário, alguns carateres não serão apresentados com precisão.
Para obter exemplos de código que demonstram como transferir os códigos de localizações geográficas, veja Exemplo de Código de Localizações Geográficas.
Formato de Ficheiro de Códigos de Localização
O ficheiro de valores separados por vírgulas (CSV) contém dados organizados nos seguintes cabeçalhos de coluna não localizados. Apenas o Nome a Apresentar do Bing é localizado consoante o URL de ficheiro utilizado acima.
Importante
Podem ser adicionadas novas colunas em qualquer altura, pelo que a sua implementação tem de ignorar colunas desconhecidas.
A ordem das localizações não é garantida, pelo que não deve assumir dependências em nenhuma sequência ou hierarquia de ordenação de colunas percebida.
Formato de Ficheiro Versão 2.0
Se especificou a Versão como 2.0 ao chamar a operação GetGeoLocationsFileUrl , os seguintes dados estão disponíveis no ficheiro transferido. Atualmente, a API de Anúncios do Bing só suporta a versão 2.0 do formato de ficheiro.
| Nome da Coluna | Descrição |
|---|---|
| ID da Localização | O identificador exclusivo do sistema de Publicidade da Microsoft para a localização. Tem de utilizar este valor para definir o critério de localização. |
| Nome a Apresentar do Bing | O nome opcional que pode utilizar para apresentar os dados de localizações, por exemplo, aos utilizadores da sua aplicação. As barras verticais são utilizadas para separar os componentes de localização dos mais específicos para os menos específicos. Por exemplo, em Seattle|Washington|Estados Unidos componente mais específico é a cidade de Seattle, no estado de Washington, na Estados Unidos. Vários IDs de localização podem ter o mesmo nome a apresentar. Não pode utilizar o nome a apresentar para nada além da apresentação. Por exemplo, não assuma nenhuma hierarquia nem assuma quaisquer dependências no nome a apresentar. |
| Tipo de Localização | Determina o subtipo de localização (por exemplo, Cidade, Condado, País, MetroArea, Código Postal ou Estado) que corresponde à coluna ID da Localização. As localizações da vizinhança estão para breve. Podem ser adicionados novos subtipos de localização em qualquer altura. Raramente o tipo de localização será alterado para um determinado ID de localização. |
| Substitui | Reservado para utilização futura para indicar que localizações ou localizações são substituídas pela localização nesta linha. |
| Estado | Indica se a localização nesta linha está ativa, pendente de preterição ou preterida. - Ativo: pode direcionar ou excluir a localização. - Preterição Pendente: a localização continua a ser utilizada pelo motor de entrega para filtragem ou exclusões; no entanto, a localização será preterida nos próximos 30 dias. - Preterido: o critério de localização já não é utilizado para filtragem ou exclusões. Os critérios de localização preteridos ainda podem ser obtidos através da API de Anúncios do Bing, por exemplo, GetCampaignCriterionsByIds, mas não pode adicionar ou atualizar critérios de localização preteridos. Considere chamar a operação GetGeoLocationsFileUrl uma ou duas vezes por mês para determinar se o conteúdo do ficheiro foi alterado, por exemplo, estado. Não deve ter de transferir todo o ficheiro, a menos que o valor lastModifiedTimeUtc devolvido tenha sido alterado desde a última vez que sincronizou os dados das localizações. |
| ID de Localização do AdWords | O ID de localização do Google Ads que corresponde mais próximo do ID de localização geográfica do Microsoft Advertising. Pode utilizá-lo para mapear localizações do Microsoft Advertising para as localizações estimadas do Google Ads. Este valor é uma estimativa heurística que pode ser utilizada para mapear as localizações geográficas do Google Ads e do Microsoft Advertising. O campo está vazio se a localização não tiver sido mapeada. |
Códigos de País
Em alguns contextos, a API requer uma cadeia de código de país, por exemplo, para o endereço empresarial de um objeto AdvertiserAccount . Os seguintes códigos de país são suportados pelo Microsoft Advertising.
| Código do País | Nome do País/Região |
|---|---|
| AF | Afeganistão |
| AL | Albânia |
| DZ | Argélia |
| AS | Samoa Americana |
| AD | Andorra |
| AO | Angola |
| IA | Anguila |
| AQ | Antárctica |
| AG | Antígua e Barbuda |
| AR | Argentina |
| AM | Arménia |
| AW | Aruba |
| AU | Austrália |
| AT | Áustria |
| AZ | Azerbaijão |
| BS | Bahamas, The |
| BH | Barém |
| BD | Bangladeche |
| BB | Barbados |
| BY | Bielorrússia |
| BE | Bélgica |
| BZ | Belize |
| BJ | Benim |
| BM | Bermudas |
| BT | Butão |
| BO | Bolívia |
| AN | Bonaire, Curaçao, Saba, Sint Eustatius, Sint Maarten |
| BA | Bósnia e Herzegovina |
| BW | Botsuana |
| BR | Brasil |
| BN | Brunei |
| BG | Bulgária |
| BF | Burquina Faso |
| BI | Burundi |
| CV | Cabo Verde |
| KH | Camboja |
| CM | Camarões |
| AC | Canadá |
| KY | Ilhas Caimão |
| CF | República Centro-Africana |
| TD | Chade |
| CL | Chile |
| CN | China |
| CX | Ilha do Natal |
| CC | Ilhas dos Cocos (Keeling) |
| CO | Colômbia |
| KM | Comores |
| CG | Congo |
| CD | República Democrática do Congo |
| CK | Ilhas Cook |
| CR | Costa Rica |
| CI | Côte d'Ivoire |
| RH | Croácia |
| CY | Chipre |
| CZ | República Checa |
| DK | Dinamarca |
| DJ | Jibuti |
| DM | Domínica |
| DO | República Dominicana |
| EC | Equador |
| Por exemplo, | Egito |
| SV | Salvador |
| GQ | Guiné Equatorial |
| ER | Eritreia |
| EE | Estónia |
| ET | Etiópia |
| FK | Ilhas Falkland (Malvinas) |
| FO | Ilhas Faroé |
| FJ | Ilhas Fiji |
| FI | Finlândia |
| FR | França |
| GF | Guiana Francesa |
| PF | Polinésia Francesa |
| Agente Convidado | Gabão |
| GM | Gâmbia, O |
| GE | Geórgia |
| DE | Alemanha |
| GH | Gana |
| GI | Gibraltar |
| GR | Grécia |
| GL | Gronelândia |
| GD | Granada |
| GP | Guadalupe |
| GU | Guame |
| GT | Guatemala |
| GN | Guiné |
| GW | Guiné-Bissau |
| GY | Guiana |
| HT | Haiti |
| HN | Honduras |
| HK | RAE de Hong Kong |
| HU | Hungria |
| IS | Islândia |
| IN | Índia |
| ID | Indonésia |
| QI | Iraque |
| IE | Irlanda |
| IL | Israel |
| TI | Itália |
| JM | Jamaica |
| JP | Japão |
| JO | Jordânia |
| KZ | Cazaquistão |
| KE | Quénia |
| KI | Quiribáti |
| KR | Coreia |
| KW | Kuwait |
| KG | Quirguizistão |
| LA | Laos |
| LV | Letónia |
| LB | Líbano |
| LS | Lesoto |
| LR | Libéria |
| LY | Líbia |
| LI | Listenstaine |
| LT | Lituânia |
| LU | Luxemburgo |
| MO | RAE de Macau |
| MK | Macedónia do Norte, Antiga República Jugoslava de |
| MG | Madagáscar |
| MW | Maláui |
| O MEU | Malásia |
| MV | Maldivas |
| ML | Mali |
| MT | Malta |
| MH | Ilhas Marshall |
| MQ | Martinica |
| MR | Mauritânia |
| MU | Maurícia |
| YT | Maiote |
| MX | México |
| FM | Micronésia |
| MD | Moldova |
| MC | Mónaco |
| MN | Mongólia |
| ME | Montenegro |
| MS | Monserrate |
| MA | Marrocos |
| Rede de perímetro | Moçambique |
| MM | Mianmar |
| NA | Namíbia |
| NR | Nauru |
| NP | Nepal |
| NL | Países Baixos |
| NC | Nova Caledónia |
| NZ | Nova Zelândia |
| NI | Nicarágua |
| NE | Níger |
| NG | Nigéria |
| NU | Niuê |
| NF | Ilha Norfolk |
| MP | Ilhas Marianas do Norte |
| NÃO | Noruega |
| OM | Omã |
| PK | Paquistão |
| PW | Palau |
| PS | Autoridade Palestiniana |
| PA | Panamá |
| PG | Papua-Nova Guiné |
| PY | Paraguai |
| PE | Peru |
| PH | Filipinas |
| PN | Ilhas Pitcairn |
| PL | Polónia |
| PT | Portugal |
| PR | Porto Rico |
| QA | Catar |
| RE | Reunião |
| RO | Roménia |
| RU | Rússia |
| RW | Ruanda |
| SH | Santa Helena |
| KN | São Cristóvão e Neves |
| LC | Santa Lúcia |
| PM | São Pedro e Miquelão |
| VC | São Vicente e Granadinas |
| WS | Samoa |
| SM | San Marino |
| ST | São Tomé e Príncipe |
| SA | Arábia Saudita |
| SN | Senegal |
| RS | Sérvia |
| SC | Seicheles |
| SL | Serra Leoa |
| SG | Singapura |
| SK | Eslováquia |
| SI | Eslovénia |
| SB | Ilhas Salomão |
| SO | Somália |
| ZA | África do Sul |
| ES | Espanha |
| LK | Sri Lanka |
| SR | Suriname |
| SZ | Suazilândia |
| SE | Suécia |
| CH | Suíça |
| TW | Taiwan |
| TJ | Tajiquistão |
| TZ | Tanzânia |
| TH | Tailândia |
| TL | Timor-Leste |
| TG | Togo |
| TK | Toquelau |
| PARA | Tonga |
| TT | Trindade e Tobago |
| TN | Tunísia |
| TR | Türkiye |
| TM | Turquemenistão |
| TC | Ilhas Turcas e Caicos |
| TV | Tuvalu |
| UG | Uganda |
| UA | Ucrânia |
| AE | Emirados Árabes Unidos |
| GB | Reino Unido |
| E.U.A | Estados Unidos |
| UY | Uruguai |
| UZ | Usbequistão |
| VU | Vanuatu |
| VA | Cidade do Vaticano |
| VE | Venezuela |
| VN | Vietname |
| VG | Ilhas Virgens, Britânicas |
| VI | Ilhas Virgens, E.U.A. |
| WF | Wallis e Futuna |
| VÓS | Iémen |
| ZM | Zâmbia |
| ZW | Zimbabué |