Merge pull request #52 from adjust/v4290

Version 4.29.0

.gitignore

@@ -1,13 +1,3 @@
-.DS_Store
-.atom/
-.dart_tool/
-.idea
-.packages
-.pub/
-build/
-ios/.generated/
-packages
-
 # Miscellaneous
 *.class
 *.lock
@@ -27,24 +17,39 @@ packages
 .idea/
 
 # Visual Studio Code related
+.classpath
+.project
+.settings/
 .vscode/
 
 # Flutter repo-specific
 /bin/cache/
+/bin/internal/bootstrap.bat
+/bin/internal/bootstrap.sh
 /bin/mingit/
 /dev/benchmarks/mega_gallery/
 /dev/bots/.recipe_deps
 /dev/bots/android_tools/
+/dev/devicelab/ABresults*.json
 /dev/docs/doc/
+/dev/docs/flutter.docs.zip
 /dev/docs/lib/
 /dev/docs/pubspec.yaml
+/dev/integration_tests/**/xcuserdata
+/dev/integration_tests/**/Pods
 /packages/flutter/coverage/
 version
+analysis_benchmark.json
+
+# packages file containing multi-root paths
+.packages.generated
 
 # Flutter/Dart/Pub related
 **/doc/api/
 .dart_tool/
 .flutter-plugins
+.flutter-plugins-dependencies
+**/generated_plugin_registrant.dart
 .packages
 .pub-cache/
 .pub/
@@ -62,6 +67,8 @@ unlinked_spec.ds
 **/android/gradlew.bat
 **/android/local.properties
 **/android/**/GeneratedPluginRegistrant.java
+**/android/key.properties
+*.jks
 
 # iOS/XCode related
 **/ios/**/*.mode1v3
@@ -80,18 +87,32 @@ unlinked_spec.ds
 **/ios/**/profile
 **/ios/**/xcuserdata
 **/ios/.generated/
+**/ios/Flutter/.last_build_id
 **/ios/Flutter/App.framework
 **/ios/Flutter/Flutter.framework
+**/ios/Flutter/Flutter.podspec
 **/ios/Flutter/Generated.xcconfig
+**/ios/Flutter/ephemeral
 **/ios/Flutter/app.flx
 **/ios/Flutter/app.zip
 **/ios/Flutter/flutter_assets/
+**/ios/Flutter/flutter_export_environment.sh
 **/ios/ServiceDefinitions.json
 **/ios/Runner/GeneratedPluginRegistrant.*
 
+# macOS
+**/macos/Flutter/GeneratedPluginRegistrant.swift
+
+# Coverage
+coverage/
+
+# Symbols
+app.*.symbols
+
 # Exceptions to above rules.
 !**/ios/**/default.mode1v3
 !**/ios/**/default.mode2v3
 !**/ios/**/default.pbxuser
 !**/ios/**/default.perspectivev3
-!/packages/flutter_tools/test/data/dart_dependencies_test/**/.packages
+!/packages/flutter_tools/test/data/dart_dependencies_test/**/.packages
+!/dev/ci/**/Gemfile.lock

CHANGELOG.md

@@ -1,3 +1,21 @@
+### Version 4.29.0 (11th June 2021)
+#### Added
+- Added support for null safety (thanks to @blaueeiner).
+- [beta] Added data residency feature. You can choose this setting by setting `urlStrategy` member of `AdjustConfig` instance to `AdjustConfig.DataResidencyEU` (for EU data residency region), `AdjustConfig.DataResidencyTR` (for TR data residency region) or `AdjustConfig.DataResidencyUS` value (for US data residency region).
+- Added `trackAdRevenueNew` method to `Adjust` interface to allow tracking of ad revenue by passing `AdjustAdRevenue` object as parameter.
+- Added support for `AppLovin MAX` ad revenue tracking.
+- Added `conversionValueUpdatedCallback` member to `AdjustConfig` which can be used to set a callback which will get information when Adjust SDK updates conversion value for the user.
+- Added preinstall tracking with usage of system installer receiver on Android platform.
+
+#### Fixed
+- Fixed attribution value comparison logic which might cause same attribution value to be delivered into attribution callback on iOS platform.
+
+#### Native SDKs
+- [[email protected]][ios_sdk_v4.29.2]
+- [[email protected]][android_sdk_v4.28.1]
+
+---
+
 ### Version 4.28.0 (2nd April 2021)
 #### Changed
 - Removed native iOS legacy code.
@@ -207,6 +225,7 @@
 [ios_sdk_v4.23.2]: https://github.com/adjust/ios_sdk/tree/v4.23.2
 [ios_sdk_v4.26.1]: https://github.com/adjust/ios_sdk/tree/v4.26.1
 [ios_sdk_v4.28.0]: https://github.com/adjust/ios_sdk/tree/v4.28.0
+[ios_sdk_v4.29.2]: https://github.com/adjust/ios_sdk/tree/v4.29.2
 
 [android_sdk_v4.17.0]: https://github.com/adjust/android_sdk/tree/v4.17.0
 [android_sdk_v4.18.0]: https://github.com/adjust/android_sdk/tree/v4.18.0
@@ -215,4 +234,5 @@
 [android_sdk_v4.24.0]: https://github.com/adjust/android_sdk/tree/v4.24.0
 [android_sdk_v4.24.1]: https://github.com/adjust/android_sdk/tree/v4.24.1
 [android_sdk_v4.26.2]: https://github.com/adjust/android_sdk/tree/v4.26.2
-[android_sdk_v4.27.0]: https://github.com/adjust/android_sdk/tree/v4.27.0
+[android_sdk_v4.27.0]: https://github.com/adjust/android_sdk/tree/v4.27.0
+[android_sdk_v4.28.1]: https://github.com/adjust/android_sdk/tree/v4.28.1

README.md

@@ -58,6 +58,7 @@ This is the Flutter SDK of Adjust™. You can read more about Adjust™ at [adju
       * [Get current authorisation status](#af-ata-getter)
    * [SKAdNetwork framework](#af-skadn-framework)
       * [Update SKAdNetwork conversion value](#af-skadn-update-conversion-value)
+      * [Conversion value updated callback](#af-skadn-cv-updated-callback)
    * [Subscription tracking](#af-subscription-tracking)
    * [Push token (uninstall tracking)](#af-push-token)
    * [Attribution callback](#af-attribution-callback)
@@ -78,6 +79,7 @@ This is the Flutter SDK of Adjust™. You can read more about Adjust™ at [adju
       * [Disable third-party sharing](#af-disable-third-party-sharing)
       * [Enable third-party sharing](#af-enable-third-party-sharing)
    * [Measurement consent](#af-measurement-consent)
+   * [[beta] Data residency](#af-data-residency)
 
 ### License
 
@@ -98,7 +100,7 @@ You can add Adjust SDK to your Flutter app by adding following to your `pubspec.
 
 ```yaml
 dependencies:
-  adjust_sdk: ^4.28.0
+  adjust_sdk: ^4.29.0
 ```
 
 Then navigate to your project in the terminal and run:
@@ -710,6 +712,18 @@ You can use Adjust SDK wrapper method `updateConversionValue` to update SKAdNetw
 Adjust.updateConversionValue(6);
 ```
 
+### <a id="af-skadn-cv-updated-callback"></a>Conversion value updated callback
+
+You can register callback to get notified each time when Adjust SDK updates conversion value for the user.
+
+```dart
+AdjustConfig adjustConfig = new AdjustConfig(yourAppToken, environment);
+config.conversionValueUpdatedCallback = (num? conversionValue) {
+  print('[Adjust]: Received conversion value update: ' + conversionValue!.toString());
+};
+Adjust.start(adjustConfig);
+```
+
 ### <a id="af-subscription-tracking"></a>Subscription tracking
 
 **Note**: This feature is only available in the SDK v4.22.0 and above.
@@ -874,6 +888,11 @@ The callback function will be called after the SDK receives the final attributio
 - `creative` the creative grouping level string of the current attribution.
 - `clickLabel` the click label string of the current attribution.
 - `adid` the Adjust device identifier string.
+- `costType` the cost type string
+- `costAmount` the cost amount
+- `costCurrency` the cost currency string
+
+**Note**: The cost data - `costType`, `costAmount` & `costCurrency` are only available when configured in `AdjustConfig` by setting `needsCost` member to `true`. If not configured or configured, but not being part of the attribution, these fields will have value `null`. This feature is available in SDK v4.26.0 and later.
 
 ### <a id="af-session-event-callbacks"></a>Session and event callbacks
 
@@ -1163,6 +1182,18 @@ Adjust.trackMeasurementConsent(true);
 
 Upon receiving this information, Adjust changes sharing the specific user's data to partners. The Adjust SDK will continue to work as expected.
 
+### <a id="af-data-residency"></a>[beta] Data residency
+
+In order to enable data residency feature, make sure to set `urlStrategy` member of the `AdjustConfig` instance with one of the following constants:
+
+```dart
+adjustConfig.urlStrategy = AdjustConfig.DataResidencyEU; // for EU data residency region
+adjustConfig.urlStrategy = AdjustConfig.DataResidencyTR; // for Turkey data residency region
+adjustConfig.urlStrategy = AdjustConfig.DataResidencyUS; // for US data residency region
+```
+
+**Note:** This feature is currently in beta testing phase. If you are interested in getting access to it, please contact your dedicated account manager or write an email to [email protected]. Please, do not turn this setting on before making sure with the support team that this feature is enabled for your app because otherwise SDK traffic will get dropped.
+
 [dashboard]:  http://adjust.com
 [adjust.com]: http://adjust.com
 

VERSION

@@ -1 +1 @@
-4.28.0
+4.29.0

android/build.gradle

@@ -36,5 +36,5 @@ android {
 }
 
 dependencies {
-    api 'com.adjust.sdk:adjust-android:4.27.0'
+    api 'com.adjust.sdk:adjust-android:4.28.1'
 }