diff --git a/CHANGELOG.md b/CHANGELOG.md index 047e297a..98717ca3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,8 +1,36 @@ -## [Unreleased] -Changes that have landed in master but are not yet released. -- fix(whitelisting): Whitelisted variation should continue when no valid variation is found. ([#123](https://github.com/optimizely/php-sdk/pull/123)) -- refac: Renames notification-center methods. ([#120](https://github.com/optimizely/php-sdk/pull/120)) -- fix: Validate Inputs for activate/track/getVariation. ([#105](https://github.com/optimizely/php-sdk/pull/105)) +## 3.0.0 +March 6th, 2019 + +The 3.0 release improves event tracking and supports additional audience targeting functionality. +### New Features: +* Event tracking: + * 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 are automatically attributed to variations that the user has previously seen, as long as our backend has 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. +* Support for all types of attribute values, not just strings. + * All values are passed through to notification listeners. + * 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 float or int in the inclusive range [-2⁵³, 2⁵³]. + * Strings, booleans, and valid numbers are relevant for audience conditions. +* Support for additional matchers in audience conditions: + * 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 float or int 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. +* Updated Pull Request template and commit message guidelines. + +### Breaking Changes: +* Previously, notification listeners were only given string-valued user attributes because only strings could be passed into various method calls. That is no longer the case. You may pass non-string attribute values, and if you do, you must update your notification listeners to be able to receive whatever values you pass in. + * We're also renaming the `clearNotifications` and `cleanAllNotifications` methods. They're now called `clearNotificationListeners` and `clearAllNotificationListeners`, respectively. The original methods are now deprecated and will be dropped in a future release. ([#120](https://github.com/optimizely/php-sdk/pull/120)) + +### Bug Fixes: +* Experiments and features can no longer activate when a negatively targeted attribute has a missing, null, or malformed value. + * 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`. +* All methods now validate that user IDs are strings and that experiment keys, feature keys, feature variable keys, and event keys are non-empty strings. +* Ignore the user's whitelisted variation if it has been stopped. ([#123](https://github.com/optimizely/php-sdk/pull/123)) ## 2.2.1 November 14th, 2018 diff --git a/src/Optimizely/Event/Builder/EventBuilder.php b/src/Optimizely/Event/Builder/EventBuilder.php index f2c56de8..6ef7c660 100644 --- a/src/Optimizely/Event/Builder/EventBuilder.php +++ b/src/Optimizely/Event/Builder/EventBuilder.php @@ -38,7 +38,7 @@ class EventBuilder /** * @const string Version of the Optimizely PHP SDK. */ - const SDK_VERSION = '2.2.1'; + const SDK_VERSION = '3.0.0'; /** * @var string URL to send event to. diff --git a/tests/EventTests/EventBuilderTest.php b/tests/EventTests/EventBuilderTest.php index 5d9dba10..16f37cbb 100644 --- a/tests/EventTests/EventBuilderTest.php +++ b/tests/EventTests/EventBuilderTest.php @@ -68,7 +68,7 @@ public function setUp() ]], 'revision' => '15', 'client_name' => 'php-sdk', - 'client_version' => '2.2.1', + 'client_version' => '3.0.0', 'anonymize_ip'=> false, 'enrich_decisions' => true, ];