Partilhar via


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é

See Also

Mostrar Anúncios à Audiência de Destino