Customer Profiling Endpoint

Profiles some demographic attributes of customer data calculating statistical parameters which are floor and ceiling bounds, an average, and a standard deviation.

Availability: Business Analyst Server.

URL Example

http://localhost:6080/arcgis/rest/services/DefaultMap/MapServer/exts/BAServer/CustomerProfiling/execute

Specific Parameters

Parameter	Description
Customers (required)	The customer layer used to get Customer Profile for. Type PointLayer.
DataLayerID (required)	ID of a geography layer to get demography. Type string.
Summarizations (required)	Array of demography field names to profile customers. Type array of string.
AnalysisExtent (optional)	Data extent to restrict the analysis with. Type ExtentData.
ProfileType (optional)	Type of profiling the bounds of demography variables. Type esriCustomerProfilingFillingType. Default: esriCustomerProfilingFloorAndCeilingValues.
Variance (optional)	A variance value in percents. Type double. Default: 0.

Other Parameters

Parameter	Description
ActiveDatasetID (optional)	ID of the active dataset. Type string. Default: ID of the first available dataset.
compatibility (optional)	Business Analyst Server version the JSON output is compatible with. Type string. Default: 9.3.1
f (optional)	Response format. Type string. Available formats: HTML, JSON, PJSON, XML. Default: HTML.
IsFullErrorMessage (optional)	Mode for composing error messages. Type boolean. Default: false.
token	Authentication token. This parameter is required if your Business Analyst Server is secured. Type string.

Returns

Customer Profile object. It is the Customer Profile in XML format serialized to a string for HTML and XML response types. In the case of JSON and PJSON response types, the response format depends on the compatibility parameter value.

Remarks

Customer Profiling is used to set up a definition query to search for geographic areas that meet a set of criteria. In other words, you can profile the composition of your customer data to determine what demographic variables best represent your customer base. In most cases, this criteria is based on an existing customer layer.

The geography level determines the feature class that will be used to profile your customers. Each customer feature point is spatially matched to a single geographic feature in the geography layer and that feature's attributes are queried to meet the requirements set. These results are compiled for each customer and returned in the output Customer Profile.

The analysis can be restricted to an analysis extent if the AnalysisExtent parameter is specified.

The ProfileType parameter specifies what bounds of ranges of demography variables will be profiled for your customers: floor bounds, ceiling bounds, or both. The Variance specifies how wide the range will be. The floor and ceiling values for a demographic variable are calculated by the formulas

floor = average * (1 – Variance/100), ceiling = average * (1 + Variance/100).

Here average is an average value of a demographic variable calculated.

NOTE: The Customer Profiling endpoint lets you set up an output object that will be used as an input for the Customer Prospecting endpoint. To do this, assign the resulting XML string value received in compatibility with version 10.0 to the CustomerProfileDescription parameter of the Customer Prospecting endpoint.

Usage Tips

• When defining the variance of the fields to profile, start with a high variance, for example, (+/-) 20 percent, to establish a general range and refine the variance further as needed.

• The ProfileType option specifies what bounds of ranges will be profiled for your customers: floor bounds, ceiling bounds, or both.

Example Usage

The example below creates a customer profile for 2 summarization variables.

Request

http://localhost:6080/arcgis/rest/services/DefaultMap/MapServer/exts/BAServer/CustomerProfiling/execute?customers={"points":[{"name":"Store 2","latitude":37.73325,"longitude":-122.4329,"storeId":"2","description":"Bosworth and Arlington"},{"name":"Store1","latitude":37.78415,"longitude":-122.4346,"storeId":"1","description":"Steiner St. and Geary Blvd"}]}&datalayerid=US.BlockGroups&summarizations=["TOTPOP_CY","HHPOP_CY"]&f=pjson

Response

{
 "results": [
  {
   "paramName": "BACustomerProfile",
   "dataType": "GPString",
   "value": "\u003cBACustomerProfile Variance=\"0.000000\" FillingType=\"FloorAndCeiling\"\u003e\u003cItem FieldName=\"TOTPOP_CY\" FieldAlias=\"2011 Total Population\" FieldCategory=\"2011 Population (Esri)\" Average=\"733.500000\" Floor=\"733.500000\" Ceiling=\"733.500000\" StdDev=\"449.012806\" /\u003e\u003cItem FieldName=\"HHPOP_CY\" FieldAlias=\"2011 Population in Households\" FieldCategory=\"2011 Population (Esri)\" Average=\"733.500000\" Floor=\"733.500000\" Ceiling=\"733.500000\" StdDev=\"449.012806\" /\u003e\u003c/BACustomerProfile\u003e"
  }
 ],
 "messages": [
  
 ]
}