Geopath Inventory & Measures

Audience Demographics, Behaviors, and Consumer Profile Segmentation

Geopath Audience Insights is powered by deep audience research integrated from multiple audience resources. Members of Geopath have access to thousands of unique audiences through the Geopath Insights Suite as well as the Geopath APIs. Audience Impressions can be qualified into consumer behaviors, demographics, psychographics, and market segmentation. Claritas, one of the source providers of these audience data combines access to direct and original consumer research with sought-after critical sources like Nielsen Scarborough, Gfk MRI, & 40 other data partnerships to help contextualize the population of the United States. Consumer audiences include 1,000's of unique attributes across automotive, financial, lifestyles, retail & shopping, and technology categories. Demographics include age, race, ethnicity, education, & more. Additionally, Prizm Premier is provided for those that are looking for audience segmentation.  We look forward to you making the most out of our audience measurement for you and your brands. Below are the core categories of Audience Profiles that available.

Type

Category

Type

Category

Population

Age

Population

Gender

Population

Race and Ethnicity

Household

Commuting Transportation Method

Household

Employment

Household

Household Income

Household

Households with Children

Household

Language Spoken at Home

Household

Male or Female Head of Household

Household

Marital Status

Demographics

Mortgage

Demographics

Rent

Demographics

Vehicles per Household

Geoscape

Asianicity

Geoscape

Hispanicity

Consumer Profiles

Alcohol

Consumer Profiles

Automotive

Consumer Profiles

Commuting and Transportation

Consumer Profiles

Digital video displays

Consumer Profiles

Environment

Consumer Profiles

Financial

Consumer Profiles

Food and Beverages

Consumer Profiles

Health

Consumer Profiles

Household Detailed Demographics

Consumer Profiles

Household Summary Demographics

Consumer Profiles

Items in the Home

Consumer Profiles

MRI Apparel & Jewelry

Consumer Profiles

MRI Gas, Credit Cards & Chains

Consumer Profiles

MRI Hardware & Appliances

Consumer Profiles

MRI Home Improvements

Consumer Profiles

MRI Magazines & Newspapers

Consumer Profiles

MRI Print Media Usage & Alternative Advertising

Consumer Profiles

MRI Psychographics

Consumer Profiles

Neighborhood Demographics

Consumer Profiles

Radio

Consumer Profiles

Restaurants

Consumer Profiles

Retail shopping

Consumer Profiles

Sports and Leisure

Consumer Profiles

Telecommunications

Consumer Profiles

Television

Consumer Profiles

Television (Claritas), 2016

Consumer Profiles

Travel

Consumer Profiles

Voting

PRIZM® Premier

PRIZM® Premier Segment

PRIZM® Premier

PRIZM® Premier Lifestage Group

PRIZM® Premier

PRIZM® Premier Social Group

Consumer Profiles

One of the most exciting enhancements being brought to the marketplace by Geopath is its calculation of audience for Claritas Consumer Profiles. This new capability will allow marketers and brands to use OOH to target audiences in ways never before offered at such scale!

Alcohol

Yes! Geopath provides a wide range of audiences defined by beer, wine and spirits! Sure to be helpful when marketing those adult beverages. As a Geopath member you now have access to things like hard cider drinkers, people that prefer Modelo Especial or where people prefer to purchase their drink of choice.

Examples:

  • Usual buys wine for $20 or more

  • Drinks Bud Light most often

  • Bought liquor at Costco in the last 30 days

Automotive

With over 200 unique variables the Automotive subcategory of Consumer profiles provide information ranging from where people are likely to shop for new tires to how much someone is likely to finance a new car for in the next 12 months.

Examples

  • Traveled 10-19 miles to buy or lease a car

  • Bought a Cadillac

  • Plans to spend $30,00 on a new car in the next 12 months

  • Got a brake repair in the past 12 months

Commuting and Transportation

When I was your age I walked to school 5 miles in the snow, uphill both ways! Well now we know with Geopath’s new audience measurement. Consumer profiles subcategory Commuting & Transportation offers insights into mode of transportation preferred to work or even people that work from home.

Examples

  • Spends an hour commuting every day

  • Carpools

  • Takes the bike to work

Digital Video Displays

There are a lot of ways to reach people when they are outside of their homes. Want to target people that are not only exposed but noted digital media in their daily lives? Use the subcategory “Digital video display” under Consumer Profiles to find audiences that recall seeing digital video displays in the airport or at the doctor’s office in the pat 30 days.

Examples

  • Viewed a digital video at a Grocery store in the past 30 days

  • Viewed digital video displays at 3 different places in the past 6 months

  • Viewed a digital video display at a Gas Station in the past 30 days

Environment

Need to reach the people that are good stewards of mother nature? Or maybe those that aren’t? Geopath offices the subcategory “Environment” under the Claritas Consumer Profiles so you can understand just exactly who is recycling, buying organic food and many more.

Examples

  • Buys eco-friendly cleaning products

  • Uses energy efficient light bulbs

  • Uses reusable shopping bags

Financial

Geopath members have access to a variety of consumer audiences through the Consumer Profiles by Claritas. The financial subcategory is especially helpful for understanding households’ approach to money. Who uses accountants for filing taxes or what insurance are people interested in are just a couple ways you can build a Target.

Examples

  • Has a student loan outstanding

  • Plans to switch insurance provider in the next 12 months

  • Banks with Wells Fargo

Food and Beverages

With over 200 unique variables, the Food and Beverage subcategory of Consumer Profiles is sure to satisfy your appetite for audiences. Need to find people that prefer soda over water? Or drink Capri Suns a lot? This is the subcategory for you.

Examples

  • Drank diet Sunkist in the past 7 days

  • Drinks Dasani water in past 7 days

  • Prefers store brand

  • Drinks energy drinks

Health

Marketing medicine can be tricky business but with the Claritas Consumer Profile subcategory “Health” you can make sure to reach a focused audience with the right message. Insights are available for things like preferred drugstore to types of doctors’ visits in the last 12 months.

Examples

  • Chose Blue Cross Blue Shield as the insurance provider

  • Buys prescription drugs at Walmart

  • Uses Cigarettes in the past 30 days

  • Goes to the skin doctor

Items in the Home

Have a CPG client? Looking for an audience based on what they have in the house? Geopath Members have access to a wide variety of audiences under the Consumer Profiles subcategory: “Items in the Home” which covers everything from remodels to consumer electronics to where they refill their copy paper.

Examples

  • Spent between 500 and 1000 on consumer electronics in the past 12 months

  • Has an ATV (all-terrain vehicle)

  • Shops at Office Max

  • Has a smartwatch

MRI Apparel & Jewelry

There are over 350 unique variables under the MRI Apparel and Jewelry subcategory of Consumer Profiles. Here you will find how much people are spending on what, preferred brands of shoes or fitness wear spend in the last 12 months.

Examples

  • Spent $100+ on Men’s jeans in the past 12 months

  • Buys golf shoes this year

  • Owns a watch

MRI Gas, Credit Cards & Chains

Need to reach the people that fill up the tank at BP or spend over $100 on gas each month. The “MRI Gas, Credit Cards & Chains” variables under Consumer Profiles all you to reach the right audience.

Examples

  • Buys Gas 1 per week

  • Buys Exxon in the past 6 months

  • Buys Premium 1 per week

MRI Hardware & Appliances

There are over 150 unique variables in the MRI Hardware & Appliances subcategory of Consumer Profiles. Need to find the audience likely to own an air purifier or a portable generator? Here’s your one-stop-shop.

Examples

  • Owns a lawn mover

  • Uses a microwave once a week

  • Owns an ice cream maker

MRI Home Improvements

With Home Improvements subcategory you have access to a wide range of audience variables. Need to market to people that use a housekeeper? Or people planning a remodel? Home Improvements subcategory of Consumer Profiles is the place for you. Tim the Tool-Man Taylor only wished Tool time had these types of audiences!

Example

  • Home remodel in the next year

  • Uses spray starch

  • Uses Terminix for pest control

MRI Magazines & Newspapers

With 300 unique variables the MRI Magazines and Newspapers subcategory of Claritas Consumer Profiles provides a treasure trove of audience insight into all things magazine and newspaper. Want to target people that read the National Geographic or Cigar Aficionado? This is the subcategory for you.

Examples

  • Reads the front page of the weekly newspaper

  • Reads Yachting

  • Reads Rolling Stone

MRI Print Media Usage & Alternative

With over 200 unique variables; the “Print Media Usage & Alternative” subcategory of Consumer Profiles provides audiences by their print media consumption whether that be online or off. For example; are you interested in targeting people that get their news from Wired Online? Or how about people that use the yellow pages?  Print media usage & alternative subcategory has the insights for you.

Examples

  • Visited Weight watchers website

  • Reads their daily newspaper

  • Watched an infomercial in the past 6 months

MRI Psychographics

With over 450 unique variables Psychographics is the largest subcategory of Consumer Profiles audiences Geopath offers. There are variables ranging from how people feel about ads in general to how likely they are to indulge in that extra slice of chocolate cake! So feel free to indulge in these audiences as much as you like! No extra calories. We promise!

Examples

  • Eating fast food is fun

  • It’s important for salespeople to know their products

  • Only answers cell phone if they know who is calling

  • Asks friends for advice when purchasing an automobile

  • Pets deserve to be pampered!

Radio

Using out of home in conjunction with a radio campaign? Perfect! Find the billboards that reach a similar audience on radio using the Claritas Consumer Profiles subcategory “Radio”. Find the audiences that have listened to NBA on the radio or prefer ABC news.

Example

  • Listened to the Super Bowl on the radio

  • Enjoys the Contemporary Connection

  • Likes the Oldies

Restaurants

Hungry to reach your target audience? With over 200 unique variables the Restaurant subcategory of Consumer profiles provide Geopath members the ability to reach consumers that have eaten at Cracker Barrel in the last 30 days or prefer quick service restaurants over sit down.

Examples

  • Eat at Chilis in the past 30 days

  • Went to a coffee bar in the past 30 days

  • Goes to sports bars

Sports and Leisure

Need to find people that are interested in college football or the pro rodeo? With over 300 unique variables, the subcategory “Sports and Leisure” hits a home run with audience targeting. Find the jog-a-holics or the people that love to stay at home and sew. Or perhaps you want people that love the Olympics or aren’t really interested in Monster Rally Truck Jams at all.

Examples

  • Grilled outdoors in the past 12 months

  • Not into Pro Boxing at all

  • Plays tennis

  • Likes photography

Telecommunications

Can you hear me now? With over 450 unique variables, the Telecommunications subcategory of Consumer Profiles covers habits from texting to shopping online to gaming and music. What are people using their phones, tablets or laptops for? This is the place to go.

Examples

  • Buys Samsung phones

  • Took a college level course on a smartphone

  • Plays fantasy sports on their tablet

Television (Claritas), 2016

Building a target based on their television viewing habits has never been easier with the Claritas Television audience subcategory under Consumer Profiles. Interested in reaching people who caught the Rose Bowl? Maybe the Golden Globes? This is your one stop shop for all things Television.

Examples

  • UFC Fight Night

  • Presidential Debates

  • Primetime tv watchers

Travel

Slightly different than the Commuting and Transportation subcategory; the “Travel” subcategory of Claritas Consumer Profiles addresses what happens when you aren’t near your home. For instance; what hotels do you like to stay at? Or what airline do you prefer? How often do you travel?

Examples

  • 3 personal trips outside the country in the last 3 years

  • Prefers Enterprise car rental

  • Visited Mexico

Voting

No matter which side of the aisle you are on you are sure to find value in the political attribute insights available to you as a Geopath Member. The Voting subcategory of the Consumer Profiles audience provides insights into how often people vote in local elections, what party are people affiliated with and many more.

Examples

  • Sometimes votes in local elections

  • Identifies as Independent

Claritas PRIZM Premier™

PRIZM segmentation is a comprehensive overview of visitors, combining demographics, consumer behavior, and geographic data, grouped together into 68 segments by common characteristics and behaviors to maximize marketing efficiency, reach, and personalization.

Standard and Custom Market Geographies

Markets are geographically defined areas used when planning, buying, and selling media. Geopath's standard markets definitions have historically been DMAs, CBSAs, and Counties (or county equivalents).

Out-of-home media companies and advertisers also use custom geographies based on their geographic coverage of their panel or product sales distribution areas respectively. Geopath is expanding its reporting capabilities by adding custom market reporting geographies and including ZIP codes within the set of standard market definitions.

Geopath Audited Inventory

Inventory makes up an extremely important part of the Geopath API. As part of the development of Geopath Insights, Geopath redesigned the legacy OOH data model to meet the growing needs of our members. The primary goals of the new model: 

Geopath has developed a new Inventory Data Model while revamping its Insights Platform to meet the growing needs from its OOH members:

  • Unlocking new OOH opportunities in place based and fleet media ratings measurement

  • Improving inventory data quality to enable better insights for the marketplace

  • Standardizing the model for all members to simplify the process, while still enabling our members to be distinctive in the marketplace

  • Providing a scaffold for future development and growth of programmatic and digital

  • Delivering a single source of unified truth across roadside, place-based, and fleet inventory

The new inventory model has been designed as such:

  • Broadly classifies OOH advertising by the "Construction" and the "Frame"

  • Break Construction further into "structure" and "media type"

  • Frame is supported by the construction and further broken down into additional layers to support rotating and digital media.

  • Categorize media options in three areas:

    • Roadside

    • Fleet

    • Place

Understanding the "Construction" (or the "thing" that holds up the advertisement)

  • Every piece of inventory has a construction and a media type

  • Every piece of inventory falls into one of the standardized construction and media types

  • Every piece of inventory also has a "media name" which gives operator the option to name it the way that is more suitable for business needs

  • Geopath can work with operators to determine the best fit of their inventory into the new inventory model

  • The new data model allows a construction to support any media type, it gives media operators the flexibility to develop rules that meets best their business needs. 

  • A single construction can support multiple frames

Standardized Construction Types

Type

Notes

Example

Type

Notes

Example

Freestanding

Generally roadside, freestanding structures taller than 10 feet, includes fences retaining walls etc...

Billboards

Exterior Wall

Generally roadside, the wall of a standing building

Wall Murals

Furniture

Roadside or place-based, freestanding structure less than 10 feet tall

Transit Shelters, Kiosks

Interior Wall

Place-based, the wall inside of a building

 

Stairs

Place-based, spread out over an entire staircase with the intent to look unified from a distance

 

Floor

Place-based, displayed on areas that people walk on

 

Ceiling

Place-based, includes inventory that hangs from the ceiling or is flat on the ceiling

 

Rooftop

Place-based, seen from the air or from elevated positions

 

Tablet

Place-based, individual scale screens

 

Interior Vehicle

Fleet, moving vehicle with a public audience inside

Buses, Trains

Exterior Vehicle

Fleet inventory with a roadside audience, any moving vehicle

Mobile Billboards, Buses, Taxis

Standardized Media Types

Type

Notes

Type

Notes

Wall

Loosely, anything larger than a bulletin

Bulletin

Based on the existing market definitions, 10-20' H x 36-60' W

Poster

Based on the existing market definitions, 10-12' H x 22-25' W

Jr. Poster

Based on the existing market definitions, 5-6' H x 11-13' W

Panel

Smaller than a Jr Poster, larger than a display, 35"H x 63" W - 5-6' H x 11-13' W

Display

smaller than a big screen TV =< 35"H x 63" W

Geopath has developed conversion to map the existing roadside inventory into these new categories following two basic principles:

  • Eliminated "digital" redundancies by adding a frame attribute to indicate if an inventory is digital or not

  • Separate the attributes that describes the construction from the attributes that describes the media

Conversion from Legacy

Existing Tabview Media Type

New Standard Media Type

New Standard Construction Type

Existing Tabview Media Type

New Standard Media Type

New Standard Construction Type

Posters

Poster

Freestanding

Bulletins

Bulletin

Freestanding

Junior Posters

Junior Poster

Freestanding

Transit Shelters (TSA)

Panel

Furniture

Phone Kiosks

Panel

Furniture

Urban Panels 

Panel

Furniture

Kiosks

Panel

Furniture

Benches

Panel

Furniture

Newsstands

Panel

Furniture

City Information Panels

Panel

Furniture

Digital Urban Panels

Panel

Furniture

Walls

Wall

Exterior Wall

Digital Posters

Poster

Freestanding

Digital Bulletins

Bulletin

Freestanding

Digital Junior Posters

Junior Poster

Freestanding

Digital Transit Shelters

Panel

Furniture

Digital Phone Kiosks

Panel

Furniture

Digital Kiosks

Panel

Furniture

Digital Newsstands

Panel

Furniture

Digital Walls

Wall

Exterior Wall

Receptacle

Panel

Furniture

Digital CIP

Panel

Furniture

Wild Postings

Panel

Exterior Wall

Bike Kiosks

Panel

Furniture

Newsstand Posters

Panel

Furniture

Digital Newsstand Posters

Panel

Furniture

Metro Lights

Panel

Freestanding

Pedestrian Panels

Panel

Furniture

Carts

Panel

Furniture

Banners

Panel

Freestanding

Bike Pillar

Panel

Furniture

Station Pod

Panel

Furniture

Rail Platform Kiosk

Panel

Furniture

Elevator Wraps

Panel

Furniture

Understanding the Frame (the "area" where the advertising goes)

  • Frames are the base unit of OOH measurement

  • There must be at least 1 frame per construction

  • Further breaks down the frame into 4 layers, Frame, Layout, Face and Spot, to support both digital and print OOH advertising

    • Each Frame has at least one Layout, one Face, and one Spot

Frame

  • Every frame gets a Geopath ID

  • Every frame has a location, which gets an assignment for ratings generation purposes

  • A print bulletin is 1 frame, a digital bulletin is also 1 frame

Layout

  • A Layout is a unique arrangement of faces on a particular

  • On most roadside inventory, there is 1 layout, the full area of the frame, but in place-based inventory there can be many dynamic changing possible layouts

Face

  • A Face is the specific extent of the specific content on a given layout

  • A print bulletin would have 1 face, a digital bulletin traditionally has 1 face, but could support many

Spot

  • The unique content on a specific face

  • A print bulletin would have 1 spot, where a digital bulletin could have multiple spots

Geopath IDs

Each inventory level has its own unique identifier that act as primary keys within the database. The table structure in the database also links the different levels using foreign keys within adjacent tables to link the inventory levels together. For example, the Frame ID is the primary key for the Frame Table. The Layout ID is the primary key for the Layout Table. However, the Layout Table also includes the Frame ID as a foreign key, to understand the link between the layout record and its parent frame.

Currently Frames and Spots are the most common way to understand most OOH advertising. As such, there are API endpoints that accept frames id and spot ids as optional or required parameters. For digital inventory it is common to have multiple spot ids that correspond to a single frame ID. In general, the legacy “Geopath Panel ID” corresponds to the Spot ID within the new database.

For Roadside inventory that was entered into the Geopath system before February 2022, it was very common for digital inventory to have one Spot ID that matched the Frame ID, and with static inventory for the single Spot ID to match the Frame ID. This was because of a legacy process that started with a flat data schema before entering the newer nested structure as detailed above. Since February 2022, this legacy process was deprecated, and now data is moving directly into the new model. As a result, since each inventory level has it’s own identifier, these each operate on their own database sequences, which means that the frame_id will not match any of the spot_ids that may be linked to it. Geopath does not recommend treating the Frame IDs and Spot IDs as interchangeable.

Each Geopath ID is immutable and will not be reused.

Geopath Statuses

Geopath utilizes statuses to indicate where along the auditing process a piece of inventory currently falls. The API returns the status in the inventory/search, inventory/search/batch, get by frame id, and measures/summary endpoints. The batch file downloads are bulk versions of the inventory/search results, so they also provide the inventory status

The inventory/search and measures/summary results are filtered based on the status of the inventory. The get by frame id endpoint will show you the current status of any frame id that is provided.

For the inventory/search results, detailed statuses that you may find in the get by frame id results, are generalized to fewer categories. Below is a table detailing the status id, status name, status description, with the generalized public id, public name and public description which are used in the inventory/search endpoints.

Status Type Id

Status Type Name

Status Type Description

Public Id

Public Name

Public Description

10

Incomplete

Asset has incomplete or invalid attributes

10

Incomplete

Asset has incomplete or invalid attributes

20

Unaudited

Required attributes contain valid data and may be audited

50

Published - Unmeasured

Measures do not exist; inventory available to licensed users

30

Audited - Level 0

Asset attributes audited, but asset not assigned and cannot be measured

50

Published - Unmeasured

Measures do not exist; inventory available to licensed users

31

Audited - Level 1

Asset attributes audited, given valid assignments, and can be measured

52

Published - Under Review

Measures created, but under review; inventory and measures available to licensed users

32

Audited - Level 2

Asset attributes and assignments under senior auditor review

52

Published - Under Review

Measures created, but under review; inventory and measures available to licensed users

33

Audited - Level 5

Asset attributes passed audit, given valid assignments, source data under review

52

Published - Under Review

Measures created, but under review; inventory and measures available to licensed users

34

Audited - Level 6

Asset attributes passed audit, given valid assignments, traffic data under review

52

Published - Under Review

Measures created, but under review; inventory and measures available to licensed users

35

Audited - Level 7

Asset attributes passed audit, given valid assignments, coverage data under review

52

Published - Under Review

Measures created, but under review; inventory and measures available to licensed users

36

Audited - Level 8

Asset attributes passed audit, given valid assignments, population data under review

52

Published - Under Review

Measures created, but under review; inventory and measures available to licensed users

39

Audited - Level 9

Asset attributes failed audit, cannot be measured

52

Published - Under Review

Measures created, but under review; inventory and measures available to licensed users

40

Unpublished - Measured

Measures created; inventory and measures suppressed for licensed users, but available for review by operator

40

Unpublished - Measured

Measures created; inventory and measures suppressed for licensed users, but available for review by operator

49

Unpublished - Inactive

Unpublished asset of a Geopath member, not scheduled for audit, no measures are available

49

Unpublished - Inactive

Unpublished asset of a Geopath member, not scheduled for audit, no measures are available

50

Published - Unmeasured

Measures do not exist; inventory available to licensed users

50

Published - Unmeasured

Measures do not exist; inventory available to licensed users

51

Published - Measured

Measures created; inventory and measures available to licensed users

51

Published - Measured

Measures created; inventory and measures available to licensed users

52

Published - Under Review

Measures created, but under review; inventory and measures available to licensed users

52

Published - Under Review

Measures created, but under review; inventory and measures available to licensed users

53

Published - Suppressed

Measures created, but under review; inventory available to licensed users, but measures are suppressed

53

Published - Suppressed

Measures created, but under review; inventory available to licensed users, but measures are suppressed

54

Published - Appealed

Asset attributes audited, given valid assignments, and is awaiting review by Operator

51

Published - Measured

Measures created; inventory and measures available to licensed users

59

Published - Inactive

Audited asset of a non-member

59

Published - Inactive

Audited asset of a non-member

80

Decommissioned

Asset no longer exists

80

Decommissioned

Asset no longer exists

90

Checked Out

Asset is currently being modified

52

Published - Under Review

Measures created, but under review; inventory and measures available to licensed users

 

Understanding the Search API Response

The /inventory/search response can be an overwhelming amount of information. Here's a breakdown of what is included.

The response is returned as a JSON object with the initial key of "inventory_summary"

Within the "inventory_summary" are 5 items. 

  • inventory_count - How many inventory records matched the search.

    • invalid_ids - If you provided a list of IDs, how many were invalid.

    • filtered_invalid_ids - If you provided a list of IDs, along with other filters, how many of the otherwise valid ids were made invalid by the additional filters.

    • inventory_items - Provides the details of the inventory that is returned.

  • pagination - Provides details on the size of the overall response. 

    • page - What page of the response you are currently viewing.

    • page_size - How many records are returned per page.

    • number_of_pages - How many pages are in the overall response.

    • number_of_frames - How many frames are in overall response.

    • number_of_spots - How many spots are in the overall response. 

From that list, the most important is the inventory_items object, which provides all the details for the inventory. Within the inventory_items object are a mix of key/value pairs, along with arrays of additional objects. The first 16 values deal with information about the frame itself.

  • frame_id - The Geopath ID for the frame.

  • plant_frame_id - The operator's internal identifier for this piece of inventory. May not be included and may not be unique among the operator itself or among other operators.

  • uri - A place for a link for more information.

  • max_height - Maximum height in inches of the frame

  • max_width - Maximum width in inches of the frame

  • digital - Boolean value describing if the frame is true or not.

  • media_name - Field for operators to provide a preferred name / marketing name for their inventory. Geopath will return what is provided by operator.

  • frame_rotating - Boolean field describing if the frame has the ability to rotate ads. This will be true for digital frames, but also for mechanical frames like scrollers or Tri-Vision. 

  • frame_full_motion - Boolean field describing if the frame has the ability to have full motion video.

  • frame_partial_motion - Boolean field describing if the frame has the ability to have partial motion video.

  • frame_audio - Boolean field describing if the frame has the ability to have audio played from it.

  • frame_interactive - Boolean field describing if the frame is intended to have people physically interact with it, like a touchscreen.

  • illumination_start_time - The hour/minutes/seconds of when any illumination of the frame begins.

  • illumination_end_time - The hour/minutes/seconds of when any illumination of the frame ends.

  • created_dtm - Date and time when the record was created in Geopath's database. This is searchable from the request.

  • updated_dtm - Date and time when any of the information in the record was last updated in Geopath's database. This is searchable from the request. 

After these initial key/value pairs there are 10 arrays which contain additional objects. Many of these are reference items where the values can be found in the Geopath reference API.

  • representations - Describes the companies that operate the piece of inventory. This is described with two main pieces of information. The representation record, and the account record. Each company in the Geopath database has representation records that get linked to the inventory record. A single company could have multiple types of representation records based on whether they own, manage, or transact on inventory. Each of those representation records is linked to their account. 

    • id - This is unique ID for the representation record in Geopath's database

    • updated_desc - Notes from any update of the representation record.

    • representation_type - The type of representation that this record is representing. This is essentially a library value from Geopath's database.

    • account - The account details that are linked to this representation record. This can often be a sub-account of a larger parent account (like a division or operating region of a company).

      • id - The unique ID for the account in Geopath's database.

      • name - The name of the account. This could be just a region / office / division name of a larger company.

      • operator_code - The ID of the office / division from the larger parent company if provided.

      • parent_account_id - The ID of any linked parent account.

      • parent_account_name - The name of any linked parent account.

  • classification_type - How Geopath has classified the inventory into Roadside, Place-Based, or Fleet.

  • construction_type - Describes the type of construction that the frame is being supported by.

  • illumintation_type - Describes the type of illumination that the frame has, wether is only natural ambient light, or include artificial light. 

  • media_type - Describes the Geopath standardized media type of the inventory.

  • media_status - Describes the status of the inventory along the Geopath auditing process.

  • location - This object contains much of the information about where the piece of inventory is located and information about that location.

    • id - An internal ID for the location in Geopath's database.

    • orientation - Expressed in degrees, the direction which the piece of inventory is facing.

    • primary_read - Provided by the operator, in their opinion, the read direction for a vehicular audience on the primary intended roadway for the piece of inventory.

    • primary_artery- Provided by the operator, in their opinion, the primary inteded roadway / description of the location for the piece of inventory.

    • level - For place-based inventory, the level of the venue that the inventory is located on.

    • levels_visible - For place-based inventory, how many interior levels a piece of inventory may be viewed from.

    • latitude - the latitude coordinate in decimal degrees of the location of the piece of inventory.

    • longitude - the longitude coordinate in decimal degrees of the location of the piece of inventory. 

    • block_id - The US Census Bureau defined census block FIPS code where the location is located in. 

    • elevation - The height in inches above the surface to the center of the frame. This is not currently widely available.

    • geometry - A JSON object of the location geometry that can be used in GeoJSON applications.

    • place_type - The Geopath defined type of place that the location is in. 

    • places - For place-based inventory any linked place records that the location is within.

    • created_dtm - Date and time when the location record was created in Geopath's database. This is not searchable from the request.

    • updated_dtm - Date and time when any of the information in the location record was last updated in Geopath's database. This is not searchable from the request.

    • dma_id - The ID of the DMA that that location is within.

    • dma_name - The Name of the DMA that the location is within.

    • cbsa_code - The US Census Bureau defined ID of the CBSA that the location is within

    • cbsa_name - The name of the CBSA that the location is within

    • county_id - The US Census Bureau defined FIPS code that the location is within. 

    • county_name- The name of the county that the location is within. 

    • zip_code - the US Postal Service defined zip code that the location is within

    • zip_code_name - The name of the zip code that the location is within.

    • state - The US State that the location is within

    • time_zone - The time zone, represented as a different from GMT that the location is within. For example -5 is the Eastern time zone

  • placement_type - A Geopath standardized description of the type of placement of the piece of inventory. 

The next object details information about the spots on the frame which includes the Geopath measures for that spot. 

  • spot_references

    • spot_id - The Geopath ID for the spot.

    • plant_spot_id -The operator's internal identifier for this spot on this piece of inventory. May not be included and may not be unique among the operator itself or among other operators.

    • frame_uri - A link to the inventory record of the parent frame of this spot. 

    • length - If a digital spot, the length of time in seconds that it will appear on the digital frame.

    • spot_roating - A boolean value that descibes if the spot rotates at all. 

    • spot_full_motion - A boolean value that describes if the spot is full motion video.

    • spot_partial_motion - A boolean value that describes if the spot is partial motion video.

    • spot_audio - A boolean value that describes if the spot plays audio.

    • spot_interactive - A boolean value that describes if the spot is meant to be interacted with by people.

    • created_dtm - Date and time when the spot record was created in Geopath's database. This is not searchable from the request.

    • updated_dtm -  Date and time when any of the information in the spotrecord was last updated in Geopath's database. This is not searchable from the request.

    • measures_time_calculated - Date and time when the information in the measures object of this spot was last calculated. This can be searched from the request.

The next information details the Geopath Measures that this spot on this piece of inventory has received after going through the Geopath audit.

  • measures

    • measures_type - The type of measures being returned. Right now this will always be "Measures"

    • period_days - The number of days of an advertisement running that the measures represent. The default is weekly (7 day) measures. Based on what is provided in the request.

    • base_segment - The audience that is used for the base population of measure comparisons. Based on what is provided in the request.

    • target_segment - The audience that is being targeted for the advertisement. Based on what is provided in the request.

    • target_geo - The geographic market that is being targeted for the adversitment. Based on what is provided in the request.

    • market - The geographic market that is being targeted for the adverstisement. Based on what is provided in the request.

    • index_comp_target The calculated target composition index. The ratio of Target Percent In-Market Impressions Comp to (Target Population/Total Population %)

    • pct_comp_pop_target_inmkt - Percent of the overall base population that matches the target segment / in the defined market

    • pct_comp_imp_target -  Target Audience Impressions as a percentage of Total Impressions. 

    • pct_comp_imp_target_inmkt - Target In-Market Impressions as a percentage of Total In-Market Impressions. 

    • freq_avg - The average number of times an individual notices an out of home advertising message during a defined period of time.

    • imp_target_inmkt - The total impressions for the target audience in the target market only.

    • imp_target - The total impressions that are reaching the target audience overall. 

    • imp_inmkt - The total impressions that are reaching the target market overall.

    • imp - The total impressions based on the base_segment.

    • pct_imp_inmkt - In market impressions as a percentage of total impressions. 

    • pct_imp_target_inmkt - Target in market impressions as a percentage of target audience impressions. 

    • pop_inmkt - The total population in the defined market.

    • pop_target_inmkt - The total population of the target segment in the target market.

    • reach_pct - The percentage of the total market that is being reached during the period defined.

    • reach_net - The number of people in the market that is being reached during the period defined.

    • trp - The total number of in-market impressions, to a target audience, delivered by an Out of Home display expressed as a percentage of a market population.

    • eff_freq_min -  The number or percentage of a target audience that is exposed to an OOH unit(s) at a set level of effective frequency.

    • eff_freq_avg The calculated average frequency of persons reached at least eff_freq_min times.

    • eff_reach_net The total target in-market population reached at least eff_freq_min times.

    • eff_reach_pct The percent of the target in-market population reached at least eff_freq_min times.

  • measure_list - If multiple target segments are provided in the request, the above measures object will be blank, and instead multiple measures objects, one for each audience requested will be present in this array.

  • total_msg_impressions - If hourly impressions are requested. They will be broken down here by day of week and hour. For more info on working with hourly measures, see this link

  • total_msg_impressions_list - If hourly measures are requested, and multiple target segments are provided, the above total_msg_impressions object will be blank and instead multiple objects one for each audience requested will be present in this array.

  • photos - If any photos are available for the frame, the links to the photos will appear in this list.