Google proporciona información de ubicación geográfica a través del objeto Geo
. En este documento, se describen detalles de nivel superior sobre cómo Google propaga la geolocalización en las solicitudes de ofertas y se sugieren prácticas recomendadas para su uso.
Cómo se completa el objeto Geo
Google solo admite información de geolocalización que describa la ubicación del dispositivo en el que se renderizará el anuncio, que se expone en BidRequest.device.geo
. Esta información de ubicación solo se obtiene de la geolocalización de IP, nunca del GPS ni de otras fuentes.
Protecciones de la privacidad
Para proteger la privacidad del usuario, Google solo proporciona una geolocalización aproximada que comparte una cantidad suficientemente grande de usuarios, generalizando la ubicación detectada según sea necesario.
Representaciones de ubicación
El objeto Geo
admite dos representaciones separadas de la ubicación: la ubicación
civil y las coordenadas geográficas.
Las ubicaciones civiles se representan con los siguientes campos:
country
region
metro
city
zip
Las coordenadas geográficas se representan con los siguientes campos:
lat
lon
accuracy
Ambas representaciones contienen la misma ubicación y precisión. Por ejemplo, si una solicitud de oferta propaga BidRequest.device.geo
con precisión a nivel de la ciudad, los campos lat
y lon
contendrán la latitud y la longitud del punto central de la ciudad identificada, y accuracy
será el radio de un círculo con el mismo área que esa ciudad. Google también limita la precisión de los campos lat
y lon
a 0.01 grados.
Prácticas recomendadas para la segmentación por geolocalización
En el caso de los ofertantes que necesitan datos de ubicación geográfica personalizados, te recomendamos que uses los campos aproximados lat
, lon
y accuracy
para realizar búsquedas de ubicación geográfica espacial.
No recomendamos el uso del campo BidRequest.device.ip
para la geolocalización, ya que Google solo comparte la dirección IP de forma truncada. El uso de direcciones IP truncadas para la geolocalización puede generar resultados poco precisos.
La tabla geográfica (obsoleto)
El campo BidRequest.device.geo.ext.geo_criteria_id
representa la geolocalización como un identificador numérico, que se asigna a una geolocalización en geo-table.csv, disponible para descargar en la sección Tablas de referencia de la página Protos y datos de referencia. Este campo y la tabla correspondiente ahora están obsoletos. Puedes usar BidRequest.device.geo
para obtener información de geolocalización similar.
A modo de ejemplo, si una solicitud de oferta propaga geo
con precisión a nivel de la ciudad, geo_criteria_id
contendrá el código de la ciudad correspondiente. Puedes usar ese ID para ubicar un registro en la tabla geográfica.
Columnas
- ID de criterios
- ID asignado único y persistente. En la API, estos criterios son del tipo
Location
. - Nombre
- El mejor nombre en inglés disponible de la segmentación geográfica.
- Nombre canónico
- Es el nombre en inglés completamente calificado que se construye y que consta del nombre del destino, el de su organización superior y el del país. Este campo solo se usa para desambiguar nombres de destino similares; no es compatible con LocationCriterionService (en su lugar, usa nombres de ubicación o IDs de criterios).
- ID superior
- El ID de los criterios de un elemento superior. Este campo se incluye para la compatibilidad heredada, y es posible que los IDs no sean coherentes entre los conjuntos de datos. Los nombres canónicos son el método preferido para construir jerarquías.
- Código de región
- El código de región ISO 3166-2 para el estado o la provincia de segmentación, si existe.
- Código de país
- Es el código de país ISO-3166-1 alpha-2 asociado con el objetivo.
- Tipo de objetivo
Valores permitidos:
- Aeropuerto
- Distrito
- Comunidad autónoma
- Municipio
- Cantón
- Ciudad
- Región de la ciudad
- Distrito electoral
- País
- Condado
- Departamento
- Distrito
- Región de DMA
- Provincia
- Metro
- Municipalidad
- Parque nacional
- Vecindario
- Ókrug
- Otro
- Código postal
- Prefectura
- Provincia
- Región
- Estado
- Territorio
- Región de televisión
- Territorios de la Unión
- Universidad
Ubicaciones para las que no se puede segmentar
Debido a las reglamentaciones y leyes publicitarias de la República Popular China, es posible que se te solicite que proporciones certificados y licencias si promocionas ciertas categorías de productos en China. No es necesario que envíes certificados hasta después de que se active tu cuenta. Una vez que tu cuenta esté activa, se te proporcionará información para enviar certificados a Google.