Packagecom.esri.baserver.tasks.segmentation
Classpublic final class UnderstandingTargetCustomersTask
InheritanceUnderstandingTargetCustomersTask Inheritance BAServerTask Inheritance BATask Inheritance AbstractTask Inheritance flash.events.EventDispatcher

The Understanding Target Customers task creates a report to compare the Tapestry profile of your core and developmental customers to the Tapestry profile of a syndicated survey.

This task is also known as the Mediamark Research, Inc. (MRI), Segmentation Report. After you have defined your target segments, you can use this task to understand them. The Core and Developmental Segments Report identify two distinct groups of segments, and you'll need to understand more about the similarities and differences between the lifestyles of these groups. Using the Tapestry profile of your customers, the MRI Segmentation Report calculates a weighted index that takes into account the percent composition for each segment of your customer profile as compared to the index for that segment for any specific product, service, or lifestyle characteristic. Using this method, you can compare the Tapestry profile of your customers to the Tapestry profile based on a syndicated customer survey conducted by MRI.

MRI conducts surveys that show how individuals or households purchase and use various products and services. If the index value is above 100 for a particular product or service in the survey, this means that these households purchase the product or service at a higher than average rate. For example, let’s say that Tapestry Segment 01: Top Rung has an index of 160 for an MRI item (e.g. Belongs to an Airline Miles Program). In this case, the households in this segment are 1.6 times more likely to belong to an airline miles program than the average household is in the base profile. The base profile could represent the whole United States, or be based on a state or other area including a custom trade area.

The result of this task is a TaskResultOutput object, which is compatible with ArcGIS Server's mapping APIs. The output report is specified as a single item of the array of ReportInfo objects in it. Additionally, the output report can be stored to the Business Analyst Server repository.

See also

UnderstandingTargetCustomersParameters
TaskResultOutput


Public Properties
 PropertyDefined By
 InheritedactiveDatasetID : String
Active dataset ID.
BAServerTask
 Inheritedconcurrency : String
Value that indicates how to handle multiple calls to the same task.
AbstractTask
 InheriteddisableClientCaching : Boolean
If true, adds a timestamp parameter ("_ts") to the REST request to prevent the request from being loaded from the browser's cache.
AbstractTask
 InheritedisFullErrorMessage : Boolean
Produce an error message with stack trace (true) or without stack trace (false).
BAServerTask
  lastResult : TaskResultOutput
[read-only] The last result of executing the Understanding Target Customers task.
UnderstandingTargetCustomersTask
 InheritedproxyURL : String
The URL to proxy the request through.
AbstractTask
 InheritedrequestTimeout : Number
The request timeout in seconds.
AbstractTask
 InheritedshowBusyCursor : Boolean
If true, a busy cursor is displayed while a service is executing.
AbstractTask
 Inheritedtoken : String
Token for accessing a secure task.
AbstractTask
 InheritedtokenProvider : ITokenProvider
Provider responsible for updating the security token if the last one expires.
BATask
 Inheritedurl : String
URL of the task.
AbstractTask
Public Methods
 MethodDefined By
  
UnderstandingTargetCustomersTask(urlOrClient:Object = null)
Creates a new instance of the UnderstandingTargetCustomersTask class.
UnderstandingTargetCustomersTask
  
createCommand(parameters:UnderstandingTargetCustomersParameters, commandName:String = null):BACommand
Creates a new command encapsulating this task and the given parameters.
UnderstandingTargetCustomersTask
  
execute(parameters:UnderstandingTargetCustomersParameters, responder:IResponder = null):AsyncToken
Sends a request for executing a Understanding Target Customers task to the Business Analyst Server HTTP (REST) Service.
UnderstandingTargetCustomersTask
Events
 Event Summary Defined By
 InheritedThe fault event is dispatched when an asynchronous execution of a Community Analyst Task fails.BATask
 InheritedThe taskCompleted event is dispatched when an asynchronous execution of a Community Analyst Task successfully completes.BATask
Public Constants
 ConstantDefined By
  name : String = UnderstandingTargetCustomers
[static] Task name.
UnderstandingTargetCustomersTask
Property Detail
lastResultproperty
lastResult:TaskResultOutput  [read-only]

The last result of executing the Understanding Target Customers task.


Implementation
    public function get lastResult():TaskResultOutput
Constructor Detail
UnderstandingTargetCustomersTask()Constructor
public function UnderstandingTargetCustomersTask(urlOrClient:Object = null)

Creates a new instance of the UnderstandingTargetCustomersTask class.

A new task can be constructed in two ways: as a task sharing a BAServerClient type instance with other tasks (the urlOrClient parameter has the BAServerClient type) or as a standalone task encapsulating its own client.

The base URL to the Business Analyst Server HTTP Service looks as follows:

http://{host}:{port}/ArcGIS/baserver/REST/services/DefaultMap/BAServer

The {host} and {port} parameters in this URL should be substituted with valid Business Analyst Server host name and port, respectively.

Parameters
urlOrClient:Object (default = null) — A variable containing either Business Analyst Server HTTP Service base URL string or an instance of the BAServerClient class.

See also

Method Detail
createCommand()method
public function createCommand(parameters:UnderstandingTargetCustomersParameters, commandName:String = null):BACommand

Creates a new command encapsulating this task and the given parameters.

Parameters

parameters:UnderstandingTargetCustomersParameters — Parameters of a task to be executed.
 
commandName:String (default = null) — Command name.

Returns
BACommand — A new command.
execute()method 
public function execute(parameters:UnderstandingTargetCustomersParameters, responder:IResponder = null):AsyncToken

Sends a request for executing a Understanding Target Customers task to the Business Analyst Server HTTP (REST) Service.

A response can be received in two ways—in an optional responder object passed in parameters of this method and/or in listeners of fault and taskCompleted events registered for this task.

The responder is notified first when a response is received and parsed. Its fault method receives a parameter of the FaultEvent type and its result method receives a parameter of the BATaskCompletedEvent type whose result property contains the result object. After that the received event is dispatched to listeners of this task.

If a response is succesfully received and parsed, the result is assigned to the lastResult property of this task.

Parameters

parameters:UnderstandingTargetCustomersParameters — Parameters of the task.
 
responder:IResponder (default = null) — A responder to call on result or fault.

Returns
AsyncToken — Asynch token associated with the response.
Constant Detail
nameConstant
public static const name:String = UnderstandingTargetCustomers

Task name.