From f247c2ae2c2e8c370ff56cef666fd65e751144c8 Mon Sep 17 00:00:00 2001 From: Juan Carlos Tong Date: Thu, 28 Feb 2019 13:27:49 -0800 Subject: [PATCH 1/6] chore(update version) --- OptimizelySDK.DemoApp/Properties/AssemblyInfo.cs | 6 +++--- OptimizelySDK.Net35/Properties/AssemblyInfo.cs | 6 +++--- OptimizelySDK.Net40/Properties/AssemblyInfo.cs | 6 +++--- OptimizelySDK.Tests/Properties/AssemblyInfo.cs | 6 +++--- OptimizelySDK/Properties/AssemblyInfo.cs | 6 +++--- 5 files changed, 15 insertions(+), 15 deletions(-) diff --git a/OptimizelySDK.DemoApp/Properties/AssemblyInfo.cs b/OptimizelySDK.DemoApp/Properties/AssemblyInfo.cs index 3208b912..5d98a26f 100644 --- a/OptimizelySDK.DemoApp/Properties/AssemblyInfo.cs +++ b/OptimizelySDK.DemoApp/Properties/AssemblyInfo.cs @@ -37,6 +37,6 @@ // // You can specify all the values or you can default the Revision and Build Numbers // by using the '*' as shown below: -[assembly: AssemblyVersion("2.2.2.0")] -[assembly: AssemblyFileVersion("2.2.2.0")] -[assembly: AssemblyInformationalVersion("2.2.2")] // Used by Nuget. +[assembly: AssemblyVersion("3.0.0.0")] +[assembly: AssemblyFileVersion("3.0.0.0")] +[assembly: AssemblyInformationalVersion("3.0.0")] // Used by Nuget. diff --git a/OptimizelySDK.Net35/Properties/AssemblyInfo.cs b/OptimizelySDK.Net35/Properties/AssemblyInfo.cs index 1aeb699b..fae304a4 100644 --- a/OptimizelySDK.Net35/Properties/AssemblyInfo.cs +++ b/OptimizelySDK.Net35/Properties/AssemblyInfo.cs @@ -38,6 +38,6 @@ // You can specify all the values or you can default the Build and Revision Numbers // by using the '*' as shown below: // [assembly: AssemblyVersion("1.0.*")] -[assembly: AssemblyVersion("2.2.2.0")] -[assembly: AssemblyFileVersion("2.2.2.0")] -[assembly: AssemblyInformationalVersion("2.2.2")] // Used by Nuget. +[assembly: AssemblyVersion("3.0.0.0")] +[assembly: AssemblyFileVersion("3.0.0.0")] +[assembly: AssemblyInformationalVersion("3.0.0")] // Used by Nuget. diff --git a/OptimizelySDK.Net40/Properties/AssemblyInfo.cs b/OptimizelySDK.Net40/Properties/AssemblyInfo.cs index 908e389b..1cec0721 100644 --- a/OptimizelySDK.Net40/Properties/AssemblyInfo.cs +++ b/OptimizelySDK.Net40/Properties/AssemblyInfo.cs @@ -38,6 +38,6 @@ // You can specify all the values or you can default the Build and Revision Numbers // by using the '*' as shown below: // [assembly: AssemblyVersion("1.0.*")] -[assembly: AssemblyVersion("2.2.2.0")] -[assembly: AssemblyFileVersion("2.2.2.0")] -[assembly: AssemblyInformationalVersion("2.2.2")] // Used by Nuget. +[assembly: AssemblyVersion("3.0.0.0")] +[assembly: AssemblyFileVersion("3.0.0.0")] +[assembly: AssemblyInformationalVersion("3.0.0")] // Used by Nuget. diff --git a/OptimizelySDK.Tests/Properties/AssemblyInfo.cs b/OptimizelySDK.Tests/Properties/AssemblyInfo.cs index 7a02c1b1..d165f49c 100644 --- a/OptimizelySDK.Tests/Properties/AssemblyInfo.cs +++ b/OptimizelySDK.Tests/Properties/AssemblyInfo.cs @@ -31,6 +31,6 @@ // // You can specify all the values or you can default the Revision and Build Numbers // by using the '*' as shown below: -[assembly: AssemblyVersion("2.2.2.0")] -[assembly: AssemblyFileVersion("2.2.2.0")] -[assembly: AssemblyInformationalVersion("2.2.2")] // Used by Nuget. +[assembly: AssemblyVersion("3.0.0.0")] +[assembly: AssemblyFileVersion("3.0.0.0")] +[assembly: AssemblyInformationalVersion("3.0.0")] // Used by Nuget. diff --git a/OptimizelySDK/Properties/AssemblyInfo.cs b/OptimizelySDK/Properties/AssemblyInfo.cs index 61123a0e..098e2add 100644 --- a/OptimizelySDK/Properties/AssemblyInfo.cs +++ b/OptimizelySDK/Properties/AssemblyInfo.cs @@ -38,6 +38,6 @@ // You can specify all the values or you can default the Build and Revision Numbers // by using the '*' as shown below: // [assembly: AssemblyVersion("1.0.*")] -[assembly: AssemblyVersion("2.2.2.0")] -[assembly: AssemblyFileVersion("2.2.2.0")] -[assembly: AssemblyInformationalVersion("2.2.0")] // Used by Nuget. +[assembly: AssemblyVersion("3.0.0.0")] +[assembly: AssemblyFileVersion("3.0.0.0")] +[assembly: AssemblyInformationalVersion("3.0.0")] // Used by Nuget. From 0e418fa7a0f8868a5ea980b6dae2e224acbb7ab8 Mon Sep 17 00:00:00 2001 From: Juan Carlos Tong Date: Thu, 28 Feb 2019 13:48:15 -0800 Subject: [PATCH 2/6] chore(update copyright) --- OptimizelySDK.DemoApp/Properties/AssemblyInfo.cs | 2 +- OptimizelySDK.Net35/Properties/AssemblyInfo.cs | 2 +- OptimizelySDK.Net40/Properties/AssemblyInfo.cs | 2 +- OptimizelySDK.Tests/Properties/AssemblyInfo.cs | 2 +- OptimizelySDK/Properties/AssemblyInfo.cs | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/OptimizelySDK.DemoApp/Properties/AssemblyInfo.cs b/OptimizelySDK.DemoApp/Properties/AssemblyInfo.cs index 5d98a26f..1ff454e5 100644 --- a/OptimizelySDK.DemoApp/Properties/AssemblyInfo.cs +++ b/OptimizelySDK.DemoApp/Properties/AssemblyInfo.cs @@ -10,7 +10,7 @@ [assembly: AssemblyConfiguration("")] [assembly: AssemblyCompany("")] [assembly: AssemblyProduct("OptimizelySDK.DemoApp")] -[assembly: AssemblyCopyright("Copyright © 2017-2018")] +[assembly: AssemblyCopyright("Copyright © 2017-2019")] [assembly: AssemblyTrademark("")] [assembly: AssemblyCulture("")] diff --git a/OptimizelySDK.Net35/Properties/AssemblyInfo.cs b/OptimizelySDK.Net35/Properties/AssemblyInfo.cs index fae304a4..484f4cb8 100644 --- a/OptimizelySDK.Net35/Properties/AssemblyInfo.cs +++ b/OptimizelySDK.Net35/Properties/AssemblyInfo.cs @@ -10,7 +10,7 @@ [assembly: AssemblyConfiguration("")] [assembly: AssemblyCompany("")] [assembly: AssemblyProduct("OptimizelySDK.Net35")] -[assembly: AssemblyCopyright("Copyright © 2017-2018")] +[assembly: AssemblyCopyright("Copyright © 2017-2019")] [assembly: AssemblyTrademark("")] [assembly: AssemblyCulture("")] diff --git a/OptimizelySDK.Net40/Properties/AssemblyInfo.cs b/OptimizelySDK.Net40/Properties/AssemblyInfo.cs index 1cec0721..162f8748 100644 --- a/OptimizelySDK.Net40/Properties/AssemblyInfo.cs +++ b/OptimizelySDK.Net40/Properties/AssemblyInfo.cs @@ -10,7 +10,7 @@ [assembly: AssemblyConfiguration("")] [assembly: AssemblyCompany("")] [assembly: AssemblyProduct("OptimizelySDK.Net40")] -[assembly: AssemblyCopyright("Copyright © 2017-2018")] +[assembly: AssemblyCopyright("Copyright © 2017-2019")] [assembly: AssemblyTrademark("")] [assembly: AssemblyCulture("")] diff --git a/OptimizelySDK.Tests/Properties/AssemblyInfo.cs b/OptimizelySDK.Tests/Properties/AssemblyInfo.cs index d165f49c..3b851092 100644 --- a/OptimizelySDK.Tests/Properties/AssemblyInfo.cs +++ b/OptimizelySDK.Tests/Properties/AssemblyInfo.cs @@ -10,7 +10,7 @@ [assembly: AssemblyConfiguration("")] [assembly: AssemblyCompany("")] [assembly: AssemblyProduct("OptimizelySDK.Tests")] -[assembly: AssemblyCopyright("Copyright © 2017-2018")] +[assembly: AssemblyCopyright("Copyright © 2017-2019")] [assembly: AssemblyTrademark("")] [assembly: AssemblyCulture("")] diff --git a/OptimizelySDK/Properties/AssemblyInfo.cs b/OptimizelySDK/Properties/AssemblyInfo.cs index 098e2add..8f2ccbc5 100644 --- a/OptimizelySDK/Properties/AssemblyInfo.cs +++ b/OptimizelySDK/Properties/AssemblyInfo.cs @@ -10,7 +10,7 @@ [assembly: AssemblyConfiguration("")] [assembly: AssemblyCompany("")] [assembly: AssemblyProduct("OptimizelySDK")] -[assembly: AssemblyCopyright("Copyright © 2017-2018")] +[assembly: AssemblyCopyright("Copyright © 2017-2019")] [assembly: AssemblyTrademark("")] [assembly: AssemblyCulture("")] From b6b08cfb399f5fec15797c5bb8edf3abad24776d Mon Sep 17 00:00:00 2001 From: Juan Carlos Tong Date: Thu, 28 Feb 2019 14:29:00 -0800 Subject: [PATCH 3/6] chore(helper scripts) updating version in other helper scripts --- OptimizelySDK.Package/verifysn.ps1 | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/OptimizelySDK.Package/verifysn.ps1 b/OptimizelySDK.Package/verifysn.ps1 index 87e4283c..2bc3db2d 100644 --- a/OptimizelySDK.Package/verifysn.ps1 +++ b/OptimizelySDK.Package/verifysn.ps1 @@ -18,8 +18,8 @@ if ($PSVersionTable["Platform"] -eq "Unix") { # Locate *.nupkg ################################################################ Write-Host "Locate *.nupkg" -# Good enough for 2.2.2 -$nupkg="./Optimizely.SDK.2.2.2.nupkg" +# Good enough for 3.0.0 +$nupkg="./Optimizely.SDK.3.0.0.nupkg" ################################################################ # Unzipping *.nupkg From e80ec0cc4f9945f5759d79174bc92442af0279b2 Mon Sep 17 00:00:00 2001 From: Juan Carlos Tong Date: Thu, 28 Feb 2019 15:45:43 -0800 Subject: [PATCH 4/6] chore(update CHANGELOG.md) --- CHANGELOG.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index f9e8487b..c311ae13 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,36 @@ +## 3.0.0 +February 28, 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 number 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 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. +* Updated Pull Request template and commit message guidelines. +### Breaking Changes: +* `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`. +### 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`. +* `SetForcedVariation` now treats an empty variation key as invalid and does not reset the variation. +* All methods now treat an empty user ID as valid. +* HttpClientEventDispatcher45 now logs full exception ([#112](https://github.com/optimizely/csharp-sdk/pull/112)) +* 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. + ## 2.2.2 January 31, 2019 ### Bug fixes From 523918bd696de86e3926a9aeb73460dc9632a31d Mon Sep 17 00:00:00 2001 From: Juan Carlos Tong Date: Thu, 28 Feb 2019 16:13:49 -0800 Subject: [PATCH 5/6] chore(recommended fixes) --- CHANGELOG.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index c311ae13..496ac724 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,5 @@ ## 3.0.0 -February 28, 2019 +March 4th, 2019 The 3.0 release improves event tracking and supports additional audience targeting functionality. ### New Features: @@ -24,11 +24,11 @@ The 3.0 release improves event tracking and supports additional audience targeti ### Breaking Changes: * `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`. ### Bug Fixes: -* Experiments and features can no longer activate when a negatively targeted attribute has a missing, null, or malformed value. +* Experiments and features can no longer activate when a negatively targeted attribute has a missing, null, or malformed value. ([#132](https://github.com/optimizely/csharp-sdk/pull/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. +* `SetForcedVariation` now treats an empty variation key as invalid and does not reset the variation. ([#113](https://github.com/optimizely/csharp-sdk/pull/113)) * All methods now treat an empty user ID as valid. -* HttpClientEventDispatcher45 now logs full exception ([#112](https://github.com/optimizely/csharp-sdk/pull/112)) +* `HttpClientEventDispatcher45` now logs full exception ([#112](https://github.com/optimizely/csharp-sdk/pull/112)) * 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. ## 2.2.2 From dd576301e29606cc498d53d065b71a2da33acbd5 Mon Sep 17 00:00:00 2001 From: Juan Carlos Tong Date: Thu, 28 Feb 2019 16:30:06 -0800 Subject: [PATCH 6/6] chore(update release date) --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 496ac724..d71a0857 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,5 @@ ## 3.0.0 -March 4th, 2019 +March 1st, 2019 The 3.0 release improves event tracking and supports additional audience targeting functionality. ### New Features: