Segmentação geográfica

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.