diff --git a/CHANGELOG.md b/CHANGELOG.md index b07c65b..0e77038 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,56 @@ # Optimizely Flutter SDK Changelog +## 2.0.0 +January 23, 2024 + +### New Features + +The 2.0.0 release introduces a new primary feature, [Advanced Audience Targeting]( https://docs.developers.optimizely.com/feature-experimentation/docs/optimizely-data-platform-advanced-audience-targeting) enabled through integration with [Optimizely Data Platform (ODP)](https://docs.developers.optimizely.com/optimizely-data-platform/docs) ([#52](https://github.com/optimizely/optimizely-flutter-sdk/pull/52), [#57](https://github.com/optimizely/optimizely-flutter-sdk/pull/57), [#72](https://github.com/optimizely/optimizely-flutter-sdk/pull/72)). + +You can use ODP, a high-performance [Customer Data Platform (CDP)]( https://www.optimizely.com/optimization-glossary/customer-data-platform/), to easily create complex real-time segments (RTS) using first-party and 50+ third-party data sources out of the box. You can create custom schemas that support the user attributes important for your business, and stitch together user behavior done on different devices to better understand and target your customers for personalized user experiences. ODP can be used as a single source of truth for these segments in any Optimizely or 3rd party tool. + +With ODP accounts integrated into Optimizely projects, you can build audiences using segments pre-defined in ODP. The SDK will fetch the segments for given users and make decisions using the segments. For access to ODP audience targeting in your Feature Experimentation account, please contact your Customer Success Manager. + +This version includes the following changes: + +* New API added to `OptimizelyUserContext`: + + - `fetchQualifiedSegments()`: this API will retrieve user segments from the ODP server. The fetched segments will be used for audience evaluation. The fetched data will be stored in the local cache to avoid repeated network delays. + + - When an `OptimizelyUserContext` is created, the SDK will automatically send an identify request to the ODP server to facilitate observing user activities. + +* New APIs added to `OptimizelyFlutterSdk`: + + - `sendOdpEvent()`: customers can build/send arbitrary ODP events that will bind user identifiers and data to user profiles in ODP. + + - `createUserContext()` with anonymous user IDs: user-contexts can be created without a userId. The SDK will create and use a persistent `VUID` specific to a device when userId is not provided. + +For details, refer to our documentation pages: + +* [Advanced Audience Targeting](https://docs.developers.optimizely.com/feature-experimentation/docs/optimizely-data-platform-advanced-audience-targeting) + +* [Client SDK Support](https://docs.developers.optimizely.com/feature-experimentation/v1.0/docs/advanced-audience-targeting-for-client-side-sdks) + +* [Initialize Flutter SDK](https://docs.developers.optimizely.com/feature-experimentation/docs/initialize-sdk-flutter) + +* [OptimizelyUserContext Flutter SDK](https://docs.developers.optimizely.com/feature-experimentation/docs/optimizelyusercontext-flutter) + +* [Advanced Audience Targeting segment qualification methods](https://docs.developers.optimizely.com/feature-experimentation/docs/advanced-audience-targeting-segment-qualification-methods-flutter) + +* [Send Optimizely Data Platform data using Advanced Audience Targeting](https://docs.developers.optimizely.com/feature-experimentation/docs/send-odp-data-using-advanced-audience-targeting-flutter) + + +### Bug Fixes + +* Crash fixed, fetchQualifiedSegments without options ([#64](https://github.com/optimizely/optimizely-flutter-sdk/pull/64)). +* Fix proguard for logback and dart version ([#68](https://github.com/optimizely/optimizely-flutter-sdk/pull/68)). + +### Functionality Enhancements + +* Add specific client name support to track event ([#72](https://github.com/optimizely/optimizely-flutter-sdk/pull/72)). +* Update Github Issue Templates ([#65](https://github.com/optimizely/optimizely-flutter-sdk/pull/65)). +* Add configurable log level support ([#63](https://github.com/optimizely/optimizely-flutter-sdk/pull/63)). + ## 2.0.0-beta September 21, 2023 diff --git a/README.md b/README.md index e8a6edf..2de1dd5 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,7 @@ Other Flutter platforms are not currently supported by this SDK. To add the flutter-sdk to your project dependencies, include the following in your app's pubspec.yaml: ``` - optimizely_flutter_sdk: ^1.0.1 + optimizely_flutter_sdk: ^2.0.0 ``` Then run diff --git a/lib/package_info.dart b/lib/package_info.dart index 4c8df19..adef0b3 100644 --- a/lib/package_info.dart +++ b/lib/package_info.dart @@ -3,5 +3,5 @@ class PackageInfo { static const String name = 'optimizely_flutter_sdk'; - static const String version = '2.0.0-beta'; -} \ No newline at end of file + static const String version = '2.0.0'; +} diff --git a/pubspec.yaml b/pubspec.yaml index bda345b..7ffd848 100644 --- a/pubspec.yaml +++ b/pubspec.yaml @@ -1,6 +1,6 @@ name: optimizely_flutter_sdk description: This repository houses the Flutter SDK for use with Optimizely Feature Experimentation, Optimizely Full Stack (legacy), and Optimizely Rollouts. -version: 2.0.0-beta +version: 2.0.0 homepage: https://github.com/optimizely/optimizely-flutter-sdk environment: diff --git a/test/optimizely_flutter_sdk_test.dart b/test/optimizely_flutter_sdk_test.dart index dd6bd7a..821e234 100644 --- a/test/optimizely_flutter_sdk_test.dart +++ b/test/optimizely_flutter_sdk_test.dart @@ -1589,14 +1589,14 @@ void main() { TestUtils.sendTestTrackClientNameAndVersion( callHandler, 0, testSDKKey, "flutter/swift-sdk", "2.0.0"); TestUtils.sendTestTrackClientNameAndVersion( - callHandler, 0, testSDKKey, "flutter/android-sdk", "2.0.0-beta"); + callHandler, 0, testSDKKey, "flutter/android-sdk", "2.0.0"); expect(responses.length == 2, true); expect(responses[0]!.eventTags!["client_name"], "flutter/swift-sdk"); expect(responses[0]!.eventTags!["client_version"], "2.0.0"); expect(responses[1]!.eventTags!["client_name"], "flutter/android-sdk"); - expect(responses[1]!.eventTags!["client_version"], "2.0.0-beta"); + expect(responses[1]!.eventTags!["client_version"], "2.0.0"); }); @@ -1611,7 +1611,7 @@ void main() { var callHandler = OptimizelyClientWrapper.methodCallHandler; tester?.setMockMethodCallHandler(channel, callHandler); TestUtils.sendTestClientNameAndVersionLogEventNotification( - callHandler, 0, testSDKKey, "flutter/android-sdk", "2.0.0-beta"); + callHandler, 0, testSDKKey, "flutter/android-sdk", "2.0.0"); TestUtils.sendTestClientNameAndVersionLogEventNotification( callHandler, 0, testSDKKey, "flutter/swift-sdk", "2.0.0"); @@ -1619,7 +1619,7 @@ void main() { expect(responses.length == 2, true); expect(responses[0]!.params!["client_name"], "flutter/android-sdk"); - expect(responses[0]!.params!["client_version"], "2.0.0-beta"); + expect(responses[0]!.params!["client_version"], "2.0.0"); expect(responses[1]!.params!["client_name"], "flutter/swift-sdk"); expect(responses[1]!.params!["client_version"], "2.0.0"); });