Перейти к содержимому

Инструкции

Массовое изменение цен встроенных покупок и подписок

App Store Connect меняет цены по одному продукту. Рассказываем, как изменить десять, пятьдесят или двести встроенных покупок и подписок разом, не теряя выходные и не оставляя половину каталога по старой цене.

Обновлено 9 мин чтения

Можно ли массово менять цены встроенных покупок в App Store Connect?

Одним действием — нет. В App Store Connect нет экрана, который менял бы цены многих встроенных покупок или подписок сразу: вы открываете каждый продукт, планируете изменение и подтверждаете его. Чтобы изменить много цен разом, нужно либо повторять это для каждого продукта, либо написать скрипт к API App Store Connect, либо взять инструмент, который работает с API за вас и даёт одну проверку.

Почему в App Store Connect это так долго

Количество кликов умножают три вещи. Во-первых, у каждой встроенной покупки и каждой автовозобновляемой подписки своё расписание цен на своей странице. Во-вторых, цены задаются по витринам: Apple генерирует сопоставимые цены для всех 175 стран и регионов от базовой страны (установка цены встроенной покупки), но любая витрина, цену которой вы задали вручную, остаётся такой, пока вы не измените её снова. В-третьих, подписки тоже планируются по витринам, и при каждом изменении нужно решать, что делать с действующими подписчиками (управление ценами автовозобновляемых подписок).

Так что «поднять всё на 10 %» в трёх приложениях по восемь продуктов — это 24 отдельных сценария, в каждом из которых нужно проверить до 175 строк. Тут и появляются ошибки: пропущенный продукт, затёртая своя цена в одной из стран, подписка, оставшаяся по старой цене, потому что её группа была свёрнута.

Ручной путь, продукт за продуктом

Если продуктов немного, встроенных экранов достаточно. Apple различает три вида изменения цены встроенной покупки: глобальное (новая базовая цена и сопоставимые цены во всех остальных странах), временное (дата начала и конца в выбранных странах) и пользовательское (цены, которыми вы управляете сами, в некоторых или во всех странах). Дату вступления в силу можно задать от сегодняшнего дня до конца следующего календарного года (планирование изменения цен встроенных покупок).

  1. В разделе «Приложения» выберите приложение, затем «Встроенные покупки» на боковой панели (подписки без автопродления находятся в разделе «Подписки»).
  2. Откройте продукт и рядом с «Расписание цен» нажмите кнопку добавления (+).
  3. Выберите «Глобальное», «Временное» или «Пользовательское», укажите дату и цену в базовой стране и проверьте сопоставимые цены.
  4. Подтвердите и повторите для следующего продукта.
  5. Для каждой автовозобновляемой подписки: откройте её, перейдите в «Цены подписки», выберите «Запланировать изменение цены подписки», укажите страны, дату и цену, решите, что будет с действующими подписчиками, и подтвердите.

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

Путь через API: как выглядит работа

API App Store Connect умеет всё, что умеют экраны, а скрипт может пройти циклом по продуктам. Нужен командный ключ API с ролью App Manager или Admin (права ролей); как его создать, описано в статье создание ключа API для работы с ценами. Устройство массовой задачи:

ШагЭндпоинтПримечания
Список продуктовGET /v1/apps/{id}/inAppPurchasesV2, GET /v1/apps/{id}/subscriptionGroups, GET /v1/subscriptionGroups/{id}/subscriptionsОдин раз на приложение; встроенные покупки, подписки в группе.
Поиск ценовых точекGET /v2/inAppPurchases/{id}/pricePoints, GET /v1/subscriptions/{id}/pricePointsФильтруйте по территории; Apple сообщает, что фильтр для подписок станет обязательным (ценовые точки подписки).
Эквиваленты Apple в других странахGET /v1/subscriptionPricePoints/{id}/equalizations, GET /v1/inAppPurchasePricePoints/{id}/equalizationsСоответствующая точка в других валютах (equalizations).
Запись изменения встроенной покупкиPOST /v1/inAppPurchasePriceSchedulesТребует baseTerritory, inAppPurchase и manualPrices; у каждой цены есть startDate и необязательный endDate (документация).
Запись изменения подпискиPOST /v1/subscriptionPricesПо одному на территорию, с startDate и preserveCurrentPrice (документация).
Отмена ожидающего изменения подпискиDELETE /v1/subscriptionPrices/{id}Только до его начала.

Арифметика важна. Подписка записывается по одной витрине, так что 20 подписок в 175 витринах — это 3,500 записей, не считая запросов ценовых точек. Apple ограничивает число запросов на ключ API за скользящий час, сообщает остаток в заголовке X-Rate-Limit и отклоняет лишние вызовы с HTTP 429 и RATE_LIMIT_EXCEEDED; в её собственном примере указано 3,500 запросов в час с оговоркой, что реальные лимиты различаются (определение лимитов запросов). Цикл, который это игнорирует, останавливается на полпути, и часть продуктов оказывается изменена, а часть нет.

  • Читайте заголовок в каждом ответе и замедляйтесь, не дожидаясь нуля; ответы 429 ставьте в очередь и повторяйте позже, а не в плотном цикле.
  • Кэшируйте ценовые точки по продукту и территории. Это основная часть ваших запросов на чтение.
  • Ожидайте ошибок по отдельным элементам (ценовой точки нет в одной из витрин, слишком близкая дата) и записывайте их по продукту и стране, чтобы отправлять повторно только неудавшееся.
  • Токены действуют не дольше 20 минут, поэтому в долгой задаче нужно выпускать новые.
  • Для встроенных покупок сначала прочитайте текущее расписание и стройте новое на его основе, чтобы цены, выставленные вами вручную, сохранялись намеренно, а не по везению.
  • Изменения могут появляться в песочнице до часа, поэтому тестовые покупки сразу после записи могут показывать старую цену.

Наше руководство по ценам через API разбирает один продукт от начала до конца; сравнение с поддержкой собственного скрипта — на странице RepriceCat против скриптов на API.

Работа в таблице для многих продуктов

Кликаете вы или пишете скрипт, таблица не даёт массовому изменению сбиться. Одна строка на продукт и витрину, где рядом сегодняшняя и новая цена, позволяет отсортировать, отфильтровать и просмотреть глазами всё изменение до отправки.

  1. Выгрузите текущие цены: одна строка на продукт × витрину с ID продукта, типом, территорией, валютой, текущей ценой и запланированным изменением, если оно есть.
  2. Добавьте столбцы для правила (например, «+10 %»), «сырой» целевой цены и округлённой цены — ближайшей цены, которую Apple реально предлагает в этой валюте.
  3. Отфильтруйте строки, где округлённая цена равна текущей или сдвигается намного сильнее задуманного. Исправьте их вручную.
  4. Добавьте столбец даты начала и, для подписок, столбец действующих подписчиков (сохранить или применить).
  5. Передайте готовую таблицу скрипту или введите её заново продукт за продуктом, а таблицу с датой сохраните как запись.

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

Текущая ценаПравилоИсходная цельБлижайшая цена с .99Фактическое изменение
$2.99+20 %$3.59$3.99+33 %
$4.99+10 %$5.49$4.99 или $5.99 (ничья)нет или +20 %
$4.99+20 %$5.99$5.99+20 %
$9.99+15 %$11.49$10.99+10 %
$49.99+10 %$54.99$54.99+10 %
Бесплатно+10 %$0.00пропущенонет

Контрольный список перед отправкой

ПроверкаЗачем
Выгрузите сегодняшние ценыЭто единственный путь назад, если что-то пойдёт не так. Сохраните выгрузку с датой.
Пробный запускСформируйте все запросы, не отправляя ни одного; сосчитайте продукты, витрины и ожидаемые ошибки.
Проверьте каждую строкуПродукт × страна, старая → новая. Ищите неизменённые строки, большие скачки и страны с ценами, заданными вручную.
Выберите дату началаБудущая дата даёт время отменить и выравнивает изменение по витринам. Время начала зависит от региона (время начала).
Решите вопрос с действующими подписчикамиСохранить им прежнюю цену или применить новую; повышение для действующих подписчиков подчиняется правилам Apple об уведомлении и согласии.
Проверьте, что уже запланированоНовое изменение подписки заменяет уже запланированное для этой витрины.
Отправляйте пакетамиУчитывайте лимит запросов; следите за неудачами по продуктам и странам.
Проверьте и зафиксируйтеПрочитайте расписания обратно, сравните с таблицей, сохраните результат.

Подводные камни массовых изменений

  • Округление. Небольшие проценты на низкие цены могут округлиться обратно к сегодняшней цене (см. $4.99 +10 % выше), а округление способно превратить +15 % в +10 %, а +20 % — в +33 %. Следите, чтобы повышение всегда оказывалось выше сегодняшней цены, а снижение — ниже, и проверяйте округлённую цену, а не правило.
  • Бесплатные продукты. Процент от нуля — ноль. Пропускайте бесплатные продукты при процентном изменении или назначайте им цену осознанно.
  • Витрины с ценой, заданной вручную. Если вы задали свою цену в витрине, Apple перестаёт корректировать её по налогам и курсам. Глобальное изменение от базовой страны может не дойти до этих витрин; решайте по каждой отдельно.
  • Подписки действуют по витринам и по изменениям. Apple допускает одно будущее изменение цены за раз на витрину и тип тарифного плана; новое расписание перезаписывает первое (правила Apple о ценах подписок).
  • Отменить вступившее в силу нельзя. Повышение цены подписки, которое уже действует, отменить нельзя, а снижение всегда распространяется на действующих подписчиков; можно лишь запланировать новое изменение.
  • Группы подписок. Если поднять месячную, но не годовую подписку, меняется скидка годового плана, и переход на более дорогой тариф может выглядеть хуже перехода на более дешёвый. Меняйте планы группы вместе и проверяйте их соотношения.
  • Apple не корректирует цены подписок по налогам и курсам, но может корректировать цены встроенных покупок в витринах, которыми управляет. Знайте, какие из ваших цен Apple всё ещё может сдвинуть.

У повышения цен подписок свои правила об уведомлении и согласии; прочитайте как поднять цену подписки в App Store, прежде чем применять повышение к действующим подписчикам.

Как это делается в RepriceCat

RepriceCat подключается к вашему командному ключу App Store Connect и проводит весь этот процесс с одной проверкой. «Изменить много цен» позволяет выбрать до 200 продуктов из ваших приложений, с быстрым выбором: все подписки, месячные, годовые, встроенные покупки или цены приложений, — затем поднять или снизить на процент либо задать одну новую цену. В Apple ничего не уходит, пока вы не просмотрите проверку и не подтвердите.

  • Процентные изменения округляются до ближайшей цены Apple с .99, а повышение всегда переходит как минимум на следующую цену вверх (снижение — как минимум на следующую вниз), так что ничто не возвращается к сегодняшней цене. Бесплатные продукты пропускаются, а каждая округлённая строка отмечена в проверке.
  • Региональные уровни включены или выключены: остальные страны получают цену своего уровня либо цены Apple с сохранением заданных вами вручную.
  • Сейчас или на дату, а для подписок — «действующие подписчики сохраняют свою цену» (preserve-current-price у Apple).
  • Таблица проверки продукт × страна, сегодняшняя цена → новая цена, и пробный запуск, который ничего не отправляет.
  • Обмен через таблицу: экспортируйте текущие цены в Excel, Numbers или CSV, отредактируйте, импортируйте; ошибки показываются первыми, а импортированные строки становятся ожидающими изменениями, которые вы проверяете.
  • Журнал активности фиксирует каждое изменение по странам, показывает страны с ошибками и причину от Apple, чтобы повторно отправить только их, и позволяет откатить изменение.

Как это работает, смотрите на странице массовое изменение цен в App Store или начните с бесплатного месяца.

Частые вопросы

Можно ли изменить цены всех встроенных покупок сразу в App Store Connect?

С одного экрана — нет. App Store Connect меняет цены по одному продукту; чтобы изменить много сразу, пишут скрипт к API App Store Connect или берут инструмент, построенный на нём.

Как массово обновить цены подписок?

Запланируйте изменение цены для каждой подписки и витрины в App Store Connect или через POST /v1/subscriptionPrices в API. Для каждого изменения решите, сохраняют ли действующие подписчики текущую цену.

Затронет ли массовое изменение цен моих действующих подписчиков?

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

Почему повышение на 10 % не изменило некоторые цены?

Цены должны попадать на одну из ценовых точек Apple. Небольшой процент на низкую цену, например $4.99 плюс 10 %, может округлиться обратно к текущей цене. Перед отправкой проверьте округлённую цену в каждой строке.

Какой лимит запросов действует при массовой смене цен через API?

Apple ограничивает число запросов на ключ API за скользящий час и сообщает остаток в заголовке X-Rate-Limit. В её примере 3,500 в час, но реальные лимиты различаются, поэтому распределяйте задачу по времени и повторяйте ошибки 429 позже.

Можно ли отменить массовое изменение цен?

Изменения, которые ещё не начались, можно удалить. Когда изменение уже действует, вы планируете новое, возвращающее прежние цены, — поэтому так важно сначала выгрузить текущие цены.

Попробуйте

Новые цены во всех странах от одной базовой цены

Уровни, привязка к ценовым точкам, одна таблица проверки, одно подтверждение — через App Store Connect API. Первый месяц бесплатно, затем $1 за приложение в месяц.

Стратегия ценообразования9 мин чтения

Как безопасно повысить цену подписки в App Store

Повышение цены подписки в App Store: сохранить текущую цену для действующих подписчиков или применить новую, правила согласия Apple, сроки уведомлений и тест заранее.

Читать руководство
App Store Connect API7 мин чтения

Смена цен через API App Store Connect: ресурсы и запросы

Меняйте цены App Store через API App Store Connect: ценовые точки, выравнивание, графики цен приложений, IAP и подписок, тела запросов, лимиты и подводные камни.

Читать руководство
Справочник7 мин чтения

Ценовые точки App Store и выравнивание цен: объяснение

Почему цены в App Store принимают только определённые значения в каждой стране, как работает выравнивание цен Apple на реальных примерах и как привязать цену к допустимой точке.

Читать руководство
Инструкции8 мин чтения

Запланировать смену цен в App Store: приложения, IAP, подписки

Как запланировать смену цен в App Store: глобальные, временные и особые изменения для приложений и IAP, правила подписок, пороги согласия и пример плана.

Читать руководство