Geo.country

The country as an ISO 3166-1 alpha-3 code, three uppercase letters such as "USA", "GBR", or "DEU".

CurrentstringOptionalSince 2.0

Field facts

Path
device.geo.country, user.geo.country
Object
Geo
Type
string
Requirement
Optional
Added
OpenRTB 2.0
Spec section
3.2.19

How it is used

Buyers use it for campaign geography and often to decide which privacy regime applies, alongside regs.gdpr and regs.gpp_sid.

Example

Where the field sits in a payload, with everything else left out:

{
  "id": "req-1",
  "device": {
    "geo": {
      "country": "USA"
    }
  }
}

Common mistakes

  • Sending the two-letter code ("US") instead of three letters. Buyers matching on alpha-3 miss the country entirely.
  • Sending a country name or lowercase code.

Version history

Added in OpenRTB 2.0, and present in the latest snapshot. The table shows how each version's spec text types the field.

VersionsType in the specRequiredDeprecated
2.0 to 2.2stringNoNo
2.3 to 2.3.1stringNoNo
2.4stringNoNo
2.5 to 2.6-202606stringNoNo

Related fields

Other Geo fields