Безопасное управление настройками ASO с проектами ASO.dev

Проекты в ASO.dev предоставляют дополнительный уровень абстракции, позволяя объединять связанные логически приложения в один проект.
Этот подход особенно полезен для управления связанных логически приложений, таких как версии iOS и Mac одного и того же приложения или приложения, нацеленные на схожую аудиторию.

Типы проектов

ASO.dev предлагает два метода создания проекта для оптимизации приложения в App Store (ASO):

• Предоставить API-ключ: Интегрируйте свой API-ключ App Store Connect для интеграции к управлению и оптимизации метаданных, ключевых слов, отзывов и многое другое.
• Пропустить API-ключ: Редактирование метаданных через API недоступно без ключа, но вы можете использовать все инструменты анализа ASO.dev, а также работать с публично-доступными метаданными, вносить изменения локально и выгрузить изменения для обновления метаданных в скрипт Fastlane для разработчиков.

Вам также может быть предоставлен совместный доступ к проектам по ссылке или по электронной почте, чтобы работать над проектом вместе с командой.

Что такое API-ключ?

API-ключ - это безопасный цифровой ключ, который обеспечивает прямой доступ к данным и управлению приложениями в App Store Connect через официальное API.
Он позволяет автоматизировать загрузку метаданных, скриншотов, локализацию и другие задачи, устраняя необходимость ручного входа.

В App Store Connect доступны два типа API-ключей:

Ключи API команды:

• Предназначены для членов команды, которым нужен доступ к нескольким приложениям в организации.
• Эти ключи предоставляют более широкие разрешения на основе назначенных ролей в App Store Connect.
• Идеально подходят для управления приложениями на уровне команды, включая обновление метаданных, аналитику и финансовые отчеты.

Индивидуальные API-ключи:

• Предназначены для использования с ограниченным доступом к определенным приложениям.
• Разрешения можно настроить так, чтобы предоставлять доступ только к определенным функциям, таким как редактирование метаданных, управление приложениями или финансовые данные.
• Полезны в ситуациях, когда необходимо более гранулированное управление доступом, обеспечивая взаимодействие пользователей только с определенными разделами App Store Connect.
• Разрешения соответствуют уровню привилегий учетной записи, к которой привязан ключ.

Функции, требующие предоставления API-ключ

Если Вы решите не предоставлять API-ключ, доступ к функциям редактирования метаданных будет ограничен.

Следующие функции доступны только с API-ключом:

• Редактор метаданных:
  • Интеграция с App Store Connect.
  • Редактирование возрастного рейтинга.
  • Выбор сборки для отправки на проверку в App Store.
  • Отправка приложения на проверку или отзыв c проверки непосредственно с ASO.dev при необходимости.
  • Примечание: просмотр ключевых слов в метаданных приложения будет недоступен без API-ключа.
• Массовый редактор метаинформации и Кросс-Локализация:
  • Интеграция с App Store Connect.
  • Редактирование метаданных для всех локализаций одновременно.
  • Примечание: просмотр ключевых слов в метаданных приложения будет недоступен.
• Подписки
  • Управление подписками, локализацией и доступностью приложения.
• Цены:
  • Контроль цен на подписки в приложении.
• Массовая загрузка скриншотов и видео:
  • Загрузка скриншотов и видео для всех локализаций
• Страницы продуктов (CPP):
  • Управление страницами продуктов приложения, локализация промо-текста, загрузка медиа-файлов.
• Отзывы:
  • Управление отзывами приложения.
  • Ответы на отзывы.
  • Пожаловаться на некорректные отзывы.
• Хроника:
  • Просмотр истории всех изменений, внесенных в метаданные приложения.
• Права доступа:
  • Некоторые разделы лимитированы из-за необходимости API-ключа.

Проект без API-ключа

1. Укажите произвольное название проекта для удобства идентификации в будущем.
2. Добавьте приложения, которые хотите добавить в проект по ссылке, идентификатору или названию.

Проект с API-ключом

Настройка API-ключа

Создайте API-ключ: В Вашем аккаунте App Store Connect создайте новый API-ключ.

Мы поддерживаем Командные и Индивидуальные .p8 API-ключи.
Мы рекомендуем создавать новый ключ для каждого проекта.

Укажите произвольное название проекта для удобства идентификации его в списке проектов.

Если у вас уже есть API-ключ и вы не уверены в его типе, проверьте формат идентификатора ключа:

• Командный API-ключ: 10 символов
• Индивидуальный API-ключ: 12 символов

Добавьте API-ключ в ASO.dev

В разделе создания проекта введите данные вашего API-ключа.

Вы можете добавить файл ключа:

• Перетащив его в окно создания проекта
• Ввести данные вручную.
• Выбрать файл ключа с вашего устройства через иконку .

Заполните обязательный идентификатор

• Для Командных API-ключей: Укажите Issuer ID.
• Для Индивидуальных API-ключей: Укажите идентификатор Issuer ID или Developer ID.

Issuer/Developer ID - уникальный идентификатор, генерируемый для каждого аккаунта App Store Connect.

Выберите настройки синхронизации API-ключа

Выберите, хотите ли вы синхронизировать API-ключ между устройствами:

• Синхронизация Выключена: Не требуется код шифрования; ключ хранится локально на компьютере пользователя в Secure Storage.
• Синхронизация Включена: Требуется указать пользовательский код шифрования для безопасного обмена ключом между устройствами в зашифрованном формате.

Код шифрования

Для безопасности: API-ключ (.p8) надежно зашифрован.

Код шифрования используется для передачи доступа к ключу при совместном использовании и для доступа к одному проекту на разных устройствах.
Чтобы восстановить доступ к проекту на другом устройстве, введите код шифрования на карточке проекта.

Код шифрования доступен только на устройстве, где был создан проект.
Для его просмотра откройте редактор проекта на этом устройстве.

Если вы потеряли доступ к устройству и забыли код шифрования, восстановить его невозможно — вам потребуется создать новый проект.

Прокси-сервер

Доступно только для профессионального плана.

Apple может временно заблокировать или ограничить доступ к учетной записи разработчика, если зафиксирует подозрительную активность.
Если один и тот же аккаунт внезапно начинает делать запросы из сильно удалённых регионов (например, США → Китай → Германия за короткое время), это может выглядеть как взлом.
Если Apple увидит, что запросы идут через известные VPN или дата-центры (особенно низкокачественные прокси), они могут запросить дополнительную верификацию.
Более того, если несколько разных учетных записей используют один и тот же IP, Apple может связать все аккаунты разработчика между собой по этому IP адресу.
Это особенно критично, если аккаунты принадлежат разным юридическим лицам или разделены в разные учетные записи с целью дальнейшей продажи приложения.
В таком случае, если один аккаунт столкнётся с проблемами, санкции могут затронуть и другие.

Использование качественных прокси позволяет снизить такие риски, так как API-запросы всегда будут исходить с одного стабильного IP-адреса, привязанного к конкретному IP прокси-сервера.

Кому это нужно?

• Разработчикам с несколькими Apple Developer Account.
• Агентствам, работающим с разными клиентами.
• Крупным компаниям с распределёнными командами.
• Владельцам отдельных юридических лиц или проектов, требующих различные IP.

Преимущества использования прокси-сервера:

• Безопасность — защита от блокировок и ограничений со стороны Apple.
• Конфиденциальность — разделение аккаунтов и предотвращение связи между ними.
• Один IP для всех сотрудников - при работе распределенной команды.
• Одновременная работа с несколькими аккаунтами — все запросы к API будут исходить не с IP пользователя, а для каждого проекта будет использоваться свой IP-адрес прокси-сервера, снижая риск блокировок.

Виды прокси

• Мобильные прокси: Маскируются под обычных пользователей iPhone/iPad. Самый безопасный, но дорогой вариант. Apple почти никогда не блокирует мобильные IP, так как они динамические.
• Резидентные прокси: выглядят как обычные пользовательские IP-адреса и менее подвержены блокировке. Выдаются интернет-провайдерами, а не дата-центрами.
• Дата-центровые прокси: самые дешевые, часто используются для массового скрейпинга, Apple определяет их как бот-трафик и блокирует чаще всего, что повышает вероятность бана по IP.

Что выбрать для работы с Apple?

Тип прокси	Безопасность	Скорость	Цена	Подходит для Apple?
Резидентные	✔️ Высокая	⚡ Средняя	💲💲💲	✔️ Да
Мобильные	✅ Очень высокая	⚡ Средняя	💲💲💲💲	✅ Да (лучший вариант)
Дата-центровые	❌ Низкая	🚀 Высокая	💲	❌ Нет (высокий риск бана)

Настройка прокси-сервера

Как настроить прокси-сервер:

1. Создайте прокси-сервер:

   • Выберите надежного провайдера прокси.
   • Настройте прокси-сервер с статическим IP-адресом.

2. Добавьте прокси-сервер в ASO.dev:

   • В настройках проекта введите IP-адрес и порт прокси-сервера.
   • При необходимости введите имя пользователя и пароль для прокси-сервера.
   • Сохраните настройки.

3. Вы можете установить прокси-сервер для каждого проекта индивидуально.

4. Вы можете включить обязательное использование прокси-сервера для всех проектов в настройках.

Прокси сервер нужен только для работы с App Store Connect и не используется при работе других функций ASO.dev - ASO-анализа.