Подключение Android SDK🔗

Минимальные требования🔗

Минимальная поддерживаемая версия Android 4.4 (api 19);

Интеграция🔗

Шаг 1 - Добавьте библиотеку в проект🔗

Установите MRGS SDK, используя предпочитаемый вами метод: через Maven или Ручная установка. А так же не забудьте подключить сервисы в зависимости от того через какой магазин вы планируете распространять ваше приложение.

Gradle - Maven установка🔗

• Добавьте MRGS Maven репозиторий в корневой build.gradle (для com.android.tools.build:gradle:7.0.4 и ниже ) или в settigns.gradle (для com.android.tools.build:gradle:7.1.0 и выше) файл вашего проекта:

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/' }
    }
}

• Добавьте следующие зависимости в файл build.gradle вашего приложения:

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

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

Gradle - Ручная установка🔗

• Загрузите последнюю версию библиотеки с сайта MRGS. Распакуйте архив.
• Скопируйте из архива файл MRGService.aar в директорию с библиотеками своего проекта (обычно libs)
• Добавьте директорию libs в раздел flatDir списка репозиториев в build.gradle

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

Google Play Store - Подключение сервисов🔗

Если ваше приложение нацелено на Google Play Store, то следует добавить следующие зависимости:

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 - Подключение сервисов🔗

Если ваше приложение нацелено на Huawei/AppTouch Store, то следует добавить следующие зависимости:

• com.huawei.hms:ads-identifier согласно документации.
• com.huawei.hms:opendevice согласно документации.

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

Шаг 2 - Вызовите метод инициализации🔗

Вызовите метод инициализации MRGServices.service в методе onCreate класса Application, либо в методе onCreate класса вашей главной Activity. В качестве аргументов необходимо передать Context, а также MRGS_APP_ID, 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);
    }
}

Шаг 3 (Опциональный) - Добавьте трекинг входа в игровой аккаунт🔗

Если ваше приложение использует идентификатор игрока (USER_ID), его необходимо передать в MRGS с помощью метода:

MRGSUsers.getInstance().setUserId(USER_ID);

Шаг 4 - Добавьте трекинг платежей🔗

После валидации платежа необходимо сообщить данные о нем в 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);

Проверка интеграции🔗

После завершения интеграции MRGS, мы рекомендуем убедиться в том, что библиотека работает корректно. О том как провести данную процедуру, читайте в разделе Проверки интеграции и поиск неисправностей