O Google fornece informações de geolocalização por meio do objeto Geo
, comum aos protocolos do OpenRTB e do Google. Este documento descreve detalhes de alto nível sobre como o Google preenche a geolocalização em solicitações de lance e sugere práticas recomendadas para seu uso.
Como o objeto "Geográfico" é preenchido
O Google só analisa a localização dos dispositivos pela geolocalização por IP, nunca pelo GPS
ou outras origens. Embora a especificação OpenRTB ofereça suporte a geolocalizações separadas para o usuário (por exemplo, endereço de casa) e o dispositivo (onde o dispositivo está quando o anúncio está sendo veiculado), o Google só oferece suporte a essa última opção. Consequentemente, o protocolo do Google contém apenas um objeto Geo
em BidRequest.geo
; e para o OpenRTB, o Google preencherá apenas o campo Device.geo
.
Os campos do objeto Geo
são preenchidos de forma idêntica em ambos os protocolos. Os campos a seguir existem apenas na variante OpenRTB do objeto Geo
. Eles nunca são preenchidos pelo Google em nenhum dos protocolos: regionfips104
, lastfix
, type
e ipservice
. A maioria dos campos não aceitos acima está relacionada a origens de locais alternativas.
Proteções de privacidade
Para proteger a privacidade do usuário, o Google só oferece uma geolocalização aproximada que é compartilhada por um número suficiente de usuários, generalizando o local detectado conforme necessário.
Representações de local
O objeto Geo
é compatível com duas representações separadas de local: localização civil e coordenadas geográficas.
Locais civis são representados pelos seguintes campos:
country
region
metro
city
zip
As coordenadas geográficas são representadas pelos seguintes campos:
lat
lon
accuracy
Tanto nos protocolos do Google quanto do OpenRTB, as duas representações contêm o mesmo local e precisão. Por exemplo, se uma solicitação de lance preencher Geo
com precisão no nível da cidade, os campos lat
e lon
conterão a latitude e a longitude do ponto central da cidade identificada, e accuracy
será o raio de um círculo com a mesma área que essa cidade. O Google também limita a precisão dos campos lat
e lon
a 0,01 grau.
Práticas recomendadas para segmentação por geolocalização
Para bidders que precisam de dados de geolocalização personalizados, recomendamos usar os campos lat
, lon
e accuracy
aproximados para realizar pesquisas de geolocalização espacial.
Não recomendamos o uso do campo ip
para geolocalização, já que o Google só compartilha o endereço IP de forma truncada. O uso de endereços IP truncados para geolocalização pode resultar em resultados imprecisos.
A tabela geográfica
O campo geo_criteria_id
representa a geolocalização como um identificador numérico, que é mapeado para uma geolocalização em geo-table.csv, disponível para download na
seção "Tabelas de referência" da página "Protocolos e dados de referência". O uso desse campo e da tabela correspondente foi descontinuado. Use o campo Geo
descrito acima para ter informações de geolocalização semelhantes. Por exemplo, se uma solicitação de lance tiver Geo
preenchido com precisão no nível da cidade, geo_criteria_id
conterá o código da cidade correspondente. Use esse ID para localizar um
registro na tabela geográfica.
Colunas
- ID dos critérios
- ID exclusivo e permanente atribuído. Na API, esses critérios são do tipo
Location
. - Nome
- Melhor nome em inglês disponível para a segmentação por área geográfica.
- Nome canônico
- O nome em inglês completo que consiste em nome da segmentação, nome da segmentação pai e país. Este campo é destinado apenas para esclarecer a ambiguidade com nomes de segmentações semelhantes. Ele não é compatível com LocationCriterionService (use nomes de local ou IDs de critérios).
- ID pai
- O ID de critérios de um pai. Esse campo está incluído no suporte legado, e os IDs podem não ser consistentes entre conjuntos de dados. Os nomes canônicos são o método preferido para criar hierarquias.
- Código da região
- O código de região ISO 3166-2 para a segmentação por estado ou província, se houver.
- Country Code
- O código de país ISO-3166-1-alpha-2 associado à segmentação.
- Tipo de segmentação
Valores permitidos:
- Aeroporto
- Arrondissement
- Comunidade autônoma
- Município
- Distrito
- Cidade
- Região da cidade
- Distrito congressional
- País
- Condado
- Departamento
- Distrito
- Região de AMD
- Província
- Metro
- Municipalidade
- Parque nacional
- Vizinhança
- Okrug
- Outros
- Código postal
- Município
- Província
- Região
- Estado
- Território
- Região da TV
- Território da União
- Universidade
Locais não segmentáveis
Devido a leis e regulamentações de publicidade da República Popular da China, talvez seja necessário fornecer certificados e licenças se estiver anunciando determinadas categorias de produtos nesse país. Você só precisa enviar os certificados depois que sua conta for ativada. Quando sua conta estiver ativa, você receberá informações sobre como enviar certificados ao Google.