Skip to main content

Contextual Attributes

Using real-time data for better treatment distribution

Auxia's decisioning system delivers the best performance when it uses real-time data.

Contextual attributes, in the GetTreatments request, provide a way to enrich each request with the current context of the user's recent behavior. This information is used during model training and scoring to provide more context and better treatment recommendations.

Example

Let's take an example of a marketplace use case, where we want to show treatment on the item listing page.

One critical contextual attribute for this use case is the information about the item that the user is currently looking at, like the product category. To deliver better treatments in real-time, we suggest customers pass back this detail in the request.

FieldTypeDescription
keystringIdentifier for the user attribute
oneofstringValuestringValue in string type.
integerValueint64Value in integer type.
doubleValuedoubleValue in double type.
booleanValueboolValue in boolean type.
boolValueboolValue in boolean type.
timestampValuestring

Format of the timestamp should be as per ISO format. https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/timestamp.proto#L108 For example, "2017-01-15T01:30:15.01Z" encodes 15.01 seconds past 01:30 UTC on January 15, 2017.

timestampMicrosValueint64Timestamp value in epoch micros.