К содержимому
MARPLA / Центр помощи

Настроить дополнительные подключения

Настроить дополнительные подключения

Подключите дополнительные источники Roblox и проверьте границы доступных данных.

Как пользоваться

  1. Если доступ ограничен вашей ролью в MARPLA, права ключа владельца скрыты. Попросите владельца открыть «Доступы» и назначить вашему аккаунту нужную роль. Разрешения ключа в Roblox не меняют роль участника MARPLA.
  2. В настройках игры проверьте, какие модули уже подключены. В окне «Доступы игры» справа под крестиком есть «Скачать помощник»: кнопка скачивает ZIP единого расширения, в том числе для обновления уже установленного.
  3. Для финансов сообщества установите помощник MARPLA версии 1.2.0 или новее. Прочитайте согласие и нажмите «Подключить финансы», подтвердите доступ в расширении, затем нажмите подключение ещё раз. Если проверка владельца игры в Roblox временно недоступна, повторите подключение позже. Сохранённые отчёты остаются доступными; заменять API-ключ не нужно. Синхронизация работает через очередь и не обходит ограничения Roblox.
  4. Периоды День, Неделя, Месяц и Год — скользящие окна отчёта Roblox на момент снимка. Баланс и ожидающие Robux показаны отдельно. Категории не суммируются: некоторые могут пересекаться; пропуски остаются прочерками. Данные относятся ко всему сообществу и могут включать несколько игр.

Файлы и ссылки

Скачать помощник MARPLA для Chrome · ZIPДанные и конфиденциальность помощникаОткрыть юнит-экономикуКак работают финансы сообщества

Советы и практика

Разделяйте подключения

Каждый модуль запрашивает конкретные разрешения и может работать независимо от других. Помощник браузера для бенчмарков загружает доступные владельцу данные отдельным способом; его статус не подтверждает права на изменение товаров, рекламы или контента.

Диагностика доступа

При ошибке сравните требуемый scope, целевой Universe и операции с фактическим ключом. Расширяйте только отсутствующее разрешение. Ошибка — менять ключ ИИ, участника MARPLA или все scopes сразу, когда сообщение относится к одному Roblox-модулю.

Инструкция помощника и его privacy-описание должны совпадать с фактическими данными, которые он читает и отправляет. После установки проверьте источник, статус сохранения и период догрузки. Не воспринимайте значок расширения как подтверждение полноты истории.

Технические деталиРасчёты, права и особенности работы

Один ключ: все текущие модули

В шапке окна «Доступы игры», справа под крестиком, нажмите «Скачать помощник», чтобы получить ZIP единого расширения MARPLA. Кнопка доступна и при уже подключённом помощнике. Распакуйте архив и установите или обновите его в Chrome через «Загрузить распакованное расширение».

Права одного ресурса, например read и write, расположены рядом. При копировании ad.campaign:read или ad.campaign:write в буфер попадает ad для поиска Roblox. В Creator Dashboard → Credentials → API Keys создайте MARPLA или измените существующий ключ.

В Access Permissions добавьте API из списка ниже; для привязанных к игре разрешений выберите её Universe ID. Для Assets выберите аккаунт или группу — владельца креативов. Включите ключ и сохраните изменения, затем вставьте его в форму MARPLA.

Список можно скопировать целиком. В окне подключения каждый модуль занимает всю ширину. В его таблице показаны «Что делает», «Название ключа» и «Статус».

Нажмите полное имя разрешения, чтобы скопировать название для поиска Roblox: часть до двоеточия, с дефисами вместо точек. Например, universe.thumbnail:read копирует universe-thumbnail. Операция read или write остаётся видна, а рядом показан текущий статус доступа.

При первом подключении нужен universe.analytics:read, чтобы подтвердить доступ к игре; остальные права можно добавить позже. Полный набор выбран при первом подключении и включает просмотр видео: Legacy Assets → Manage (Asset Delivery, legacy-asset:manage). В «Сохранённых ключах» перед именем владельца показан его аватар Roblox; тот же аватар виден в раскрытых деталях ключа.

Если изображение недоступно, вместо него показывается нейтральная иконка, а имя остаётся видно. Рядом указаны текущий или сохранённый ключ, статус прав и время проверки. Новый ключ сохраняется отдельно, прежний остаётся в списке; повторная вставка того же ключа не создаёт копию.

Нажмите строку, чтобы открыть права именно этого ключа и проверить, чего не хватает. Если владелец старого ключа неизвестен, нажмите «Проверить доступ» внутри него. Просмотр другого ключа не переключает подключение, права разных ключей не объединяются.

Общий ключ игры отмечен как текущий; отдельный выбор рекламного подключения остаётся в разделе рекламы. Старые ключи появляются, только если их зашифрованная копия сохранилась в сервисе. Выбор «Только просмотр» убирает запись из списка, но не отнимает права у уже существующего ключа в Roblox.

Аналитика и отчёты

DAU, удержание, выручка, источники трафика и отчёт инвестору.

Выбранная игра (Universe ID)

Чтение

universe.analytics:read

События игры

Календарь событий Roblox; создание и редактирование названия, описания, времени, места, видимости и креатива.

События: Universe ID игры; Assets: владелец изображения

Чтение

universe.event:read · asset:read

Изменение

universe.event:write · asset:write

Рекламные кампании

Просмотр кампаний и платёжных аккаунтов; создание, переименование, запуск и остановка рекламы.

Рекламный аккаунт владельца ключа

Чтение

ad.campaign:read · ad.billing:read

Изменение

ad.campaign:write

Креативы, Home-превью и видео

Загрузка изображений, чтение и применение Home-превью. Для просмотра видео внутри MARPLA добавьте Legacy Assets → Manage (Asset Delivery). Это расширенное разрешение Roblox входит в полный набор подключения; установка иконок и видео выполняется в Creator Dashboard.

Assets: владелец изображений; Home-превью: выбранный Universe ID; Asset Delivery: доступ ключа к видео Roblox

Чтение

asset:read · universe.thumbnail:read

Изменение

asset:write · universe.thumbnail:write · legacy-asset:manage

Пассы

Каталог пассов; изменение названия, описания, цены и доступности продажи с подтверждением.

Выбранная игра (Universe ID)

Чтение

game-pass:read

Изменение

game-pass:write

Developer products

Каталог повторных покупок; изменение названия, описания, цены и доступных настроек продажи.

Выбранная игра (Universe ID)

Чтение

developer-product:read

Изменение

developer-product:write

Сверено с документацией Roblox: 2026-08-31. API keys ↗ Advertising ↗ Assets ↗ Asset Delivery ↗ Game events ↗ Home thumbnails ↗ OpenAPI · scopes ↗

Роль участника и права ключа

Если окно «Доступы игры» сообщает об ограничении роли, сведения о подключении скрыты для вашего аккаунта. Это не означает, что у ключа Roblox отсутствуют разрешения: количество подключённых модулей и права ключа в этом случае не показываются. Владелец игры в MARPLA должен открыть «Доступы», выбрать участника и назначить роль с нужными разделами.

Изменение Access Permissions ключа в Roblox само по себе не меняет роль участника MARPLA. Если у вас есть собственный ключ с подтверждённым доступом к этой игре, раскройте «Подключить свой Roblox API-ключ» и примените его через обычную проверку Roblox; один лишь просмотр окна прав не выдаёт.

Другие возможности Roblox · ещё нет в MARPLA

Ниже — возможные будущие интеграции, а не работающие функции MARPLA. Эти разрешения не входят в набор первого подключения. Их стоит добавлять только вместе с соответствующим интерфейсом и контролем действий.

Настройки игры и A/B-тесты · ещё нет

universe:read · universe:write

Чтение, публикация конфигураций и управление экспериментами Roblox. Интерфейса MARPLA пока нет; запись влияет на действующую игру.
Управление серверами · ещё нет

universe:read · universe:write

Списки серверов, журналы и перезапуск. В MARPLA не реализовано; перезапуск затрагивает игроков.
Команды живым серверам · ещё нет

universe-messaging-service:publish

Доставка сообщений через MessagingService. В MARPLA не реализовано; нужен обработчик в коде игры.
Аудит сохранений игроков · ещё нет

universe-datastores.control:list · universe-datastores.objects:list · universe-datastores.objects:read

Чтение DataStore выбранной игры. В MARPLA не реализовано. Запись и удаление сохранений не входят в этот набор и не нужны для аналитики.
Модерация игроков · ещё нет

universe.user-restriction:read · universe.user-restriction:write

Просмотр и изменение ограничений игроков. В MARPLA не реализовано; запись позволяет менять блокировки.
Проверка подписок · ещё нет

universe.subscription-product.subscription:read · universe:write

Проверка конкретной подписки по её ID; спецификация этого метода требует оба разрешения. В MARPLA нет интерфейса, это не полный журнал всех платежей.

Резервный помощник: подключение, данные и история

Единый помощник MARPLA включает бенчмарки и рекламу: устанавливается одно расширение с одним значком. В его меню выберите нужный раздел. Если ранее установлены отдельные помощники, отключите их после установки единого, затем перезагрузите MARPLA и Roblox.

Серверная синхронизация — независимый канал: показатели игры и пороги P50/P90 поступают через официальный Open Cloud API с правом universe.analytics:read. Дневные и семидневные пороги сохраняются отдельно, с датой и группой сравнения из Roblox. Обновление аналитики также запрашивает P50/P90 выбранной игры, без ожидания общей очереди.

Точный ранг игры поступает отдельно из карточки Roblox через помощник. При отказе Roblox шкалы остаются без новых точных данных, а не заполняются оценками. Помощник Chrome — резервный канал, его установка не обязательна для обычной аналитики.

Раскрывашка «Установка и подключение», кнопка «Разрешение» для скачивания расширения и значок синхронизации всегда доступны в бенчмарках участникам с правом управления интеграцией, даже если расширение не установлено. Кнопка расширения краснеет, если требуется обновление. Точный ранг берётся только из карточки Roblox; исторические цифра и точка красные, дата источника указана при наведении.

Если точного ранга нет, он не вычисляется из P50/P90. Прямая ссылка на архив находится и выше в этой инструкции. Статус «Помощник на связи» означает, что сервер получил heartbeat за последние пять минут.

Само наличие сохранённого ключа не подтверждает активное обновление; при более старой связи MARPLA показывает помощник офлайн и время последнего heartbeat. Для передачи отдельных недельных P50/P90 скачайте обновлённый помощник; старые версии продолжают передавать только дневные пороги. Значок синхронизации вращается только при отправке вашего запроса.

Регулярная фоновая догрузка не запускает постоянную анимацию; её состояние видно в подсказке значка.

Серые зоны графиков

Границы P50–P90 показаны плавными кривыми во всех графиках с историей бенчмарков. Кривые проходят через сохранённые точки, не пересекаются и не создают новых пиков между ними. При пропущенной дате реальные наблюдения разделяются; промежуток можно показать красным продлением последних порогов.

Одиночная дата остаётся отдельной полосой. Сглаживание меняет только изображение, а не числа в базе. Группы сравнения и даты доступны при наведении на P50–P90.

Roblox может сменить выборку с игр этого жанра на похожие успешные игры: тогда P50/P90 меняются, а соседние наблюдения плавно соединяются. Это смена базы сравнения, а не скачок показателя вашей игры.

Изменение показателя

Изменение из карточки Roblox хранится в исходных единицах и показывается в процентах: 0,479 означает рост на 47,9%. Номер процентиля и пороги P50/P90 — отдельные значения; этот перевод единиц их не меняет.

Установка

Скачайте ZIP и распакуйте его в постоянную папку. В Chrome откройте chrome://extensions, включите «Режим разработчика», выберите «Загрузить распакованное расширение» и папку с manifest.json. Войдите в Roblox в этом профиле, перезагрузите MARPLA и нажмите «Подключить помощник».

Если его ещё нет, кнопка откроет шаги установки; ключ подключения не создаётся до обнаружения помощника. Если расширение установлено, но потеряло привязку к этой игре, кнопка подключает его заново без повторной установки.

Месяц истории

После подключения нажмите «Догрузить 30 дней». Запрашиваются 30 завершённых дней по UTC, в том числе до первой сохранённой в MARPLA даты: дневные P50/P90, дневные и семидневные процентили, подробные показатели Home. Подключение не меняется; повторное нажатие не дублирует задания и не сбрасывает ограничения Roblox.

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

Доступ

Пароли и cookies Roblox не читаются, не сохраняются и не передаются в MARPLA. Передаются только значения аналитики по отдельному отзываемому ключу одной игры на 90 дней. Chrome должен оставаться запущенным, а сессия Roblox — действующей.

Отключение помощника отзывает его ключ, но не удаляет историю и не отключает серверную синхронизацию.

Обновление и пропуски

Текущие дневные и семидневные шкалы проверяются раз в 6 часов, доступная история догружается очередью. «Синхронизировать через помощник» ставит текущие шкалы в приоритет. При 401/403 проверьте вход и доступ к аналитике Roblox; при ограничении частоты запросы ждут.

Полученные наблюдения и исправления хранятся без срока удаления. Если Roblox не отдаёт старую дату, она остаётся пропуском, а не заменяется сегодняшним значением.

Даты шкал

«Последние» показывает последний полученный scorecard каждого показателя с собственной датой: у D7 она обычно старше. Календарь показывает только выбранную дату. Семидневные процентили не вычисляются усреднением дневных.

Серые зоны графиков используют сохранённые дневные P50/P90 за соответствующие даты. Старый ручной импорт не считается текущей автоматической синхронизацией.

Финансы сообщества

Финансы сообщества перенесены в «Юнит-экономика → выбор сообщества → Финансы». Существующие подключения и снимки сохранены.

Полезные статьи: примеры и решения

В инструкции — шаги в сервисе. В статьях — смысл показателей, примеры, приёмы и проверка результата.

Короткие действия и отдельные понятия (7)