CSharp-SDK - 3.0.0

4 min

The 3.0 release improves event tracking and supports additional audience targeting functionality.

The track method now dispatches its conversion event unconditionally, without first determining whether the user is targeted by a known experiment that uses the event. This may increase outbound network traffic.

In Optimizely results, conversion events sent by 3.0 SDKs don't explicitly name the experiments and variations that are currently targeted to the user. Instead, conversions are automatically attributed to variations that the user has previously seen, as long as those variations were served via 3.0 SDKs or by other clients capable of automatic attribution, and as long as our backend actually received the impression events for those variations.

Altogether, this allows you to track conversion events and attribute them to variations even when you don't know all of a user's attribute values, and even if the user's attribute values or the experiment's configuration have changed such that the user is no longer affected by the experiment. As a result, you may observe an increase in the conversion rate for previously-instrumented events. If that is undesirable, you can reset the results of previously-running experiments after upgrading to the 3.0 SDK.

This will also allow you to attribute events to variations from other Optimizely projects in your account, even though those experiments don't appear in the same datafile.

Note that for results segmentation in Optimizely results, the user attribute values from one event are automatically applied to all other events in the same session, as long as the events in question were actually received by our backend. This behavior was already in place and is not affected by the 3.0 release.

Strings, booleans, and valid numbers are passed to the event dispatcher and can be used for Optimizely results segmentation. A valid number is a finite number in the inclusive range [-2⁵³, 2⁵³].

An exists matcher that passes if the user has a non-null value for the targeted user attribute and fails otherwise.

A substring matcher that resolves if the user has a string value for the targeted attribute.

gt (greater than) and lt (less than) matchers that resolve if the user has a valid number value for the targeted attribute. A valid number is a finite number in the inclusive range [-2⁵³, 2⁵³].

The original (exact) matcher can now be used to target booleans and valid numbers, not just strings.

Support for A/B tests, feature tests, and feature rollouts whose audiences are combined using "and" and "not" operators, not just the "or" operator.

Datafile-version compatibility check: The SDK will remain uninitialized (i.e., will gracefully fail to activate experiments and features) if given a datafile version greater than 4.

Conversion events sent by 3.0 SDKs don't explicitly name the experiments and variations that are currently targeted to the user, so these events are unattributed in raw events data export. You must use the new results export to determine the variations to which events have been attributed.

UserAttributes objects, which are passed to API methods and returned to notification listeners, can now contain non-string values. More concretely, UserAttributes now extends Dictionary instead of Dictionary.

Experiments and features can no longer activate when a negatively targeted attribute has a missing, null, or malformed value. (#132)

Audience conditions (except for the new exists matcher) no longer resolve to false when they fail to find an legitimate value for the targeted user attribute. The result remains null (unknown). Therefore, an audience that negates such a condition (using the "not" operator) can no longer resolve to true unless there is an unrelated branch in the condition tree that itself resolves to true.

SetForcedVariation now treats an empty variation key as invalid and does not reset the variation. (#113)

You can now specify 0 or 1 as the revenue or value for a conversion event when using the Track method. Previously, 0 and 1 were withheld, would not appear in your data export, and in the case of 1 would not contribute to the user's total revenue or value.