Merge pull request #43 from adjust/v4150

Version 4.15.0

Author: uerceg

CHANGELOG.md

@@ -1,3 +1,20 @@
+### Version 4.15.0 (10th October 2018)
+#### Added
+- Added `setCallbackId` method on `AdjustEvent` object for users to set custom ID on event object which will later be reported in event success/failure callbacks.
+- Added `callbackId` field to event tracking success callback object.
+- Added `callbackId` field to event tracking failure callback object.
+
+#### Changed
+- Updated Android SDK and build tools to 26 (thanks to @hamidhadi).
+- Marked `setReadMobileEquipmentIdentity` method of `AdjustConfig` object as deprecated.
+- SDK will now fire attribution request each time upon session tracking finished in case it lacks attribution info.
+
+#### Native SDKs
+- [[email protected]][ios_sdk_v4.15.0]
+- [[email protected]][android_sdk_v4.15.0]
+
+---
+
 ### Version 4.14.0 (4th July 2018)
 #### Added
 - Added deep link caching in case `appWillOpenUrl` method is called before SDK is initialised.
@@ -229,6 +246,7 @@
 [ios_sdk_v4.12.3]: https://github.com/adjust/ios_sdk/tree/v4.12.3
 [ios_sdk_v4.13.0]: https://github.com/adjust/ios_sdk/tree/v4.13.0
 [ios_sdk_v4.14.1]: https://github.com/adjust/ios_sdk/tree/v4.14.1
+[ios_sdk_v4.15.0]: https://github.com/adjust/ios_sdk/tree/v4.15.0
 
 [android_sdk_v4.10.4]: https://github.com/adjust/android_sdk/tree/v4.10.4
 [android_sdk_v4.11.0]: https://github.com/adjust/android_sdk/tree/v4.11.0
@@ -242,3 +260,4 @@
 [android_sdk_v4.12.4]: https://github.com/adjust/android_sdk/tree/v4.12.4
 [android_sdk_v4.13.0]: https://github.com/adjust/android_sdk/tree/v4.13.0
 [android_sdk_v4.14.0]: https://github.com/adjust/android_sdk/tree/v4.14.0
+[android_sdk_v4.15.0]: https://github.com/adjust/android_sdk/tree/v4.15.0

README.md

@@ -24,6 +24,7 @@ This is the React Native SDK of Adjust™. You can read more about Adjust™ at
       * [In-app purchase verification](#iap-verification)
       * [Callback parameters](#callback-parameters)
       * [Partner parameters](#partner-parameters)
+      * [Callback identifier](#callback-id)
    * [Session parameters](#session-parameters)
       * [Session callback parameters](#session-callback-parameters)
       * [Session partner parameters](#session-partner-parameters)
@@ -384,6 +385,18 @@ You can read more about special partners and networks in our [guide to special p
 
 **Note**: **Both** parameters in this method must be **strings**. If either of the passed parameters is not a string, the key-value pair will not be added to the parameters list.
 
+### <a id="callback-id"></a>Callback identifier
+
+You can also add custom string identifier to each event you want to track. This identifier will later be reported in event success and/or event failure callbacks to enable you to keep track on which event was successfully tracked or not. You can set this identifier by calling the `setCallbackId` method on your `AdjustEvent` instance:
+
+```js
+var adjustEvent = new AdjustEvent("abc123");
+
+adjustEvent.setCallbackId("Your-Custom-Id");
+
+Adjust.trackEvent(adjustEvent);
+```
+
 ### <a id="session-parameters"></a>Session parameters
 
 Some parameters are saved to be sent in every event and session of the Adjust SDK. Once you have added any of these parameters, you don't need to add them every time, since they will be saved locally. If you add the same parameter twice, there will be no effect.
@@ -511,6 +524,7 @@ adjustConfig.setEventTrackingSucceededCallbackListener(function(eventSuccess) {
     console.log(eventSuccess.message);
     console.log(eventSuccess.timestamp);
     console.log(eventSuccess.eventToken);
+    console.log(eventSuccess.callbackId);
     console.log(eventSuccess.adid);
     console.log(eventSuccess.jsonResponse);
 });
@@ -529,6 +543,7 @@ adjustConfig.setEventTrackingFailedCallbackListener(function(eventFailure) {
     console.log(eventSuccess.message);
     console.log(eventSuccess.timestamp);
     console.log(eventSuccess.eventToken);
+    console.log(eventSuccess.callbackId);
     console.log(eventSuccess.adid);
     console.log(eventSuccess.willRetry);
     console.log(eventSuccess.jsonResponse);
@@ -582,6 +597,7 @@ The callback functions will be called after the SDK tries to send a package to t
 Both event response data objects contain:
 
 - `var eventToken` the event token, if the package tracked was an event.
+- `var callbackId` the custom defined callback ID set on event object.
 
 And both event and session failed objects also contain:
 

VERSION

@@ -1 +1 @@
-4.14.0
+4.15.0

android/build.gradle

@@ -1,12 +1,19 @@
 apply plugin: 'com.android.library'
 
+def _ext = rootProject.ext
+
+def _compileSdkVersion = _ext.has('compileSdkVersion') ? _ext.compileSdkVersion : 26
+def _buildToolsVersion = _ext.has('buildToolsVersion') ? _ext.buildToolsVersion : "26.0.3"
+def _minSdkVersion = _ext.has('minSdkVersion') ? _ext.minSdkVersion : 16
+def _targetSdkVersion = _ext.has('targetSdkVersion') ? _ext.targetSdkVersion : 26
+
 android {
-    compileSdkVersion 23
-    buildToolsVersion "23.0.1"
+    compileSdkVersion _compileSdkVersion
+    buildToolsVersion _buildToolsVersion
 
     defaultConfig {
-        minSdkVersion 16
-        targetSdkVersion 22
+        minSdkVersion _minSdkVersion
+        targetSdkVersion _targetSdkVersion
         versionCode 1
         versionName "1.0"
     }