Geo object

A Geo object describes a location. Under device.geo it is where the device is now; under user.geo it is the user's home base, such as a registration address, which may be somewhere else. It can hold anything from precise coordinates down to a bare country code, with type recording where the location came from.

14 fieldsOpenRTB 2.0 to 2.6-202606At device.geo, user.geo

How it is used

Every field is optional. Send the most precise data the request's consent and regulatory signals allow and no more, and never dress coarse data up as precise: coordinates belong only when they are as accurate as type and accuracy claim, never the center of a postal code or city. Codes follow specific standards (ISO 3166-1 alpha-3 for country, ISO 3166-2 for region), and mixing in other formats is a frequent source of Geo bugs.

Fields

FieldTypeRequirementSinceStatus
accuracyintegerOptional2.4Current
citystringOptional2.0Current
countrystringOptional2.0Current
extobjectOptional2.1Current
ipserviceintegerOptional2.4Current
lastfixintegerOptional2.4Current
latfloatOptional2.0Current
lonfloatOptional2.0Current
metrostringOptional2.0Current
regionstringOptional2.0Current
regionfips104stringOptional2.0Current
typeintegerOptional2.0Current
utcoffsetintegerOptional2.3Current
zipstringOptional2.0Current

Where it sits

Contained in: Device, User.

All objects

The field reference index lists every OpenRTB 2.x object.