PredictorClient.PredictMostLikelySegment
.gif "Ee784533.c++_on(en-US,CS.10).gif")
.gif "Ee784533.vb_off(en-US,CS.10).gif")
Use this method to predict the most likely segment of a population to which a user, the current case, belongs.
Definition
Function PredictMostLikelySegment(dCurrentCase As Object,Optional pvarProbability As Variant) As String
Parameters
dCurrentCase
A Dictionary object that contains the current case.
pvarProbability
A Variant used to return the membership probability associated with the segment name.
Return Values
If successful, this method returns a String containing the segment name.
Error Values
This method sets the Number property of the global Err object to S_OK (&H00000000) to indicate success and to standard COM error values to indicate failure. For more information about standard COM errors, see Standard COM Errors. Additional information may be available using the global Err object. In particular, the Description property may contain a text description of the error.
Remarks
The Microsoft Research Cluster Engine Data Modeler groups similar users into segments. Similar segments are further grouped into higher order collections of segments, creating a hierarchy from which to analyze trends and discover hidden correlations.
This method returns the name of the segment most likely to contain the given case, and optionally, the probability that the user belongs to this segment.
Load the segment model using the LoadModelFromDB or LoadModelFromFile methods prior to using this method.
For more information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.
Example
' sSegment is a String, vProbabilty is a Variant
' dCase is a Commerce.Dictionary object
sSegment = oPredictorClient.PredictMostLikelySegment(dCase, vProbability)