Regions

Contents

Introduction

Regions detects a user's country, state, DMA (media market), or postal code.

Regions provides the following user context:

{
  country: {
    code: "US",
    name: "United States"
  },
  state: {
    code: "MD",
    name: "Maryland"
  },
  dma: {
    code: "26",
    name: "Baltimore"
  },
  postalCode: {
    code: "21014"
  }
}

Regions also provides the following events:

  • user.entered_region_country
  • user.exited_region_country
  • user.entered_region_state
  • user.exited_region_state
  • user.entered_region_dma
  • user.exited_region_dma

Regions is a premium context type, available only to Enterprise customers.

Ask your customer success manager to enable Regions.

Countries

Regions supports country detection globally. Each country has a name and a unique 2-letter ISO 3166 code. View the full list of countries.

Country whitelist or blacklist

Regions can also be used to whitelist or blacklist location updates in specific countries for privacy or compliance reasons. Contact your customer success manager to enable this feature.

States

Regions supports state detection in the US only. Each state has a name and a unique 2-letter code. View the full list of states.

DMAs

Regions supports DMA (designated market area) detection in the US only. Each DMA has a name and a unique code. View the full list of DMAs. Or, learn more about DMAs.

Postal codes

Regions supports postal (ZIP) code detection in the US only. Each postal code has a unique 5-letter code.

Support

Have questions after reading the documentation? Visit our Help Center. Still have questions? Click the button on the bottom right of any page to chat with us.