Перейти к содержанию

Мобильный проект🔗

Чтобы добавить приложение в MRGS, нужно перейти в раздел «Настройки» –> «Проекты» и нажать на кнопку «Добавить».

В открывшемся окне нужно заполнить информацию о проекте и настроить список людей, которые будут иметь доступ к данному проекту в MRGS. После сохранения проект появится в системе и получит свой ID и секретные ключи для API. Этот ID и ключи потребуются для интеграции MRGS.

Все поля, отмеченные красными звездочками на странице создания проекта, являются обязательными для заполнения.

Основные настройки🔗

  1. На вкладке «Основные настройки» выберите платформу проекта из списка:
    platform
  2. Выберите компанию: MY.GAMES, MGVC или Hyper Casual:
    company
  3. Выберите студию из списка. Если нужной студии нет в списке, вы можете ее создать, нажав на кнопку добавления студии:
    studio
    В появившемся окне выберите компанию, введите название студии и нажмите «Сохранить».
  4. Выберите группу. Группа проектов — это объединение нескольких платформ одного проекта. Например, группа Castle Tower Wars включает в себя проекты Castle Tower Wars iOS и Castle Tower Wars Android. Если нужной группы нет в списке, вы можете ее создать, нажав на кнопку добавления группы:
    group
    В появившемся окне введите название группы и нажмите «Сохранить».

  5. Далее в зависимости от платформы:

    • iOS:
      • Если приложение уже есть в магазине приложений, укажите Store URL:
        ios_url
        После этого автоматически подтянутся параметры: Русское название, Английское название, Иконка, Bundle ID, Внешний идентификатор. Если какой-то параметр не подтянулся, его нужно добавить вручную
        ios_parameters
      • Если приложения еще нет в магазине приложений, введите Русское название, Английское название, Bundle ID, Внешний идентификатор и загрузите иконку, если есть.
    • Android:
      • Если приложение уже есть в магазине приложений, укажите Store URL:
        android_url
        После этого автоматически подтянутся параметры: Русское название, Английское название, Иконка, Bundle ID (package name). Если какой-то параметр не подтянулся, его нужно добавить вручную.
        android_parameters
      • Если приложения еще нет в магазине приложений, введите Русское название, Английское название, Bundle ID (package name) и загрузите иконку, если есть.

    • Amazon, Huawei/AppTouch, Samsung, WindowsPhone: Введите Русское название, Английское название, Bundle ID, Внешний идентификатор и загрузите иконку, если есть.

      Внимание!

      Huawei: Внешний идентификатор это не Bundle ID (package name). Внешний идентификатор можно найти в Huawei Console в разделе Мои проекты huawei_console

  6. Укажите тревожный E-mail. На данный E-mail будут приходить сообщения о возникающих проблемах.

  7. Опциональные параметры проекта:
    • Скрытый проект. При создании проекта ставить здесь галочку не нужно. Из MRGS нельзя удалить проект, а можно только скрыть. При проставлении галочки проект скроется из всех списков, где есть выбор проектов. В самом списке скрытый проект появится, если поставить галочку в фильтре «Показать скрытые».
    • Тестовый проект. Автоматически добавляет [TEST] к платформе проекта. Также влияет на отображение проекта в списке – название тестового проекта подсвечивается серым цветом (а не черным, как боевое).
  8. Основная настройка проекта завершена. Нажмите «Сохранить».

Автоматически созданные параметры🔗

После того как приложение будет создано, у него появятся следующие параметры, сгенерированные автоматически:

  • ID: параметр находится на вкладке «Основные настройки». Этот ID нужно использовать и на клиенте.

  • Клиентский ключ/серверный ключ: параметры находятся на вкладке «Основные настройки». Используются для проверки подписи запросов.

  • Ссылка для рекламы: параметр находится на вкладке «Основные настройки». Это ссылка, по которой можно попасть в стор. Используется для редиректов через MRGS.

  • Ссылка для Террабанка: параметр находится на вкладке «Интеграции». Если нужно передавать данные по платежам в Террабанк, то сгенерированную ссылку и параметр после пробела нужно указать как источник данных в задаче на подключение приложения к Террабанку.

  • Ссылка для Террабанка (реклама): параметр находится на вкладке «Интеграции». Если нужно передавать данные по рекламным платежам в Террабанк, то сгенерированную ссылку и параметр после пробела нужно указать как источник данных в задаче на подключение приложения к Террабанку.

  • Ссылка для ITStatus: параметр находится на вкладке «Интеграции». ITStatus – система статистики. По умолчанию данные туда не передаются. Если нужно передавать данные в ITStatus, то в ITStatus нужно завести приложение и указать там эту ссылку как источник данных.

Платежи и бонусы🔗

  1. Перейдите на вкладку «Платежи и бонусы» и укажите данные в зависимости от платформы:

    • iOS: Укажите Секретный ключ для проверки платежей. На iOS используется в новом API Apple. Подробная инструкция о том, как получить эти ключи, есть в разделе «Платежи» -> «Настройка окружения». Даже если вы не используете MRGS валидацию, данный параметр будет нужен для создания проекта в MyTracker.

    • Android: Укажите JSON настройки для проверки платежей. С помощью него можно отличать тестовые платежи от боевых. Подробная инструкция о том, как его получить, есть в разделе «Платежи» -> «Настройка окружения». Даже если вы не используете MRGS валидацию, данный параметр будет нужен для создания проекта в MyTracker.

      Внимание!

      В Google активация credentials может занять от 1 до 24 часов после выдачи прав на верификацию.

    • Остальные платформы:
      Укажите ключ для проверки платежей. Подробная инструкция о том, как его получить, есть в разделе «Платежи» -> «Настройка окружения».

  2. Далее выберите один из трех вариантов в «Механизме работы с платежами»:

    • Информирование о валидных платежах. В данном случае MRGS не будет валидировать платежи. Вам нужно на своем сервере проводить валидацию и отправлять MRGS уже валидные платежи.
    • Информирование о платежах с валидацией MRGS. В данном случае MRGS будет валидировать платежи, которые вы присылаете, но не будет отправлять информацию о них на ваш игровой сервер или клиент.
    • Проведение платежей через MRGS. Активируйте этот параметр, если хотите использовать MRGSBilling и валидировать платеж на сервере MRGS. В данном случае MRGS будет отправлять платежи на ваш игровой сервер или клиент.

  3. Куда отправлять информацию о платежах и бонусах:

    • Если в шаге 2 вы выбрали «Проведение платежа через MRGS», то укажите, куда отправлять информацию о платежах: на ваш игровой сервер или на клиент. При выборе «На игровой сервер» нужно будет указать его URL. Для этого нажмите на «Указать URL сервера»:

      server_URL

      Вы перейдете на вкладку «Дополнительные возможности», где нужно будет указать URL вашего игрового сервера, а также выбрать формат данных:

      server_URL(2)

      На тот же URL MRGS будет отправлять информацию о бонусах

    • Если в шаге 2 вы выбрали «Информирование о валидных платежах» или «Информирование о платежах с валидацией MRGS», то укажите, куда отправлять информацию о бонусах.

Интеграции🔗

Создание проекта в MyTracker🔗

Доступно только для платформ iOS и Android.

  1. Убедитесь, что на вкладке «Основные настройки» заполнены все необходимые параметры:
    • Платформа
    • Компания
    • Студия
    • Группа
    • Русское название
    • Английское название
    • Bundle ID
    • Для iOS: Внешний идентификатор
  2. Перейдите на вкладку «Платежи и бонусы» и укажите параметры:
    • iOS: Секретный ключ для проверки платежей. Инструкция, как получить секретный ключ, есть в разделе «Платежи» -> «Настройка окружения».
    • Android: JSON настройки для проверки платежей. Инструкция, как получить JSON, есть в разделе «Платежи» -> «Настройка окружения».
  3. Перейдите на вкладку «Интеграции».
  4. Откройте раздел «MyTracker».

  5. Перейдите к параметру «MyTracker idApp»:

    • Если у вас еще нет приложения в MyTracker, нажмите на кнопку «Создать» рядом с параметром «MyTracker idApp».

      mytracker_idapp

      После нажатия на кнопку «Создать» приложение создастся в MyTracker, его idApp пропишется в это поле, а SDK ключ отобразится под ним

      mytracker_sdkkey

    • Если приложение уже было создано ранее, пропишите его idApp (не SDK ключ), который указан в ссылке на приложение на сайте MyTracker. Пример idApp: 53600.

    Внимание

    На клиенте нужно будет использовать SDK ключ, а не idApp. MyTracker idApp используется на сайте MRGS для синхронизации с MyTracker.

    Если SDK ключ не отобразился, то, скорее всего, произошла ошибка - для решения проблемы обратитесь к команде MRGS.

  6. Скопируйте SDK ключ и передайте разработчикам проекта. Данный SDK ключ нужно указывать в клиенте при подключении MRGS SDK, подробнее читайте в разделе Подключение SDK для вашей платформы. Пример SDK ключа: 97979452142000402518.

  7. Если вы хотите опубликовать приложение в MyTracker, переключите кнопку Off в On рядом с параметром «Публикация в MyTracker»:

    mytracker_publish

    Внимание

    После этого нельзя будет изменить Bundle ID и External ID (Внешний идентификатор для iOS) в MyTracker. После публикации SDK ключ будет связан с приложением из магазина.

  8. Нажмите «Сохранить».

Настройка загрузки данных из IronSource🔗

  1. Перейдите на вкладку «Интеграции».
  2. Откройте раздел «IronSource».
  3. Укажите там ID данного проекта в IronSource. Ключ в IronSource нужен для того, чтобы забирать данные по рекламному доходу из IronSource и отображать в отчетах MRGS. Для этого нужно завести приложение в IronSource и прописать ключ в этом поле. Также эти данные MRGS передает в Террабанк.

Внимание

Если данные спустя сутки не появятся в отчетах, обратитесь к команде MRGS.

Создание проекта в Террабанк🔗

  1. Поставьте задачу в JIRA в проекте DMR. В задаче необходимо указать параметры:
    • Название проекта для отображения в статистике
    • ЦФО проекта
    • Группа проекта (опционально, при наличии). Группа проекта нужна, чтобы: а) сразу видеть суммарную выручку по Группе; б) бюджетировать Группу. В группе можно на ваше усмотрение указать, например, студию или группу проекта (проект на всех платформах).
    • Коэффициент, применяемый к получаемым суммам (опционально, при необходимости)
    • Видимость проекта (лица, которым должны быть доступны в статистике данные по проекту)
    • Параметры импорта: для проекта на платформах iOS, Android, Amazon, Samsung – ID проекта в MRGS; для других платформ – url для забора данных (описание формата забора данных Ext)
    • Если проект уже принимает платежи – дата, с которой нужно импортировать данные. Если проект еще не принимает платежи – отдельно в том же таске позднее сигнализировать о начале приема платежей, получить подтверждение, что импорт данных активен, и убедиться в том, что данные импортируются адекватно (что параметры платежей в stat.money.mail.ru соответствуют реальным)
    • Если в проекте будут рекламные платежи, то в задаче нужно указать, что нужен также второй проект – рекламный.

  2. После того как Террабанк ID будут получены, их необходимо прописать в данном проекте в MRGS. Для этого нужно:

    • Зайти в настройки проекта в MRGS.
    • Перейти на вкладку «Интеграции».
    • Открыть раздел Terrabank и указать там ID. Если у проекта несколько Террабанк ID (например, для in-app и для рекламных платежей), то можно добавлять несколько ID по нажатию на плюс:

    terrabank_id

    • Нажать «Сохранить».

Создание проекта в GAMESTAT🔗

  1. Перейдите на вкладку «Интеграции».
  2. Откройте раздел «1link». Убедитесь, что указан 1link ID проекта. Если его нет, обратитесь к Сергею Антонову (sergei.antonov@astrum.team).
  3. Откройте раздел «Террабанк». Введите ID проекта в Террабанк. Обратите внимание, что для мобильных проектов часто бывает несколько Террабанк ID: например, для in-app и для рекламных платежей. Можно добавлять несколько Террабанк ID по нажатию на плюс.
  4. Откройте раздел «GAMESTAT». Переключите кнопку Off в On рядом с параметром «Проект в GAMESTAT». Если у вас не хватает прав, а также при возникновении трудностей напишите Максиму Пчелину.
  5. Нажмите «Сохранить».
    • После этого через небольшое время у вас появится доступ к данному проекту на дашборде без финансовых метрик: в GAMESTAT и в MRGS.
    • Вы также можете сами выдать доступ другим пользователям, подробнее читайте в инструкции по выдаче доступов.
    • Данные по проекту за всю имеющуюся историю загрузятся ближайшей ночью.
  6. Для получения доступа к дашборду с финансовыми метриками поставьте задачу в проект GAMESTAT. В задаче необходимо указать:
    • Название или ID проекта в MRGS
    • Кому выдать доступ к финансовым метрикам: список e-mail пользователей, под которыми они заведены в MRGS, или список ссылок на SYS.

Ссылки на дашборд: в GAMESTAT и в MRGS.

Создание проекта в Бизнес Моделировании🔗

  1. Перейдите на вкладку «Интеграции».
  2. Откройте раздел «Бизнес Моделирование».
  3. Переключите кнопку Off в On рядом с параметром «Проект в Бизнес Моделировании».
  4. Нажмите «Сохранить».

Дополнительные возможности🔗

Push-уведомления🔗

Для платформ iOS, Android и Samsung.

  1. Откройте вкладку «Дополнительные возможности».
  2. Перейдите в раздел «Push-уведомления».
  3. Настройте работу с Push-уведомлениями
    • iOS: Создайте сертификаты по инструкции из раздела «Уведомления» -> «Настройка окружения» и загрузите их.
    • Android и Samsung: Создайте ключ по инструкции из раздела «Уведомления» -> «Настройка окружения» и укажите его в поле «Ключ для отправки PUSH нотификаций».
  4. Нажмите «Сохранить».

Клиентский или браузерный проект🔗

Клиентские и браузерные проекты создаются в MRGS для интеграции с системами GAMESTAT, MyUA и Бизнес Моделирование.

Основные настройки🔗

  1. На вкладке «Основные настройки» выберите платформу проекта из списка.
  2. Выберите компанию: MY.GAMES, MGVC или Hyper Casual.
  3. Выберите студию. Если нужной студии нет в списке, вы можете ее создать, нажав на кнопку добавления студии. В появившемся окне выберите компанию, введите название студии и нажмите «Сохранить».
  4. Выберите группу. Группа проектов — это объединение нескольких платформ одного проекта. Например, группа Warface Breakout включает в себя проекты Warface Breakout Xbox и Warface Breakout PS4. Если нужной группы нет в списке, вы можете ее создать, нажав на кнопку добавления группы. В появившемся окне введите название группы и нажмите «Сохранить».
  5. Введите русское и английское название проекта.
  6. Загрузите иконку проекта.
  7. Опциональные параметры проекта:
    • Скрытый проект. При создании проекта ставить здесь галочку не нужно. Из MRGS нельзя удалить проект, а можно только скрыть. При проставлении галочки проект скроется из всех списков, где есть выбор проектов. В самом списке скрытый проект появится, если поставить галочку в фильтре «Показать скрытые».
    • Тестовый проект. Автоматически добавляет [TEST] к платформе проекта. Также влияет на отображение проекта в списке – название тестового проекта подсвечивается серым цветом (а не черным, как боевое).
  8. Основная настройка проекта завершена. Нажмите «Сохранить».

Выдача доступов к проекту🔗

Выдавать доступы к проекту могут только владелец проекта и те, у кого есть права на выдачу доступов.

  1. Перейдите на страницу редактирования проекта.
  2. Откройте раздел «Привилегии доступа для менеджеров». access
  3. Нажмите на кнопку «Добавить менеджера».
  4. Найдите в списке нужных людей по имени, фамилии или e-mail. Выберите их галочками и нажмите «Добавить».
  5. Они появятся в списке. Далее вы можете детально настроить их доступы к данному проекту:
    • просмотр
    • редактирование
    • просмотр доступов
    • выдача доступов access_checkbox
  6. Выбранные люди получат доступ к проекту в MRGS и GAMESTAT (если данный проект создан в GAMESTAT).
  7. Чтобы убрать доступы, нужно снять галочки.
Последнее обновление: 2025-01-27
Дата создания: 2020-09-10