Merge pull request #190 from adjust/v4310

Version 4.31.0

Author: uerceg

CHANGELOG.md

@@ -1,3 +1,21 @@
+### Version 4.31.0 (10th August 2022)
+#### Added
+- Added ability to mark your app as COPPA compliant. You can enable this setting by calling `setCoppaCompliantEnabled` method of `AdjustConfig` instance to `true`.
+- Added ability to mark your Android app as app for the kids in accordance to Google Play Families policies. You can enable this setting by calling `setPlayStoreKidsAppEnabled` method of `AdjustConfig` instance to `true`.
+- Added `checkForNewAttStatus` method to `Adjust` API to allow iOS apps to instruct to SDK to check if `att_status` might have changed in the meantime.
+- Added support for Generic ad revenue tracking.
+- Added support for `LinkMe` feature.
+- Added support to get Facebook install referrer information in attribution callback.
+
+#### Fixed
+- Fixed `react-native` 0.69 autolinking issue (https://github.com/adjust/react_native_sdk/pull/186).
+
+#### Native SDKs
+- [[email protected]][ios_sdk_v4.31.0]
+- [[email protected]][android_sdk_v4.31.0]
+
+---
+
 ### Version 4.29.6 (26th January 2022)
 #### Added
 - Added support to OAID plugin for MSA SDK v1.1.0.
@@ -503,6 +521,7 @@
 [ios_sdk_v4.29.4]: https://github.com/adjust/ios_sdk/tree/v4.29.4
 [ios_sdk_v4.29.5]: https://github.com/adjust/ios_sdk/tree/v4.29.5
 [ios_sdk_v4.29.6]: https://github.com/adjust/ios_sdk/tree/v4.29.6
+[ios_sdk_v4.31.0]: https://github.com/adjust/ios_sdk/tree/v4.31.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
@@ -532,3 +551,4 @@
 [android_sdk_v4.28.4]: https://github.com/adjust/android_sdk/tree/v4.28.4
 [android_sdk_v4.28.8]: https://github.com/adjust/android_sdk/tree/v4.28.8
 [android_sdk_v4.28.9]: https://github.com/adjust/android_sdk/tree/v4.28.9
+[android_sdk_v4.31.0]: https://github.com/adjust/android_sdk/tree/v4.31.0

LICENSE

@@ -1,6 +1,6 @@
 The Adjust SDK is licensed under the MIT License.
 
-Copyright (c) 2012-2018 Adjust GmbH, http://www.adjust.com
+Copyright (c) 2012-Present Adjust GmbH, http://www.adjust.com
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -22,6 +22,7 @@ This is the React Native SDK of Adjust™. You can read more about Adjust™ at
    * [AppTrackingTransparency framework](#att-framework)
       * [App-tracking authorisation wrapper](#ata-wrapper)
       * [Get current authorisation status](#ata-getter)
+      * [Check for ATT status change](#att-status-change)
    * [SKAdNetwork framework](#skadn-framework)
       * [Update SKAdNetwork conversion value](#skadn-update-conversion-value)
       * [Conversion value updated callback](#skadn-cv-updated-callback)
@@ -62,6 +63,8 @@ This is the React Native SDK of Adjust™. You can read more about Adjust™ at
       * [Deferred deep linking](#deeplinking-deferred)
       * [Reattribution via deep links](#deeplinking-reattribution)
    * [Data residency](#data-residency)
+   * [COPPA compliance](#coppa-compliance)
+   * [Play Store Kids Apps](#play-store-kids-apps)
 * [License](#license)
 
 ## <a id="example-app"></a>Example app
@@ -147,7 +150,6 @@ The Adjust SDK by default adds two permissions to your app's `AndroidManifest.xm
 
 ```xml
 <uses-permission android:name="android.permission.INTERNET" />
-<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
 ```
 
@@ -170,7 +172,7 @@ Since August 1, 2014, apps in the Google Play Store must use the [Google Adverti
 In order to do this, open your app's `build.gradle` file and find the `dependencies` block. Add the following line:
 
 ```gradle
-compile 'com.google.android.gms:play-services-analytics:10.0.1'
+implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
 ```
 
 **Note**: The version of the Google Play Services library that you're using is not relevant to the Adjust SDK, as long as the analytics part of the library is present in your app. In the example above, we just used the most recent version of the library at the time of writing.
@@ -209,7 +211,7 @@ In order to correctly attribute an install of your Android app to its source, Ad
 In order to support this, add the following line to your app's `build.gradle` file:
 
 ```gradle
-compile 'com.android.installreferrer:installreferrer:1.0'
+compile 'com.android.installreferrer:installreferrer:2.2'
 ```
 
 `installreferrer` library is part of Google Maven repository, so in order to be able to build your app, you need to add Google Maven repository to your app's `build.gradle` file if you haven't added it already:
@@ -259,7 +261,6 @@ Select your project in the Project Navigator. In the left hand side of the main
 * `iAd.framework` - to support Apple Search Ads campaigns
 * `AdServices.framework` - to support Apple Search Ads campaigns
 * `AdSupport.framework` - to read iOS Advertising Id (IDFA) value
-* `CoreTelephony.framework` - to read MCC and MNC information
 * `StoreKit.framework` - to communicate with `SKAdNetwork` framework
 * `AppTrackingTransparency.framework` - to ask for user's consent to be tracked and obtain status of that consent
 
@@ -332,6 +333,16 @@ To get the current app tracking authorization status you can call `getAppTrackin
 * `3`: The user authorized access to IDFA
 * `-1`: The status is not available
 
+### <a id="att-status-change"></a>Check for ATT status change
+
+**Note**: This feature exists only in iOS platform.
+
+In cases where you are not using [Adjust app-tracking authorization wrapper](#ata-wrapper), Adjust SDK will not be able to know immediately upon answering the dialog what is the new value of app-tracking status. In situations like this, if you would want Adjust SDK to read the new app-tracking status value and communicate it to our backend, make sure to make a call to this method:
+
+```js
+Adjust.checkForNewAttStatus();
+```
+
 ### <a id="skadn-framework"></a>SKAdNetwork framework
 
 **Note**: This feature exists only in iOS platform.
@@ -650,24 +661,26 @@ adjustConfig.setAttributionCallbackListener(function(attribution) {
     console.log(attribution.costType);
     console.log(attribution.costAmount);
     console.log(attribution.costCurrency);
+    console.log(attribution.fbInstallReferrer);
 });
 
 Adjust.create(adjustConfig);
 ```
 
 Within the listener function you have access to the `attribution` parameters. Here is a quick summary of its properties:
 
-- `trackerToken`    the tracker token of the current attribution.
-- `trackerName`     the tracker name of the current attribution.
-- `network`         the network grouping level of the current attribution.
-- `campaign`        the campaign grouping level of the current attribution.
-- `adgroup`         the ad group grouping level of the current attribution.
-- `creative`        the creative grouping level of the current attribution.
-- `clickLabel`      the click label of the current attribution.
-- `adid`            the Adjust device identifier.
-- `costType`        the cost type.
-- `costAmount`      the cost amount.
-- `costCurrency`    the cost currency.
+- `trackerToken`        the tracker token of the current attribution.
+- `trackerName`         the tracker name of the current attribution.
+- `network`             the network grouping level of the current attribution.
+- `campaign`            the campaign grouping level of the current attribution.
+- `adgroup`             the ad group grouping level of the current attribution.
+- `creative`            the creative grouping level of the current attribution.
+- `clickLabel`          the click label of the current attribution.
+- `adid`                the Adjust device identifier.
+- `costType`            the cost type.
+- `costAmount`          the cost amount.
+- `costCurrency`        the cost currency.
+- `fbInstallReferrer`   the cost currency (Android only).
 
 Please make sure to consider our [applicable attribution data policies][attribution-data].
 
@@ -861,19 +874,9 @@ Upon receiving this information, Adjust changes sharing the specific user's data
 
 ### <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.
+When you set up the SDK Signature, each SDK communication package is "signed". This lets Adjust’s servers easily detect and reject any install activity that is not legitimate. 
 
-If the SDK signature has already been enabled on your account and you have access to App Secrets in your Adjust Dashboard, please use the method below to integrate the SDK signature into your app.
-
-An App Secret is set by passing all secret parameters (`secretId`, `info1`, `info2`, `info3`, `info4`) to `setAppSecret` method of `AdjustConfig` instance:
-
-```js
-var adjustConfig = new AdjustConfig(appToken, environment);
-
-adjustConfig.setAppSecret(secretId, info1, info2, info3, info4);
-
-Adjust.create(adjustConfig);
-```
+There are just a few steps involved in setting up the SDK Signature. Please contact your Technical Account Manager or [email protected] to get started.
 
 ### <a id="background-tracking"></a>Background tracking
 
@@ -1123,6 +1126,26 @@ adjustConfig.setUrlStrategy(AdjustConfig.DataResidencyTR); // for Turkey data re
 adjustConfig.setUrlStrategy(AdjustConfig.DataResidencyUS); // for US data residency region
 ```
 
+### <a id="coppa-compliance"></a>COPPA compliance
+
+By default Adjust SDK doesn't mark app as COPPA compliant. In order to mark your app as COPPA compliant, make sure to call `setCoppaCompliantEnabled` method of `AdjustConfig` instance with parameter `true`:
+
+```js
+adjustConfig.setCoppaCompliantEnabled(true);
+```
+
+**Note:** By enabling this feature, third-party sharing will be automatically disabled for the users. If later during the app lifetime you decide not to mark app as COPPA compliant anymore, third-party sharing **will not be automatically re-enabled**. Instead, next to not marking your app as COPPA compliant anymore, you will need to explicitly re-enable third-party sharing in case you want to do that.
+
+### <a id="play-store-kids-apps"></a>Play Store Kids Apps
+
+**Note**: This feature exists only in Android platform.
+
+By default Adjust SDK doesn't mark Android app as Play Store Kids App. In order to mark your app as the app which is targetting kids in Play Store, make sure to call `setPlayStoreKidsAppEnabled` method of `AdjustConfig` instance with parameter `true`:
+
+```js
+adjustConfig.setPlayStoreKidsAppEnabled(true);
+```
+
 [dashboard]:    http://adjust.com
 [adjust.com]:   http://adjust.com
 
@@ -1153,7 +1176,7 @@ adjustConfig.setUrlStrategy(AdjustConfig.DataResidencyUS); // for US data reside
 
 The Adjust SDK is licensed under the MIT License.
 
-Copyright (c) 2012-2021 Adjust GmbH, http://www.adjust.com
+Copyright (c) 2012-Present Adjust GmbH, http://www.adjust.com
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

VERSION

@@ -1 +1 @@
-4.29.6
+4.31.0

android/libs/adjust-android.jar

@@ -125,6 +125,8 @@ public void create(ReadableMap mapConfig) {
         boolean readMobileEquipmentIdentity = false;
         boolean preinstallTrackingEnabled = false;
         boolean needsCost = false;
+        boolean playStoreKidsAppEnabled = false;
+        boolean coppaCompliantEnabled = false;
 
         // Suppress log level.
         if (checkKey(mapConfig, "logLevel")) {
@@ -223,6 +225,7 @@ public void create(ReadableMap mapConfig) {
             adjustConfig.setUserAgent(userAgent);
         }
 
+        // Preinstall file path.
         if (checkKey(mapConfig, "preinstallFilePath")) {
             preinstallFilePath = mapConfig.getString("preinstallFilePath");
             adjustConfig.setPreinstallFilePath(preinstallFilePath);
@@ -275,6 +278,12 @@ && checkKey(mapConfig, "info4")) {
             adjustConfig.setNeedsCost(needsCost);
         }
 
+        // Google Play Store kids app.
+        if (checkKey(mapConfig, "playStoreKidsAppEnabled")) {
+            playStoreKidsAppEnabled = mapConfig.getBoolean("playStoreKidsAppEnabled");
+            adjustConfig.setPlayStoreKidsAppEnabled(playStoreKidsAppEnabled);
+        }
+
         // Launching deferred deep link.
         if (checkKey(mapConfig, "shouldLaunchDeeplink")) {
             shouldLaunchDeeplink = mapConfig.getBoolean("shouldLaunchDeeplink");
@@ -287,6 +296,12 @@ && checkKey(mapConfig, "info4")) {
             adjustConfig.setDelayStart(delayStart);
         }
 
+        // COPPA compliance.
+        if (checkKey(mapConfig, "coppaCompliantEnabled")) {
+            coppaCompliantEnabled = mapConfig.getBoolean("coppaCompliantEnabled");
+            adjustConfig.setCoppaCompliantEnabled(coppaCompliantEnabled);
+        }
+
         // Attribution callback.
         if (attributionCallback) {
             adjustConfig.setOnAttributionChangedListener(this);
@@ -714,7 +729,7 @@ public void updateConversionValue(int conversionValue) {
 
     @ReactMethod
     public void getAppTrackingAuthorizationStatus(Callback callback) {
-        callback.invoke("-1");
+        callback.invoke(-1);
     }
 
     @ReactMethod
@@ -755,6 +770,11 @@ public void trackMeasurementConsent(boolean measurementConsent) {
         com.adjust.sdk.Adjust.trackMeasurementConsent(measurementConsent);
     }
 
+    @ReactMethod
+    public void checkForNewAttStatus() {
+        // do nothing
+    }
+
     @ReactMethod
     public void setAttributionCallbackListener() {
         this.attributionCallback = true;

android/src/main/java/com/adjust/sdk/Adjust.java

@@ -30,6 +30,7 @@ final class AdjustUtil {
     private static final String ATTRIBUTION_COST_TYPE = "costType";
     private static final String ATTRIBUTION_COST_AMOUNT = "costAmount";
     private static final String ATTRIBUTION_COST_CURRENCY = "costCurrency";
+    private static final String ATTRIBUTION_FB_INSTALL_REFERRER = "fbInstallReferrer";
 
     private static final String EVENT_SUCCESS_MESSAGE = "message";
     private static final String EVENT_SUCCESS_TIMESTAMP = "timestamp";
@@ -74,6 +75,7 @@ public static WritableMap attributionToMap(AdjustAttribution attribution) {
         map.putString(ATTRIBUTION_COST_TYPE, null != attribution.costType ? attribution.costType : "");
         map.putDouble(ATTRIBUTION_COST_AMOUNT, null != attribution.costAmount && !attribution.costAmount.isNaN() ? attribution.costAmount : 0);
         map.putString(ATTRIBUTION_COST_CURRENCY, null != attribution.costCurrency ? attribution.costCurrency : "");
+        map.putString(ATTRIBUTION_FB_INSTALL_REFERRER, null != attribution.fbInstallReferrer ? attribution.fbInstallReferrer : "");
         return map;
     }
 

android/src/main/java/com/adjust/sdk/AdjustUtil.java

@@ -0,0 +1,4 @@
+module.exports = {
+  root: true,
+  extends: '@react-native-community',
+};

example/.eslintrc.js

@@ -0,0 +1,66 @@
+[ignore]
+; We fork some components by platform
+.*/*[.]android.js
+
+; Ignore "BUCK" generated dirs
+<PROJECT_ROOT>/\.buckd/
+
+; Ignore polyfills
+node_modules/react-native/Libraries/polyfills/.*
+
+; Flow doesn't support platforms
+.*/Libraries/Utilities/LoadingView.js
+
+.*/node_modules/resolve/test/resolver/malformed_package_json/package\.json$
+
+[untyped]
+.*/node_modules/@react-native-community/cli/.*/.*
+
+[include]
+
+[libs]
+node_modules/react-native/interface.js
+node_modules/react-native/flow/
+
+[options]
+emoji=true
+
+exact_by_default=true
+
+format.bracket_spacing=false
+
+module.file_ext=.js
+module.file_ext=.json
+module.file_ext=.ios.js
+
+munge_underscores=true
+
+module.name_mapper='^react-native/\(.*\)$' -> '<PROJECT_ROOT>/node_modules/react-native/\1'
+module.name_mapper='^@?[./a-zA-Z0-9$_-]+\.\(bmp\|gif\|jpg\|jpeg\|png\|psd\|svg\|webp\|m4v\|mov\|mp4\|mpeg\|mpg\|webm\|aac\|aiff\|caf\|m4a\|mp3\|wav\|html\|pdf\)$' -> '<PROJECT_ROOT>/node_modules/react-native/Libraries/Image/RelativeImageStub'
+
+suppress_type=$FlowIssue
+suppress_type=$FlowFixMe
+suppress_type=$FlowFixMeProps
+suppress_type=$FlowFixMeState
+
+[lints]
+sketchy-null-number=warn
+sketchy-null-mixed=warn
+sketchy-number=warn
+untyped-type-import=warn
+nonstrict-import=warn
+deprecated-type=warn
+unsafe-getters-setters=warn
+unnecessary-invariant=warn
+
+[strict]
+deprecated-type
+nonstrict-import
+sketchy-null
+unclear-type
+unsafe-getters-setters
+untyped-import
+untyped-type-import
+
+[version]
+^0.176.3