What's New in Android Library Version🔗

v6.19.0 Release (2025-01-17)🔗

In this version:

MRGService module:

• Improved SDK performance in Vietnam.
• Added logs for MRGSTracker#trackEvent(String name, Map params) parameters.

Advertising module:

• Improved ad loading for URLs that do not contain a file extension

Appsflyer module:

• Fixed an issue where an incorrect payment amount could be sent to AppsFlyer for Huawei payments.

Authentication module:

• Fixed an issue where java.lang.IllegalArgumentException: URLDecoder: Incomplete trailing escape (%) pattern for MyGames authorization.

Billing-catappult module:

• Added support for Catappult.

Bank module:

• Fixed possible loss of deviceId in http requests for payment validation.

Notifications module:

• Fixed crash when clicking on notification if developerPayload contains extra quotes

Read more about the new features and how to use them in the documentation.

v6.18.0 Release (2024-11-15)🔗

In this version:

MRGService module:

• Added new MRGSProductInfo class to send new format product information
• Updated androidx.core:core:1.9.0 to androidx.core:core-ktx:1.13.1
• Updated com.google.android.gms:play-services-ads-identifier from 18.0.1 to 18.1.0.
• Updated com.google.android.gms:play-services-appset from 16.0.2 to 16.1.0.
• Updated androidx.appcompat:appcompat from 1.6.1 to 1.7.0
• Updated kotlin from 1.8.22 to 1.9.23
• Improved thread queue, fixed Thread pool blocking queue is full error

Authentication module:

• Added the ability to open another browser with CustomTabs if the default browser does not support CustomTabs. If the device does not have a browser with CustomTabs, then the regular browser will be opened.
• Removed dependency androidx.localbroadcastmanager:localbroadcastmanager.
• Updated com.google.android.gms:play-services-games-v2 from 20.1.0 to 20.1.2

Advertising module:

• Removed dependency androidx.localbroadcastmanager:localbroadcastmanager.
• Updated androidx.recyclerview:recyclerview from 1.2.1 to 1.3.2.
• Updated androidx.vectordrawable:vectordrawable from 1.1.0 to 1.2.0
• Fixed getting video file name from creative_video_file value in MRGSAdvertisingCampaign.

Bank module:

• Updated com.android.billingclient:billing from 6.0.1 to 7.1.1.
• Updated com.facebook.android:facebook-gamingservices from 16.0.1 to 17.0.2

GDPR module:

• Updated com.bigossp:bigo-ads from 4.7.0 to 5.0.2.
• Updated com.moloco.sdk.adapters:moloco:2.1.1.0 to com.moloco.sdk:moloco-sdk:3.2.0
• Updated com.tappx.sdk.android:tappx-sdk from 4.0.6 to 4.1.6
• Updated com.unity3d.ads:unity-ads from 4.4.1 to 4.12.3
• Updated com.tapjoy:tapjoy-android-sdk from 12.11.0 to 14.1.0
• Updated com.my.target:mytarget-sdk from 5.16.2 to 5.22.1
• Updated com.vungle:publisher-sdk-android:6.12.0 to com.vungle:vungle-ads:7.4.1
• Updated com.fyber:fairbid-sdk from 3.33.1 to 3.55.0
• Updated com.facebook.android:facebook-core from 15.1.0 to 17.0.2
• Updated com.chartboost:chartboost-sdk from 9.1.1 to 9.7.0
• Updated com.applovin:applovin-sdk from 11.6.0 to 13.0.0
• Fixed Activity leak in CCPA.

Notifications module:

• Updated com.google.firebase:firebase-messaging from 24.0.0 to 24.0.3.
• Added intent filters for broadcast receivers.

Recommendations module:

• Added new event type for Recsys - geo pricing.

Showcase module:

• Removed dependency androidx.localbroadcastmanager:localbroadcastmanager.
• Updated androidx.browser:browser from 1.5.0 to 1.8.0.
• Updated androidx.recyclerview:recyclerview from 1.2.1 to 1.3.2.

Read more about the new features and how to use them in the documentation.

v6.17.4 Release (2024-10-25)🔗

In this version:

MRGService module:

• Fixed a bug where MRGSMetrics events were lost if the events were added before MRGService initialization and it was the very first launch of the application (however, on subsequent launches of the application the events were not lost)
• Fixed reset of the total time spent in the game (allSession) counter when changing the day during the game

Advertising module:

• Fixed some ANR errors

Didomi module:

• Fixed ANR errors

GDPR module:

• Updated CCPA Mintegral dependencies

Notifications module:

• Added null data check in PostPermissionActivity.

Read more about the new features and how to use them in the documentation.

v6.17.3 Release (2024-10-05)🔗

In this version:

MRGService module:

• The MRGSDevice#getSendDictionary(Callback<Object) method is marked as Deprecated and will be removed in the near future.
• Added collection of GAID, ASID, OA ID, ODID and Amazon advertising id and sending them to the server as separate parameters.
• Added handling of all errors in the MRGSReflection.isClassExists() method.

Bank module:

• Changed maximum size of developerPayload in OnestoreBilling - reduced to 200 characters.
• Fixed developerPayload disappearance when resuming the application after onPause.
• Fixed a bug where transactionId from Samsung Galaxy Store could not be sent to Appsflyer.
• Fixed a thread race condition that could result in developerPayload being lost when validating a payment.

Didomi module:

• Updated io.didomi.sdk:android from 2.10.1 to 2.13.0

Firebase module:

• Updated com.google.firebase:firebase-analytics from 22.1.0 to 22.1.2

Notifications module:

• Added try/catch blocks in notification creation methods and added sending logs to the server.

Support module:

• Added network availability check when displaying the support window.

Read more about the new features and how to use them in the documentation.

v6.17.2 Release (2024-09-12)🔗

In this version:

MRGService module:

• Fixed a bug since version 6.17.0, due to which it was impossible to install other applications that use MRGS SDK due to the error INSTALL_FAILED_DUPLICATE_PERMISSION: Package to redeclare permission games.my.mrgs.permission.OPEN_UDID already owned

Read more about the new features and how to use them in the documentation.

v6.17.1 Release (2024-09-06)🔗

In this version:

Analytics module:

• Added a new waitForTCF field to mrgs_dma_start event.

Read more about the new features and how to use them in the documentation.

v6.17.0 Release (2024-08-29)🔗

In this version:

MRGService module:

• Added the ability to share OpenUDID between applications.
• Added a new way to generate a stable OpenUDID
• Added a new key MRGSTrackerMediationNetwork.ToponPte for custom logs.
• Fixed a duplicate value error when using MRGService#setHost, which led to broken network requests.

Analytics module:

• Removed the com.appsflyer:adrevenue dependency.
• Updated com.appsflyer:af-android-sdk from 6.14.2 to 6.15.0.

Bank module:

• Fixed subscription recovery in Amazon - now cancelled and inactive subscriptions will not be sent to the delegate

Didomi module:

• Updated io.didomi.sdk:android from 2.7.0 to 2.10.1

Firebase Module:

• Updated com.google.firebase:firebase-analytics from 22.0.1 to 22.1.0

Read more about the new features and how to use them in the documentation.

v6.16.1 Release (2024-07-02)🔗

In this version:

Module MRGService:

• Added internal support for switching hosts in case some countries block access to MRGS resources.
• Disabled SSL connection security checks for all network requests to the MRGS server for Android 7.0 and below.

Authentication module:

• Changed minimum required version of Android from 4.4 (19 api) to 5.0 (21 api) for the MRGSGoogleSignIn module
• Updated com.google.android.gms:play-services-games from 23.1.0 to 23.2.0.
• Updated com.google.android.gms:play-services-auth from 20.6.0 to 21.2.0.
• Changed minimum required version of Android from 4.4 (19 api) to 5.0 (21 api) for the MRGSGooglePlay module
• Updated com.google.android.gms:play-services-games-v2 from 17.0.0 to 20.1.0

Module Appsflyer:

• Updated com.appsflyer:af-android-sdk from 6.14.0 to 6.14.2.

Module Bank:

• Fixed a bug where MRGSBillingDelegate#onReceiveFailedPurchase returned the result without an error for the new private implementation of Google payments.

Module Didomi:

• Updated io.didomi.sdk:android from 2.5.1 to 2.7.0.

Read more about the new features and how to use them in the documentation.

v6.16.0 Release (2024-06-13)🔗

In this version:

Authentication module:

• Added asynchronous isLoggedIn method for more accurate state checking.

Read more about the new features and how to use them in the documentation.

v6.15.1 Release (2024-06-11)🔗

In this version:

Module MRGService:

• Fixed java.util.ConcurrentModificationException error in MRGSTracker.

Module Bank:

• Added automatic closing of TopUp (WebView) upon successful purchase

Firebase module:

• Updated com.google.firebase:firebase-analytics from 22.0.0 to 22.0.1

GDPR module:

• Added support for new libraries for CCPA - Moloco and BigoAds

Advertising module:

• Some improvements for sending DSP links.

Read more about the new features and how to use them in the documentation.

v6.15.0 Release (2024-05-28)🔗

In this version:

Module MRGService:

• Fixed connection to the auto tracking billing service, added a countdown timer to limit the automatic number of connection attempts.
• Fixed ANR bug. The getHwMemoryUse() call has been moved to a background thread inside the updateHwMemoryUse() method.

Authentication (Facebook) module:

• Graph Api version used raised to 19

Analytics module:

• Fixed a bug where events sent during the active waitForCustomerUserId mode were lost.
• Fixed a bug where AppsFlyer would start sending analytics after the waitForCustomerUserId mode was removed, but the user agreement (DMA) had not yet been received. The problem only occurred when using the waitForCustomerUserId mode.

Module Bank:

• Added new fields isSandbox (whether the payment was made in the test environment) and usd (payment amount in dollars)
• Fixed error java.lang.NoClassDefFoundError: Failed resolution of: Lcom/amazon/device/drm/LicensingListener. This error will no longer cause the application to crash.

GDPR module:

• Fixed showing the PIPA window on small screens

Read more about the new features and how to use them in the documentation.

v6.14.3 Release (2024-05-16)🔗

In this version:

MRGService module:

• Fixed ANR when calling MRGSTracker#flush().

Read more about the new features and how to use them in the documentation.

v6.14.2 Release (2024-05-07)🔗

In this version:

Analytics module:

• Updated com.appsflyer:af-android-sdk from 6.13.0 to 6.14.0.

Didomi module:

• Updated io.didomi.sdk:android from 2.4.0 to 2.5.1.

Firebase module:

• Updated com.google.firebase:firebase-analytics from 21.6.2 to 22.0.0.
• Changed minimum required Android version from 4.4 (19 api) to 5.0 (21 api).

Notification module:

• Updated com.google.firebase:firebase-messaging from 23.1.2 to 24.0.0.
• Changed minimum required Android version from 4.4 (19 api) to 5.0 (21 api).

Read more about the new features and how to use them in the documentation.

v6.14.1 Release (2024-04-27)🔗

In this version:

Module MRGService:

• Added sending firebaseInstanceId to MRGS events
• Added flag to disable auto-tracking of payments from a remote config.
• Changed the way sessionId is generated from MD5 to UUID v4 to reduce collisions.

Module Bank:

• Changed the behavior of the restoreTransaction method for Amazon. Now the behavior of the method will be similar to the behavior of Google payments, the method will no longer attempt to load missing products, but will access the local cache of products that is formed when calling requestProducts, and will return an error in onReceiveFailedPurchase if not managed to find the product in the local cache.
• Fixed a bug where transactions were not restored if there was no cache on the device, indicating that the payment was made on this particular device. Now the payment will be restored no matter on which device the user makes the restoration.
• Fixed a bug where in rare cases, after validating a payment, the transaction was closed for all non-validated payments for OneStore.

Module Didomi:

• Updated io.didomi.sdk:android from 1.90.0 to 2.4.0.

Firebase module:

• Updated com.google.firebase:firebase-analytics from 21.6.1 to 21.6.2.

Read more about the new features and how to use them in the documentation.

v6.14.0 Release (2024-04-11)🔗

In this version:

MRGService module:

• Fixed a possible ANR because of writing logs for remote logging.
• Fixed a NullPointerException and ANR in TransferManager.
• Fixed some errors which would lead to crash of MRGService.
• Fixed a crash while trying to connect to Google Billing for auto-tracking payments.

Bank module:

• Fixed a ForegroundTaskPipeline: No UI visible to execute task error, when couldn't start a payment window in Amazon IAP SDK on Unity builds.

Didomi module:

• Fixed behavior when MRGSDidomi called FirebaseAnalytics#setAnalyticsCollectionEnabled. Now this method will be called even if user does not fall under TCF, to avoid blocking Firebase collection data.

Firebase module:

• Added a new FirebaseAnalytics#setAnalyticsCollectionEnabled(bool) method.

Read more about the new features and how to use them in the documentation.

v6.13.3 Release (2024-04-02)🔗

In this version:

Advertising module:

• Added support for additional tracking links (percentage of video views) for AdTech
• Disabled network request caching for AdTech.

Module Bank:

• Fixed error when building a project if the project used obfuscation with proguard-android-optimize.txt

Module Didomi:

• MRGSDidomi will also call FirebaseAnalytics#setAnalyticsCollectionEnabled with true, after each call to FirebaseAnalytics#setConsent.

Firebase module:

• Updated com.google.firebase:firebase-analytics from 21.5.1 to 21.6.1.

Read more about the new features and how to use them in the documentation.

v6.13.2 Release (2024-03-27)🔗

In this version:

• Fixed JVM Verifier rejected class errors that led to problems on some versions of Android due to the fact that kotlin in the MRGS SDK was compiled with an old compiler .

Analytics module:

• Fixed crash when MRGSAnalytics module was added to the project but did not pass MRGSAppsFlyerParams to initialize AppsFlyer.

Advertising module:

• Updated obfuscation rules.

Module Bank:

• Updated obfuscation rules.
• Fixed MyGames payments (WebView).

Read more about the new features and how to use them in the documentation.

v6.13.1 Release (2024-03-25)🔗

In this version:

Bank module:

• Fixed an issue com.amazon.a.a.o.a.b: Executing thread must be thread: 2, was: N if Amazon IAP wasn't initialized with Android main-thread.

Didomi module:

• Fixed an issue java.lang.ClassNotFoundException: games.my.mrgs.analytics.MRGSAnalytics.

Read more about the new features and how to use them in the documentation.

v6.13.0 Release (2024-03-21)🔗

In this version:

• Supported DMA for AppsFlyer and Firebase.
• Minimum required kotlin version is 1.8.22.

MRGService module:

• Fixed an issue when auto-tracking payments was not be disabled if MRSRGBank was used, so auto-tracking made extra validation requests.

Advertising module:

• Improved hash checking for downloaded AdTech ads.

Analytics module:

• Updated com.appsflyer:af-android-sdk from 6.12.1 to 6.13.0.

• Fixed an issue when MRGSAnalytics didn't send purchases to AppsFlyer, if auto-tracking payments was used.

Bank module:

• Added a new MRGServiceParams#setBillingVersionAtFirstRun(int) property to change version at the first application launching. For next launches the version will be used from remote config.

Firebase module:

• Updated com.google.firebase:firebase-analytics from 21.3.0 to 21.5.1.

Didomi module:

• Added a new MRGSDidomi#reset() method.

• Updated io.didomi.sdk:android from 1.89.0 to 1.90.0.

GDPR module:

• Changed width of button in dialog for COPPA.

IronSource-Adapter module:

• Added data sending of GDPR to AdTech.

Read more about the new features and how to use them in the documentation.

v6.12.0 Release (2024-02-27)🔗

Native SDK versions: Android 6.11.2, iOS 6.11.1

In this version:

MRGService module:

• Added collection versions of SDK's for some libraries.
• Added a new MRGSUsers#setEmail(String) method to send user's email to MRGS.
• Supported payments auto-tracking for Google Play. This feature is enabled by default, and will send historical data to MRGS at the first start.

Analytics module:

• Supported sending payments info to AppsFlyer from MRGS server.

Bank module:

• Updated Samsung IAP SDK from 5.0.1 to 6.1.0.

• Updated Amazon IAP SDK from 2.0.76 to 3.0.4.

• Fixed an issue when MRGSBank completed operations incorrectly with empty receipt, as a result callback could be called several times.

• Fixed long validation if transaction cache contains the same user and transaction id.

Didomi module:

• Added a new MRGSDidomi#shouldUserStatusBeCollected() method.

• Supported Activity from Android SDK to work with Didomi SDK for projects which don't use Androidx libraries.

• Update io.didomi.sdk:android from 1.87.0 to 1.89.0.

GDPR module:

• Changed conditions for showing CCPA button, now it has the same behavior as oniOS.

Notifications module:

• Supported different notification styles and improved supporting of custom notifications.

• Fixed incorrect behavior for Android 13 and deferredPushStart flag was disabled.

Read more about the new features and how to use them in the documentation.

v6.11.2 Release (2024-01-29)🔗

In this version:

MRGService module:

• Fixed a bug when in rare cases applicationRun event wasn't sent, and installations were not tracked in 1Link.

• Fixed an ANR when calling MRGSDevice#getHwMemoryUse() method.

• Fixed a rare issue IndexOutOfBoundsException when calling MRGSDevice#getHwMemoryUse() method.

Advertising module:

• Fixed an ANR during loading ads.

Showcase module:

• Fixed an ANR during loading ads.

Read more about the new features and how to use them in the documentation.

v6.11.1 Release (2024-01-24)🔗

In this version:

Advertising module:

• Improved an algorithm for calculating an average price of an advertisement for AdTech.
• Improved an approach to checking ads for AdTech.

Authentication module:

• Fixed a problem with "web-authentication" on Google Play Games on PC platform.

Bank module:

• Added a handler of RESULT_NEED_LOGIN error during OneStore IAP SDK initialization.

• Fixed an issue when empty developerPayload was sent to MRGS for OneStore payments.

IronSource-Adapter module:

• Improved ads downloading for AdTech.

Read more about the new features and how to use them in the documentation.

v6.11.0 Release (2024-01-17)🔗

In this version:

Bank module:

• Supported OneStore payments.

GDPR module:

• Supported korean PIPA law.

Read more about the new features and how to use them in the documentation.

v6.10.1 Release (2023-12-14)🔗

In this version:

Didomi module:

• Updated io.didomi.sdk:android from 1.85.1 to 1.87.0.

• Fixed an issue with sending statistics from MRGSDidomi

Read more about the new features and how to use them in the documentation.

v6.10.0 Release (2023-12-04)🔗

In this version:

MRGService module:

• Added a new MRGService#setHost(String) method to server host in MRGService.

Advertising module:

• Improved caching of video ads for AdTech.

Authentication module:

• Fixed sending of socialLogin and socialUser events when GooglePlayGamesV2 was used.

Didomi module:

• Added new MRGSDidomi module to support TCF.

Firebase module:

• Changed behavior of sending mrgs_valid_inapp_N_dollars_plus event. Now they will be sent even for test purchases.

GameCenter module:

• Deprecated MRGSGameCenter module and it will be removed in near feature.

IronSource-Adapter module:

• Added extra statistics of accepted agreements and settings.

Showcase module:

• Changed title font from gotham to open-sans.

Read more about the new features and how to use them in the documentation.

v6.9.4 Release (2023-11-20)🔗

In this version:

GDPR module:

• Fixed an issue when updated agreement was shown instead of changed publisher if user had accepted agreement version 1591736400.
• Fixed an issued when callback wasn't called with MRGSGDPR#showAgreement(Activity, MRGSGDPRShowParams, BiConsumer<MRGSGDRPShowResult, MRGSError>) if COPPA was shown through MRGSGDPR and COPPA return an error.
• Fixed an issue when methods of showing agreement could skip showing update agreement or change publisher until the next application restart.

Read more about the new features and how to use them in the documentation.

v6.9.3 Release (2023-11-14)🔗

In this version:

GDPR module:

• Changed behavior of MRGSGDPR#showDefaultAgreementAtActivity(Activity, String) method to show default file for changed publisher.

Read more about the new features and how to use them in the documentation.

v6.9.2 Release (2023-11-14)🔗

In this version:

GDPR module:

• Fixed an issue, when MRGSGDPR#shouldShowGDPR(Activity, String, boolean, MRGSGDPRAsyncStatus) method read isEUOnly flag from MRGSGDPR#onlyEU(boolean) instead of reading passed value. Now it will read passed value and ignore MRGSGDPR#onlyEU(boolean).
• Fixed ClassCastException for MRGSGDPR#getAgreementTime(Context) and MRGSGDPR#getAcceptedAgreement(Context) methods.
• Fixed behavior with incorrect choosing for file for change publisher and update agreements with advertising cases.

Read more about the new features and how to use them in the documentation.

v6.9.1 Release (2023-11-10)🔗

In this version:

GDPR module:

• Changed logic for MRGSGDPR#setPublisherUpdateFile(String) to handle null values.

• Fixed an issue when new MRGSGDPR#ShowAgreement() method didn't read MRGSGDPRShowParam#isAutomaticCOPPAFlowEnabled value.

• Fixed a problem with selecting chinese localization for GDPR based on user's locale device.
• Fixed a crash in COPPA, when couldn't continue COPPA after acceptance of the agreement.

Read more about the new features and how to use them in the documentation.

v6.9.0 Release (2023-11-08)🔗

In this version:

GDPR module:

• Supported tracking of changing publisher cases.
• Improved definition of the need to show the agreement
• Supported reading files from StreamingAssets (now it is enough to pass only its name to methods).

• Localization of the agreement will be automatically selected based on the user's current device language.

• Added a new MRGSGDPR#setup(Activity, String, String) method to initialize MRGSGDPR and MRGSCOPPA.

• Added a new MRGSGDPR#showAgreement(Activity, MRGSGDPRShowParams, BiConsumer<MRGSGDPRShowResult, MRGSError>) method to show GDPR window.
• Added a new MRGSGDPR#shouldShowAgreement(Activity, BiConsumer<MRGSGDPRShowReason, MRGSGDPRAgreement>) method to check reasons of showing GDPR window to user.
• Added a new MRGSGDPR#onAgreementAccepted(Context, boolean) method to inform MRGS that user have accepted agreements outside of MRGS GDPR window. (For showing your own GDPR windows).
• Added a new temporary MRGSGDPR#setPublisherUpdateFile(String) method to set html file path changed publisher cases.
• Added a new MRGSGDPR#setOnShowListener(OnShowListener) method set a listener to get a result from MRGS GDPR window.
• Added a new MRGSGDPR#getAcceptedAgreement(Context) method to get information about the accepted agreement by user.

• Added a new MRGSGDPR#getLocalizations(Context) method get list of supported localizations from mrgsgdpr_langs.json SDK file.

• Added a new MRGSGDPRAgreement class that describes information of current GDPR agreement from MRGS console.

• Added a new MRGSGDPRAcceptedAgreement class that describes information of accepted agreement by user.
• Added a new MRGSGDPRLocalization class that contains properties to localize html page of MRGSGDPR SDK.
• Added a new MRGSGDPRShowParams class that contains properties to change showing behavior of MRGS GDPR window.
• Added a new MRGSGDPRShowReason enum that describes reasons of showing MRGS GDPR window.

• Added a new MRGSGDPRShowResultclass that contains result of showing MRGS GDPR window.

• Deprecated MRGSGDPR#withAdvertising(boolean) method. Use MRGSGDPRShowParams#withAdvertising(boolean) instead.

• Deprecated MRGSGDPR#enableAutomaticCOPPAFlow(String, String) method. Use MRGSGDPRShowParams#setAutomaticCOPPAFlowEnabled(boolean) instead.
• Deprecated MRGSGDPR#setLocalizationLanguage(String) method. Use MRGSGDPRShowParams#setLocalization(MRGSGDPRLocalization).
• Deprecated MRGSGDPR#setUseWebViewForExternalLinks(boolean) method. Use MRGSGDPRShowParams#setUseWebViewForExternalLinks(boolean) instead.
• Deprecated MRGSGDPR#getAgreementTime(Context) method. Use MRGSGDPR#getAcceptedAgreement(Context) instead.
• Deprecated MRGSGDPR#getAgreedVersion(Context) method. Use MRGSGDPR#getAcceptedAgreement(Context) instead.
• Deprecated MRGSGDPR#getSupportedLocalizations(Context) method. Use MRGSGDPR#getLocalizations(Context) instead.
• Deprecated MRGSGDPR#showDefaultAgreementAtActivity(Activity, String) method. Use MRGSGDPR#showAgreement(Activity, MRGSGDPRShowParams) instead.
• Deprecated MRGSGDPR#showAgreementAtActivity(Activity, String, String) method. Use MRGSGDPR#showAgreement(Activity, MRGSGDPRShowParams) instead.
• Deprecated MRGSGDPR#checkIfUserGetsUnderGDPR(Activity, String, MRGSGDPRAsyncStatus) method. Use MRGSGDPR#shouldShowAgreement(Activity, BiConsumer<MRGSGDPRShowReason, MRGSGDPRAgreement>) instead.
• Deprecated MRGSGDPR#shouldShowGDPR(Activity, String, boolean, MRGSGDPRAsyncStatus) method. Use MRGSGDPR#shouldShowAgreement(Activity, BiConsumer<MRGSGDPRShowReason, MRGSGDPRAgreement>) instead.
• Deprecated MRGSGDPR#setUserHasAcceptedAgreement(Context, boolean, boolean, String) method. Use MRGSGDPR#onAgreementAccepted(Context, boolean).
• Deprecated MRGSGDPR.MRGSGDPRDelegate interface. Use MRGSGDPR.OnShowListener instead.

IronSource-Adapter module:

• Fixed an issue, when after showing ads, in rare cases, a large number of duplicated events of completion, clicks and other could be sent.

Read more about the new features and how to use them in the documentation.

v6.8.1 Release (2023-10-17)🔗

In this version:

MRGService module:

• Fixed an issue when MRGService could track session incorrectly in the application. It could also affect the behavior of: advertisements (MRGSAdvertising), authentications (MRGSAuthentication), notifications (MRGSNotifications), and payments (MRGSBank). This usually led to the inability to display the UI in rare cases.

Notifications module:

• Fixed NullPointerException when tried to request a notification permission.

Read more about the new features and how to use them in the documentation.

v6.8.0 Release (2023-10-13)🔗

In this version:

• Supported Android 14.
• Updated androidx.core:core from 1.7.0 to 1.9.0.
• Updated androidx.appcompat:appcompat from 1.4.2 to 1.6.1.

MRGService module:

• Added a new MRGSGeoIpInfo#getCity() method to get city name.

• Updated com.huawei.hms:ads-identifier from 3.4.58.301 to 3.4.62.300.

• Updated com.huawei.hms:opendevicefrom 6.9.0.300 to 6.11.0.300.
• Fixed an issue when MRGService#getServerTime() could return 0. Improved tracking server time, now it will always be relevant from the launch of the application until the device is restarted.

Advertising module:

• Supported extra click events for AdTech

• Fixed an issue Not attached to Activity.

• Fixed an issue when onSaveInstanceState was called before VideoAdFragment closing.

Authentication module:

• Updated com.google.android.gms:play-services-auth from 20.4.0 to 20.6.0.

• Updated androidx.browser:browser from 1.3.0 to 1.5.0.

• Fixed an issue when onSaveInstanceState was called before MyGamesLoginFragment closing.

Bank module:

• Updated com.huawei.hms:iap from 6.1.0.300 to 6.4.0.301.

• Fixed an issue Too many bind requests 999+ because of unstable connections with Google Service.

IronSource-Adapter module:

• Supported sending extra data to server.

• Fixed NullPointerException when tried to release resources.

• Fixed an issue when prepared content was accidentally deleted.
• Fixed an issue when IronSource couldn't create MRGSCustomAdapter if old IronSource SDK was used.

IronSource module:

• Supported check integration for MRGSIronSource.

Notifications module:

• Updated com.huawei.hms:push from 6.7.0.300 to 6.11.0.300.

Read more about the new features and how to use them in the documentation.

v6.7.2 Release (2023-09-26)🔗

In this version:

MRGService module:

• Fixed an issue of incorrect data sending with MRGSTracker#trackEvent(String, Map<String, Object>) method.

Analytics module:

• Fixed a regression since release of 6.7.1 when payment information stopped being sent to AppsFlyer.

Advertising module:

• Fixed Zip Path Traversal Vulnerability.

GDPR module:

• Supported CCPA for new libraries: Tappx and Ogury.

• Fixed a rare NullPointerException error when trying to show GDPR with FragmentDialog(WebView).

• Fixed aActivityNotFoundException error when trying open a link with browser if there is no browser on a device.

Read more about the new features and how to use them in the documentation.

v6.7.1 Release (2023-09-02)🔗

In this version:

MRGService module:

• Updated proguard rules for aggressive obfuscation (android.enableR8.fullMode=true).

Authentication module:

• Fixed an issue of logging MyGames with browser, when system deleted required data to continue authentication.

Read more about the new features and how to use them in the documentation.

v6.7.0 Release (2023-08-16)🔗

In this version:

• Added a new ISMRGSCustomAdapter module - it's a cross-promo with DSP for IronSource.

MRGService module:

• Fixed an issue with duplicates of MRGS logs in Logcat.

Bank module:

• Updated com.android.billingclient:billing from 4.1.0 to 6.0.1.

GDPR module:

• Added a new MRGSGDPR#setBackgroundColor(float, float, float, float) method to change background in WebView.

Analytics module:

• Updated AppsFlyer SDK from 6.12.0 to 6.12.1.

Firebase module:

• Updated Firebase SDK from 10.12.0 to 10.13.0.

Authentication module:

• Updated VKId SDK from 0.102.0 to 0.103.0.

Read more about the new features and how to use them in the documentation.

v6.6.0 Release (2023-07-12)🔗

In this version:

MRGService module:

• Added a new MRGServiceParams#setUserAnonymizationEnabled(boolean) method for user anonymization in http requests to server.

• Fixed an issue when MRGSDevice#GetAdvertisingId can return null into callback.

Analytics module:

• Updated com.appsflyer:af-android-sdk from 6.11.1 to 6.12.1.

Firebase module:

• [iOS] Updated Firebase SDK from 10.10.0 to 10.12.0.

GDPR module:

• Extended a list of states for supporting CCPA: Connecticut(CTDPA) and Colorado(CPA).

MyTracker module:

• Updated com.my.tracker:mytracker-sdk from 3.0.11 to 3.0.12.

Read more about the new features and how to use them in the documentation.

v6.5.1 Release (2023-06-26)🔗

In this version:

Advertising module:

• Fixed internal algorithms for estimating the cost of cross-promo.

Analytics module:

• Updated com.appsflyer:af-android-sdk from 6.11.0 to 6.11.1.

Read more about the new features and how to use them in the documentation.

v6.5.0 Release (2023-06-20)🔗

In this version:

MRGService module:

• Supported remote log collection.

• Fixed an incorrect sending events with @deprecated MRGSTracker#trackEvent(MRGSTrackerEvent) method.

Authentication module:

• Fixed an issue when callback was called twice after authentication in Facebook.

Notifications module:

• Added a new MRGServiceParams#setClearNotificationTrayEnabled(boolean) method to control of removing push-notifications at application start.

Read more about the new features and how to use them in the documentation.

v6.4.0 Release (2023-06-09)🔗

In this version:

• Updated com.facebook.android:facebook-gamingservices from 11.2.0 to 16.0.1.

MRGService module:

• Improved detection of geo-positioning by IP.

• MRGSDevice#getReachability method will return 1 (slow connection) for mobile internet. It used to return 2 for mobile and wi-fi connection.

• Fixed an internal issue of incorrect validation of passed params for MRGSTracker#trackAdRevenue method.

GDPR module:

• Fixed an issue for UI in MRGSCOPPA.

Analytics module:

• Added sending test purchases to AppsFlyer. Such purchases will be sent with revenue 0.

• Supported sending Amazon purchases to AppsFlyer.

• Updated* com.appsflyer:af-android-sdk from 6.10.2 to 6.11.0.

• Fixed a potential error which can lead to crashes.

Authentication module:

• Added MRGSAuthentication#login(Activity, MRGSLoginCallback) and MRGSAuthentication#login(Activity, List<String>, MRGSLoginCallback) method for stable authentication. The old methods were marked as deprecated.

Firebase module:

• Added sending test purchases to AppsFlyer. Such purchases will be sent with revenue 0.

IronSource module:

• Supported auto-setting segments into IronSource according to with settings from MRGS console.

• Fixed a crash after failed casting ImpressionData.revenue to double, if there was not revenue in ImpressionData.

Read more about the new features and how to use them in the documentation.

v6.3.1 Release (2023-05-02)🔗

In this version:

MRGService module:

• Fixed an issue with many request of applicationExit.
• Fixed a issue of tracking session if the user continued to play from one day to another in his time zone.

Read more about the new features and how to use them in the documentation.

v6.3.0 Release (2023-04-25)🔗

In this version:

• Added a new MRGSIronSource module to auto-collect and send impression-level data of advertising revenue, and auction results to MRGS and AppsFlyer.

MRGService module:

• Added a new MRGSTracker#trackAdRevenue(String, String, double, String, Map<String, String>) method to send impression-level data of advertising revenue to MRGS.

• Updated com.huawei.hms:opendevice from 6.7.0.300 to 6.9.0.300.

Analytics module:

• Supported sending impression-level data of advertising revenue to AppsFlyer. It can be enabled/disabled in MRGS console of project section.

• Updated com.appsflyer:af-android-sdk from 6.9.3 to 6.10.2.

Authentication module:

• Added a new MRGSMyGames#setIgnoreCachedSession(boolean) method to force ignoring of current authentication session in MyGames.

Firebase module:

• Updated com.google.firebase:firebase-analytics from 21.2.0 to 21.2.2.

Notifications module:

• Updated com.google.firebase:firebase-messaging from 23.1.1 to 23.1.2.
• Updated com.huawei.hms:push from 6.7.0.300 to 6.9.0.300.

MyTracker module:

• Updated com.my.tracker:mytracker-sdk from 3.0.10 to 3.0.11.

Read more about the new features and how to use them in the documentation.

v6.2.0 Release (2023-04-07)🔗

In this version:

MRGService module:

• Added logger for network requests for new MRGS API.

Analytics module:

• Fixed sending of MRGS metrics into AppsFlyer.

Authentication module:

• Added MRGSMyGames#setPrimaryNetwork(String) and MRGSMyGames#setExcludedNetworks(List<String>) methods for changing or hiding main and small authentication buttons in MyGames.

• Fixed a crash when MRGSGooglePlayGames#IsLoggedIn() method was called.

• Removed extra web page after authentication in MRGSMyGames, if Firefox was used.

Read more about the new features and how to use them in the documentation.

v6.1.1 Release (2023-04-04)🔗

In this version:

MRGService module:

• Fixed an issue when MRGService#GetServerTime() return 0 because of race condition.

Read more about the new features and how to use them in the documentation.

v6.1.0 Release (2023-03-27)🔗

In this version:

MRGService module:

• Added MRGSPurchaseEvent#custom(MRGSRevenue) method to create and send purchase information from different payment systems. Such purchases won't be validated by MRGS.

• Fixed an issue when tried to initialize MRGS SDK from work thread.

Analytics module:

• Added a new way to send subscription purchase information to AppsFlyer with S2S instead of client side. It can be enabled in MRGS console.

• Fixed duplication of subscription purchase events (both af_purchase and af_subscribe were sent).

Firebase module:

• Added a new MRGSFirebase#getAppInstanceId(Consumer<String>) method to get appInstanceId from Firebase SDK.

Read more about the new features and how to use them in the documentation.

v6.0.0 Release (2023-02-10)🔗

In this version:

MRGService module:

• Added support for method for sending a new format of unified logs - accepts event name and a dictionary with any keys and values
• Added method for setting default values that will enrich all logs sent via the new method to MRGSTracker
• Added support for agreement acceptance event in MRGSTracker (e.g. when a user accepts a subscription agreement in California)
• Added support for new MRGSTrackerProfile class to send new format profiles to unified logs
• Fixed rare thread race bugs in MRGSTracker, due to which events could leave with separate requests

Bank module:

• Added sending appsflyerId for payments to Market|MyGames

GDPR module:

• Fixed keyboard overlay for typing email in COPPA

Notifications module:

• Fixed permission request for while push notifications when app starts on Android 13.

Support module:

• Added notification support for the support widget - now when you click on the notification, the user will be able to go directly to the support widget

Analytics module:

• Added UDL (Universal Deep Linking) support in AppsFlyer
• Added support for subscription purchase events af_start_trial and af_subscribe in AppsFlyer
• Fixed sending subscription data to Firebase - discounted price will now be taken into account

Authentication module:

• Fixed a bug due to which the authorization token for MRGSGooglePlayGames was not updated.
• Fixed a bug due to which it was not possible to restore the authorization token from the cache for MRGSMyGames authorization, which caused authorization to stop working.

Read more about the new features and how to use them in the documentation.

v6.0.0-b02 Release (2023-01-23)🔗

In this version:

Showcase module:

• Fixed ANR when trying to get User Agent.

Read more about the new features and how to use them in the documentation.

v6.0.0-b Release (2023-01-12)🔗

In this version:

Main:

• Added Native share window support. Read more here
• Added Android 13 support
• Completely redesigned MyGamesSupport API
• Added authorization support for GooglePlayGamesV2.
• The authorization module has been split into submodules - Facebook,Amazon,GoogleSignIn,GoogleGames
• Parameters for modules have been moved to the appropriate modules
• The SDK now requires a minimum version of Android 4.4 (API 19).
• Bugs fixed

MRGService module:

• Added Native share window support. Read more here
• Added bundleId validation to IntegrationCheck
• MRGService SDK now requires a minimum version of Android 4.4 (API 19).
• Removed deprecated functionality.
• Added hiding secrets in IntegrationCheck logs
• Fixed rules for R8/ProGuard.
• Returned bankSubstitution, now a String. The MRGSBilling#useAsMainBilling() methods have been removed.

Bank module:

• Added a new MRGSBilling#getLoadedProducts() method that will return a list of loaded products.
• SamsungBillingParams config has been renamed to MRGSSamsungBillingParams and moved to MRGSBillingModule module.
• Updated com.huawei.agconnect:agcp from 1.6.0.300 to 1.7.3.300
• Updated com.huawei.hms:ads-identifier from 3.4.39.302 to 3.4.58.301
• Updated com.huawei.hms:opendevice from 5.1.1.307 to 6.7.0.300
• Updated com.huawei.hms:push from 6.1.0.300 to 6.7.0.300
• Updated com.huawei.hms:iap from 6.1.0.300 to 6.4.0.301
• Fixed error getting micros for Huawei subscriptions.

Notifications module:

• Added support for Android 13 - request permission to send notifications.
• Updated com.google.firebase:firebase-messaging from 23.1.0 to 23.1.1.
• Updated com.google.firebase:firebase-messaging from 23.0.6 to 23.1.0.

Support module:

• Added a new class MRGSMyGamesSupport with a new completely redesigned interface for working with the support service (classes of pages, config, new methods for opening a window were added), old classes are marked as Deprecated

Analytics module:

• all events will now add additional mrgs userId and deviceId values.
• Changed default behavior for sending userId and deviceId - default AppsFlyer CUID now sends userId, and using useDeviceIdAsUserId you can enable the old behavior for sending deviceId. Read more here
• AppsFlyerParams config has been renamed to MRGSAppsFlyerParams and moved to MRGSAnalyticsModule module.
• Updated com.appsflyer:af-android-sdk from 6.8.2 to 6.9.3.

Firebase module:

• Added method setUserProperties
• Updated com.google.firebase:firebase-analytics from 21.1.0 to 21.2.0.

Authentication module:

• Added authorization support for GooglePlayGamesV2.
• The MRGSAuthenticationFacebook authorization has been moved into its own module MRGSAuthenticationFacebookModule.
• The MRGSAuthenticationAmazon authorization has been moved into its own module MRGSAuthenticationAmazonModule.
• MRGSGooglePlayGames authorization has been split into two modules MRGSGoogleSignIn and MRGSGooglePlayGames.
• The AmazonAuthParams config has been renamed to MRGSAmazonAuthParams and moved to the MRGSAuthenticationModule module.
• The FacebookParams config has been renamed to MRGSFacebookParams and moved to the MRGSAuthenticationModule module.
• The MRGSGooglePlayGamesParams config has been moved to the MRGSAuthenticationGooglePlayGames module.
• MyGamesAuthParams config has been renamed to MRGSMyGamesAuthParams and moved to MRGSAuthenticationModule module.
• Updated com.google.android.gms:play-services-auth from 20.3.0 to 20.4.0.
• Updated com.google.android.gms:play-services-games from 22.0.1 to 23.1.0.

Module MyTracker:

• Updated com.my.tracker:mytracker-sdk from 3.0.9 to 3.0.10.

GameCenter module:

• GameCenterParams config has been renamed to MRGSGameCenterParams and moved to MRGSGameCenterModule module.

Read more about the new features and how to use them in the documentation.

v6.0.0-a04 Release (2022-12-16)🔗

In this version:

GDPR module:

• Added Virginia VCDPA law support to CCPA functionality

Bank module:

• Fixed error 60001: too many query items for Huawei billing when try to request product
• Fixed a bug in the #useAsMainbilling() method

Analytics module:

• Added af_level field when proxying MRGS metrics in AppsFlyer

Read more about the new features and how to use them in the documentation.

v6.0.0-a03 Release (2022-11-10)🔗

In this version:

MRGService module:

• Fixed bugs with integration check.

Bank module:

• Returned default behavior for changing subscription from DEFERRED to IMMEDIATE_WITH_TIME_PRORATION.

Showcase module:

• Changed popup text about installing all games from the list.

Read more about the new features and how to use them in the documentation.

v6.0.0-a02 Release (2022-11-08)🔗

In this version:

MRGService module:

• The launch event will now tag the first launch on the device to track reattribution metrics
• Proxy settings for MyTracker are now obtained only when connecting this module
• Fixed integration check for authorization modules and MyTracker

Support module:

• Fixed MyGames Support

Read more about the new features and how to use them in the documentation.

v6.0.0-a Release (2022-11-03)🔗

This version includes backwards incompatible changes. To migrate to the new version, please refer to the Migrations documentation.

In this version:

• MyTracker is now not a required dependency. Working with it is moved into a separate module MRGSMyTracker. The MRGSMyTrackerParams class has moved into the MRGSMyTracker module.
• Work with VK authorization moved to a separate module MRGSAuthenticaitonVK. The MRGSVKontakteParams class has moved to the MRGSAuthenticationVK module.
• Changed all package names from ru.mail.mrgservice to games.my.mrgs
• removed references to VK/MyTracker from modules and moved them to the corresponding new modules

MRGService module:

• Changed initialization method MRGS - external sdk parameters are now passed as an array.
• Property MRGSMyGamesParams#VKPlayMode removed. Use MRGSMyGamesParams#CustomHost.

Support module:

• Enum ru.mail.mrgservice.MRGSMyComSupport.Credential.SocialNetwork.VK removed.

Authentication module:

• Enum MRGSAuthenticationNetwork removed, now uses string constants in corresponding classes

Read more about the new features and how to use them in the documentation.

v5.3.3 Release (2022-11-02)🔗

In this version:

Analytics module:

• Changed host for AppsFlyer to appsflyersdk.com to bypass blocks in Russia

Showcase module:

• Added support for remote title setting for Showcase

Bank module:

• Improved handling of purchase errors in Samsung billing

Read more about the new features and how to use them in the documentation.

v5.3.2 Release (2022-10-17)🔗

In this version:

MRGService module:

• Added support for enriching MRGS events with the appsflyerId parameter even if the MRGSAnalytics module is not connected, i.e. the AppsFlyer SDK is integrated separately.

Read more about the new features and how to use them in the documentation.

v5.3.1 Release (2022-10-15)🔗

In this version:

Analytics module:

• Fixed a bug with sending AppsFlyer id in MRGS events.

Read more about the new features and how to use them in the documentation.

v5.3.0 Release (2022-10-14)🔗

In this version:

MRGService module:

• BillingSubstitution.MY_GAME is tagged @Deprecated, use BillingSubstitution.MY_GAMES instead.

Analytics module:

• Added ability to automatically set UserID in AppsFlyer instead of deviceId. See AppsFlyer connection documentation for details.
• Added ability to delay AppsFlyer start until UserID is set. See AppsFlyer connection documentation for details.
• Added sending of cumulative session events (10/30/60/90/180 minutes) for new users. For details, see in the AppsFlyer connection documentation.
• Added enrichment of all requests in MRGS with the AppsFlyerID field.

Read more about the new features and how to use them in the documentation.

v5.2.1 Release (2022-10-03)🔗

In this version:

MRGService module:

• Fixed a bug due to which it was incorrectly parsed MRGService.xml config, as a result of which MRGSGoogleGames returned a server code instead of an authorization token. Now, by default, the authorization token is returned again, unless a different value is set in MRGService.xml config.

Read more about the new features and how to use them in the documentation.

v5.2.0 Release (2022-10-03)🔗

In this version:

MRGService module:

• Deprecated MRGServiceParams#shouldUseMyGamesBillingOnly() and MRGServiceParams#setUseMyGamesBillingOnly(boolean) methods, use MRGServiceParams#setBillingSubstitution(BillingSubstitution) instead.

Authentication module:

• Added a new MRGSExternalSDKParams.MyGamesAuthParams#setDevEnvironment(boolean) method to enable/disable DEV environment for MyGames/VKPlay authentication. Learn more.

• Supported a new authorization method via VKID (superappkit SDK). Learn more.

Bank module:

• Supported a new authorization method MRGSBilling#openSubscriptionManager(Activity) to open Subscription Manager. Learn more.

• Supported a new payment method via VKPay (superappkit SDK). Learn more.

Read more about the new features and how to use them in the documentation.

v5.1.1 Release (2022-09-05)🔗

In this version:

MRGService module:

• Updated com.my.tracker:mytracker-sdk from 3.0.8 to 3.0.9.

Read more about the new features and how to use them in the documentation.

v5.1.0 Release (2022-09-02)🔗

In this version:

MRGService module:

• Added a new method MRGSApplication#getInstallTime() to get the application installation time in unixTime format in milliseconds. Learn more.

• Added a new method MRGSExternalSDKParams.MyTrackerParams#setTrackingLocationEnabled(boolean) to enable/disable device location data collection in MyTracker SDK. Location tracking in the MyTracker SDK will now be disabled by default. Learn more.

• Updated com.my.tracker:mytracker-sdk from 3.0.7 to 3.0.8.

Analytics module:

• Updated com.appsflyer:af-android-sdk from 6.8.0 to 6.8.2.

Authentication module:

• Added a new method MRGSMyGames#setHideBrandOccurrences(boolean) to hide all brand mentions MY.GAMES when logging in via IMRGSAuthenticationMyGames. Learn more

• Added a new method MRGSExternalSDKParams.MyGamesAuthParams#setVkPlayModeEnabled(boolean) to change the authorization method from MyGames to VKPlay. Learn more.

• Removed checking of Play Games application when trying to login in via MRGSGoogleGames.

• Fixed a crash when trying to login in via MRGSGoogleGames on some Samsung devices.

Bank module:

• Updated com.android.billingclient:billing from 3.0.3 to 4.1.0.

• Fixed an issue when MRGSMyGamesBank saved data in MRGSBank instead of saving them at itself.

Read more about the new features and how to use them in the documentation.

v5.0.4 Release (2022-08-05)🔗

In this version:

Bank module:

• Fixed an issue, when Google purchase information was not sent to AppsFlyer, Firebase, and MyTracker since version 5.0.0 - MRGS Android SDK.

Read more about the new features and how to use them in the documentation.

v5.0.3 Release (2022-08-02)🔗

In this version:

• Downgraded androidx.appcompat:appcompat from 1.4.2 to 1.3.1, because it required compileSdkVersion not lower than 31.

MRGService module:

• Fixed an issue when MRGSDevice#getOpenUDID(Callback) returns invalid OpenUDID as "0000-0000".

Authentication module:

• Downgraded com.vk:android-sdk-core from 3.5.2 to 3.4.1, because it required compileSdkVersion not lower than 31.
• Downgraded androidx.browser:browser from 1.4.0 to 1.3.0, because it is not compatible with android gradle plugin/gradle 4.0/6.1.1 and lower.

Read more about the new features and how to use them in the documentation.

v5.0.2 Release (2022-07-27)🔗

In this version:

• Updated androidx.appcompat:appcompat from 1.2.0 to 1.4.2.

MRGService module:

• Updated com.my.tracker:mytracker-sdk from 3.0.4 to 3.0.7

Bank module:

• Added support for remote Market|MyGames showcase title change.

Notifications module:

• Updated com.google.firebase:firebase-messaging from 22.0.0 to 23.0.6.

Analytics module:

• Updated com.appsflyer:af-android-sdk from 6.5.2 to 6.8.0

Firebase module:

• Updated com.google.firebase:firebase-analytics from 19.0.2 to 21.1.0.

Authentication module:

• Added sending user info when logging in via Vk social network.
• Updated com.vk:android-sdk-core from 3.3.0 to 3.5.2
• Updated com.google.android.gms:play-services-auth from 19.2.0 to 20.2.0.
• Updated com.google.android.gms:play-services-games from 21.0.0 to 22.0.1.
• Updated androidx.browser:browser from 1.3.0 to 1.4.0.

Read more about the new features and how to use them in the documentation.

v5.0.1 Release (2022-07-05)🔗

In this version:

Notifications module:

• Fixed an issue java.lang.RuntimeException: Unable to start receiver.

Read more about the new features and how to use them in the documentation.

v5.0.0 Release (2022-06-29)🔗

In this version:

This version includes backwards incompatible changes. To migrate to a new version, see Migration guide.

• Added support for SDK distribution via Maven repository. Learn more.
• SDK requires Java 8 in your project. Learn more.

MRGService module:

• Now the SDK can be downloaded via Maven repository. Learn more.

• Redesigned methods of MRGService initialization. Now it is similar to methods used in MRGS Unity SDK. Learn more

• Interface MRGService.ActivityResultListener removed.

• Interface Printable removed.
• Interface MRGSIntegrationCheck.MRGSIntegrationCheckListener removed.
• Class MRGSX509ExtendedTrustManager removed.
• Class MRGSX509TrustManager removed.
• Class MRGSAirLog removed.

• Class MRGSExtSDK removed.

• Method MRGService#instance() renamed to MRGService#getInstance().

• Method MRGService#checkIntegration(MRGSIntegrationCheck.MRGSIntegrationCheckListener) removed. Use checkIntegration(@Nullable Consumer<MRGSIntegrationCheckResult>) instead.
• Method MRGService#initialized() removed. Use MRGService#isInitialized() instead.
• Method MRGService#registerResultListener(ActivityResultListener) removed.
• Method MRGService#unregisterResultListener(ActivityResultListener) removed.
• Method MRGService#onActivityRes(Activity, int, int, Intent) removed.
• Method MRGService#registerTransferManagerDelegate(String, MRGSTransferManagerDelegate) removed.
• Method MRGService#unregisterTransferManagerDelegate(MRGSTransferManagerDelegate) removed.
• Method MRGService#getIsRunService() removed.
• Method MRGService#setAppContext(Context) removed.
• Method MRGService#onStart(Activity) removed.
• Method MRGService#onStop(Activity) removed.
• Method MRGService#getSharedPreferences(String) removed. Use MRGSSharedPreferences#newInstance(String) instead.
• Method MRGService#getSharedPreferences(Context, String) removed. Use MRGSSharedPreferences#newInstance(Context, String) instead.
• Method MRGService#sendHandleException(String) removed. Use MRGSCrashReports#sendHandleException(String) instead.

• Method MRGService#sendHandleException(String, String) removed. Use MRGSCrashReports#sendHandleException(String, String) instead.

• Method MRGSLog#log(String) removed.

• Method MRGSMetrics.addPurchase(String, String, String) removed. Use MRGSMetrics.addPurchase(MRGSPurchaseEvent) instead.

• Method MRGSUsers#instance() renamed to MRGSUsers#getInstance().

• Method MRGSUsers#getCurrentUser() now returns MRGSUser instead of MRGSMap.

• Method MRGSDevice#instance() renamed to MRGSDevice#getInstance().

• Method MRGSDevice#useOldUDIDMethod() removed.
• Method MRGSDevice#shouldUseOldUDIDMethod() removed.
• Method MRGSDevice#generateDeviceIdOld(Context) removed.
• Method MRGSDevice#getGoogleAccountPrimary() removed.
• Method MRGSDevice#getODIN1() removed.
• Method MRGSDevice#getIMEI() removed.
• Method MRGSDevice#openSystemSettingsOfApplication() removed. MRGSDevice#openApplicationDetailsSettings(Context).

• Method MRGSDevice#getOldOpenUDID() renamed to MRGSDevice#getDeviceIdOrUUID().

• Method MRGSApplication#instance() renamed to MRGSApplication#getInstance().

• Method MRGSApplication#getApplicationBundleName() will not return any more null.

• Method MRGSServerData#instance() renamed to MRGSServerData#getInstance().

Advertising module:

• Now the SDK can be downloaded via Maven repository. Learn more.

• Class ru.mail.mrgservice.MRGSAdvertisingConsts removed.

• Class MRGSAdvertisingFactory moved from ru.mail.mrgservice to ru.mail.mrgservice.advertising.
• Const MRGSAdvert.SHOW_FULLSCREEN marked as @Deprecated and well be deleted soon.
• Method MRGSAdvert#showContent(int, String) marked as @Deprecated and well be deleted soon.

Analytics module:

• Now the SDK can be downloaded via Maven repository. Learn more.

• Class MRGSGoogleConversion removed.

• Class MRGSAnalytics moved from ru.mail.mrgservice to ru.mail.mrgservice.advertising.

• Class MRGSAppsFlyer moved from ru.mail.mrgservice to ru.mail.mrgservice.advertising.

• Method MRGSAnalytics#getGoogleConversion() removed.

• Method MRGSAppsFlyer#setCustomerUserId(String) removed. Use MRGSAppsFlyer#forceCustomerUserId(String) instead.

Authentications module:

• Now the SDK can be downloaded via Maven repository. Learn more.

• Class MRGSAmazon moved from ru.mail.mrgservice.amazon to ru.mail.mrgservice.authentication.amazon.

• Class MRGSFacebook moved from ru.mail.mrgservice.facebook to ru.mail.mrgservice.authentication.facebook..
• Class MRGSGoogleGames moved from ru.mail.mrgservice.googlegames to ru.mail.mrgservice.authentication.googlegames.
• Class MRGSMyGames moved from ru.mail.mrgservice.mygames to ru.mail.mrgservice.authentication.mygames.
• Class MRGSVK moved from ru.mail.mrgservice.vk to ru.mail.mrgservice.authentication.
• Class MRGSUser is interface now, and also moved from from ru.mail.mrgservice to ru.mail.mrgservice.authentication.amazon.
• Class FacebookUser removed.
• Class MRGSCredentials is interface now.

• Class MRGSAuthInfo marked ad @Deprecated. Use MRGSAccessToken instead.

• Interface MRGSAuthentication.ExternalLogoutCallback marked as @Deprecated. Use MRGSAuthentication.OnExternalLogoutListener instead.

• Interface MRGSSocial moved from ru.mail.mrgservice.social to ru.mail.mrgservice.authentication.
• Interface MRGSScore moved from ru.mail.mrgservice.games to ru.mail.mrgservice.authentication.
• Interface MRGSLeaderBoards moved from ru.mail.mrgservice.games to ru.mail.mrgservice.authentication.
• Interface MRGSAchievements moved from ru.mail.mrgservice.games to ru.mail.mrgservice.authentication.

• Interface MRGSAuthInfoCallback.java removed.

• Enum MRGSAuthenticationNetwork.MRGSAuthenticationNetworkAmazon renamed to MRGSAuthenticationNetwork.AMAZON.

• Enum MRGSAuthenticationNetwork.MRGSAuthenticationNetworkFacebook renamed to MRGSAuthenticationNetwork.FACEBOOK.
• Enum MRGSAuthenticationNetwork.MRGSAuthenticationNetworkGoogleGames renamed to MRGSAuthenticationNetwork.GOOGLE_GAMES.
• Enum MRGSAuthenticationNetwork.MRGSAuthenticationNetworkMyGames renamed to MRGSAuthenticationNetwork.MY_GAMES.
• Enum MRGSAuthenticationNetwork.MRGSAuthenticationNetworkVKontakte renamed to MRGSAuthenticationNetwork.VKONTAKTE.

• Enum MRGSAuthenticationNetwork.Unknown renamed to MRGSAuthenticationNetwork.UNKNOWN.

• Method MRGSAuthentication#loginWithScopes(List<String>, MRGSLoginCallback) marked as @Deprecated. Use MRGSAuthentication#login(List<String>, MRGSLoginCallback) instead.

• Method MRGSAuthentication#getAuthInfo(BiConsumer<MRGSAuthInfo, MRGSError>) marked as @Deprecated. Use MRGSAuthentication#getAccessToken(BiConsumer<MRGSAuthInfo, MRGSError>) instead.
• Method MRGSAuthentication#getUserAvatar(MRGSUser, MRGSAvatarCallback, int, int) marked as @Deprecated. Use MRGSAuthentication#getUserAvatar(MRGSUser, int, int, MRGSAvatarCallback) instead.

• Method MRGSAuthentication#setOnExternalLogoutCallback(ExternalLogoutCallback) marked as @Deprecated. Use MRGSAuthentication#setOnExternalLogoutListener(OnExternalLogoutListener) instead.

• Method MRGSAmazon#tryUpdateToken() removed. Use MRGSAmazon#getAccessToken(BiConsumer<MRGSAccessToken, MRGSError>) instead.

• Method MRGSAchievement#achievementId() marked as @Deprecated. Use MRGSAchievement#getAchievementId() instead.

• Method MRGSAchievement#name() marked as @Deprecated. Use MRGSAchievement#getName() instead.
• Method MRGSAchievement#description() marked as @Deprecated. Use MRGSAchievement#getDescription() instead.
• Method MRGSAchievement#state() marked as @Deprecated. Use MRGSAchievement#getState() instead.
• Method MRGSAchievement#currentSteps() marked as @Deprecated. Use MRGSAchievement#getCurrentSteps() instead.
• Method MRGSAchievement#totalSteps() marked as @Deprecated. Use MRGSAchievement#getTotalSteps() instead.

• Method MRGSAchievement#completionPercent() marked as @Deprecated. Use MRGSAchievement#getCompletionPercent() instead.

• Method MRGSCredentials#setUserId(String) removed.

• Method MRGSCredentials#setUser(MRGSUser) removed.
• Method MRGSCredentials#setAuthInfo(MRGSAuthInfo) removed.

• Method MRGSCredentials#getAuthInfo() marked as @Deprecated. Use MRGSCredentials#getAccessToken() instead.

• Method MRGSLeaderboard#leaderboardId() marked as @Deprecated. Use MRGSLeaderboard#getLeaderboardId() instead.

• Method MRGSLeaderboard#name() marked as @Deprecated. Use MRGSLeaderboard#getName() instead.

• Method MRGSScore#leaderboardId() marked as @Deprecated. Use MRGSScore#getLeaderboardId() instead.

• Method MRGSScore#rank() marked as @Deprecated. Use MRGSScore#getRank() instead.
• Method MRGSScore#displayRank() marked as @Deprecated. Use MRGSScore#getDisplayRank() instead.
• Method MRGSScore#rawScore() marked as @Deprecated. Use MRGSScore#getRawScore() instead.
• Method MRGSScore#displayScore() marked as @Deprecated. Use MRGSScore#getDisplayScore() instead.

• Method MRGSScore#player() marked as @Deprecated. Use MRGSScore#getPlayer() instead.

• Method MRGSUser#userId() marked as @Deprecated. Use MRGSUser#getUserId() instead.

• Method MRGSUser#nick() marked as @Deprecated. Use MRGSUser#getNickName() instead.
• Method MRGSUser#firstName() marked as @Deprecated. Use MRGSUser#getFirstName() instead.
• Method MRGSUser#lastName() marked as @Deprecated. Use MRGSUser#getLastName() instead.
• Method MRGSUser#middleName() marked as @Deprecated. Use MRGSUser#getMiddleName() instead.
• Method MRGSUser#fullName() marked as @Deprecated. Use MRGSUser#getFullName() instead.
• Method MRGSUser#displayName() marked as @Deprecated. Use MRGSUser#getDisplayName() instead.
• Method MRGSUser#gender() marked as @Deprecated. Use MRGSUser#getGender() instead.
• Method MRGSUser#birthDate() marked as @Deprecated. Use MRGSUser#getBirthDate() instead.
• Method MRGSUser#location() marked as @Deprecated. Use MRGSUser#getLocation() instead.
• Method MRGSUser#socialId() marked as @Deprecated. Use MRGSUser#getSocialId() instead.

Billing module:

• Now the SDK can be downloaded via Maven repository. Learn more.

• Class MRGSBilling moved from ru.mail.mrgservice to ru.mail.mrgservice.billing.

• Class MRGSPurchaseItem renamed to MRGSBillingProduct and moved from ru.mail.mrgservice to ru.mail.mrgservice.billing.
• Class MRGSBillingEntities moved from ru.mail.mrgservice to ru.mail.mrgservice.billing.
• Class MRGSMyGamesBilling moved from ru.mail.mrgservice to ru.mail.mrgservice.billing.
• Interface MRGSBillingDelegate removed.

• Interface MRGSBillingDelegateEx renamed to MRGSBillingDelegate and moved from ru.mail.mrgservice to ru.mail.mrgservice.billing.

• Method MRGSBilling#instance() renamed to MRGSBilling#getInstance().

• Method MRGSBilling#requestProductsInfoWithRequest(MRGSBankProductsRequest) renamed to MRGSBilling#requestProductsInfo(MRGSBankProductsRequest).
• Method MRGSBilling#buyItem(String sku, final String type) removed. Use MRGSBilling#buyItem(String sku) instead.
• Method MRGSBilling#buyItem(String sku, String type, String developerPayload) removed. Use MRGSBilling#buyItem(String sku, String developerPayload) instead.
• Method MRGSBilling#buyItem(final MRGSPurchaseItem purchase) removed. Use MRGSBilling#buyItem(MRGSBankPurchaseRequest) instead.
• Method MRGSBilling#setDelegate(MRGSBillingDelegateEx) removed.
• Method MRGSBilling#changeItem(String, String, String) removed. Use MRGSBilling#buyItem(MRGSBankPurchaseRequest) instead.
• Method MRGSBilling#changeItem(String, String, String, String) removed. Use MRGSBilling#buyItem(MRGSBankPurchaseRequest) instead.
• Method MRGSBilling#changeItem(MRGSPurchaseItem, MRGSPurchaseItem) removed. Use MRGSBilling#buyItem(MRGSBankPurchaseRequest) instead.
• Method MRGSBilling#getProductsInfo(ArrayList<String>) removed. Use MRGSBilling#requestProductsInfo(MRGSBankProductsRequest) instead.
• Method MRGSBilling#getProductsInfoWithTypes(ArrayList<Pair<String, String>>) removed. Use MRGSBilling#requestProductsInfo(MRGSBankProductsRequest) instead.
• Method MRGSBilling#getProductsInfoFromPurchaseInfo(ArrayList<MRGSBillingProduct>) removed. Use MRGSBilling#requestProductsInfo(MRGSBankProductsRequest) instead.
• Method MRGSBilling#notifyMRGSAboutConsume(MRGSPurchaseItem) changed on MRGSBilling#notifyMRGSAboutConsume(String sku, String transactionId)

• Method MRGSBilling#closePayment(MRGSPurchaseItem) removed. Use MRGSBilling#notifyMRGSAboutConsume(String sku, String transactionId) instead.

• Method MRGSBillingProduct#createWithPurchaseInfo(String) removed.

• Method MRGSBillingProduct#createWithPurchaseInfoWithType(String, String) removed.
• Method MRGSBillingProduct#fromJSON(String) removed.
• Method MRGSBillingProduct#setSku(String) removed.
• Method MRGSBillingProduct#setIntroductoryPeriod(String) removed.
• Method MRGSBillingProduct#setType(String) removed.
• Method MRGSBillingProduct#getDictionary() removed.
• Method MRGSBillingProduct#getPurchaseToken() removed.
• Method MRGSBillingProduct#setPurchaseToken(String token) removed.
• Method MRGSBillingProduct#getTransactionId() removed. Use MRGSBankTransaction#getTransactionIdentifier() instead.
• Method MRGSBillingProduct#getTransactionReceipt() removed.
• Method MRGSBillingProduct#getResultCode() removed.
• Method MRGSBillingProduct#getRawPurchaseInfo() removed. Use MRGSBankTransaction#getRawPurchaseResult() instead.
• Method MRGSBillingProduct#getDeveloperPayload() removed. Use MRGSBankPurchaseResult#getDeveloperPayload() instead.
• Method MRGSBillingProduct#setDeveloperPayload(String) removed.

• Method MRGSBillingProduct#getUserId() removed.

• Method MRGSBillingDelegate#onReceiveProductsResponce renamed to MRGSBillingDelegate#onReceiveProductsResponse.

• Method MRGSBillingDelegate#onReceiveSuccessfullPurchase renamed to MRGSBillingDelegate#onReceiveSuccessfulPurchase.

Firebase module:

• Now the SDK can be downloaded via Maven repository. Learn more.

• Class MRGSFirebaseAnalytics moved from ru.mail.mrgservice to ru.mail.mrgservice.firebase.

GDPR module:

• Now the SDK can be downloaded via Maven repository. Learn more.

• Class MRGSGDPR moved from ru.mail.mrgservice to ru.mail.mrgservice.gdpr.

• Class MRGSGDPR.MRGSGDPRFactory removed. Use MRGSGDPR#getInstance() instead.

• Interface MRGSCOPPA.OnResponseCallback removed from the public API, as it's intended for internal work.

• Method MRGSGDPR#showAgreementAtActivity(Activity, String, String, int) removed. Use MRGSGDPR#showAgreementAtActivity(Activity, String, String) instead.

• Method MRGSGDPR#shouldShowGDPRForVersion(Activity, String, int, boolean, MRGSGDPRAsyncStatus) removed. Use MRGSGDPR#shouldShowGDPRForVersion(Activity, String, boolean, MRGSGDPRAsyncStatus) instead.
• Method MRGSGDPR#setUserHasAcceptedAgreementWithVersion(Context, int, boolean, boolean, String) removed. Use MRGSGDPR#setUserHasAcceptedAgreementWithVersion(Context, boolean, boolean, String) instead.
• Method MRGSCCPA#fetchCountyIfNeeded() removed from the public API, as it's intended for internal work.
• Method MRGSCOPPA#isUnderUk(Consumer<Boolean>) removed from the public API, as it's intended for internal work.
• Method MRGSCOPPA#shouldShowCoppa(Consumer<Boolean>) removed from the public API, as it's intended for internal work.
• Method MRGSCOPPA#shouldShowCoppa(Context, Consumer<Boolean>) removed from the public API, as it's intended for internal work.
• Method MRGSCOPPA#sendEmail(String, OnResponseCallback<MRGSSendEmailResult>) removed from the public API, as it's intended for internal work.
• Method MRGSCOPPA#checkEmails(List<String>, OnResponseCallback<MRGSCheckEmailResult>) removed from the public API, as it's intended for internal work.

GameCenter module:

• Now the SDK can be downloaded via Maven repository. Learn more.

MyTarget module:

• Was removed.

Notifications module:

• Now the SDK can be downloaded via Maven repository. Learn more.

• Class MRGSGDPR moved from ru.mail.mrgservice to ru.mail.mrgservice.gdpr.

• Class MRGSPushNotifications removed. Use MRGSNotificationCenter instead.
• Class MRGSLocalPushService removed. Use MRGSNotificationCenter instead.
• Class MRGSLocalPushAutoStartReceiver removed.
• Class MRGSPushNotification.MRGSPushNotificationChannel removed. Use ru.mail.mrgservice.MRGSNotificationChannel instead.

• Class MRGSPushNotification.MRGSPushNotificationChannelsGroup removed. Use ru.mail.mrgservice.MRGSNotificationChannelGroup instead.

• Interface MRGSPushNotificationHandler.MRGSPushNotificationDelegate removed.

• Interface MRGSPushNotificationHandler.MRGSPushNotificationDelegateEx renamed to MRGSPushNotificationHandler.MRGSPushNotificationDelegate.

• Interface MRGSPushNotificationHandler.MRGSPushNotificationGroupDelegate removed.

• Interface MRGSPushNotificationHandler.MRGSPushNotificationExGroupDelegate renamed to MRGSPushNotificationHandler.MRGSPushNotificationGroupDelegate.

• Method MRGSNotificationCenterImpl.getInstance() removed. Use MRGSNotificationCenter.getInstance() instead.

• Method MRGSPushNotification.getCutomTextStrings() renamed to MRGSPushNotification.getCustomTextStrings().
• Method MRGSPushNotificationHandler#setDelegate(MRGSPushNotificationDelegateEx) removed.

Recommendations module:

• Now the SDK can be downloaded via Maven repository. Learn more.

• Class MRGSRecommendations moved from ru.mail.mrgservice to ru.mail.mrgservice.recsys.

• Method MRGSRecommendations#offerView(String, MRGSMap) removed. Use MRGSRecommendations#trackEvent(MRGSRecSysEvent) instead.

• Method MRGSRecommendations#offerClick(String, MRGSMap) removed. Use MRGSRecommendations#trackEvent(MRGSRecSysEvent) instead.
• Method MRGSRecommendations#offerBuy(String, MRGSMap) removed. Use MRGSRecommendations#trackEvent(MRGSRecSysEvent) instead.

Showcase module:

• Now the SDK can be downloaded via Maven repository. Learn more.

Support module:

• Now the SDK can be downloaded via Maven repository. Learn more.

• Constructor MRGSMyComSupportDialog(Activity, String) removed. Use MRGSMyComSupportDialog(Activity) instead.

• Constructor MRGSMyComSupportDialog(Activity, String, boolean) removed. Use MRGSMyComSupportDialog(Activity) instead.

Read more about the new features and how to use them in the documentation.

v4.18.5 Release (2022-06-06)🔗

In this version:

MRGService module:

• Added support for remote setting proxy server for MyTracker requests

Read more about the new features and how to use them in the documentation.

v4.18.4 Release (2022-05-23)🔗

In this version:

Notifications module:

• Fixed crash in the previous release, when trying to restore local push-notifications from the cache after restarting the application.

Read more about the new features and how to use them in the documentation.

v4.18.3 Release (2022-05-17)🔗

In this version:

Notifications module:

• Fixed crash in the previous release when trying to create a local custom push notification if resources could not be found.

Read more about the new features and how to use them in the documentation.

v4.18.2 Release (2022-05-04)🔗

In this version:

Advertising module:

• Changed button size from 30dp to 35dp.

Notifications module:

• Fixed errors when displaying notifications after updating the application due to changing resource ids after recompilation.

Showcase module:

• Added ability to hide showcase title remotely

Read more about the new features and how to use them in the documentation.

v4.18.1 Release (2022-04-08)🔗

In this version:

MRGService module:

• Changed a behavior of MRGService#ServerTime. Now serverTime will not be reset to 0 when the application is minimized. Learn more.

• Fixed a bug with infinite sending of network requests in case of network problems.

Authentication module:

• Fixed an issue Class not found when unmarshalling for Vk authentication.

Bank module:

• Added sending of version number and build to the server MRGS for VKPay payments.

Read more about the new features and how to use them in the documentation.

v4.18.0 Release (2022-03-24)🔗

In this version:

MRGService module:

• Added a new MRGSDevice#getGeoIpInfo(BiConsumer<MRGSGeoIpInfo, MRGSError>) method to determine the geographical location of the device with Internet access by its IP address. Learn more.

Read more about the new features and how to use them in the documentation.

v4.17.0 Release (2022-03-22)🔗

In this version:

MRGService module:

• The MRGSApplication#instance() method is marked @Deprecated and will be removed shortly. Use MRGSApplication#getInstance() instead of the old method.
• The MRGSDevice#instance() method is marked @Deprecated and will be removed shortly. Use MRGSDevice#getInstance() instead of the old method.
• The MRGService#instance() method is marked @Deprecated and will be removed shortly. Use MRGService#getInstance() instead of the old method.
• The MRGSServerData#instance() method is @Deprecated and will be removed shortly. Use MRGSServerData#getInstance() instead of the old method.
• The MRGSUsers#instance() method is @Deprecated and will be removed shortly. Use MRGSUsers#getInstance() instead of the old method.

Bank module:

• Improved error handling in MyGamesBank

Read more about the new features and how to use them in the documentation.

v4.16.0 Release (2022-03-18)🔗

In this version:

All modules:

• All MRGS***Version classes are marked as @Deprecated and will be removed soon. Versions can now be found in each module's BuildConfig.

Bank module:

• Added support for VKPay (Market|MyGames) payments - an alternative way to pay for purchases when placed outside of app stores

• Deprecated MRGSBilling#instance(). Use MRGSBilling#getInstance() instead.

Read more about the new features and how to use them in the documentation.

v4.15.0 Release (2022-02-25)🔗

In this version:

MRGService module:

• Added MRGSDevice#getAdvertisingId(Context, AdvertisingIdCallback) method to retrieve IDFA asynchronously. Learn more.

• Fixed a bug where metrics were not sent from MRGSMetrics to AppsFlyer when forwardMetrics was enabled.

Support module:

• Removed android.permission.READ_EXTERNAL_STORAGE from manifest.
• android.permission.WRITE_EXTERNAL_STORAGE requires android 8 or lower.

Read more about the new features and how to use them in the documentation.

v4.14.0 Release (2022-02-07)🔗

In this version:

MRGService module:

• Updated MyTracker SDK from 3.0.2 to 3.0.4. Learn more.

• Now, as a result of the integration check, a part of the secret key of MRGS SDK will be output.

• Fixed an error that caused a problem about parsing JSONArray to be displayed in the log when MRGService debug was enabled. This error did not affect the SDK functionality in any way..

Analytics module:

• Updated AppsFlyer SDK from 6.5.0 to 6.5.2. Learn more.
• Added additional sending of payment data such as: af_content_id (sku of a product) and af_order_id (orderId from a receipt).

Authentication module:

• Added a new MRGSAuthentication#getAuthInfo(BiConsumer<MRGSAuthInfo, MRGSError>) method to get AccessToken asynchronously, this will always allow you to get an up-to-date and valid token.

• Deprecated MRGSAuthentication#getAuthInfo() method.

• Fixed an error indicating an incorrect token expiration time for MRGSVK authorization, now 0 will be returned instead of the token creation time.

• Fixed an error when the user logged out in MRGSVK while initialization MRGService SDK if there is no internet connection.

Read more about the new features and how to use them in the documentation.

v4.13.0 Release (2022-01-24)🔗

In this version:

MRGService module:

• Added a new MRGSTracker#trackUserProfile(MRGSTrackerUserProfile) method for sending a user profile to the system of custom logs (events). Learn more.
• Downgraded appcompat library version from 1.3.1 to 1.2.0 because the new version requires updating a project to targetSdkVersion 31.

Advertising module:

• Fixed the private method of opening links in PlayableAds in mraid format.

Authentication module:

• Fixed issue when system could create another instance of CustomTabActivity for Facebook or MyGames authentication to pass result and it could lead to crash.
• Fixed incorrect saving Activity state.

GDPR module:

• Added a new MRGSGDPR#resetModule(Context) method to reset the fact of acceptance of the agreement and all data in GDPR, COPPA. It also resets the CCPA settings and sets them to the third-party tracking allowed status if tracking was turned off earlier. That is, a complete reset of the GDPR module to the state of the newly installed application. This method should be called ONLY if the user requested to delete his account according to the GDPR law, he was deleted, and you need to reset the fact of his acceptance of the agreement on the client so that the GDPR/COPPA window for the new user account is shown again.

Support module:

• Added an ability to create a request to delete all your data by the user (GDPR). Learn more.

Showcase module:

• Changed showcase design.
• Changed behavior for calculating notification. Now if the advertisement that the user has already seen comes again, then there will be no more notifications.

Read more about the new features and how to use them in the documentation.

v4.12.2 Release (2021-12-16)🔗

In this version:

MRGService module:

• Updated MyTracker SDK from 3.0.1 to 3.0.2. Learn more.
• Updated Appset Id SDK from 16.0.0 to 16.0.1.

Analytics module:

• Updated AppFlyer SDK from 6.3.2 to 6.5.0. Learn more.

Read more about the new features and how to use them in the documentation.

v4.12.1 Release (2021-12-13)🔗

In this version:

Bank module:

• Fixed incorrect behavior when different callback methods could return developerPayload with different structure. Now only the option that was originally transferred at the time of purchase will be returned.

GDPR module:

• Fixed error with a long response time when calling MRGSCOPPA#showCOPPAFlowIfNeeded if there is no internet.

Authentication module:

• Fixed rare crash when trying to log in with Facebook on a mobile device.

Read more about the new features and how to use them in the documentation.

v4.12.1 Release (2021-12-13)🔗

In this version:

Bank module:

• Fixed incorrect behavior when different callback methods could return developerPayload with different structure. Now only the option that was originally transferred at the time of purchase will be returned.

GDPR module:

• Fixed error with a long response time when calling MRGSCOPPA#showCOPPAFlowIfNeeded if there is no internet.

Authentication module:

• Fixed rare crash when trying to log in with Facebook on a mobile device.

Read more about the new features and how to use them in the documentation.

v4.12.0 Release (2021-12-07)🔗

In this version:

MRGService module:

• Added a new MRGSMyTracker#forceCustomUserId(String) method, which allows you to set the customer user ID (customUserId) before initializing MRGService. Learn more.
• Added support App set ID.

• Added a new MRGSDevice#getVendorId(Context, OnVendorIdCallback) method which provides AppSet id for Google store, ODID for Huawei store or null for another stores.

• Deprecated MRGSDevice#openSystemSettingsOfApplication() method, use MRGSDevice#openApplicationDetailsSettings(Context) instead.

• Deprecated MRGSDevice#getODIN1() method and it will be removed at the end of 2021.
• Deprecated MRGSDevice#getGoogleAccountPrimary() method and it will be removed at the end of 2021.
• Removed sending unique identifiers over the network such as Build.SERIAL and Wi-Fi MAC address, due to warnings from Google.
• Changed behaviour of the MRGSDevice#getOpenUDID(CallbackOpenUDID) method, because this method could not correctly generate OpenUDID before initializing MRGService. Now this method can return null if it is called on the very first launch of the application before initialization of MRGService.

Advertising module:

• Fixed long loading of ads, which could take from 0 to 5 seconds.
• Fixed a bug where the "close" button could be blocked when showing a video.
• Fixed out-of-sync between the time counter in the button and the video player.

Analytics module:

• Added a new static MRGSAppsFlyer#forceCustomerUserId(String) method, which allows you to set the customer user ID (customerUserId) before initializing MRGService. Learn more.

• Deprecated MRGSAppsFlyer#setCustomerUserId(String) method, use MRGSAppsFlyer#forceCustomerUserId(String) instead.

Bank module:

• Fixed a bug with json parsing when JSONObject.optstring could return "null" instead of "" for Facebook Cloud billing.

GDPR module:

• Added MRGSGDPR#openLinkInWebView(Context context, String title, String url) method to open external links of GDPR in WebView for Facebook Cloud.
• Foxed a bug, where two events about opening and accepting GDPR had different hashes.

Support module:

• Improved check tickets(MRGSMyComSupport#checkTickets(Context))) for support widget - now the check will work faster and load the support server less.
• Removed support for the old MyGames Support widget.
• Removed MRGSMyComSupport#checkTicketsOld(Context) method, which was used for the old widget.
• Removed MRGSMyComSupport#saveInfo(String, String) method, which was used for the old widget.
• Removed MRGSMyComSupport#getSecret() method, which was used for the old widget.
• Removed MRGSMyComSupport#setSecret(String) method, which was used for the old widget.
• Removed MRGSMyComSupportDialog.Builder#setSecret(String) method, which was used for the old widget.

Read more about the new features and how to use them in the documentation.

v4.11.0 Release (2021-11-03)🔗

In this version:

MRGService module:

• Added supporting Android 12.
• Updated MyTracker SDK from 3.0.0 to 3.0.1.
• Updated com.google.gms:google-services from 4.3.5 to 4.3.10.
• Updated com.huawei.agconnect:agcp from 1.4.1.300 to 1.6.0.300.
• Updated com.huawei.hms:ads-identifier from 3.4.34.301 to 3.4.39.302.
• Updated com.huawei.hms:opendevice from 5.0.4.300 to 5.1.1.307.
• Fixed a rare error that caused mrgsmetrics#addpurchase to lose events that did not have time to go away during the game session after restarting the application.

Advertising module:

• Updated androidx.appcompat:appcompat from 1.2.0 to 1.3.1.
• Updated androidx.recyclerview:recyclerview from 1.0.0 to 1.2.1.

Analytics module:

• Updated androidx.appcompat:appcompat from 1.2.0 to 1.3.1.

Authentication module:

• Increased the number of available browsers for authorization. Previously, only Chrome was used.
• Removed WebView as one of the ways to login to Facebook, since this method is no longer supported. An error with the code will also be sent to the callback -110 and the description Browser not found if there is no browser on the device.
• Excluded authorization way via Facebook or Google in MyGames if WebView is used, so these social networks no longer support WebView.
• Updated Facebook graph api version from 6.0 to 11.0.
• Updated androidx.appcompat:appcompat from 1.2.0 to 1.3.1.
• Updated androidx.browser:browser from 1.0.0 to 1.3.0.
• Updated com.google.android.gms:play-services-auth from 18.0.0 to 21.0.0.
• Updated com.google.android.gms:play-services-games from 19.0.0 to 19.2.0.
• Updated com.vk:androidsdk:2.7.0 from com.vk:android-sdk-core:3.3.0. Attention!!! Now VK authorization is required minSdkVersion="21" (Android 5.0+) to work.
• Fixed NullPointerException in CustomTabMainActivity when trying to log in via MyGames.

Bank module:

• Added supporting AppTouch. This feature is enabled automatically and does not require additional settings.
• Added check for the size of the developer Payload, if it is larger than 255 bytes, an error will be returned when trying to make a payment.
• Added package visibility for Samsung billing, for Android 11.
• Updated androidx.appcompat:appcompat from 1.2.0 to 1.3.1.
• Updated com.huawei.hms:iap from 5.1.0.300 to 6.1.0.300.
• Fixed error on collecting the type of currency for Samsung payments for the module MRGSBilling. Previously, they took the code from "79.99$", but this code can be used for different currencies, which is why the statistics were not correct. Now the currency code RUB, EUR, etc will be sent. There is no such error if payments were sent via MRGSMetrics#addPurchase(MRGSPurchaseEvent).

Firebase module:

• Updated androidx.appcompat:appcompat from 1.2.0 to 1.3.1.
• Updated com.google.firebase:firebase-analytics from 18.0.2 to 19.0.2.

GameCenter module:

• Updated androidx.appcompat:appcompat from 1.2.0 to 1.3.1.
• Updated androidx.recyclerview:recyclerview from 1.0.0 to 1.2.1.

GDPR module:

• Updated androidx.appcompat:appcompat from 1.2.0 to 1.3.1.

Notifications module:

• Now MRGSPushNotification#setCustomViewImage will search for the image not only in drawable but also in mipmap if the image was not in drawable.
• Updated androidx.appcompat:appcompat from 1.2.0 to 1.3.1.
• Updated com.google.firebase:firebase-messaging from 21.0.1 to 22.0.0.
• Updated com.huawei.hms:push from 5.0.4.302 to 6.1.0.300.

Recommendations module:

• Updated androidx.appcompat:appcompat from 1.2.0 to 1.3.1.

Showcase module:

• Updated androidx.appcompat:appcompat from 1.2.0 to 1.3.1.
• Updated androidx.recyclerview:recyclerview from 1.0.0 to 1.2.1.
• Fixed potential memory leaks.

Support module:

• Added support for VK authorization when opening the support widget.
• Deprecated an old support widget, and it will be removed in the next release.
• Deprecated MRGSMyComSupport#getSecret method, and it will be removed by the end of the year.
• Deprecated MRGSMyComSupport#setSecret method, and it will be removed by the end of the year.
• Deprecated MRGSMyComSupportDialog.Builder#setSecret method, and it will be removed by the end of the year.
• Updated androidx.appcompat:appcompat from 1.2.0 to 1.3.1.
• Fixed potential memory leaks.

Read more about the new features and how to use them in the documentation.

v4.10.0 Release (2021-10-01)🔗

In this version:

MRGService module:

• Added support for events sending messages in chat and correspondence in the game using MRGSTracker (transferring chat logs according to Yarovaya's law).
• Added ability to check if the client id was specified correctly for MyGames authorization by checking the integration.

Authentication module:

• Now the device locale will be transferred to the MyGames authorization in order to change the interface language. The locale will be transmitted if a flag is set in the MRGS remote config.
• Fixed updating the token in MyGames authorization within one game session (previously, the token was updated only at the start of the application).
• Fixed possible display of the "follow the link" window in the MyGames authorization if WebView was used.

Bank module:

• Fixed error INVALID_PARAMETER, errorMessage: This operation duplicates an unresolved request when multiple calls to the isBillingAvailable method for FacebookCloud.

GDPR module:

• Added support for private links to Privacy policy in GDPR when displaying default/custom HTML with localization. It is enough to register a link to policy in the MRGS admin panel.
• Fixed crash of java.lang.NullPointerException in COPPA.

Support module:

• Added support for authorization in the support widget - now the widget has become more secure, and will allow you to link user requests with accounts in social networks. When using the MRGSAuthentication module, authorization will be pulled up automatically.

Read more about the new features and how to use them in the documentation.

v4.9.3 Release (2021-09-21)🔗

In this version:

MRGService module:

• Updated facebook-gamingservices SDK from 11.0.0 to 11.2.0.
• Added a limit on the size of unified logs sent in the amount of 128kb.

Advertising module:

• Fixed an error when checking the hash amount if a non-valid md5 hash came from the server.

GDPR module:

• Fixed support notch of android for the COPPA dialog.
• Changed text in the window showing restrictions on the game in COPPA

Notifications module:

• Fixed a bug with sending local push notifications for Facebook Cloud.

Showcase module:

• Fixed an error when checking the hash amount if a non-valid md5 hash came from the server.

Read more about the new features and how to use them in the documentation.

v4.9.2 Release (2021-09-17)🔗

In this version:

GDPR module:

• Fixed a crash IllegalStateException: Can not perform this action after onSaveInstanceState when trying to show the COPPA dialog, if the user minimized the application at the time of launching the dialog.

Notifications module:

• Fixed a crash when trying to send metrics about receiving push notifications or trying to open the app via push.
• Fixed a crash when trying to open the app via a local push notification.

Read more about the new features and how to use them in the documentation.

v4.9.1 Release (2021-09-16)🔗

In this version:

MRGService module:

• Fixed bug when getting application context.
• Fixed error when trying to get a token for a new network api.

GDPR module:

• Changed behavior of checking the user's page for COPPA. Now, if it was not possible to get ahead of the user's country by ip address, then the result will be returned that the user does not fall under COPPA.
• Changed behavior of checking the user's page for COPPA. Now the country is checked only by the ip address.

Support module:

• Fixed error Class not found when unmarshalling: MyComSupportParams when trying to open MyGames Support on older Samsung devices.

Read more about the new features and how to use them in the documentation.

v4.9.0 Release (2021-09-03)🔗

In this version:

Authentication module:

• Added support Facebook Login For Gaming.
• Added support for authorization in Facebook Cloud. Learn more.

Bank module:

• Added support for Facebook Cloud billing. Learn more

GDPR module:

• Added support for the COPPA law. Learn more.

Read more about the new features and how to use them in the documentation.

v4.8.1 Release (2021-08-25)🔗

In this version:

MRGService (base) module:

• Fixed error setting additional parameters for metrics in the method of the MRGSMetrics#addMetric class.

Read more about the new features and how to use them in the documentation.

v4.8.0 Release (2021-08-24)🔗

In this version:

MRGService (base) module:

• Added support for a new system for collecting in-game logs/events. Learn more.
• Changed sending events through MRGSMetrics#adMetric method, now they are sent via the new server api.
• Updated MyTracker SDK from 2.1.2 to 3.0.0.
• Fixed error when trying to cast String to MRGSMap when checking integration, if the server did not return response.

Analytics module:

• Improved payment tracking. Now information on new payments is sent only once, which allows to avoid duplicates in statistics.
• Updated Appsflyer SDK from 6.2.3 to 6.3.2.

Firebase module:

• Improved payment tracking. Now information on new payments is sent only once, which allows to avoid duplicates in statistics.

Showcase module:

• Fixed an error when checking the hash-sum of banners, which affected the display of the banner in the showcase.

Recommendations module:

• Added support for sending new types of events for the recommendation system (RecSys). For more details see documentation.

Read more about the new features and how to use them in the documentation.

v4.7.0 Release (2021-08-06)🔗

In this version:

MRGService (base) module:

• Fixed a problem with the idfa consisting of only zeros for the Huawei store. Now, for more accurate statistics, you need to added com.huawei.hms:open device:<version> library.
• Added new function MRGSDevice#retrieveGoogleAdvertisingId(Advertising Id Callback) to get GAID.

Analytics module:

• Added functionality from AppsFlyer for generating links. For more information, see Link generation

Authentication module:

• Google

  • Fixed login error for target 30+ (Android 11+) due to missing entry <package android:name= "com.google.android.play.games" /> in the SDK manifest file.
  • Fixed an error due to which, at the time of login, an error was always written to the log MRGSGoogleGames getSignInClient no activity attached!!!

• MyGames

  • Fixed authorization issue if the user has two-factor authentication enabled.

Billing module:

• Deprecated MRGSBilling#setDelegate(MRGSBillingDelegate). Use MRGSBilling#setDelegateEx(MRGSBillingDelegateEx) instead.
• Deprecated MRGSBilling#getProductsInfo(ArrayList). To request products, you should use newer methods, for example MRGSBilling#requestProductsInfoWithRequest(MRGSBillingEntities.MRGSBankProductsRequest).

• Deprecated MRGSBillingDelegate.class. User MRGSBillingDelegateEx.class instead.

• Samsung

  • Fixed error setting developer Payload when calling the function-transaction recovery.

Firebase module:

• Fixed NullPointerException if the module was added but the Firebase SDK wasn't, then in some cases the module could throw an error.

GDPR module:

• Changed behavior for the time of sending the GDPR acceptance event, since it requires knowing the MRGS platform to send it. Now this event is sent after initialization of MRGService.
• Fixed a problem with updating the GDPR version separately for each application. Now for each application, you can specify the GDPR version in the config on the MRGS server.

MyGamesSupport module:

• Fixed an error for the new widget, due to which the extra_params field was passed to the locale field and was not processed on the server.

Showcase module:

• Removed a timer that blocked banner clicks if click_time was sent from the server greater than 0.
• Changed a behavior of sending the number of banner click events for one display of the showcase. Previously, it was possible to send no more than one click event for each banner for one display of the showcase, now there is no such restriction.

Read more about the new features and how to use them in the documentation.

v4.6.2 Release (2021-06-28)🔗

In this version:

GDPR module:

• Fixed a issue in the localization text for the Japanese language.
• Fixed a bug with text transfer for the Korean language in WebView.
• Added animation of "clicking" on the GDPR acceptance button in the WebView.
• Changed behavior of displaying GDPR in WebView. Now GDPR is shown by default without Ad permission.
• Fixed a bug that allows the server to downgrade the GRDP version on the client. Now the version can only be upgraded.

MyGamesSupport module:

• Fixed an error of sending the support window closing event if you return to the application by clicking the icon, and the manifest does not have a standard launchMode set for this event.
• Fixed a bug with requesting the widget version. Now the widget version is requested only once during the session to avoid blocking by the server.

Showcase module:

• Now you can set the desired screen orientation via the manifest. Learn more.
• Fixed an error of sending the showcase closing event if you return to the application by clicking the icon, and the manifest for this event is not set to the standard launchMode. Learn more.
• Fixed a bug with a broken layout when turning the screen.

Read more about the new features and how to use them in the documentation.

v4.6.1 Release (2021-06-03)🔗

In this version:

• Updated all obfuscation rules for ProGuard/R8. All obfuscation rules are supplied by .aar libraries.
• Added supporting for targetSdkVersion 30 (Android 11).

Authentication module:

• Fixed some bugs with incorrect switching of threads when returning the result from the Android.main thread to the Unity.main thread.

• Facebook

  • Fixed bug when trying to invite friends.

Billing module:

• Amazon
  • Updated In-app purchases SDK from 2.0.61 to 2.0.76.
  • Added supporting for the new MRGSBilling API, which was previously added for Google, Huawei, and Samsung but was not added for Amazon.

Showcase module:

• Fixed a layout issue for screens with sw320dp width.

Read more about the new features and how to use them in the documentation.

v4.6.0🔗

In this version:

MRGService (core) module:

• Fixed bug that caused integration check, now if the platform could not be identified, it will be considered that the platform is Android. The platform is determined by the type of billing set. See Parameter setup.

Billing module:

• Google
  • Added a new MRGSBankPurchaseRequest.setObfuscatedAccountId(String) method for supporting of Karaganda Fraud Prevention API. Learn more.
  • Added a new MRGSBankPurchaseRequest.setObfuscatedProfileId(String) method for supporting of Karaganda Fraud Prevention API. Learn more.
  • Fixed a rare bug due to premature caching of the subscription before it is actually closed(consumed): subscription purchase on the client -> validation on the server -> result caching on the client -> subscription closure (consumption) on the client. If Google Billing threw an error at the time of closing the subscription, it could cause the subscription to hang, which led to a refund to the user. Now the subscription will be cached only after it is successfully closed(consumed): subscription purchase -> validation -> subscription closure (consumption) -> result caching.

Firebase module:

• Added new events about the user's total time spent in the app: 30 minutes (mrgs_cumulative_session_time_30min), 1 hour (mrgs_cumulative_session_time_60min), 2 hours (mrgs_cumulative_session_time_120min) and 3 hours (mrgs_cumulative_session_time_180min). Events will only occur once, when the user reaches the appropriate time. For more information, see Sending events

Showcase module:

• Added support for direct links to the Google Play Store. Now, if the banner has a direct link to the Google Play Store, then the transition to the Google Play Store will be carried out without the mediation of the browser.

Read more about the new features and how to use them in the documentation.

v4.5.4🔗

In this version:

MRGService (core) module:

• Fixed an issue where an incorrect platform for Amazon, Huawei, and Samsung was passed to the server during integration verification, resulting in incorrect platform verification recommendations.
• Fixed an issue where the integration check did not display information on the MMS SDK settings if the SDK was configured via code instead of xml config.
• Improved integration validation. Now the integration check will output information on the enabled modules.
• Improved integration validation. Now the integration check will output more information about errors that occurred during module initialization.

Authentication module:

• MyGames
  • Fixed an issue where MRGSAuthentication.getCurrentUser() could return data on a user without MRGSAuthenticationNetwork.

Billing module:

• Google
  • Updated Google Billing SDK from 2.0.3 to 3.0.3.

MyGamesSupport module:

• Added new MRGSMyComSupport.getMyComSupport().setCustomUserId(String) method, in case you need to open a support with a different userId than MRGSUsers.instance().setUserId(String).