Reter assinantes com ofertas de retenção

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:

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:

  1. O assinante abre a assinatura no Google Play e inicia o cancelamento.
  2. 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.

  3. 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_CANCELED de 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 planTransitionDetails ao campo autoRenewingPlan do item de linha afetado no recurso SubscriptionPurchaseV2.

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 planTransitionDetails no estado IN_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:

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:

  1. 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.
  2. 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.
  3. 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.
  4. ID da oferta: se as ofertas ainda estiverem empatadas, o Google Play vai mostrar aquela cujo offerId vem 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:

  1. Acesse Monetizar com o Google Play > Produtos > Assinaturas.
  2. Selecione uma assinatura e, em seguida, o plano básico em que você quer adicionar a oferta.
  3. Adicione uma oferta para Assinantes atuais tentando cancelar.
  4. 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: defina retentionRule como um objeto RetentionTargetingRule que 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, defina retentionPerUserRule. 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. Se recurrenceCount for maior que 1, a fase duration precisa ser igual ao período de faturamento do plano básico.
    • regionalConfigs[]: defina relativeDiscount como o desconto como uma fração maior que 0 e menor que 1. Por exemplo, use 0.5 para 50% de desconto. As ofertas de retenção são compatíveis apenas com relativeDiscount. 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 a startTime.

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, de P0D a P1826D. Por exemplo, use P90D para 90 dias. Para não exigir um tempo mínimo de assinatura paga, defina esse campo como P0D.
  • allowMultipleClaims: opcional. Se um assinante pode resgatar a oferta mais de uma vez. Se for false, um assinante que já tiver resgatado essa oferta nunca mais vai se qualificar para ela. Se for true, um assinante poderá se qualificar novamente após o tempo em minOfferCooldownDuration desde o fim do período de desconto da oferta de retenção anterior. O padrão é false.
  • minOfferCooldownDuration: obrigatório se allowMultipleClaims for true. 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, de P1D a P1826D. Por exemplo, use P180D para 180 dias. Não defina esse campo se allowMultipleClaims for false ou 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:

  1. 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.patch ou monetization.subscriptions.basePlans.offers.batchUpdate, defina targeting como um objeto retentionPerUserRule em vez de um objeto retentionRule. O objeto RetentionPerUserTargetingRule não tem campos. Uma oferta pode usar retentionRule ou retentionPerUserRule, 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 activateOfferTargeting para uma oferta que nunca foi ativada, a chamada vai falhar com um código de status HTTP 400 Bad Request e um status de erro INVALID_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.

  2. Segmentar a promoção para uma assinatura. Chame o método purchases.subscriptionsv2.activateOfferTargeting com o nome do pacote do app, o purchaseToken da assinatura e o offerId da 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 Content sem 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 um retentionRule. 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 activateOfferTargeting uma 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 o activateTime da promoção para o horário da solicitação mais recente.

  3. 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.deactivateOfferTargeting com o mesmo nome de pacote, purchaseToken e offerId. Uma chamada bem-sucedida retorna um código de status HTTP 204 No Content sem corpo de resposta.

    O método deactivateOfferTargeting també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_PROGRESS enquanto 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, offerPhase vai 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 o offerPhase do 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.defer enquanto uma transição de oferta de retenção estiver em IN_PROGRESS, a transição pendente será preservada e aplicada na renovação adiada. Para saber a nova data de renovação, verifique o expiryTime do item de linha.
  • Mudança de plano antes da transição: uma oferta de retenção se aplica apenas ao purchaseToken da assinatura em que o assinante a aceitou. Se o assinante mudar para um plano básico ou uma assinatura diferente antes do expectedTransitionTime, o Google Play vai gerar um novo token de compra, cancelar a transição programada e limpar planTransitionDetails. 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 transitionState vai continuar como IN_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_PROGRESS ainda 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:

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:

  1. 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 targeting como um objeto retentionPerUserRule. Para mais detalhes, consulte Segmentar ofertas de retenção para assinantes específicos.
  2. 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.
  3. No dispositivo de teste, faça login com a conta de testador de licença e compre o plano básico no app.
  4. No back-end, chame o método purchases.subscriptionsv2.activateOfferTargeting com o nome do pacote do app, o purchaseToken do testador de licença e o offerId da promoção de retenção.
  5. 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.
  6. Aceite a oferta e confirme se o back-end recebe a RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED e 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:

  1. No app ou plano básico de teste, crie uma oferta de retenção baseada em regras e defina minDuration como P0D (0 dias). No Google Play Console, escolha Oferta de retenção no nível da coorte. Com a API Google Play Developer, defina targeting como um objeto retentionRule. Veja mais detalhes em Definir regras de qualificação para retenção.
  2. 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.
  3. No dispositivo de teste, faça login com a conta de testador de licença e compre o plano básico de teste.
  4. 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.
  5. Aceite a oferta e confirme se o back-end recebe a RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED e 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 startTime e endTime, se você os definiu.
  • Para uma oferta de retenção de usuários por usuário, o campo developerTargetedOffers na resposta purchases.subscriptionsv2.get para o purchaseToken do 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.