Android SDK Connection🔗

Minimum requirements🔗

Minimum supported Android version is 4.4 (api 19).

Integration🔗

Step 1. Add the library to the project🔗

Add MRGS SDK, using your preferred method: via Maven or Manual install. And also do not forget to add services, depending on which store you plan to distribute your application through.

Gradle - Maven install🔗

• Add MRGS Maven repository in the root build.gradle (for com.android.tools.build:gradle:7.0.4 and lower) or in settings.gradle (for com.android.tools.build:gradle:7.1.0 and higher) file of your project:

allprojects {
    repositories {
        google()
        mavenCentral()
        // MRGS Maven repository.
        maven { url 'https://mrgs-nexus.my.games/repository/maven2/' }
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // MRGS Maven repository.
        maven { url 'https://mrgs-nexus.my.games/repository/maven2/' }
    }
}

• Add next dependency in build.gradle file of your project:

dependencies {
    def mrgsVersion = "6.x.x"

    implementation "games.my.mrgs:core:$mrgsVersion"
}

Gradle - Manual install🔗

• Download the latest version of the library from the MRGS website. Unpack the archive.
• Copy a file called MRGService.aar from the archive into your project's directory with libraries (in most cases, libs).
• Add the libs directory to the flatDir section of the repository list in build.gradle:

allprojects {
   repositories {
      flatDir {
        dirs 'libs'
      }
      google()
      jcenter()
   }
}

Google Play Store - Add Services🔗

For Google Play Store you should add next dependencies:

dependencies {
    implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
    implementation 'com.google.android.gms:play-services-appset:16.0.2'
}

Huawei/AppTouch Store - Add Services🔗

For Huawei/AppTouch Store, you should add next dependencies:

• com.huawei.hms:ads-identifier according to documentation.
• com.huawei.hms:opendevice according to documentation.

dependencies {
    implementation 'com.huawei.hms:ads-identifier:3.4.62.300'
    implementation 'com.huawei.hms:opendevice:6.11.0.300'
}

Step 2. Call the initialization method🔗

Call the initialization method MRGServices.service in the onCreate method of the Application class, or your main Activity. Need to pass some params: Context of your application, MRGS_APP_ID, and CLIENT_SECRET.

import games.my.mrgs.MRGSPlatform;
import games.my.mrgs.MRGService;
import games.my.mrgs.MRGServiceParams;

public class YourApplicationClass extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        final MRGServiceParams serviceParams = MRGServiceParams.init(<MRGS_APP_ID>, <CLIENT_SECRET>, MRGSPlatform.ANDROID);
        serviceParams.setDebuggable(false);

        MRGService.service(context, serviceParams);
    }
}

Step 3 (Optional). Add account login tracking🔗

If your application uses a player identifier (USER_ID), it must be passed to MRGS using the method:

MRGSUsers.getInstance().setUserId(USER_ID);

Step 4. Add payment tracking🔗

Upon validation of the payment, it is necessary to report data about it to MRGS.

MRGSMetrics.addPurchase(MRGSPurchaseEvent);

MRGSPurchaseEvent event = MRGSPurchaseEvent.amazon(productJson, receiptJson, userDataJson);
MRGSMetrics.addPurchase(event);

MRGSPurchaseEvent event = MRGSPurchaseEvent.google(skuDetails, purchaseData, dataSignature);
MRGSMetrics.addPurchase(event);

MRGSPurchaseEvent event = MRGSPurchaseEvent.huawei(inAppPurchaseDataJson, inAppSignature);
MRGSMetrics.addPurchase(event);

MRGSPurchaseEvent event = MRGSPurchaseEvent.samsung(productVoJson, purchaseVoJson);
MRGSMetrics.addPurchase(event);

String transactionId = "1234-5678-000-ABCD";
String productId = "com.your.product.custom1";
float price = 10f;
String priceCurrency = "USD";
MRGSRevenue product = MRGSRevenue.newBuilder(transactionId, productId, price, priceCurrency)
    .setTitle("Custom Product")
    .setDescription("Custom product need for test")
    .build();
MRGSPurchaseEvent customPurchaseEvent = MRGSPurchaseEvent.custom(product);
MRGSMetrics.addPurchase(customPurchaseEvent);

Integration check🔗

After completing the MRGS integration, we recommend that you verify that the library is working correctly. To learn how to perform this procedure, see Integration checks and troubleshooting section.