As ofertas de retenção ajudam a reduzir a desistência voluntária de usuários mostrando um desconto para os assinantes no momento em que eles tentam cancelar a assinatura no Google Play.
Quando um assinante qualificado inicia o cancelamento, o Google Play mostra uma oferta de retenção configurada por você, como "Mantenha sua assinatura e ganhe 50% de desconto nos próximos 2 meses". Se o assinante aceitar a oferta, a assinatura não será cancelada. O preço com desconto começa na próxima data de faturamento.
Nesta página, explicamos como as promoções de retenção funcionam, como configurá-las, como lidar com os eventos resultantes no back-end e como testá-las.
Antes de começar
Antes de configurar as promoções de retenção, faça o seguinte:
- Criou uma assinatura com pelo menos um plano básico com renovação automática. As ofertas de retenção só podem ser adicionadas a planos básicos com renovação automática.
- Configurou as Notificações do desenvolvedor em tempo real (RTDN, na sigla em inglês) e o
back-end para chamar o método
purchases.subscriptionsv2.get. O back-end usa essas informações para detectar quando um assinante aceita uma oferta de retenção.
Como o Google Play mostra as ofertas de retenção fora do app, não é necessário mudar o app nem atualizar a integração da Biblioteca Google Play Faturamento para usá-las. Todo o trabalho de integração acontece no Google Play Console e no seu back-end.
Como funcionam as ofertas de retenção
As ofertas de retenção aparecem apenas no gerenciamento de assinaturas do Google Play: o app
Google Play Store e o Google Play na Web. Elas não aparecem no app.
A Biblioteca Google Play Faturamento não retorna ofertas de retenção nos resultados de
queryProductDetailsAsync(). Por isso, elas não são incluídas em
ProductDetails.getSubscriptionOfferDetails(), e não é possível vendê-las usando
launchBillingFlow(). Se o app usa links diretos para enviar assinantes à
central de assinaturas do Google Play ou a uma assinatura específica para que eles
possam gerenciar ou cancelar, esses assinantes vão ver sua oferta de retenção quando
começarem a cancelar.
As etapas a seguir descrevem o que acontece quando um assinante tenta cancelar:
- O assinante abre a assinatura no Google Play e inicia o cancelamento.
O Google Play verifica se o assinante se qualifica para uma das suas ofertas de retenção com base nas regras de qualificação que você definiu para a oferta ou se você segmentou a oferta para esse assinante.
Se o assinante se qualificar, o Google Play poderá mostrar a oferta de retenção como uma alternativa ao cancelamento. Atender aos critérios de qualificação não garante que a oferta apareça, porque o Google Play também realiza outras verificações no nível da plataforma, como requisitos de conformidade regional. Se o Google Play mostrar a oferta, o assinante poderá fazer o seguinte:
- Aceitar a oferta: o assinante aceita com um único toque. A assinatura permanece ativa e com renovação automática. O assinante não é cobrado imediatamente. O preço com desconto é aplicado a partir do próximo período de faturamento.
- Continuar o cancelamento: o assinante recusa a oferta e conclui
o fluxo de cancelamento padrão. Você recebe a notificação
SUBSCRIPTION_CANCELEDde sempre. Para mais detalhes, consulte Cancelamentos.
Se o assinante sair do fluxo de cancelamento sem aceitar a oferta ou cancelar, a assinatura não vai mudar. Isso se aplica ao app Google Play Store e ao Google Play na Web. Visualizar uma oferta de retenção sem aceitá-la não conta para o limite de resgate nem inicia o período de espera entre ofertas. O Google Play verifica o limite de resgate quando mostra a oferta e novamente quando o assinante a aceita. Uma oferta aceita é contabilizada no limite de resgate quando a assinatura é renovada pelo preço com desconto. O período de espera entre as ofertas começa quando o período de desconto da oferta de retenção anterior no mesmo plano básico termina. O assinante poderá ver a oferta novamente na próxima vez que tentar cancelar, desde que ainda se qualifique.
Transição de plano programada
Quando um assinante aceita uma oferta de retenção, o Google Play a modela como uma
transição de plano programada na compra atual do assinante. Isso é diferente
de uma substituição adiada, que exige um novo fluxo de compra e cria
um novo token de compra. Com uma oferta de retenção, o assinante mantém o mesmo
purchaseToken, e apenas os termos de faturamento futuros mudam.
Quando o assinante aceita a oferta, o Google Play faz o seguinte:
- Envia uma RTDN
SUBSCRIPTION_PLAN_TRANSITION_UPDATED(21) ao seu back-end. - Adiciona um objeto
planTransitionDetailsao campoautoRenewingPlando item de linha afetado no recursoSubscriptionPurchaseV2.
Para mais detalhes sobre como lidar com esses eventos, consulte Processar eventos de oferta de retenção no back-end.
Requisitos de qualificação
Uma assinatura pode receber uma oferta de retenção a qualquer momento antes da próxima renovação, desde que todas as seguintes condições sejam atendidas:
- A assinatura está ativa e com renovação automática. As assinaturas em período de carência, em suspensão de conta ou pausadas não podem receber ofertas de retenção.
- A assinatura é única. As ofertas de retenção não são compatíveis com assinaturas com complementos.
- A assinatura não usa um plano de base instalada. Os planos da base instalada parcelados não se qualificam para ofertas de retenção.
- O próximo pagamento será feito pelo preço recorrente normal do plano básico. Se o assinante estiver em um teste sem custo financeiro ou em uma fase de preço inicial, a oferta vai estar disponível apenas durante o período de faturamento final dessa fase, quando a próxima renovação estiver no preço normal.
- O assinante não está em um período de faturamento com desconto de uma oferta de retenção aceita anteriormente. Um assinante que está na fase de desconto de uma oferta de retenção não pode reivindicar outra oferta de retenção até que a assinatura seja renovada pelo preço normal do plano básico.
- A assinatura não tem uma transição de plano programada pendente. Uma assinatura
pode ter no máximo uma transição de plano programada pendente, que é um
objeto
planTransitionDetailsno estadoIN_PROGRESS. Por exemplo, um assinante que já aceitou uma oferta de retenção que ainda não entrou em vigor não pode receber outra. - A assinatura não tem mudanças de preço não confirmadas.
- O preço com desconto da oferta de retenção é menor ou igual ao próximo preço de renovação do plano básico do assinante.
- O assinante atende às regras de qualificação que você configurou para a
promoção. Para uma oferta de retenção de usuários por usuário, você ativou a segmentação para a assinatura com o método
activateOfferTargeting.
Configurar ofertas de retenção
É possível criar ofertas de retenção no Google Play Console ou usando a API Google Play Developer. Cada oferta de retenção usa um dos seguintes modos de segmentação:
- Segmentação com base em regras: o Google Play decide quais assinantes estão qualificados com base nas regras de qualificação que você define, como uma duração mínima de assinatura paga.
- Segmentação por usuário: seu back-end decide quais assinantes podem ver a oferta segmentando-a para assinaturas específicas.
Um plano básico pode ter mais de uma oferta de retenção ativa no mesmo país ou região. Quando um assinante se qualifica para mais de uma oferta, o Google Play mostra no máximo uma oferta de retenção no fluxo de cancelamento. O Google Play escolhe a oferta na seguinte ordem:
- Modo de segmentação: uma oferta segmentada por usuário (
retentionPerUserRule) sempre tem prioridade sobre uma oferta baseada em regras (retentionRule), mesmo que a oferta baseada em regras tenha uma porcentagem de desconto maior. - Porcentagem de desconto: entre as ofertas qualificadas que usam o mesmo modo de segmentação, o Google Play mostra a oferta com a maior porcentagem de desconto exibida.
- Preço com desconto: se as ofertas tiverem a mesma porcentagem de desconto, o Google Play vai mostrar a oferta com o menor preço com desconto.
- ID da oferta: se as ofertas ainda estiverem empatadas, o Google Play vai mostrar aquela cujo
offerIdvem por último em ordem alfabética.
Criar uma promoção de retenção no Play Console
Para criar uma promoção de retenção no Google Play Console, faça o seguinte:
- Acesse Monetizar com o Google Play > Produtos > Assinaturas.
- Selecione uma assinatura e, em seguida, o plano básico em que você quer adicionar a oferta.
- Adicione uma oferta para Assinantes atuais tentando cancelar.
- Escolha Promoção de retenção no nível da coorte ou Promoção de retenção no nível do usuário.
Criar uma oferta de retenção com a API Play Developer
Também é possível criar e atualizar ofertas de retenção de forma programática. Para criar uma
oferta, chame o método
monetization.subscriptions.basePlans.offers.create. Para atualizar as ofertas, chame o método
monetization.subscriptions.basePlans.offers.patch ou
monetization.subscriptions.basePlans.offers.batchUpdate. Todos
os três métodos são compatíveis com os campos retentionRule, retentionPerUserRule, startTime
e endTime. No objeto SubscriptionOffer, defina os seguintes
campos:
offerId: o ID da oferta de retenção exclusivo.targeting: definaretentionRulecomo um objetoRetentionTargetingRuleque define quem está qualificado para a oferta. Para ver os campos disponíveis, consulte Definir regras de qualificação para retenção. Para escolher assinantes qualificados no back-end, definaretentionPerUserRule. Para mais detalhes, consulte Segmentar ofertas de retenção para assinantes específicos.phases[]: uma oferta de retenção aceita apenas uma fase de preços. Nessa fase, defina os seguintes campos:recurrenceCount: o número de períodos de faturamento em que o desconto é válido, de 1 a 52. SerecurrenceCountfor maior que 1, a fasedurationprecisa ser igual ao período de faturamento do plano básico.regionalConfigs[]: definarelativeDiscountcomo o desconto como uma fração maior que 0 e menor que 1. Por exemplo, use0.5para 50% de desconto. As ofertas de retenção são compatíveis apenas comrelativeDiscount. As fases de preço fixo (price), desconto absoluto (absoluteDiscount) e sem custo financeiro (free) não são aceitas.
startTime: opcional. O horário em que a oferta de retenção fica disponível para assinantes qualificados, como um carimbo de data/hora RFC 3339. A definição desse campo não ativa a oferta. Se você não definir esse campo, a oferta vai ficar disponível com base no estado dela.endTime: opcional. O horário em que a oferta de retenção deixa de estar disponível, como um carimbo de data/hora RFC 3339, independentemente do estado da oferta. Se você não definir esse campo, a oferta não terá uma data de término. Se você definir esse campo, ele precisará estar no futuro e ser posterior astartTime.
O método monetization.subscriptions.basePlans.offers.create sempre cria
a oferta no estado DRAFT, mesmo que você defina startTime. Para ativar a oferta, chame o método monetization.subscriptions.basePlans.offers.activate.
Definir regras de qualificação de retenção
O objeto RetentionTargetingRule contém estes campos:
scope: obrigatório. As assinaturas consideradas pela regra. Para ofertas de retenção, o único valor compatível éthisSubscription, a assinatura em que a oferta é definida. Defina esse campo como{"thisSubscription": {}}.minDuration: obrigatório. O tempo mínimo que um usuário precisa ter sido um assinante pago para se qualificar, como uma duração ISO 8601 em dias, deP0DaP1826D. Por exemplo, useP90Dpara 90 dias. Para não exigir um tempo mínimo de assinatura paga, defina esse campo comoP0D.allowMultipleClaims: opcional. Se um assinante pode resgatar a oferta mais de uma vez. Se forfalse, um assinante que já tiver resgatado essa oferta nunca mais vai se qualificar para ela. Se fortrue, um assinante poderá se qualificar novamente após o tempo emminOfferCooldownDurationdesde o fim do período de desconto da oferta de retenção anterior. O padrão éfalse.minOfferCooldownDuration: obrigatório seallowMultipleClaimsfortrue. O tempo mínimo que precisa passar após o término do período de desconto da oferta de retenção anterior para que o assinante se qualifique novamente, como uma duração ISO 8601 em dias, deP1DaP1826D. Por exemplo, useP180Dpara 180 dias. Não defina esse campo seallowMultipleClaimsforfalseou não estiver definido.
O exemplo a seguir mostra os campos startTime, endTime e targeting
de um objeto SubscriptionOffer para uma oferta de retenção disponível para
assinantes que pagaram por pelo menos 90 dias e que podem reivindicar novamente
180 dias após o término do desconto de retenção anterior:
{
"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"
}
}
}
Segmentar ofertas de retenção para assinantes específicos
Em vez de deixar o Google Play decidir a qualificação com um
RetentionTargetingRule, você pode disponibilizar uma oferta de retenção apenas para os
assinantes escolhidos pelo seu back-end. Por exemplo, você pode segmentar uma oferta para
assinantes que seu modelo de previsão de desistência sinaliza como em risco ou para assinantes
que iniciam uma jornada de cancelamento no app.
Os assinantes veem uma oferta de retenção de usuários no mesmo fluxo de cancelamento do Google Play que qualquer outra oferta de retenção, e você lida com a aceitação da mesma forma. Para mais detalhes, consulte Processar eventos de ofertas de retenção no back-end.
Para segmentar ofertas de retenção para assinantes específicos, faça o seguinte:
Crie uma oferta de retenção de usuários por usuário. Ao chamar o método
monetization.subscriptions.basePlans.offers.create,monetization.subscriptions.basePlans.offers.patchoumonetization.subscriptions.basePlans.offers.batchUpdate, definatargetingcomo um objetoretentionPerUserRuleem vez de um objetoretentionRule. O objetoRetentionPerUserTargetingRulenão tem campos. Uma oferta pode usarretentionRuleouretentionPerUserRule, mas não ambos.{ "offerId": "retention-peruser-30off", "targeting": { "retentionPerUserRule": {} } }Ative a promoção antes de segmentá-la para os assinantes. Se você chamar o método
activateOfferTargetingpara uma oferta que nunca foi ativada, a chamada vai falhar com um código de status HTTP400 Bad Requeste um status de erroINVALID_ARGUMENT. Para mais detalhes, consulte Tratar erros de segmentação. Mesmo quando a oferta está ativa, o Google Play só a mostra para os assinantes que você segmentar na próxima etapa.Segmentar a promoção para uma assinatura. Chame o método
purchases.subscriptionsv2.activateOfferTargetingcom o nome do pacote do app, opurchaseTokenda assinatura e oofferIdda oferta de retenção de usuários por usuário:POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{purchaseToken}:activateOfferTargeting { "offerId": "retention-peruser-30off" }Uma chamada bem-sucedida retorna um código de status HTTP
204 No Contentsem corpo de resposta. O Google Play armazena a segmentação com a assinatura, então não é necessário chamar a API no momento em que o assinante cancela. Na próxima vez que o assinante iniciar o cancelamento no Google Play, o Google Play poderá mostrar a oferta, desde que a assinatura atenda aos requisitos de qualificação. A segmentação por usuário substitui apenas as regras de qualificação definidas por umretentionRule. Todos os outros requisitos de qualificação e as verificações no nível da plataforma que o Google Play realiza, como os requisitos de compliance regional, ainda se aplicam.É possível segmentar mais de uma oferta de retenção de usuários por assinatura. Para fazer isso, chame o método
activateOfferTargetinguma vez para cada oferta. O Google Play ainda mostra no máximo uma oferta de retenção no fluxo de cancelamento. Para saber como o Google Play escolhe a oferta, consulte Configurar ofertas de retenção.O método
activateOfferTargetingé idempotente. Se você chamar o método para uma promoção que já está segmentada para a assinatura, a chamada será bem-sucedida, e o Google Play vai atualizar oactivateTimeda promoção para o horário da solicitação mais recente.Remova a segmentação quando necessário. Se você não quiser mais que um assinante receba a oferta, por exemplo, porque o risco de desistência mudou, chame o método
purchases.subscriptionsv2.deactivateOfferTargetingcom o mesmo nome de pacote,purchaseTokeneofferId. Uma chamada bem-sucedida retorna um código de status HTTP204 No Contentsem corpo de resposta.O método
deactivateOfferTargetingtambém é idempotente. Se a oferta não for segmentada para a assinatura, por exemplo, porque você nunca ativou a segmentação, a chamada será bem-sucedida e não terá efeito.
A segmentação se aplica a um único purchaseToken e não expira enquanto a
assinatura estiver ativa e com renovação automática. Ele permanece no lugar depois que o assinante
vê, aceita ou recusa a oferta. O Google Play só o remove quando você chama
o método deactivateOfferTargeting ou 60 dias após a expiração
da assinatura. Se uma mudança de plano ou renovação de assinatura criar um novo purchaseToken, a
segmentação não será transferida.
Para verificar quais ofertas de retenção de usuários por usuário são direcionadas a uma assinatura, chame o método purchases.subscriptionsv2.get. O campo developerTargetedOffers
de cada item de linha lista as ofertas segmentadas. Cada entrada contém o
offerId e o activateTime de quando você ativou a segmentação:
{
"lineItems": [
{
"productId": "premium_monthly_sub",
"developerTargetedOffers": [
{
"offerId": "retention-peruser-30off",
"activateTime": "2026-12-03T15:04:05Z"
}
]
}
]
}
Tratar erros de segmentação
Quando uma chamada para o método activateOfferTargeting ou deactivateOfferTargeting falha, a resposta contém um código de status HTTP e um status de erro que descreve a causa. A tabela a seguir lista os códigos de status HTTP e
de erro que esses métodos podem retornar:
| Código de status HTTP | Status do erro | Métodos | Causa |
|---|---|---|---|
404 Not Found |
NOT_FOUND |
Ambos | O purchaseToken não existe. |
400 Bad Request |
INVALID_ARGUMENT |
activateOfferTargeting |
O offerId não existe no plano básico atual da assinatura ou a oferta ainda está no estado de rascunho e nunca foi ativada. |
400 Bad Request |
FAILED_PRECONDITION |
activateOfferTargeting |
O targeting da oferta não está definido como
retentionPerUserRule. |
400 Bad Request |
FAILED_PRECONDITION |
activateOfferTargeting |
A assinatura já expirou. |
O método activateOfferTargeting não verifica se uma assinatura não expirada
está qualificada para a oferta. Por exemplo, se a assinatura for
cancelada, mas ainda não tiver expirado, a chamada será bem-sucedida, e o Google Play vai armazenar a
segmentação. O Google Play
avalia a qualificação da assinatura quando o assinante entra no
fluxo de cancelamento.
Processar eventos de ofertas de retenção no back-end
Quando um assinante aceita uma oferta de retenção e, posteriormente, quando ocorre a renovação
com desconto, o Google Play envia RTDNs ao seu back-end. Depois de receber cada
notificação, chame o método purchases.subscriptionsv2.get com o
purchaseToken da notificação para conferir o estado mais recente da assinatura.
Aceitar uma oferta de retenção não cria uma nova compra. O purchaseToken
permanece o mesmo, então não é necessário confirmar a compra novamente, e o Google
Play não gera um linkedPurchaseToken. Manter o direito atual do assinante. Processe o pedido de renovação com desconto da mesma forma que qualquer
outra renovação de assinatura.
| Tipo de notificação | Quando o envio é feito | O que fazer |
|---|---|---|
SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) |
Quando um assinante aceita uma oferta de retenção no fluxo de cancelamento. | Chame o método purchases.subscriptionsv2.get e verifique
planTransitionDetails. O transitionState é
IN_PROGRESS. A assinatura permanece ativa e
com renovação automática. Portanto, continue concedendo acesso. |
SUBSCRIPTION_RENEWED (2) |
Quando o período de faturamento atual termina e a assinatura é renovada pelo preço com desconto da oferta de retenção. | Chame o método purchases.subscriptionsv2.get, confirme
se offerDetails.offerId é o ID da oferta de retenção e se
planTransitionDetails não está mais presente e estenda o
acesso do assinante ao novo expiryTime. |
O objeto planTransitionDetails contém estes campos:
productId: o ID do produto do plano para o qual a assinatura será transferida. Para uma oferta de retenção, é o mesmo produto.basePlanId: o ID do plano básico para o qual a assinatura será transferida.offerId: o ID da oferta de retenção que o assinante aceitou. Use esse campo para identificar qual oferta de retenção foi resgatada.transitionInfo.transitionState: o estado da transição. Para ofertas de retenção, o estado éIN_PROGRESSenquanto a transição está pendente.transitionInfo.expectedTransitionTime: quando os termos da oferta de retenção entram em vigor.
O Google Play inclui planTransitionDetails apenas enquanto a transição está
pendente. Quando a assinatura é renovada pelo preço com desconto da oferta de retenção,
a transição é concluída, e o Google Play remove planTransitionDetails da
resposta purchases.subscriptionsv2.get. A partir de então, o próprio item de linha
mostra o desconto de retenção ativo:
offerDetails.offerIdé o ID da oferta de retenção aceita.offerPhaseé{"introductoryPrice": {}}durante os períodos de faturamento com desconto. Depois que os períodos de faturamento com desconto terminarem e a assinatura for renovada pelo preço normal do plano básico,offerPhasevai mudar para{"basePrice": {}}.
Resposta depois que o assinante aceita a oferta
Depois que o assinante aceita a oferta de retenção, o período de faturamento atual
continua inalterado. O objeto planTransitionDetails mostra a transição
programada com um transitionState de 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"
}
}
}
}
]
}
Resposta após a renovação com desconto
Depois que a data de renovação passar e o assinante for cobrado pelo preço com desconto, offerDetails.offerId vai mostrar a oferta de retenção, offerPhase vai mostrar
introductoryPrice, e a resposta não vai mais incluir
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
}
}
}
]
}
Interações do ciclo de vida
Lembre-se dos seguintes comportamentos ao lidar com ofertas de retenção:
- Fim do desconto: após o término dos períodos de faturamento com desconto, a
assinatura é renovada automaticamente pelo preço normal do plano básico. Você
recebe uma notificação
SUBSCRIPTION_RENEWED, como em qualquer outra renovação, e oofferPhasedo item de linha muda para{"basePrice": {}}. O assinante não precisa fazer nada. - Recuperação de pagamento após o desconto: se a renovação pelo preço normal do plano básico após o término do desconto for recusada e a assinatura entrar em um período de carência ou suspensão da conta, a recuperação de pagamento vai cobrar o preço normal do plano básico. O Google Play não aplica o desconto da oferta de retenção concluída. Se o pagamento da primeira renovação com desconto for recusado, a transição pendente será preservada, e o preço da oferta de retenção será aplicado quando o pagamento for recuperado.
- Faturamento adiado: se você chamar o método
purchases.subscriptionsv2.deferenquanto uma transição de oferta de retenção estiver emIN_PROGRESS, a transição pendente será preservada e aplicada na renovação adiada. Para saber a nova data de renovação, verifique oexpiryTimedo item de linha. - Mudança de plano antes da transição: uma oferta de retenção se aplica apenas ao
purchaseTokenda assinatura em que o assinante a aceitou. Se o assinante mudar para um plano básico ou uma assinatura diferente antes doexpectedTransitionTime, o Google Play vai gerar um novo token de compra, cancelar a transição programada e limparplanTransitionDetails. A oferta de retenção pendente não se aplica ao novo plano. - Cancelamento e restauração: se um assinante cancelar a assinatura depois de
aceitar uma oferta de retenção, a transição programada vai continuar pendente e
transitionStatevai continuar comoIN_PROGRESS. Se o assinante restaurar a assinatura antes que ela expire, o desconto da oferta de retenção ainda será aplicado na renovação. - Expiração e renovação da assinatura: se a assinatura expirar sem ser restaurada, o Google Play vai cancelar a transição pendente. Se o usuário renovar a assinatura ou se inscrever novamente mais tarde, o Google Play vai criar uma nova compra de assinatura, e a oferta de retenção aceita anteriormente não será aplicada.
- Mudanças na oferta: se você mudar o desconto ou os períodos de faturamento de uma oferta de retenção, a mudança será aplicada apenas a resgates futuros. Os assinantes que já aceitaram a oferta mantêm os termos originais.
- Desativação da oferta: se você desativar uma oferta de retenção ou se ela
chegar à data de término, os assinantes que já a aceitaram vão manter os termos
com que concordaram. Os assinantes com uma transição do
IN_PROGRESSainda recebem o desconto na próxima renovação, e os assinantes que já estão nos períodos de faturamento com desconto mantêm o desconto durante todo o período acordado. - Mudanças no preço: as mudanças no preço do plano básico ainda se aplicam. O Google Play migra um assinante para um novo preço somente quando ele está pagando o preço normal e não tem uma transição de oferta de retenção pendente. Para mais informações, consulte Mudar os preços das assinaturas.
- Reembolsos: é possível reembolsar um assinante com as APIs padrão de reembolso e revogação, como o método
purchases.subscriptionsv2.revoke. Isso reembolsa o pagamento mais recente e encerra o acesso do assinante.
Testar promoções de retenção
O Google Play mostra apenas as ofertas de retenção ativas no fluxo de cancelamento e avalia as regras de qualificação em tempo real. Para testar as ofertas de retenção com uma conta de testador de licença, use um dos seguintes métodos:
- Teste uma oferta de retenção de usuários por usuário em um plano básico de produção, sem mostrar a oferta para assinantes reais.
- Teste uma oferta de retenção baseada em regras em um app de teste ou em um plano básico de teste que os usuários de produção não podem acessar.
Antes de usar qualquer um dos métodos, acesse Configurações > Teste de licença no Google Play Console e adicione a Conta do Google de teste como testador de licença.
Testar uma oferta de retenção de usuários por usuário
O Google Play mostra uma oferta de retenção de usuários por usuário apenas para as assinaturas que você segmentar. Assim, é possível testar em um plano básico de produção sem expor a assinantes reais. Para testar uma oferta de retenção de usuários por usuário, faça o seguinte:
- Crie uma oferta de retenção de usuários por usuário no plano básico e, em seguida, ative-a. No Google Play Console, escolha Promoção de retenção no nível do usuário.
Com a API Google Play Developer, defina
targetingcomo um objetoretentionPerUserRule. Para mais detalhes, consulte Segmentar ofertas de retenção para assinantes específicos. - Se você acabou de ativar a oferta, aguarde de 10 a 15 minutos para que a mudança seja propagada e limpe o cache do app Google Play Store.
- No dispositivo de teste, faça login com a conta de testador de licença e compre o plano básico no app.
- No back-end, chame o método
purchases.subscriptionsv2.activateOfferTargetingcom o nome do pacote do app, opurchaseTokendo testador de licença e oofferIdda promoção de retenção. - No app Google Play Store, acesse Pagamentos e assinaturas > Assinaturas, selecione a assinatura e toque em Cancelar assinatura. A oferta de retenção aparece no fluxo de cancelamento.
- Aceite a oferta e confirme se o back-end recebe a
RTDN
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDe processa a renovação com desconto.
Testar uma promoção de retenção baseada em regras
Depois que você ativar uma promoção de retenção baseada em regras, o Google Play poderá mostrá-la a qualquer assinante qualificado no plano básico. Para evitar que a promoção seja exposta aos usuários de produção, teste-a em um app de teste que não seja de produção ou em um plano básico de teste dedicado que os usuários de produção não possam acessar. Para testar uma oferta de retenção baseada em regras, faça o seguinte:
- No app ou plano básico de teste, crie uma oferta de retenção baseada em regras e defina
minDurationcomoP0D(0 dias). No Google Play Console, escolha Oferta de retenção no nível da coorte. Com a API Google Play Developer, definatargetingcomo um objetoretentionRule. Veja mais detalhes em Definir regras de qualificação para retenção. - Ative a oferta, aguarde de 10 a 15 minutos para que a mudança seja propagada e limpe o cache do app Google Play Store.
- No dispositivo de teste, faça login com a conta de testador de licença e compre o plano básico de teste.
- No app Google Play Store, acesse Pagamentos e assinaturas > Assinaturas, selecione a assinatura e toque em Cancelar assinatura. Como a oferta não exige uma duração mínima de assinatura paga, você pode iniciar o fluxo de cancelamento logo após a compra. A oferta de retenção aparece no fluxo de cancelamento.
- Aceite a oferta e confirme se o back-end recebe a
RTDN
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDe processa a renovação com desconto.
Depois de verificar a integração, crie e ative a oferta de retenção baseada em regras no seu plano básico de produção.
Resolver problemas de teste de ofertas de retenção
Se a oferta de retenção não aparecer, verifique o seguinte:
- A oferta de retenção está ativa, e o horário atual está entre
startTimeeendTime, se você os definiu. - Para uma oferta de retenção de usuários por usuário, o campo
developerTargetedOffersna respostapurchases.subscriptionsv2.getpara opurchaseTokendo testador de licença inclui a oferta. - A assinatura é única, não uma assinatura com complementos.
- A assinatura não está em um período de carência, suspensão de conta ou pausada.
- A assinatura não tem mudanças pendentes de plano ou preço.
- A próxima renovação será pelo preço normal do plano básico. Para testes sem custo financeiro e promoções iniciais, a oferta de retenção só está disponível durante o período de faturamento final do teste ou da fase inicial.
- Você esperou de 10 a 15 minutos depois de ativar ou mudar a promoção e limpou o cache do app Google Play Store.