Spatial.aiHelp Center

Delivery Format

Geographic PersonaLive files delivered via Spatial Cloud—segment and group counts and percentages by geography.

PersonaLive geographic segmentation files are delivered through your Spatial Cloud account. These files include counts and percentages of each segment and group at a geographic level.

Standard geographic levels are census block group, ZIP code, and county.

Customer enrichment

To append PersonaLive segments to customer lists, mobile reports, or locations, use Append in the app or the API—not Cloud geographic files.

Data aggregated at a geographic level

At the block group level, a file looks like the following (sample of five block groups; not every column is shown). Column labels use segment and group names from the current PersonaLive catalog (see Dataset Structure). Scroll horizontally to see all columns.

BLOCKGROUPA01 - Midas MightA02 - Sky HighA03 - Exclusive ExburbsA04 - Family Outposts...O - Small Town PercP - Melting Pot Families PercQ - City Hopefuls PercCensus PopulationIndividual Household RecordsCensus Household CountDominant SegmentDominant Group
515102012021825081...0.00.00.0705281306A01 - Midas MightA - Ultra Wealthy Families
1716700360210000...3.510.00.01530626626B03 - Backyard BlissB - Wealthy Suburban Families
3605940970040004...0.00.00.01435555641J04 - Golden City SolosJ - Sunset Boomers
12009064126100035...0.00.00.01805556556B03 - Backyard BlissB - Wealthy Suburban Families
5506796060010000...66.170.03.17916388473O01 - Small Town SatellitesO - Small Town

The full file has four main column sections:

  1. Counts of households in each segment
  2. Counts of households in each group
  3. Percentages of households in each segment
  4. Percentages of households in each group

Plus census and dominant-segment summary fields. See the schema below.

Schema

Column nameDescriptionTypeExample
Blockgroup IDGeographic identifierString551332037032
A01 - Midas MightCount of households in this geography in segment A01Int223
A02 - Sky HighCount of households in this geography in segment A02Int223
............
Q08 - Aspiring ParentsCount of households in this geography in segment Q08Int223
A - Ultra Wealthy FamiliesCount of households in this geography in group AInt478
B - Wealthy Suburban FamiliesCount of households in this geography in group BInt478
............
Q - City HopefulsCount of households in this geography in group QInt478
A01 - Midas Might PercentPercentage of households in this geography in segment A01Float21.12
A02 - Sky High PercentPercentage of households in this geography in segment A02Float21.12
............
Q08 - Aspiring Parents PercentPercentage of households in this geography in segment Q08Float21.12
A - Ultra Wealthy Families PercentPercentage of households in this geography in group AFloat57.88
B - Wealthy Suburban Families PercentPercentage of households in this geography in group BFloat57.88
............
Q - City Hopefuls PercentPercentage of households in this geography in group QFloat57.88
Census PopulationCount of people in this geography according to the US CensusInt567
Individual Household RecordsHouseholds in this geography with household-specific variables available (max equals Census Household Count)Int328
Census Household CountHouseholds in this geography according to the US CensusInt343
Dominant SegmentMost common segment in this geography (highest household count)StringA01 - Midas Might
Dominant GroupMost common group in this geography (highest household count)StringA - Ultra Wealthy Families

Groups vs Family in files

Product UI and these docs use groups. Some delivered files or API fields may still label the same rollup as Family—treat them as the same 17 rollups (A–Q). Exact column punctuation in your Cloud file (for example A01 - Midas Might vs A01: Midas Might) may vary by delivery vintage; codes and display names match the platform catalog.

This format suits mapping, trade-area analysis, store-performance modeling, and similar geographic workflows.

  • Accessing Data — Cloud account, partners, and other delivery paths
  • Dataset Structure — Segment and group codes
  • Append — Enrich customer lists, mobile reports, and locations in the app
  • API — Programmatic customer matching

On this page