Skip to content

Mobile project🔗

To add an application to MRGS, go to the «Settings» -> «Projects» section and click on the «New» button.

In the window that opens, you need to fill in the information about the project and configure the list of people who will have access to this project in MRGS. After saving, the project will appear in the system and receive its ID and secret keys for the API. This ID and keys will be required for MRGS integration.

All fields marked with red asterisks on the project creation page are required.

Basic settings🔗

  1. On the «Basic settings» tab, select the project platform from the list: platform
  2. Choose a company: MY.GAMES, MGVC or Hyper Casual: company
  3. Select a studio from the list. If the studio you need is not in the list, you can create it by clicking on the add studio button: studio In the window that appears, select a company, enter the name of the studio and click «Save».
  4. Select a group. A project group is a union of several platforms of one project. For example, the Castle Tower Wars group includes the Castle Tower Wars iOS and Castle Tower Wars Android projects. If the needed group is not in the list, you can create it by clicking on the add group button: group In the window that appears, enter the name of the group and click «Save».

  5. Further, depending on the platform:

    • iOS:
      • If the app is already in the app store, specify the Store URL: url After that, the parameters will automatically be adjusted: Russian name, English name, Icon, Bundle ID, External ID. If some parameter is not downloaded from the store, you need to add it manually.
      • If the app is not yet in the app store, enter the Russian name, English name, Bundle ID, External ID and upload the icon, if any.
    • Android:
      • If the app is already in the app store, specify the Store URL: url After that, the parameters will automatically be adjusted: Russian name, English name, Icon, Bundle ID (package name). If some parameter is not downloaded from the store, you need to add it manually.
      • If the application is not yet in the app store, enter the Russian name, English name, Bundle ID (package name) and upload the icon, if any.

    • Amazon, Huawei/AppTouch, Samsung, WindowsPhone: Enter Russian name, English name, Bundle ID, External ID and upload the icon, if any.

      Attention!

      Huawei: The External ID is not the Bundle ID (package name). The External ID can be found in Huawei Console under My Projects huawei_console

  6. Enter the Alarm E-mail. Messages about emerging problems will be sent to this E-mail.

  7. Optional project parameters:
    • Hidden project. When creating a project, you do not need to check this box. You cannot delete a project from MRGS, you can only hide it. When you check the box, the project will be hidden from all lists where there is a choice of projects. In the list itself, a hidden project will appear if you tick the Show hidden filter.
    • Test project. Automatically adds [TEST] to the project platform. It also affects the display of the project in the list - the name of the test project is highlighted in gray (and not black, like a production project).
  8. The basic project setup is complete. Click «Save».

Auto-generated parameters🔗

After the application is created, it will have the following parameters generated automatically:

  • ID: the parameter is located on the Basic settings tab. This ID must be used on the client as well.

  • Client Key / Server Key: The options are located on the Basic settings tab. Used to verify the signature of requests.

  • Link for advertising: the parameter is located on the Basic settings tab. This is the link which leads to the app store. It is used for MRGS redirects.

  • Link for Terrabank: the parameter is located on the Integrations tab. If you need to transfer payment data to Terrabank, then the generated link and the parameter after the space must be specified as a data source in the task for connecting the application to Terrabank.

  • Link for Terrabank (advertising): the parameter is located on the Integrations tab. If you need to transfer ad payments data to Terrabank, then the generated link and the parameter after the space must be specified as a data source in the task for connecting the application to Terrabank.

  • Link for ITStatus: the parameter is located on the Integrations tab. ITStatus is a statistics system. By default, no data is sent there. If you need to transfer data to ITStatus, then you need to create an application in ITStatus and specify this link there as a data source.

Payments and bonuses🔗

  1. Go to the «Payments and bonuses» tab and enter the data depending on the platform:

    • iOS: Enter the Secret Key to verify payments. On iOS it is used in Apple's new API. Detailed instructions on how to get these keys are in the «Payments» -> «Environment setting» section. Even if you are not using MRGS validation, this parameter will be needed to create a project in MyTracker.

    • Android: Specify JSON settings for payment verification. It can be used to distinguish test payments from production ones. Detailed instructions on how to get it are in the «Payments» -> «Environment setting» section. Even if you are not using MRGS validation, this parameter will be needed to create a project in MyTracker.

      Note

      Attention! On Google, the activation of credentials can take from 1 to 24 hours after the issuance of verification rights.

    • Other platforms: Enter the Key to verify payments. Detailed instructions on how to get these keys are in the «Payments» -> «Environment setting» section.

  2. Next, select one of the three options in the «Mechanism for working with payments»:

    • Informing about valid payments. In this case, MRGS will not validate payments. You need to perform validation on your server and send already valid payments to MRGS.
    • Informing about payments with MRGS validation. In this case, MRGS will validate the payments that you send, but will not send information about them to your game server or client.
    • Making payments through MRGS. Activate this option if you want to use MRGSBilling and validate payment on the MRGS server. In this case, MRGS will send payments to your game server or client.

  3. Where to send information about payments and bonuses:

    • If in step 2 you selected «Making payments through MRGS», then indicate where to send information about payments: to your game server or to the client. If you select «To the game server», you will need to specify its URL. To do this, click on «Specify server URL». You will go to the «Additional features» tab, where you will need to specify the URL of your game server, and also select the data format. MRGS will send bonus information to the same URL.
    • If in step 2 you selected «Informing about valid payments» or «Informing about payments with MRGS validation», then indicate where to send information about bonuses.

Integrations🔗

Creating a project in MyTracker🔗

Available for iOS and Android platforms only.

  1. Make sure that all required parameters are filled in on the «Basic settings» tab:
    • Platform
    • Company
    • Studio
    • Group
    • Russian name
    • English name
    • Bundle ID
    • For iOS: External ID
  2. Go to the «Payments and bonuses» tab and specify the parameters:
    • iOS: Secret key to verify payments. Instructions on how to get the secret key are in the «Payments» -> «Environment setting» section.
    • Android: JSON settings for checking payments. Instructions on how to get JSON are in the «Payments» -> «Environment setting» section.
  3. Go to the «Integrations» tab.
  4. Open the «MyTracker» section.

  5. Go to the «MyTracker idApp» parameter.

    • If you do not have app in MyTracker Click on the «Create» button next to the MyTracker idApp parameter. After clicking on the «Create» button, the application will be created in MyTracker, its idApp will be written in this field, and the SDK key will be displayed under it.
    • If the project has already been created earlier Enter its idApp (not the SDK key!), which is indicated in the link to the application in the MyTracker admin panel. Example of the idApp: 53600.

    Attention!

    You will need to use the SDK key on the client, not the idApp. MyTracker idApp is used in MRGS admin panel to sync with MyTracker.

    If the SDK key is not displayed, then most likely an error has occurred - to resolve the issue, contact MRGS team.

  6. Copy the SDK key and send it to the project developers. This SDK key must be specified on the client when integrating the MRGS SDK, read more in the Connect the SDK section for your platform. Example of the SDK key: 97979452142000402518.

  7. If you want to publish the application to MyTracker, toggle the Off button to On next to the «Publish to MyTracker» parameter. !!! danger "Attention!" After that you will not be able to change the Bundle ID and External ID in MyTracker. After the SDK is published, the SDK key will be associated with the app from the store.
  8. Click Save.

Loading data from IronSource🔗

  1. Go to the «Integrations» tab.
  2. Open the «IronSource» section.
  3. Enter the ID of this project in IronSource there. The IronSource key is used to load the ad revenue data from IronSource and display it in MRGS reports. To do this, you need to create the application in IronSource and register the key in this field. Also, MRGS transfers these data to Terrabank.

Attention!

If the data does not appear in the reports a day later, contact MRGS team.

Creating a project in Terrabank🔗

  1. Submit an issue to JIRA in the DMR project. The task must specify the parameters:
    • Project name to be displayed in statistics
    • Center of financial responsibility
    • Project group (optional, if available). The project group is needed to: a) see the total revenue for the Group; b) budget the Group. In a group you can specify a studio or a project group (project on all platforms).
    • Coefficient applied to the received amounts (optional, if necessary)
    • Project visibility (persons to whom the project data should be available in the statistics)
    • Import parameters: for a project on iOS, Android, Amazon, Samsung - project ID in MRGS; for other platforms - url for data collection (description of the data collection format Ext)
    • If the project is already accepting payments - the date from which you want to import data. If the project still does not accept payments - separately in the same task later signal the start of accepting payments, receive confirmation that the data import is active, and make sure that the data is imported correctly (that the payment parameters in stat.money.mail.ru correspond to the real ones)
    • If there are advertising payments in the project, then you need to indicate in the task that you also need a second project - the advertising one.
  2. After Terrabank IDs are received, they must be registered in this project on MRGS website. For this you need:
    • Go to project settings in MRGS.
    • Go to the "Integrations" tab.
    • Open the Terrabank section and specify the ID there. If the project has several Terrabank IDs (for example, for in-app and for advertising payments), then you can add several IDs by clicking on the plus.
    • Click "Save".

Creating a project in GAMESTAT🔗

  1. Go to the «Integrations» tab.
  2. Open the «1link» section. Make sure the 1link project ID is listed. If not, contact Sergei Antonov (sergei.antonov@astrum.team).
  3. Open the «Terrabank» section. Enter the project ID in Terrabank. Please note that there are often several Terrabank IDs for mobile projects: for example, for in-app and for advertising payments. You can add several Terrabank IDs by clicking on the plus.
  4. Open the «GAMESTAT» section. Toggle the Off button to On next to the Project in GAMESTAT parameter. If you do not have enough rights, as well as in case of difficulties, write to Maxim Pchelin.
  5. Click Save.
    • After that, after a short time, you will have access to this project on the dashboard without financial metrics: in GAMESTAT and in MRGS.
    • You can also grant access to other users yourself, read more in instructions for granting access.
    • Project data for the entire available history will be loaded next night.
  6. To get access to the dashboard with financial metrics, create a task in GAMESTAT project. The task must include:
    • Name or ID of the project in MRGS
    • Users who should get access to financial metrics: a list of e-mails registered in MRGS, or a list of links to SYS.

Dashboard links: in GAMESTAT and in MRGS.

Creating a Project in Business Modeling🔗

  1. Go to the «Integrations» tab.
  2. Open the «Business Modeling» section.
  3. Toggle the Off button to On next to the Project in Business Modeling option.
  4. Click Save.

Additional features🔗

Push notifications🔗

For iOS, Android and Samsung platforms.

  1. Open the «Additional Features» tab.
  2. Go to the «Push Notifications» section.
  3. Set up work with Push notifications
    • iOS: Create certificates according to instructions in the «Notifications» -> «Adding keys» section and upload them. *** Android and Samsung:** Create a key according to instructions in the «Notifications» -> «Adding keys» section and specify it in the «Key to send PUSH notifications» field.
  4. Click Save.

Client or browser project🔗

Client and browser projects are created in MRGS for integration with GAMESTAT, MyUA and Business Modeling systems.

Basic settings🔗

  1. On the Basic settings tab, select a project platform from the list.
  2. Choose a company: MY.GAMES, MGVC or Hyper Casual.
  3. Select a studio. If the studio you need is not in the list, you can create it by clicking on the add studio button. In the window that appears, select a company, enter the name of the studio and click «Save».
  4. Select a group. A project group is a union of several platforms of one project. For example, the Warface Breakout group includes the Warface Breakout Xbox and Warface Breakout PS4 projects. If the needed group is not in the list, you can create it by clicking on the add group button. In the window that appears, enter the name of the group and click «Save».
  5. Enter the Russian and English project names.
  6. Load the project icon.
  7. Optional project parameters:
    • Hidden project. When creating a project, you do not need to check this box. You cannot delete a project from MRGS, you can only hide it. When you check the box, the project will be hidden from all lists where there is a choice of projects. In the list itself, a hidden project will appear if you tick the Show hidden filter.
    • Test project. Automatically adds [TEST] to the project platform. It also affects the display of the project in the list - the name of the test project is highlighted in gray (and not black, like a combat project).
  8. The basic project setup is complete. Click «Save».

Issuing access to the project🔗

Only the owner of the project and those who have the rights to issue access can issue access to the project.

  1. Go to the project settings page.
  2. Open the «Access Privileges for Managers» section.
  3. Click on the «Add new manager» button.
  4. Find the people you need in the list by first name, last name or e-mail. Select them with checkboxes and click «Add».
  5. They will appear in the list. Then you can configure their access to this project in detail:
    • view
    • edit
    • view accesses
    • grant access
  6. The selected people will have access to the project in MRGS and GAMESTAT (if this project is created in GAMESTAT).
  7. To remove access, you need to uncheck the boxes.
Last update: 2025-01-27
Created: 2020-09-11