Segmentação geográfica

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

Como o objeto Geo é preenchido

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

Proteções de privacidade

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

Representações de local

O objeto Geo oferece suporte a duas representações separadas de local: 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 acurácia. Por exemplo, se uma solicitação de bid preencher BidRequest.device.geo com precisão no nível da cidade, os campos lat e lon vão conter a latitude e a longitude do ponto central 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 grau.

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 fazer pesquisas de geolocalização espacial. Não recomendamos o uso do campo BidRequest.device.ip para geolocalização, já que o Google compartilha apenas o endereço IP de forma truncada. O uso de endereços IP truncados para geolocalização pode resultar em resultados um pouco imprecisos.

A 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. Esse arquivo está disponível para download na seção "Tabelas de referência" da página "Protos e dados de referência". Esse campo e a tabela correspondente foram descontinuados. Use BidRequest.device.geo para receber informações de geolocalização semelhantes.

Por exemplo, se uma solicitação de lance preencher geo com precisão no nível da cidade, o geo_criteria_id vai 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 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 locais ou IDs de critérios).
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 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 para o estado ou província segmentada, 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 regulamentações e leis de publicidade da República Popular da China, talvez seja necessário fornecer certificados e licenças se você estiver anunciando determinadas categorias de produtos no país. Não é necessário enviar certificados até que sua conta seja ativada. Depois que sua conta for ativada, você vai receber informações sobre como enviar certificados ao Google.