Регистрация продуктов в App Store

Чтобы воспользоваться функционалом внутриигровых покупок на iOS, зарегистрируйте свое приложение и все доступные продукты в iTunes Connect. Это руководство предоставляет краткое введение в процесс регистрации приложения и его внутриигровых продуктов в App Store.

Внутриигровые покупки можно тестировать только на реальном оборудовании для платформы iOS. Для получения дополнительной информации обратитесь к документации iOS.

Регистрация уникального идентификатора приложения

Одним из требований для поддержки внутриигровых покупок на iOS является регистрация уникального идентификатора приложения. Это означает, что нельзя использовать идентификатор приложения, содержащий символ подстановки. Вы можете проверить существующие идентификаторы приложений и создать новые в менеджере сертификатов, идентификаторов и профилей Apple Developer.

В вкладке Идентификаторы приложений менеджера Сертификаты, идентификаторы и профили разработчика нажмите кнопку + для создания нового идентификатора приложения. Это откроет страницу для регистрации нового идентификатора iOS приложения.

Присвойте вашему приложению соответствующее описание и префикс идентификатора. Идентификатор приложения Suffix должен быть явного типа. Введите уникальный идентификатор приложения в поле Bundle ID. Рекомендуется использовать соглашение com.mycompany.myappname для идентификатора приложения, где "com.mycompany" — это доменное имя издателя в интернете.

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

Создание профиля управления

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

Перейдите к вкладке Профили управления менеджера и нажмите кнопку +, чтобы создать новый профиль управления. Убедитесь, что выбран пункт Разработка приложений для iOS, и нажмите кнопку Продолжить.

Теперь у вас есть возможность выбрать идентификатор приложения для этого профиля, который будет уникальным идентификатором, созданным в предыдущем разделе. Еще раз убедитесь, что идентификатор приложения не содержит символов подстановки («*»), так как использовать услугу внутриигровых покупок с таким идентификатором будет невозможно.

На следующей странице вам нужно будет выбрать сертификаты, которые будут распространяться с вашим профилем управления. Ранее вам нужно было загрузить сертификат на локальную машину разработки в менеджер Apple Developer Certificate, Identifiers, and Profiles. Обычно вы хотите добавить все сертификаты членов вашей команды, которым потребуется создавать ваше приложение.

На следующей странице вам нужно будет выбрать устройства, на которых вы будете разрабатывать и тестировать свое приложение. Ранее необходимо было зарегистрировать свои устройства в менеджере Apple Developer Certificate, Identifiers, and Profiles. Устройства, которые вы выберите здесь, являются единственными устройствами, способными запускать приложения, подписанные с помощью этого профиля управления, поэтому выберите все устройства, которые планируете использовать на этапе разработки и тестирования.

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

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

Регистрация вашего приложения

Прежде чем вы сможете зарегистрировать новые продукты, доступные для сервиса внутриигровых покупок, вам необходимо зарегистрировать свое приложение в iTunes Connect. iTunes Connect — это место, где вы регистрируете приложение, когда хотите отправить его в Apple iOS App Store.

Начните с перехода на iTunes Connect и входа в систему. После входа откройте ссылку Управление приложениями. Если вы уже зарегистрировали свое приложение здесь, вы можете пропустить шаг регистрации, в противном случае нажмите кнопку Добавить новое приложение в верхнем левом углу страницы.

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

Вероятно, на этом этапе у вас нет всех необходимых данных для заполнения всей информации, требуемой для регистрации приложения. На данный момент просто заполните формы тестовыми данными, так как все поля, кроме полей SKU и Версия, можно изменить позже.

Регистрация продуктов

После регистрации вашего приложения в iTunes Connect у вас появятся дополнительные возможности для управления этим приложением. На странице Управление вашими приложениями в iTunes Connect нажмите значок, представляющий ваше приложение, чтобы управлять его подробностями. В этом меню вы можете выбрать кнопку Управление внутриигровыми покупками справа, чтобы зарегистрировать внутриигровые продукты, которые вы хотите предложить.

Чтобы зарегистрировать новый продукт, нажмите кнопку Создать новый в верхнем левом углу страницы. Первое, что вам нужно будет выбрать, — это тип внутриигровой покупки, которую вы хотите создать. API покупок Qt в настоящее время поддерживает только типы "Потребляемый" и "Непотребляемый", поэтому ограничьте свой выбор этими типами. См. QInAppProduct для объяснения различных типов продуктов.

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

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

В следующем разделе Подробности внутриигровой покупки вы указываете данные хотя бы для одного языка. Когда приложение запрашивает подробности о продукте, такие как title и description, они будут предоставлены на языке их локали, если они доступны. Создайте языковые данные для регионов, в которых вы планируете распространять приложение.

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

Создание тестового пользователя iTunes

После регистрации продуктов вы сможете приобрести их из своего приложения. При разработке приложения желательно протестировать покупку продуктов без реальных денежных затрат. На самом деле существуют два отдельных магазина, к которым могут отправляться запросы при использовании сервиса внутриигровых покупок на iOS. Пока ваше приложение разрабатывается, все запросы iOS App Store будут отправляться в тестовый магазин. Это происходит, когда ваше приложение подписано профилем разработчика. Тестовый магазин будет принимать запросы только от тестовых пользователей и не будет взимать плату за покупки. Однако, когда вы отправляете приложение в iOS App Store и оно принимается, все запросы на внутриигровые покупки отправляются в магазин, который требует реальных учетных записей пользователей iTunes и взимает плату за покупки.

Чтобы создать тестового пользователя iTunes, войдите в iTunes Connect.

Выберите ссылку Управление пользователями слева и нажмите кнопку Тестовый пользователь. Здесь вы увидите всех существующих тестовых пользователей iTunes, связанных с вашей учетной записью. Чтобы добавить нового тестового пользователя iTunes, нажмите кнопку Добавить нового пользователя в верхнем левом углу страницы. Заполните необходимые данные по своему усмотрению, помня, что важнейшим выбором является Выберите магазин iTunes, который указывает регион магазина, из которого будут тестироваться пользователи.

Использование тестового магазина приложений

После создания тестового пользователя iTunes вы сможете войти в тестовый магазин приложений при разработке приложения.

Важно сначала выйти из текущего пользователя iTunes на вашем устройстве Apple. Для этого откройте приложение Настройки на главном экране и перейдите к пункту iTunes и App Store. Нажмите на первую запись (которая должна быть Apple ID) и выберите Выйти.

Не входите в систему с помощью своего тестового пользователя iTunes из приложения Настройки, так как это подключится к производственному App Store, и ваш запрос на покупку не будет выполнен.

В первый раз, когда ваше приложение отправляет запрос в тестовый магазин приложений, оно запросит вход в систему. Именно здесь вам нужно войти в систему, используя учетные данные своего тестового пользователя iTunes.