Difference between revisions of "Census Integration"
(→Returning Census Data) |
|||
Line 102: | Line 102: | ||
A full list of the census data templates can be found here: {link to census templates} | A full list of the census data templates can be found here: {link to census templates} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
[[Category:Integration]] | [[Category:Integration]] |
Revision as of 15:32, 2 July 2014
Contents
Overview
SmartSimple integrates with the U.S. Census online database to provide our clients with the ability to access the most up-to-date geographically-relevant data pertaining to their clients.
Census data is provided at three different levels: Tract, County and State. Census Tracts are the lowest level of geographic region for which census data is aggregated.
In the example below, a Web Page View has been configured to display all three levels of census data on an organization profile.
Census Data can be referenced anywhere in SmartSimple:
...on a list view:
...on a record:
...or anywhere else. Data from the U.S. census can also be used to drive branching logic on SmartSimple workflows, or perform other calculations.
Returning the Tract Code
SmartSimple's Census Integration works by deriving the census block number from your organization or contact's address details. The census block number is a 15-digit code that incorporates - reading from left to right - the location's two-digit State code, three-digit County code, and six-digit census tract code.
In the above example:
- 22 is the State code for Louisiana,
- 113 is the County code for Vermilion Parish and
- 951100 is the census tract code for the address of Abbeville Womens Equality.
FIPS Code Syntax
In the above example, the census block number for Abbeville Womens Equality's location is returned using the following variable:
- @FFD(FIPS;;@address@ @city@ @state@)@
FFD stands for "Federal Financial Data" and FIPS stands for Federal Information Processing Standards.
On a record, the census block number can be returned for an associated Organization by using:
- @FFD(FIPS;;@client.address@ @client.city@ @client.state@)@
Returning Census Data
Detailed census data can be retrieved at three levels, the tract, county, and state.
Census Data Variable Syntax
- @FFD(Profile;;year;;Address or FIPS code;;level;;[[template]])@
Where:
- Profile is a constant.
- year is the census year from which {need to enter allowable year values}
- Address or FIPS code accepts
- a variable reference to the address, such as @address@ @city@ @state@
- the 15-digit census block number
- level accepts three values, one of
- tract
- county or
- state
- template Note that the template should be enclosed within a double set of square brackets (e.g., [[B01003_001E]])
You would then use the following template: for the tract level @FFD(Profile;;year;;Address or FIPS code;;tract;;template)
for the county level @FFD(Profile;;year;;Address or FIPS code;;county;;template) for the state level @FFD(Profile;;year;;Address or FIPS code;;state;;template) Example: @FFD(profile;;2012;;@address@ @city@ @state@;;county;; B01003_001E)
Profile – constant, query name
Year – integer value of year like 2012,2013. Normally last year statistics are not available until second halve of the current year
Address or FIPS code – can be full address or fips code like “@address@ @city@ @state@“ or “@FIPS@
Template – html template with statistic variables like “Earnings for Households:$B06002_001E”
Where B06002_001E is field name of Census data (please refer to the xlsx for complete list I sent earlier) ,2 square brackets are used to embed a fieldname
List of Commonly-used Templates
The census data templates used in the illustration at the top of the page are as follows:
Template Name | Description |
B01003_001E | Total Population |
B05010_001E | Ratio of Income to Poverty Level in the Past 12 Months of Children by Living Arrangements and Nativity of Parents |
B06002_001E | Median Age By Place of Birth In the United States |
B17008_001E | Aggregate Income Deficit (Dollars) of Unrelated Individuals by Sex |
B19051_001E | Earnings for Households |
B19113_001E | Median Family Income |
A full list of the census data templates can be found here: {link to census templates}