Специальные предложения для удержания пользователей помогают снизить добровольный отток. Они показываются подписчикам, когда те пытаются отменить подписку в Google Play.
Когда подписчик, соответствующий требованиям, начинает отменять подписку, Google Play показывает ему настроенное вами предложение, например "Сохраните подписку и получите скидку 50 % на следующие два месяца". Если подписчик принимает предложение, его подписка не отменяется. Цена со скидкой начнет действовать со следующей даты оплаты.
В этой статье рассказывается, как работают специальные предложения, как их настроить, как обрабатывать события в серверной части и как тестировать предложения.
Подготовка
Прежде чем настраивать специальные предложения для удержания, убедитесь, что вы выполнили следующие действия:
- Создана подписка хотя бы с одним основным планом с автоматическим продлением. Предложения для удержания можно добавлять только к основным планам с автоматическим продлением.
- Настройте уведомления для разработчиков в режиме реального времени и вызов метода
purchases.subscriptionsv2.get. Ваш сервер использует их, чтобы определить, когда подписчик принимает предложение.
Поскольку Google Play показывает предложения по удержанию за пределами приложения, вам не нужно менять его или обновлять интеграцию с библиотекой Google Play Платежей. Интеграция выполняется в Google Play Console и на вашем сервере.
Как работают предложения для удержания пользователей
Предложения для удержания подписчиков показываются только в разделе управления подписками в Google Play: в приложении Google Play и на сайте Google Play. Они не показываются в приложении. Библиотека Google Play Платежей не возвращает предложения по удержанию в результатах queryProductDetailsAsync(), поэтому они не включаются в ProductDetails.getSubscriptionOfferDetails() и их нельзя продавать через launchBillingFlow(). Если в вашем приложении есть ссылки на контент, которые перенаправляют пользователей в центр подписок Google Play или на страницу определенной подписки, чтобы они могли управлять ею или отменить ее, то при попытке отмены они увидят ваше предложение.
Ниже описано, что происходит, когда подписчик пытается отменить подписку.
- Подписчик открывает свою подписку в Google Play и начинает процесс ее отмены.
Google Play проверяет, соответствует ли подписчик критериям допуска, которые вы задали для предложения, или таргетировано ли оно на этого пользователя.
Если подписчик соответствует требованиям, Google Play может показать ему специальное предложение в качестве альтернативы отмене. Соответствие критериям не гарантирует, что специальное предложение будет показываться, поскольку Google Play также выполняет дополнительные проверки на уровне платформы, например на соответствие региональным требованиям. Если Google Play показывает предложение, подписчик может сделать следующее:
- Принять предложение. Подписчик принимает предложение одним нажатием. Подписка останется активной и будет продлеваться автоматически. Скидка начнет действовать со следующего расчетного периода.
- Продолжить отмену. Подписчик отказывается от предложения и отменяет подписку. Вы получите обычное уведомление
SUBSCRIPTION_CANCELED. Подробнее об отмене подписки…
Если подписчик покинет процесс отмены, не приняв предложение и не отменив подписку, она останется без изменений. Это относится как к приложению Google Play, так и к веб-версии сервиса. Просмотр предложения без его принятия не учитывается в лимите и не запускает период ожидания между предложениями. Google Play проверяет лимит, когда показывает предложение и когда подписчик принимает его. Принятое предложение учитывается в лимите, когда подписка продлевается по сниженной цене. Период ожидания между предложениями начинается, когда заканчивается срок действия скидки предыдущего предложения по удержанию для того же основного плана. Если подписчик соответствует условиям, он может снова увидеть предложение при следующей попытке отменить подписку.
Запланированный переход на другой тарифный план
Когда подписчик принимает предложение, Google Play моделирует его как запланированный переход на другой тарифный план в рамках существующей покупки. Это отличается от отложенной замены, которая требует нового процесса покупки и создает новый токен покупки. При этом у подписчика сохраняется тот же purchaseToken, меняются только условия оплаты.
Когда подписчик принимает предложение, Google Play выполняет следующие действия:
- На ваш сервер отправляется уведомление RTDN
SUBSCRIPTION_PLAN_TRANSITION_UPDATED(21). - Добавляет объект
planTransitionDetailsв полеautoRenewingPlanзатронутой позиции в ресурсеSubscriptionPurchaseV2.
Подробнее о том, как обрабатывать эти события, рассказывается в разделе Обработка событий, связанных с предложениями по удержанию, на сервере.
Требования
Предложение по удержанию можно получить в любой момент до следующего продления подписки, если выполняются все следующие условия:
- Подписка активна и продлевается автоматически. Специальные предложения недоступны для подписок, которые находятся в льготном периоде, временно заблокированы или приостановлены.
- Подписка является индивидуальной. Специальные предложения для удержания пользователей не поддерживаются для подписок с дополнениями.
- В подписке не используется основной план с рассрочкой. Основные планы с рассрочкой не подходят для предложений по удержанию.
- Следующий платеж будет взиматься по обычной цене основного плана. Если у подписчика действует бесплатный пробный период или начальная цена, предложение доступно только в течение последнего расчетного периода этого этапа, когда следующее продление будет по обычной цене.
- Подписчик не находится в расчетном периоде со скидкой, который был предоставлен в рамках ранее принятого специального предложения. Подписчик, который пользуется специальным предложением, не может воспользоваться другим, пока подписка не будет продлена по обычной цене основного плана.
- Для подписки не запланирован переход на другой план. У подписки может быть не более одного запланированного перехода на другой тарифный план, который представляет собой объект
planTransitionDetailsв состоянииIN_PROGRESS. Например, если подписчик уже принял предложение, но оно ещё не вступило в силу, он не сможет получить другое. - У подписки нет неподтвержденного изменения цены.
- Цена со скидкой по специальному предложению меньше или равна цене следующего продления основного плана подписчика.
- Подписчик соответствует правилам, которые вы настроили для специального предложения. Для предложения по удержанию пользователей вы активировали таргетинг для подписки с помощью метода
activateOfferTargeting.
Как настроить специальные предложения для удержания пользователей
Создать предложение для удержания можно в Google Play Console или с помощью Google Play Developer API. Для каждого предложения по удержанию используется один из следующих режимов таргетинга:
- Таргетинг на основе правил. Google Play определяет, какие подписчики соответствуют правилам, которые вы задали, например минимальной продолжительности платной подписки.
- Таргетинг на уровне пользователя. Ваш сервер определяет, какие подписчики могут видеть предложение, настраивая таргетинг на определенные подписки.
У основного плана может быть несколько активных предложений для удержания в одной стране или регионе. Если подписчик соответствует условиям нескольких предложений, Google Play покажет ему только одно из них. Google Play выбирает специальное предложение в следующем порядке:
- Режим таргетинга. Предложение с таргетингом на отдельных пользователей (
retentionPerUserRule) всегда имеет приоритет над предложением на основе правил (retentionRule), даже если в последнем указана более высокая скидка. - Процент скидки. Среди подходящих специальных предложений с одинаковым режимом таргетинга Google Play показывает предложение с самым высоким процентом скидки.
- Цена со скидкой. Если у специальных предложений одинаковый процент скидки, Google Play показывает предложение с самой низкой ценой со скидкой.
- Идентификатор предложения. Если предложения по-прежнему равнозначны, Google Play показывает то, у которого
offerIdидет последним в алфавитном порядке.
Как создать специальное предложение для удержания пользователей в Play Console
Чтобы создать специальное предложение для удержания пользователей в Google Play Console, выполните следующие действия:
- Перейдите в раздел Монетизация с Google Play > Товары > Подписки.
- Выберите подписку, а затем основной план, к которому хотите добавить специальное предложение.
- Добавьте предложение для текущих подписчиков, желающих отменить подписку.
- Выберите Предложение по удержанию на уровне когорты или Предложение по удержанию на уровне пользователя.
Как создать специальное предложение для удержания пользователей с помощью Play Developer API
Вы также можете создавать и обновлять предложения для удержания пользователей программно. Чтобы создать предложение, вызовите метод monetization.subscriptions.basePlans.offers.create. Чтобы обновить существующие предложения, вызовите метод monetization.subscriptions.basePlans.offers.patch или monetization.subscriptions.basePlans.offers.batchUpdate. Все три метода поддерживают поля retentionRule, retentionPerUserRule, startTime и endTime. В объекте SubscriptionOffer задайте следующие поля:
offerId– уникальный идентификатор предложения по удержанию.targeting. Задайте для свойстваretentionRuleобъектRetentionTargetingRule, который определяет, кто может воспользоваться предложением. Доступные поля перечислены в статье Как настроить правила хранения. Чтобы выбирать подходящих подписчиков на сервере, задайтеretentionPerUserRule. Подробнее о том, как предлагать скидки определенным подписчикам…phases[]: в предложении для удержания пользователей может быть только один ценовой период. На этом этапе задайте следующие поля:recurrenceCount– количество расчетных периодов, в течение которых действует скидка (от 1 до 52). Если значениеrecurrenceCountбольше 1, то этапdurationдолжен быть равен расчетному периоду основного плана.regionalConfigs[]. Для атрибутаrelativeDiscountнеобходимо задать значение скидки в виде дроби больше 0 и меньше 1. Например, укажите0.5, чтобы предложить скидку 50 %. В предложениях для удержания можно использовать толькоrelativeDiscount. Фиксированная цена (price), абсолютная скидка (absoluteDiscount) и бесплатные этапы (free) не поддерживаются.
startTime: необязательно. Время, когда предложение по удержанию становится доступно соответствующим требованиям подписчикам, в формате RFC 3339. Заполнение этого поля не активирует предложение. Если вы не зададите значение этого поля, то доступность предложения будет определяться его статусом.endTime: необязательно. Время, когда предложение по удержанию перестает быть доступным, в формате временной метки RFC 3339, независимо от статуса предложения. Если вы не укажете дату окончания, предложение будет действовать бессрочно. Если вы задаете это поле, оно должно быть в будущем и позже, чемstartTime.
Метод monetization.subscriptions.basePlans.offers.create всегда создает предложение в состоянии DRAFT, даже если вы задали startTime. Чтобы активировать предложение, вызовите метод monetization.subscriptions.basePlans.offers.activate.
Как настроить правила хранения
Объект RetentionTargetingRule содержит следующие поля:
scope: обязательно. Подписки, к которым применяется правило. Для специальных предложений, направленных на удержание пользователей, поддерживается только одно допустимое значение –thisSubscription(подписка, для которой определено специальное предложение). Укажите значение{"thisSubscription": {}}.minDuration: обязательно. Минимальный срок, в течение которого пользователь должен быть платным подписчиком, чтобы получить право на участие. Указывается в днях в формате ISO 8601. Значение должно быть в диапазоне отP0DдоP1826D. Например, для 90 дней укажитеP90D. Если вы не хотите устанавливать минимальный период платной подписки, укажите в этом полеP0D.allowMultipleClaims: необязательно. Может ли подписчик воспользоваться предложением несколько раз. Если задано значениеfalse, подписчик, который уже воспользовался этим предложением, больше не сможет его получить. Еслиtrue, подписчик может снова получить право на предложение по истечении времени, указанного вminOfferCooldownDuration, с момента окончания срока действия скидки по предыдущему предложению. Значение по умолчанию –false.minOfferCooldownDuration: обязательный параметр, если дляallowMultipleClaimsзадано значениеtrue. Минимальный срок, который должен пройти после окончания действия скидки по предыдущему предложению для удержания, прежде чем подписчик снова сможет воспользоваться предложением. Указывается в днях в формате ISO 8601. Значение должно быть в диапазоне отP1DдоP1826D. Например, укажитеP180Dдля 180 дней. Не заполняйте это поле, если для поляallowMultipleClaimsзадано значениеfalseили не задано никакое значение.
В примере ниже показаны поля startTime, endTime и targeting объекта SubscriptionOffer для специального предложения, доступного подписчикам, которые оплачивали подписку в течение как минимум 90 дней. Они могут снова воспользоваться этим предложением через 180 дней после окончания предыдущей скидки.
{
"offerId": "retention-50off-2m",
"startTime": "2026-12-01T00:00:00Z",
"endTime": "2027-03-01T00:00:00Z",
"targeting": {
"retentionRule": {
"scope": {
"thisSubscription": {}
},
"minDuration": "P90D",
"allowMultipleClaims": true,
"minOfferCooldownDuration": "P180D"
}
}
}
Как предлагать специальные условия определенным подписчикам
Вместо того чтобы позволить Google Play определять соответствие требованиям с помощью RetentionTargetingRule, вы можете сделать предложение для удержания доступным только для подписчиков, которых выберет ваш сервер. Например, вы можете нацелить предложение на подписчиков, которые, согласно вашей модели прогнозирования оттока, находятся в группе риска, или на тех, кто начал процесс отмены подписки в вашем приложении.
Подписчики увидят предложение по удержанию пользователей в том же окне отмены подписки в Google Play, что и другие предложения. Принятие предложения обрабатывается так же. Подробнее о том, как обрабатывать события, связанные со специальными предложениями для удержания пользователей, на сервере…
Чтобы настроить таргетинг специальных предложений на определенных подписчиков, выполните следующие действия:
Создайте специальное предложение для удержания пользователей. При вызове метода
monetization.subscriptions.basePlans.offers.create,monetization.subscriptions.basePlans.offers.patchилиmonetization.subscriptions.basePlans.offers.batchUpdateзадайте дляtargetingобъектretentionPerUserRuleвместо объектаretentionRule. У объектаRetentionPerUserTargetingRuleнет полей. В предложении можно использовать либоretentionRule, либоretentionPerUserRule, но не оба атрибута.{ "offerId": "retention-peruser-30off", "targeting": { "retentionPerUserRule": {} } }Прежде чем настраивать таргетинг на подписчиков, активируйте предложение. Если вы вызовете метод
activateOfferTargetingдля предложения, которое никогда не активировалось, вызов завершится ошибкой с кодом статуса HTTP400 Bad Requestи статусом ошибкиINVALID_ARGUMENT. Подробнее о том, как устранять ошибки таргетинга… Даже если специальное предложение активно, Google Play показывает его только тем подписчикам, на которых вы настроите таргетинг на следующем шаге.Настройте таргетинг специального предложения на подписку. Вызовите метод
purchases.subscriptionsv2.activateOfferTargeting, указав название пакета приложения,purchaseTokenподписки иofferIdпредложения по удержанию пользователей.POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{purchaseToken}:activateOfferTargeting { "offerId": "retention-peruser-30off" }При успешном вызове возвращается код статуса HTTP
204 No Contentбез тела ответа. Google Play сохраняет таргетинг вместе с подпиской, поэтому вам не нужно вызывать API в момент отмены подписки. Когда подписчик в следующий раз попытается отменить подписку в Google Play, он увидит предложение, если подписка соответствует требованиям. Таргетинг на уровне пользователя заменяет только правила соответствия, заданные вretentionRule. Все остальные требования к участникам и проверки на уровне платформы, которые выполняет Google Play, например на соответствие региональным требованиям, по-прежнему действуют.Вы можете настроить несколько предложений для удержания пользователей в рамках одной подписки. Для этого вызовите метод
activateOfferTargetingпо одному разу для каждого предложения. В процессе отмены подписки Google Play по-прежнему показывает не более одного предложения. Подробнее о том, как Google Play выбирает предложение…Метод
activateOfferTargetingявляется идемпотентным. Если вы вызовете его для специального предложения, которое уже связано с подпиской, вызов будет выполнен успешно, а Google Play обновит значениеactivateTimeдля специального предложения на время последнего запроса.Удалите таргетинг, если он больше не нужен. Если вы больше не хотите, чтобы подписчик получал предложение, например потому что изменился риск его оттока, вызовите метод
purchases.subscriptionsv2.deactivateOfferTargetingс тем же названием пакета,purchaseTokenиofferId. При успешном вызове возвращается код статуса HTTP204 No Contentбез тела ответа.Метод
deactivateOfferTargetingтакже является идемпотентным. Если специальное предложение не предназначено для подписки, например потому что вы не активировали таргетинг, вызов будет выполнен успешно, но не будет иметь эффекта.
Таргетинг применяется к одному purchaseToken и не прекращает действовать, пока подписка активна и автоматически продлевается. Она остается на месте после того, как подписчик увидит, примет или отклонит предложение. Google Play удаляет ее только после вызова метода deactivateOfferTargeting или через 60 дней после окончания срока действия подписки. Если в результате изменения плана или повторного оформления подписки создается новый объект purchaseToken, таргетинг не переносится.
Чтобы узнать, какие предложения по удержанию пользователей доступны для подписки, вызовите метод purchases.subscriptionsv2.get. Целевые предложения перечислены в поле developerTargetedOffers каждой позиции. Каждая запись содержит offerId и activateTime активации таргетинга:
{
"lineItems": [
{
"productId": "premium_monthly_sub",
"developerTargetedOffers": [
{
"offerId": "retention-peruser-30off",
"activateTime": "2026-12-03T15:04:05Z"
}
]
}
]
}
Как устранять ошибки таргетинга
Если вызов метода activateOfferTargeting или deactivateOfferTargeting завершается ошибкой, ответ содержит код статуса HTTP и статус ошибки, описывающий причину. В таблице ниже перечислены коды статуса HTTP и статусы ошибок, которые могут возвращать эти методы.
| Код статуса HTTP | Статус ошибки | Методы | Причина |
|---|---|---|---|
404 Not Found |
NOT_FOUND |
Оба варианта | purchaseToken не существует. |
400 Bad Request |
INVALID_ARGUMENT |
activateOfferTargeting |
offerId не существует в текущем основном плане подписки или предложение все ещё находится в статусе черновика и никогда не активировалось. |
400 Bad Request |
FAILED_PRECONDITION |
activateOfferTargeting |
Для атрибута targeting в предложении не задано значение retentionPerUserRule. |
400 Bad Request |
FAILED_PRECONDITION |
activateOfferTargeting |
Срок действия подписки уже истек. |
Метод activateOfferTargeting не проверяет, доступно ли специальное предложение для подписки, срок действия которой не истек. Например, если подписка отменена, но срок ее действия ещё не истек, вызов будет выполнен успешно и Google Play сохранит таргетинг. Google Play оценивает соответствие подписки требованиям, когда пользователь начинает процесс отмены.
Как обрабатывать события, связанные с предложениями для удержания, на сервере
Когда подписчик принимает предложение, а затем продлевает подписку со скидкой, Google Play отправляет уведомления для разработчиков в режиме реального времени на ваш сервер. После получения каждого уведомления вызывайте метод purchases.subscriptionsv2.get с параметром purchaseToken из уведомления, чтобы получить актуальный статус подписки.
Принятие предложения не считается новой покупкой. Значение purchaseToken остается прежним, поэтому вам не нужно снова подтверждать покупку, а Google Play не генерирует linkedPurchaseToken. Сохранить существующее право подписчика. Обработайте заказ на продление со скидкой так же, как и любой другой заказ на продление подписки.
| Тип уведомления | Когда отправляются данные | Что вам нужно сделать |
|---|---|---|
SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) |
Когда подписчик принимает предложение по удержанию в процессе отмены. | Вызовите метод purchases.subscriptionsv2.get и проверьте planTransitionDetails. transitionState: IN_PROGRESS. Подписка остается активной и автоматически продлевается, поэтому доступ должен сохраняться. |
SUBSCRIPTION_RENEWED (2) |
Когда текущий расчетный период закончится и подписка будет продлена по специальной цене. | Вызовите метод purchases.subscriptionsv2.get, убедитесь, что offerDetails.offerId – это идентификатор предложения по удержанию, а planTransitionDetails больше нет, и продлите доступ подписчика к новому expiryTime. |
Объект planTransitionDetails содержит следующие поля:
productId– идентификатор товара, на который переходит подписка. Для предложения по удержанию это тот же продукт.basePlanId– идентификатор основного плана, на который переходит подписка.offerId: идентификатор предложения по удержанию, которое принял подписчик. Это поле позволяет определить, какое предложение по удержанию было активировано.transitionInfo.transitionState– состояние перехода. Для предложений по удержанию клиентов статус будетIN_PROGRESS, пока переход не будет завершен.transitionInfo.expectedTransitionTime– дата, когда условия специального предложения вступят в силу.
Google Play включает planTransitionDetails только на время ожидания перехода. Когда подписка продлевается по цене, указанной в предложении, переход завершается и Google Play удаляет planTransitionDetails из ответа purchases.subscriptionsv2.get. После этого в самой позиции будет показываться активная скидка для удержания:
offerDetails.offerId– идентификатор принятого предложения по удержанию.offerPhase–{"introductoryPrice": {}}в течение расчетных периодов со скидкой. Когда расчетные периоды со скидкой закончатся и подписка будет продлена по обычной цене основного плана, значениеofferPhaseизменится на{"basePrice": {}}.
Ответ после того, как подписчик принимает предложение
После того как подписчик примет предложение, текущий расчетный период продолжится без изменений. Объект planTransitionDetails показывает запланированный переход со значением transitionState, равным IN_PROGRESS:
{
"lineItems": [
{
"productId": "premium_monthly_sub",
"expiryTime": "2026-12-15T10:00:00Z",
"offerDetails": {
"basePlanId": "monthly-base"
},
"autoRenewingPlan": {
"autoRenewEnabled": true,
"planTransitionDetails": {
"productId": "premium_monthly_sub",
"basePlanId": "monthly-base",
"offerId": "retention-50off-2m",
"transitionInfo": {
"transitionState": "IN_PROGRESS",
"expectedTransitionTime": "2026-12-15T10:00:00Z"
}
}
}
}
]
}
Ответ после продления со скидкой
После того как наступит дата продления и с подписчика будет списана плата со скидкой, в offerDetails.offerId будет указано специальное предложение, в offerPhase – introductoryPrice, а в ответе больше не будет planTransitionDetails:
{
"lineItems": [
{
"productId": "premium_monthly_sub",
"expiryTime": "2027-01-15T10:00:00Z",
"offerDetails": {
"basePlanId": "monthly-base",
"offerId": "retention-50off-2m"
},
"offerPhase": {
"introductoryPrice": {}
},
"autoRenewingPlan": {
"autoRenewEnabled": true,
"recurringPrice": {
"currencyCode": "USD",
"units": "9",
"nanos": 990000000
}
}
}
]
}
Взаимодействия в рамках жизненного цикла
При работе со специальными предложениями для удержания пользователей учитывайте следующее:
- Окончание скидки. По окончании расчетных периодов со скидкой подписка автоматически продлевается по обычной цене основного плана. Вы получите уведомление
SUBSCRIPTION_RENEWED, как и при любом другом продлении, аofferPhaseпозиции изменится на{"basePrice": {}}. Подписчику не нужно ничего делать. - Восстановление платежа после скидки. Если продление по обычной цене основного плана после окончания скидки отклонено и подписка переходит в льготный период или временную блокировку аккаунта, при восстановлении платежа взимается обычная цена основного плана. Google Play не применяет скидку по завершенному специальному предложению. Если платеж за первое продление со скидкой отклонен, ожидающий переход сохраняется, а цена специального предложения применяется, когда платеж восстанавливается.
- Отложенная оплата. Если вы вызываете метод
purchases.subscriptionsv2.defer, когда переход на предложение по удержанию имеет статусIN_PROGRESS, ожидающий переход сохраняется и применяется при отложенном продлении. Чтобы узнать новую дату продления, проверьтеexpiryTimeпозиции. - Смена тарифного плана до перехода. Предложение для удержания применяется только к
purchaseTokenподписки, для которой оно было принято. Если подписчик перейдет на другой основной план или подписку до наступленияexpectedTransitionTime, Google Play сгенерирует новый токен покупки, отменит запланированный переход и очиститplanTransitionDetails. Ожидающее специальное предложение не применяется к новому тарифному плану. - Отмена и восстановление. Если подписчик отменит подписку после принятия предложения, запланированный переход останется в ожидании, а значение
transitionStateостанется равнымIN_PROGRESS. Если подписчик восстановит подписку до ее окончания, скидка по специальному предложению будет применена при продлении. - Истечение срока действия и повторное оформление подписки. Если срок действия подписки истекает без восстановления, Google Play отменяет ожидающий переход. Если пользователь возобновит подписку или оформит ее заново, Google Play создаст новую покупку, и ранее принятое предложение по удержанию не будет применено.
- Изменение специальных предложений. Если вы измените скидку или расчетный период в специальном предложении, это повлияет только на будущие активации. Для подписчиков, которые уже приняли предложение, сохраняются исходные условия.
- Деактивация предложения. Если вы деактивируете предложение или срок его действия истечет, условия для подписчиков, которые его приняли, не изменятся. Подписчики, которые перешли на
IN_PROGRESS, по-прежнему получат скидку при следующем продлении, а те, у кого уже действуют расчетные периоды со скидкой, сохранят ее на весь согласованный срок. - Изменение цены. Изменения цены основного тарифного плана по-прежнему применяются. Google Play переводит подписчика на новую цену, только если он платит обычную цену и у него нет ожидающего перехода на предложение по удержанию. Подробнее о том, как изменить цену подписки…
- Возврат средств. Вы можете вернуть средства подписчику и отменить подписку с помощью стандартных API, например метода
purchases.subscriptionsv2.revoke. В этом случае пользователю возвращается последний платеж, а его доступ к контенту прекращается.
Тестирование предложений по удержанию
В процессе отмены подписки Google Play показывает только активные предложения по удержанию и проверяет соответствие правилам в реальном времени. Чтобы протестировать предложения по удержанию с помощью аккаунта тестировщика лицензий, воспользуйтесь одним из следующих способов:
- Протестируйте предложение по удержанию пользователей в рабочем основном плане, не показывая его реальным подписчикам.
- Протестируйте специальное предложение на основе правил в тестовом приложении или на тестовом основном плане, к которому у пользователей рабочей версии нет доступа.
Прежде чем использовать любой из этих методов, перейдите в раздел Настройки > Тестирование лицензий в Google Play Console и добавьте тестовый аккаунт Google в качестве тестировщика лицензий.
Как протестировать предложение по удержанию пользователей на уровне пользователя
Google Play показывает предложение по удержанию пользователей только для выбранных вами подписок, поэтому вы можете протестировать его на основном тарифном плане рабочей версии, не показывая реальным подписчикам. Чтобы протестировать предложение для удержания пользователей, выполните следующие действия:
- Создайте предложение для удержания пользователей в рамках основного плана и активируйте его. В Google Play Console выберите Специальное предложение для удержания пользователей.
В Google Play Developer API задайте для
targetingобъектretentionPerUserRule. Подробнее о том, как предлагать скидки определенным подписчикам… - Если вы только что активировали предложение, подождите 10–15 минут, пока изменения вступят в силу, а затем очистите кеш приложения Google Play.
- На тестовом устройстве войдите в аккаунт тестировщика лицензий и купите основной план в приложении.
- Вызовите метод
purchases.subscriptionsv2.activateOfferTargetingиз серверной части, указав название пакета приложения,purchaseTokenтестировщика лицензий иofferIdпредложения по удержанию. - В приложении Google Play перейдите в раздел Платежи и подписки > Подписки, выберите подписку и нажмите Отменить подписку. Предложение по удержанию появляется в процессе отмены.
- Примите предложение и убедитесь, что бэкенд получает уведомление
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDRTDN и обрабатывает продление со скидкой.
Как протестировать предложение по удержанию на основе правил
После активации специального предложения на основе правил Google Play может показывать его всем подписчикам, соответствующим условиям. Чтобы пользователи рабочей версии не увидели специальное предложение, тестируйте его в тестовом приложении или на специальном тестовом основном плане, к которому у них нет доступа. Чтобы протестировать предложение на основе правил, выполните следующие действия:
- В тестовом приложении или основном плане создайте специальное предложение на основе правил и задайте для параметра
minDurationзначениеP0D(0 дней). В Google Play Console выберите Специальное предложение для удержания когорты. В Google Play Developer API задайте дляtargetingобъектretentionRule. Подробнее о правилах соответствия требованиям хранения… - Активируйте предложение, подождите 10–15 минут, пока изменения вступят в силу, и очистите кеш приложения Google Play.
- На тестовом устройстве войдите в аккаунт тестировщика лицензий и купите тестовый основной план.
- В приложении Google Play перейдите в раздел Платежи и подписки > Подписки, выберите подписку и нажмите Отменить подписку. Поскольку в предложении не указана минимальная продолжительность платной подписки, вы можете начать процесс отмены сразу после покупки. Предложение по удержанию появляется в процессе отмены.
- Примите предложение и убедитесь, что бэкенд получает уведомление
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDRTDN и обрабатывает продление со скидкой.
После проверки интеграции создайте и активируйте предложение для удержания на основе правил в основном плане рабочей версии.
Устранение неполадок при тестировании предложений по удержанию
Если предложение не появляется, проверьте следующее:
- Специальное предложение активно, и текущее время находится между его
startTimeиendTime, если вы их задали. - Для предложения по удержанию пользователей поле
developerTargetedOffersв ответеpurchases.subscriptionsv2.getдляpurchaseTokenтестировщика лицензий включает предложение. - Подписка является единой, а не с дополнениями.
- Подписка не находится в льготном периоде, временной блокировке аккаунта и не приостановлена.
- Для подписки нет ожидающих изменений плана или цены.
- Следующее продление будет по обычной цене основного плана. Если у пользователя бесплатная пробная версия или специальное предложение, то предложение для удержания доступно только в течение последнего расчетного периода.
- Вы подождали 10–15 минут после активации или изменения предложения и очистили кеш приложения Google Play.