Merge pull request #52 from adjust/v4210

Version 4.21.0

CHANGELOG.md

@@ -1,3 +1,24 @@
+### Version 4.21.0 (10th April 2020)
+#### Added
+- Added support for Huawei App Gallery install referrer.
+- Added `disableThirdPartySharing` method to `Adjust` interface to allow disabling of data sharing with third parties outside of Adjust ecosystem.
+- Added external device ID support.
+- Added support for signature library as a plugin.
+- Added more aggressive sending retry logic for install session package.
+- Added additional parameters to `ad_revenue` package payload.
+
+#### Changed
+- Updated communication flow with `iAd.framework`.
+
+#### Fixed
+- Fixed lack of `trackAdRevenue` method definition in iOS extension.
+
+#### Native SDKs
+- [[email protected]][ios_sdk_v4.21.1]
+- [[email protected]][android_sdk_v4.21.1]
+
+---
+
 ### Version 4.18.0 (26th November 2019)
 #### Added
 - Added 64-bit support to ANE for Android platform.
@@ -419,6 +440,7 @@
 [ios_sdk_v4.14.1]: https://github.com/adjust/ios_sdk/tree/v4.14.1
 [ios_sdk_v4.17.1]: https://github.com/adjust/ios_sdk/tree/v4.17.1
 [ios_sdk_v4.18.3]: https://github.com/adjust/ios_sdk/tree/v4.18.3
+[ios_sdk_v4.21.1]: https://github.com/adjust/ios_sdk/tree/v4.21.1
 
 [android_sdk_v2.1.3]: https://github.com/adjust/android_sdk/tree/v2.1.3
 [android_sdk_v2.1.4]: https://github.com/adjust/android_sdk/tree/v2.1.4
@@ -439,3 +461,4 @@
 [android_sdk_v4.14.0]: https://github.com/adjust/android_sdk/tree/v4.14.0
 [android_sdk_v4.17.0]: https://github.com/adjust/android_sdk/tree/v4.17.0
 [android_sdk_v4.18.4]: https://github.com/adjust/android_sdk/tree/v4.18.4
+[android_sdk_v4.21.1]: https://github.com/adjust/android_sdk/tree/v4.21.1

README.md

@@ -15,6 +15,7 @@ This is the Adobe AIR SDK of Adjust™. You can read more about Adjust™ at [Ad
    * [Install referrer](#install-referrer)
       * [Google Play Referrer API](#gpr-api)
       * [Google Play Store intent](#gps-intent)
+      * [Huawei Referrer API](#huawei-referrer-api)
    * [Proguard settings](#sdk-proguard)
 * [Additional features](#additional-features)
    * [Event tracking](#event-tracking)
@@ -34,6 +35,7 @@ This is the Adobe AIR SDK of Adjust™. You can read more about Adjust™ at [Ad
    * [Offline mode](#offline-mode)
    * [Event buffering](#event-buffering)
    * [GDPR right to be forgotten](#gdpr-forget-me)
+   * [Disable third-party sharing](#disable-third-party-sharing)
    * [SDK signature](#sdk-signature)
    * [Background tracking](#background-tracking)
    * [Device IDs](#device-ids)
@@ -230,6 +232,10 @@ The Google Play Store `INSTALL_REFERRER` intent should be captured with a broadc
 
 Also, in case you are using your custom broadcast receiver, please make a call to the Adjust broadcast receiver as described in [here][custom-broadcast-receiver].
 
+#### <a id="huawei-referrer-api"></a>Huawei Referrer API
+
+As of v4.21.0, the Adjust SDK supports install tracking on Huawei devices with Huawei App Gallery version 10.4 and higher. No additional integration steps are needed to start using the Huawei Referrer API.
+
 ### <a id="sdk-proguard"></a>Proguard settings
 
 If you are using Proguard, add these lines to your Proguard file:
@@ -677,6 +683,19 @@ Adjust.gdprForgetMe();
 
 Upon receiving this information, Adjust will erase the user's data and the Adjust SDK will stop tracking the user. No requests from this device will be sent to Adjust in the future.
 
+### <a id="disable-third-party-sharing"></a>Disable third-party sharing for specific users
+
+You can now notify Adjust when a user has exercised their right to stop sharing their data with partners for marketing purposes, but has allowed it to be shared for statistics purposes. 
+
+Call the following method to instruct the Adjust SDK to communicate the user's choice to disable data sharing to the Adjust backend:
+
+
+```actionscript
+Adjust.disableThirdPartySharing();
+```
+
+Upon receiving this information, Adjust will block the sharing of that specific user's data to partners and the Adjust SDK will continue to work as usual.
+
 ### <a id="sdk-signature"></a>SDK signature
 
 An account manager must activate the Adjust SDK signature. Contact Adjust support ([email protected]) if you are interested in using this feature.

VERSION

@@ -1 +1 @@
-4.18.0
+4.21.0

default/src/com/adjust/sdk/Adjust.as

@@ -100,6 +100,10 @@ package com.adjust.sdk {
             trace("Adjust: trackAdRevenue called");
         }
 
+        public static function disableThirdPartySharing():void {
+            trace("Adjust: disableThirdPartySharing called");
+        }
+
         public static function setTestOptions(testOptions:AdjustTestOptions):void {
             trace("Adjust: setTestOptions called");
         }

default/src/com/adjust/sdk/AdjustConfig.as

@@ -1,13 +1,13 @@
 package com.adjust.sdk {
     public class AdjustConfig {
-        // For iOS & Android
         private var delayStart:Number;
 
         private var appToken:String;
         private var logLevel:String;
         private var userAgent:String;
         private var environment:String;
         private var defaultTracker:String;
+        private var externalDeviceId:String;
 
         private var sendInBackground:Boolean;
         private var shouldLaunchDeeplink:Boolean;
@@ -27,13 +27,26 @@ package com.adjust.sdk {
         private var info3:String;
         private var info4:String;
 
-        // For Android only
+        // Android only
         private var processName:String;
         private var readMobileEquipmentIdentity:Boolean;
 
+        // iOS only
+        private var allowiAdInfoReading:Boolean;
+        private var allowIdfaReading:Boolean;
+
         public function AdjustConfig(appToken:String, environment:String) {
             this.appToken = appToken;
             this.environment = environment;
+
+            // set Boolean members to their default values
+            this.sendInBackground = false;
+            this.shouldLaunchDeeplink = true;
+            this.eventBufferingEnabled = false;
+            this.isDeviceKnown = false;
+            this.readMobileEquipmentIdentity = false;
+            this.allowiAdInfoReading = true;
+            this.allowIdfaReading = true;
         }
 
         public function setLogLevel(logLevel:String):void {
@@ -60,6 +73,10 @@ package com.adjust.sdk {
             this.defaultTracker = defaultTracker;
         }
 
+        public function setExternalDeviceId(externalDeviceId:String):void {
+            this.externalDeviceId = externalDeviceId;
+        }
+
         public function setProcessName(processName:String):void {
             this.processName = processName;
         }
@@ -122,6 +139,14 @@ package com.adjust.sdk {
             this.readMobileEquipmentIdentity = readMobileEquipmentIdentity;
         }
 
+        public function setAllowiAdInfoReading(allowiAdInfoReading:Boolean):void {
+            this.allowiAdInfoReading = allowiAdInfoReading;
+        }
+
+        public function setAllowIdfaReading(allowIdfaReading:Boolean):void {
+            this.allowIdfaReading = allowIdfaReading;
+        }
+
         // Getters
         public function getAppToken():String {
             return this.appToken;
@@ -155,6 +180,10 @@ package com.adjust.sdk {
             return this.defaultTracker;
         }
 
+        public function getExternalDeviceId():String {
+            return this.externalDeviceId;
+        }
+
         public function getProcessName():String {
             return this.processName;
         }
@@ -214,5 +243,13 @@ package com.adjust.sdk {
         public function getReadMobileEquipmentIdentity():Boolean {
             return this.readMobileEquipmentIdentity;
         }
+
+        public function getAllowiAdInfoReading():Boolean {
+            return this.allowiAdInfoReading;
+        }
+
+        public function getAllowIdfaReading():Boolean {
+            return this.allowIdfaReading;
+        }
     }
 }

default/src/com/adjust/sdk/AdjustTestOptions.as

@@ -5,6 +5,7 @@ package com.adjust.sdk {
         public var noBackoffWait:Boolean = false;
         public var tryInstallReferrer:Boolean = false;
         public var useTestConnectionOptions:Boolean = false;
+        public var iAdFrameworkEnabled:Boolean = false;
 
         public var baseUrl:String = null;
         public var gdprUrl:String = null;

doc/migrate.md

@@ -1,4 +1,4 @@
-## Migrate your adjust SDK for Adobe AIR to 4.18.0 from 3.4.3
+## Migrate your Adjust SDK for Adobe AIR to 4.21.0 from 3.4.3
 
 ### SDK initialization
 

example/Main-app.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?> 
 <application xmlns="http://ns.adobe.com/air/application/32.0"> 
   <id>com.adjust.examples</id> 
-  <versionNumber>4.18.0</versionNumber> 
+  <versionNumber>4.21.0</versionNumber> 
   <filename>Adjust AIR SDK Demo</filename> 
 
   <initialWindow>