Segmentação geográfica

O Google fornece informações de geolocalização pelo objeto Geo. Este documento descreve detalhes mais avançados sobre como o Google preenche a geolocalização em solicitações de lances e sugere práticas recomendadas para o uso.

Como o objeto Geo é preenchido

O Google só oferece suporte a informações de geolocalização que descrevem o local do dispositivo em que o anúncio seria renderizado, o que é exposto em BidRequest.device.geo. Essas informações de localização são obtidas apenas pela geolocalização de IP, nunca pelo GPS ou outras fontes.

Proteções de privacidade

Para proteger a privacidade do usuário, o Google só fornece uma geolocalização aproximada que é compartilhada por um número suficientemente grande de usuários, generalizando a localização detectada conforme necessário.

Representações de local

O objeto Geo oferece suporte a duas representações separadas de localização: localização civil e coordenadas geográficas.

Os 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

Ambas as representações contêm o mesmo local e a mesma precisão. Por exemplo, se uma solicitação de lance preencher BidRequest.device.geo com precisão de cidade, os campos lat e lon vão conter a latitude e a longitude do centro da cidade identificada, e accuracy será o raio de um círculo com a mesma área dessa cidade. O Google também limita a precisão dos campos lat e lon a 0,01 graus.

Práticas recomendadas para segmentação por geolocalização

Para os bidders que precisam de dados de geolocalização personalizados, recomendamos usar os campos aproximados lat, lon e accuracy para realizar pesquisas de geolocalização espacial. Não recomendamos o uso do campo BidRequest.device.ip para geolocalização, já que o Google só compartilha o endereço IP em forma truncada. O uso de endereços IP truncados para geolocalização pode resultar em resultados imprecisos.

Tabela geográfica (descontinuada)

O campo BidRequest.device.geo.ext.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 "Protos e dados de referência". O uso deste campo e da tabela correspondente foi descontinuado. Você pode usar BidRequest.device.geo para receber informações de geolocalização semelhantes.

Por exemplo, se uma solicitação de lance preencher geo com precisão de cidade, geo_criteria_id vai conter o código da cidade correspondente. É possível usar esse ID para localizar um registro na tabela geográfica.

Colunas

ID dos critérios
ID exclusivo e persistente 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ério.
ID pai
O ID de critérios de um pai. Esse campo é incluído para suporte legado, e os IDs podem não ser consistentes entre os conjuntos de dados. Os nomes canônicos são o método preferido de construção de hierarquias.
Código da região
O código de região ISO 3166-2 do estado ou província de segmentação, se houver.
Código do país
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
  • Outro
  • CEP
  • 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 às leis e regulamentações de publicidade da República Popular da China, você pode ser solicitado a fornecer certificados e licenças se estiver anunciando determinadas categorias de produtos na China. Não é necessário enviar certificados até que sua conta seja ativada. Quando sua conta estiver ativa, você vai receber informações sobre como enviar certificados ao Google.