Segmentação geográfica

O Google fornece informações de geolocalização por meio do objeto Geo, comum nos protocolos do OpenRTB e do Google. Este documento descreve detalhes de alto nível de como o Google preenche a geolocalização em solicitações de lance e sugere práticas recomendadas de uso.

Como o objeto Geo é preenchido

O Google só determina as localizações do dispositivo por geolocalização de IP, nunca por GPS ou outras origens. Embora a especificação do OpenRTB ofereça suporte a geolocalizações separadas para o usuário (por exemplo, endereço residencial) e o dispositivo (onde o dispositivo está quando o anúncio é veiculado), o Google só oferece suporte ao último. Consequentemente, a implementação do OpenRTB pelo Google preenche apenas BidRequest.device.geo, e o protocolo RTB descontinuado do Google só é compatível com um campo BidRequest.geo que se refere ao local do dispositivo.

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 é compatível com 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

Nos protocolos do Google e 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 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 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 aproximados lat, lon e accuracy 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 um pouco imprecisos.

Tabela geográfica (descontinuada)

O campo BidRequest.geo_criteria_id do protocolo RTB do Google descontinuado representa a geolocalização como um identificador numérico, que é mapeado para uma geolocalização no 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 desse campo e da tabela correspondente foi suspenso. Use o campo Geo para receber informações de geolocalização semelhantes.

Por exemplo, se uma solicitação de lance tiver Geo preenchido com precisão de nível de cidade, geo_criteria_id terá o código da cidade correspondente. Você pode usar esse ID para localizar um registro na tabela geográfica.

Coluna

ID dos critérios
ID atribuído exclusivo e persistente. 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 eliminar a ambiguidade de nomes de segmentação 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 preferencial para criar hierarquias.
Código da região
O código regional ISO 3166-2 para o estado ou província de destino, 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 referentes à publicidade da República Popular da China, talvez seja necessário apresentar certificados e licenças se estiver anunciando determinadas categorias de produto nesse país. Não é necessário enviar certificados até que sua conta seja ativada. Depois que sua conta estiver ativa, você receberá informações sobre como enviar certificados ao Google.