Retén suscriptores con ofertas de retención

Las ofertas de retención te ayudan a reducir la deserción voluntaria, ya que muestran un descuento a los suscriptores en el momento en que intentan cancelar su suscripción en Google Play.

Cuando un suscriptor que cumple con los requisitos inicia el proceso de cancelación, Google Play le muestra una oferta de retención que configuraste, como "Conserva tu suscripción y obtén un 50% de descuento durante los próximos 2 meses". Si el suscriptor acepta la oferta, no se cancelará su suscripción. El precio con descuento se aplicará a partir de la próxima fecha de facturación.

En esta página, se explica cómo funcionan las ofertas de retención, cómo configurarlas, cómo controlar los eventos resultantes en tu backend y cómo probarlas.

Antes de comenzar

Antes de configurar las ofertas de retención, asegúrate de haber hecho lo siguiente:

Como Google Play muestra ofertas de retención fuera de tu app, no necesitas cambiarla ni actualizar la integración de la Biblioteca de Facturación Google Play para usarlas. Todo el trabajo de integración se realiza en Google Play Console y tu backend.

Cómo funcionan las ofertas de retención

Las ofertas de retención solo aparecen en la administración de suscripciones de Google Play: la app de Google Play Store y Google Play en la Web. No aparecen dentro de tu app. La Biblioteca de Facturación Google Play no devuelve ofertas de retención en los resultados de queryProductDetailsAsync(), por lo que no se incluyen en ProductDetails.getSubscriptionOfferDetails() y no puedes venderlas a través de launchBillingFlow(). Si tu app usa vínculos directos para enviar a los suscriptores al centro de suscripciones de Google Play o a una suscripción específica para que puedan administrarla o cancelarla, esos suscriptores podrán ver tu oferta de retención cuando comiencen a cancelarla allí.

En los siguientes pasos, se describe lo que sucede cuando un suscriptor intenta cancelar su suscripción:

  1. El suscriptor abre su suscripción en Google Play y comienza a cancelarla.
  2. Google Play verifica si el suscriptor cumple con los requisitos para una de tus ofertas de retención, según las reglas de elegibilidad que estableciste para la oferta o si segmentaste la oferta para ese suscriptor.

  3. Si el suscriptor cumple con los requisitos, es posible que Google Play muestre la oferta de retención como una alternativa a la cancelación. Cumplir con los criterios de elegibilidad no garantiza que aparezca la oferta, ya que Google Play también realiza verificaciones adicionales a nivel de la plataforma, como los requisitos de cumplimiento regionales. Si Google Play muestra la oferta, el suscriptor puede realizar una de las siguientes acciones:

    • Aceptar la oferta: El suscriptor acepta con un solo toque. La suscripción permanece activa y se renueva automáticamente. No se le cobra al suscriptor de inmediato, sino que el precio con descuento se aplica a partir del próximo período de facturación.
    • Continuar con la cancelación: El suscriptor rechaza la oferta y completa el flujo de cancelación estándar. Recibirás la notificación habitual de SUBSCRIPTION_CANCELED. Para obtener más información, consulta Cancelaciones.

Si el suscriptor abandona el flujo de cancelación sin aceptar la oferta ni cancelar, su suscripción no cambia. Esto se aplica tanto a la app de Google Play Store como a Google Play en la Web. Ver una oferta de retención sin aceptarla no se tiene en cuenta para el límite de canjes de la oferta ni inicia el período de espera entre ofertas. Google Play verifica el límite de canjes cuando muestra la oferta y, luego, cuando el suscriptor la acepta. Una oferta aceptada se tiene en cuenta para el límite de reclamos cuando la suscripción se renueva con el precio con descuento. El período de espera entre ofertas comienza cuando finaliza el período con descuento de la oferta de retención anterior en el mismo plan básico. Es posible que el suscriptor vuelva a ver la oferta la próxima vez que intente cancelar la suscripción, siempre y cuando siga cumpliendo con los requisitos.

Transición de plan programada

Cuando un suscriptor acepta una oferta de retención, Google Play la modela como una transición de plan programada en la compra existente del suscriptor. Esto difiere de un reemplazo diferido, que requiere un flujo de compra nuevo y crea un token de compra nuevo. Con una oferta de retención, el suscriptor conserva el mismo purchaseToken y solo cambian las condiciones de facturación futuras.

Cuando el suscriptor acepta la oferta, Google Play hace lo siguiente:

  • Envía una RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) a tu backend.
  • Agrega un objeto planTransitionDetails al campo autoRenewingPlan de la línea de pedido afectada en el recurso SubscriptionPurchaseV2.

Para obtener detalles sobre cómo controlar estos eventos, consulta Cómo controlar eventos de ofertas de retención en tu backend.

Requisitos de elegibilidad

Una suscripción puede recibir una oferta de retención en cualquier momento antes de su próxima renovación, siempre que se cumplan todas las condiciones siguientes:

  • La suscripción está activa y se renueva automáticamente. Las suscripciones en un período de gracia, en suspensión de la cuenta o pausadas no pueden recibir ofertas de retención.
  • La suscripción es única. No se admiten las ofertas de retención para las suscripciones con complementos.
  • La suscripción no usa un plan básico de cuotas. Los planes básicos de cuotas no son aptos para las ofertas de retención.
  • El próximo pago se realizará al precio regular recurrente del plan básico. Si el suscriptor se encuentra en una fase de prueba gratuita o de precio de lanzamiento, la oferta solo estará disponible durante el período de facturación final de esa fase, cuando la próxima renovación sea al precio normal.
  • El suscriptor no se encuentra en un período de facturación con descuento de una oferta de retención aceptada anteriormente. Un suscriptor que se encuentra en la fase de descuento de una oferta de retención no puede reclamar otra oferta de retención hasta que la suscripción se renueve al precio normal del plan básico.
  • La suscripción no tiene ninguna transición de plan programada pendiente. Una suscripción puede tener como máximo una transición de plan programada pendiente, que es un objeto planTransitionDetails en el estado IN_PROGRESS. Por ejemplo, un suscriptor que ya aceptó una oferta de retención que aún no entró en vigencia no puede recibir otra.
  • La suscripción no tiene ningún cambio de precio sin confirmar.
  • El precio con descuento de la oferta de retención es menor o igual que el próximo precio de renovación del plan básico del suscriptor.
  • El suscriptor cumple con las reglas de elegibilidad que configuraste para la oferta. En el caso de una oferta de retención por usuario, activaste la segmentación para la suscripción con el método activateOfferTargeting.

Configura ofertas de retención

Puedes crear ofertas de retención en Google Play Console o con la API de Google Play Developer. Cada oferta de retención usa uno de los siguientes modos de segmentación:

Un plan básico puede tener más de una oferta de retención activa en el mismo país o región. Cuando un suscriptor cumple con los requisitos para más de una oferta, Google Play muestra, como máximo, una oferta de retención en el flujo de cancelación. Google Play elige la oferta en el siguiente orden:

  1. Modo de segmentación: Una oferta segmentada por usuario (retentionPerUserRule) siempre tiene prioridad sobre una oferta basada en reglas (retentionRule), incluso si la oferta basada en reglas tiene un porcentaje de descuento más alto.
  2. Porcentaje de descuento: Entre las ofertas aptas que usan el mismo modo de segmentación, Google Play muestra la oferta con el porcentaje de descuento más alto.
  3. Precio con descuento: Si las ofertas tienen el mismo porcentaje de descuento, Google Play muestra la oferta con el precio con descuento más bajo.
  4. ID de la oferta: Si las ofertas siguen empatadas, Google Play muestra la oferta cuyo offerId aparece en último lugar en orden alfabético.

Cómo crear una oferta de retención en Play Console

Para crear una oferta de retención en Google Play Console, sigue estos pasos:

  1. Ve a Monetiza con Play > Productos > Suscripciones.
  2. Selecciona una suscripción y, luego, el plan básico al que deseas agregar la oferta.
  3. Agrega una oferta para Suscriptores existentes que intentan cancelar la suscripción.
  4. Elige Oferta de retención a nivel de cohorte u Oferta de retención a nivel de usuario.

Cómo crear una oferta de retención con la API de Play Developer

También puedes crear y actualizar ofertas de retención de manera programática. Para crear una oferta, llama al método monetization.subscriptions.basePlans.offers.create. Para actualizar las ofertas existentes, llama al método monetization.subscriptions.basePlans.offers.patch o monetization.subscriptions.basePlans.offers.batchUpdate. Los tres métodos admiten los campos retentionRule, retentionPerUserRule, startTime y endTime. En el objeto SubscriptionOffer, configura los siguientes campos:

  • offerId: Es el ID único de tu oferta de retención.
  • targeting: Establece retentionRule en un objeto RetentionTargetingRule que defina quién cumple con los requisitos para la oferta. Para conocer los campos disponibles, consulta Establece reglas de elegibilidad de retención. Para elegir suscriptores aptos desde tu backend, establece retentionPerUserRule. Para obtener más detalles, consulta Segmenta ofertas de retención para suscriptores específicos.
  • phases[]: Una oferta de retención solo admite una fase de precios. En esa fase, configura los siguientes campos:
    • recurrenceCount: Es la cantidad de períodos de facturación que dura el descuento, de 1 a 52. Si recurrenceCount es mayor que 1, la fase duration debe ser igual al período de facturación del plan básico.
    • regionalConfigs[]: Establece relativeDiscount en el descuento como una fracción mayor que 0 y menor que 1. Por ejemplo, usa 0.5 para un 50% de descuento. Las ofertas de retención solo admiten relativeDiscount. No se admiten las fases de precio fijo (price), descuento absoluto (absoluteDiscount) ni gratuitas (free).
  • startTime: Opcional Es la hora en que la oferta de retención estará disponible para los suscriptores que cumplan con los requisitos, como una marca de tiempo RFC 3339. Configurar este campo no activa la oferta. Si no configuras este campo, la oferta estará disponible según su estado.
  • endTime: Opcional Es la hora en que la oferta de retención deja de estar disponible, como una marca de tiempo RFC 3339, independientemente del estado de la oferta. Si no estableces este campo, la oferta no tendrá fecha de finalización. Si estableces este campo, debe ser en el futuro y posterior a startTime.

El método monetization.subscriptions.basePlans.offers.create siempre crea la oferta en el estado DRAFT, incluso si estableces startTime. Para activar la oferta, llama al método monetization.subscriptions.basePlans.offers.activate.

Configura reglas de elegibilidad de retención

El objeto RetentionTargetingRule contiene los siguientes campos:

  • scope: Obligatorio. Son las suscripciones que se consideran en la regla. Para las ofertas de retención, el único valor admitido es thisSubscription, la suscripción en la que se define la oferta. Establece este campo en {"thisSubscription": {}}.
  • minDuration: Obligatorio. Es el tiempo mínimo que un usuario debe haber sido suscriptor pagado para cumplir con los requisitos, como una duración ISO 8601 en días, de P0D a P1826D. Por ejemplo, usa P90D para 90 días. Para no exigir un tiempo mínimo de suscripción pagada, establece este campo en P0D.
  • allowMultipleClaims: Opcional Si un suscriptor puede canjear la oferta más de una vez Si es false, un suscriptor que ya haya reclamado esta oferta no volverá a cumplir con los requisitos para acceder a ella. Si es true, un suscriptor puede volver a cumplir con los requisitos después de que haya transcurrido el tiempo en minOfferCooldownDuration desde el final del período con descuento de la oferta de retención anterior. El valor predeterminado es false.
  • minOfferCooldownDuration: Es obligatorio si allowMultipleClaims es true. Es el tiempo mínimo que debe transcurrir después de que finaliza el período con descuento de la oferta de retención anterior para que el suscriptor vuelva a cumplir con los requisitos, como una duración ISO 8601 en días, de P1D a P1826D. Por ejemplo, usa P180D para 180 días. No establezcas este campo si allowMultipleClaims es false o no está establecido.

En el siguiente ejemplo, se muestran los campos startTime, endTime y targeting de un objeto SubscriptionOffer para una oferta de retención que está disponible para los suscriptores que pagaron durante al menos 90 días y que pueden volver a reclamar 180 días después de que finalice su descuento de retención 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"
    }
  }
}

Segmenta las ofertas de retención para suscriptores específicos

En lugar de permitir que Google Play decida la elegibilidad con un objeto RetentionTargetingRule, puedes hacer que una oferta de retención esté disponible solo para los suscriptores que elija tu backend. Por ejemplo, puedes segmentar una oferta para los suscriptores que tu modelo de predicción de deserción marque como en riesgo o para los suscriptores que inicien un recorrido de cancelación en tu app.

Los suscriptores ven una oferta de retención por usuario en el mismo flujo de cancelación de Google Play que cualquier otra oferta de retención, y tú controlas la aceptación de la misma manera. Para obtener más detalles, consulta Controla los eventos de ofertas de retención en tu backend.

Para segmentar las ofertas de retención para suscriptores específicos, haz lo siguiente:

  1. Crea una oferta de retención por usuario. Cuando llames al método monetization.subscriptions.basePlans.offers.create, monetization.subscriptions.basePlans.offers.patch o monetization.subscriptions.basePlans.offers.batchUpdate, establece targeting en un objeto retentionPerUserRule en lugar de un objeto retentionRule. El objeto RetentionPerUserTargetingRule no tiene campos. Una oferta puede usar retentionRule o retentionPerUserRule, pero no ambos.

    {
      "offerId": "retention-peruser-30off",
      "targeting": {
        "retentionPerUserRule": {}
      }
    }
    

    Activa la oferta antes de segmentarla para los suscriptores. Si llamas al método activateOfferTargeting para una oferta que nunca se activó, la llamada falla con un código de estado HTTP 400 Bad Request y un estado de error INVALID_ARGUMENT. Para obtener más información, consulta Cómo controlar los errores de segmentación. Incluso cuando la oferta está activa, Google Play solo la muestra a los suscriptores cuyas suscripciones segmentas en el siguiente paso.

  2. Segmenta la oferta para una suscripción. Llama al método purchases.subscriptionsv2.activateOfferTargeting con el nombre del paquete de tu app, el purchaseToken de la suscripción y el offerId de la oferta de retención por usuario:

    POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{purchaseToken}:activateOfferTargeting
    
    {
      "offerId": "retention-peruser-30off"
    }
    

    Una llamada exitosa devuelve un código de estado HTTP 204 No Content sin cuerpo de respuesta. Google Play Store almacena la segmentación con la suscripción, por lo que no necesitas llamar a la API en el momento en que el suscriptor cancela la suscripción. La próxima vez que el suscriptor comience a cancelar en Google Play, Google Play podrá mostrar la oferta, siempre que la suscripción cumpla con los requisitos de elegibilidad. La segmentación por usuario solo reemplaza las reglas de elegibilidad que define un retentionRule. Se siguen aplicando todos los demás requisitos de elegibilidad y las verificaciones a nivel de la plataforma que realiza Google Play, como los requisitos de cumplimiento regionales.

    Puedes segmentar más de una oferta de retención por usuario para la misma suscripción. Para ello, llama al método activateOfferTargeting una vez por cada oferta. Google Play seguirá mostrando, como máximo, una oferta de retención en el flujo de cancelación. Para obtener detalles sobre cómo Google Play elige la oferta, consulta Cómo configurar ofertas de retención.

    El método activateOfferTargeting es idempotente. Si lo llamas para una oferta que ya está orientada a la suscripción, la llamada se realiza correctamente y Google Play actualiza el activateTime de la oferta a la hora de la solicitud más reciente.

  3. Quita la segmentación cuando sea necesario. Si ya no quieres que un suscriptor reciba la oferta, por ejemplo, porque cambió su riesgo de deserción, llama al método purchases.subscriptionsv2.deactivateOfferTargeting con el mismo nombre de paquete, purchaseToken y offerId. Una llamada correcta devuelve un código de estado HTTP 204 No Content sin cuerpo de respuesta.

    El método deactivateOfferTargeting también es idempotente. Si la oferta no está segmentada para la suscripción, por ejemplo, porque nunca activaste la segmentación, la llamada se realiza correctamente y no tiene ningún efecto.

La segmentación se aplica a un solo purchaseToken y no vence mientras la suscripción esté activa y se renueve automáticamente. Se mantiene en su lugar después de que el suscriptor ve, acepta o rechaza la oferta. Google Play lo quita solo cuando llamas al método deactivateOfferTargeting o 60 días después de que vence la suscripción. Si un cambio de plan o una nueva suscripción crean un purchaseToken nuevo, la segmentación no se transfiere.

Para verificar qué ofertas de retención por usuario se orientan a una suscripción, llama al método purchases.subscriptionsv2.get. En el campo developerTargetedOffers de cada línea de pedido, se indican las ofertas segmentadas. Cada entrada contiene el offerId y el activateTime de cuando activaste la segmentación:

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "developerTargetedOffers": [
        {
          "offerId": "retention-peruser-30off",
          "activateTime": "2026-12-03T15:04:05Z"
        }
      ]
    }
  ]
}

Cómo controlar los errores de segmentación

Cuando falla una llamada al método activateOfferTargeting o deactivateOfferTargeting, la respuesta contiene un código de estado HTTP y un estado de error que describe la causa. En la siguiente tabla, se enumeran los códigos de estado HTTP y los estados de error que pueden devolver estos métodos:

Código de estado HTTP Estado del error Métodos Causa
404 Not Found NOT_FOUND Ambos El purchaseToken no existe.
400 Bad Request INVALID_ARGUMENT activateOfferTargeting La offerId no existe en el plan básico actual de la suscripción, o la oferta aún está en estado de borrador y nunca se activó.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting El targeting de la oferta no está configurado como retentionPerUserRule.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting La suscripción ya venció.

El método activateOfferTargeting no verifica si una suscripción no vencida cumple con los requisitos de la oferta. Por ejemplo, si la suscripción se cancela, pero aún no venció, la llamada se realiza correctamente y Google Play almacena la segmentación. Google Play evalúa la elegibilidad de la suscripción cuando el suscriptor ingresa al flujo de cancelación.

Cómo controlar los eventos de ofertas de retención en tu backend

Cuando un suscriptor acepta una oferta de retención y, luego, cuando se produce la renovación con descuento, Google Play envía RTDN a tu backend. Después de recibir cada notificación, llama al método purchases.subscriptionsv2.get con el purchaseToken de la notificación para obtener el estado más reciente de la suscripción.

Aceptar una oferta de retención no crea una compra nueva. El purchaseToken sigue siendo el mismo, por lo que no es necesario que vuelvas a confirmar la compra, y Google Play no genera un linkedPurchaseToken. Mantener el derecho existente del suscriptor Procesa el pedido de renovación con descuento de la misma manera que cualquier otra renovación de suscripción.

Tipo de notificación Cuándo se envía Qué hacer
SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) Cuando un suscriptor acepta una oferta de retención en el flujo de cancelación Llama al método purchases.subscriptionsv2.get y verifica planTransitionDetails. El transitionState es IN_PROGRESS. La suscripción permanece activa y se renueva automáticamente, por lo que debes seguir otorgando acceso.
SUBSCRIPTION_RENEWED (2) Cuando finaliza el período de facturación actual y la suscripción se renueva con el precio de la oferta de retención con descuento. Llama al método purchases.subscriptionsv2.get, confirma que offerDetails.offerId sea el ID de la oferta de retención y que planTransitionDetails ya no esté presente, y extiende el acceso del suscriptor al nuevo expiryTime.

El objeto planTransitionDetails contiene los siguientes campos:

  • productId: Es el ID del producto del plan al que se cambia la suscripción. En el caso de una oferta de retención, se trata del mismo producto.
  • basePlanId: Es el ID del plan básico al que se realiza la transición de la suscripción.
  • offerId: Es el ID de la oferta de retención que aceptó el suscriptor. Usa este campo para identificar qué oferta de retención se canjeó.
  • transitionInfo.transitionState: Es el estado de la transición. En el caso de las ofertas de retención, el estado es IN_PROGRESS mientras la transición está pendiente.
  • transitionInfo.expectedTransitionTime: Es el momento en que se espera que entren en vigencia las condiciones de la oferta de retención.

Google Play incluye planTransitionDetails solo mientras la transición está pendiente. Cuando la suscripción se renueva con el precio de la oferta de retención con descuento, se completa la transición y Google Play quita planTransitionDetails de la respuesta de purchases.subscriptionsv2.get. A partir de ese momento, la línea de pedido muestra el descuento por retención activo:

  • offerDetails.offerId es el ID de la oferta de retención aceptada.
  • offerPhase es {"introductoryPrice": {}} durante los períodos de facturación con descuento. Una vez que finalizan los períodos de facturación con descuento y la suscripción se renueva al precio normal del plan básico, offerPhase cambia a {"basePrice": {}}.

Respuesta después de que el suscriptor acepta la oferta

Después de que el suscriptor acepta la oferta de retención, el período de facturación actual continúa sin cambios. El objeto planTransitionDetails muestra la transición programada con un 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"
          }
        }
      }
    }
  ]
}

Respuesta después de la renovación con descuento

Después de que pasa la fecha de renovación y se le cobra al suscriptor el precio con descuento, offerDetails.offerId muestra la oferta de retención, offerPhase muestra introductoryPrice y la respuesta ya no incluye 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
        }
      }
    }
  ]
}

Interacciones del ciclo de vida

Ten en cuenta los siguientes comportamientos cuando manejes ofertas de retención:

  • Fin del descuento: Una vez que finalizan los períodos de facturación con descuento, la suscripción se renueva automáticamente al precio normal del plan básico. Recibes una notificación SUBSCRIPTION_RENEWED, como con cualquier otra renovación, y el offerPhase de la línea de pedido cambia a {"basePrice": {}}. El suscriptor no necesita realizar ninguna acción.
  • Recuperación de pagos después del descuento: Si se rechaza la renovación al precio normal del plan básico después de que finaliza el descuento y la suscripción entra en un período de gracia o una suspensión de la cuenta, la recuperación de pagos cobra el precio normal del plan básico. Google Play no aplica el descuento de la oferta de retención completada. Si se rechaza el pago de la primera renovación con descuento, se conserva la transición pendiente y se aplica el precio de la oferta de retención cuando se recupera el pago.
  • Facturación diferida: Si llamas al método purchases.subscriptionsv2.defer mientras la transición de la oferta de retención está en estado IN_PROGRESS, se conserva la transición pendiente y se aplica en la renovación diferida. Para obtener la nueva fecha de renovación, consulta el campo expiryTime de la línea de pedido.
  • Cambio de plan antes de la transición: Una oferta de retención solo se aplica al purchaseToken de la suscripción en la que el suscriptor la aceptó. Si el suscriptor cambia a un plan básico o una suscripción diferentes antes de la expectedTransitionTime, Google Play genera un nuevo token de compra, cancela la transición programada y borra planTransitionDetails. La oferta de retención pendiente no se aplica al plan nuevo.
  • Cancelación y restablecimiento: Si un suscriptor cancela la suscripción después de aceptar una oferta de retención, la transición programada permanece pendiente y transitionState se mantiene como IN_PROGRESS. Si el suscriptor restablece la suscripción antes de que venza, el descuento de la oferta de retención se seguirá aplicando en la renovación.
  • Vencimiento y nueva suscripción: Si la suscripción vence sin restablecerse, Google Play cancela la transición pendiente. Si el usuario vuelve a suscribirse o registrarse más adelante, Google Play creará una nueva compra de suscripción, y no se aplicará la oferta de retención aceptada anteriormente.
  • Cambios en la oferta: Si cambias el descuento o los períodos de facturación de una oferta de retención, el cambio se aplicará solo a los canjes futuros. Los suscriptores que ya aceptaron la oferta conservan las condiciones originales.
  • Desactivación de la oferta: Si desactivas una oferta de retención o esta alcanza su fecha de finalización, los suscriptores que ya la hayan aceptado conservarán las condiciones que aceptaron. Los suscriptores con una transición IN_PROGRESS seguirán recibiendo el descuento en su próxima renovación, y los suscriptores que ya se encuentren en los períodos de facturación con descuento conservarán el descuento durante todo el período acordado.
  • Cambios de precio: Se siguen aplicando los cambios de precio del plan básico. Google Play migra a un suscriptor a un precio nuevo solo cuando este paga el precio normal y no tiene una transición de oferta de retención pendiente. Para obtener más información, consulta Cómo cambiar los precios de las suscripciones.
  • Reembolsos: Puedes reembolsar a un suscriptor con las APIs estándar de reembolso y revocación, como el método purchases.subscriptionsv2.revoke. Esto reembolsa el pago más reciente y finaliza el acceso del suscriptor.

Prueba las ofertas de retención

Google Play solo muestra ofertas de retención activas en el flujo de cancelación y evalúa las reglas de elegibilidad en tiempo real. Para probar las ofertas de retención con una cuenta de verificador con licencia, usa uno de los siguientes métodos:

Antes de usar cualquiera de los métodos, ve a Configuración > Prueba de licencias en Google Play Console y agrega la Cuenta de Google de prueba como verificador de licencias.

Prueba una oferta de retención de usuarios

Google Play muestra una oferta de retención de usuarios solo para las suscripciones a las que segmentas, de modo que puedas probarla en un plan básico de producción sin exponerla a suscriptores reales. Para probar una oferta de retención por usuario, haz lo siguiente:

  1. Crea una oferta de retención por usuario en el plan básico y, luego, actívala. En Google Play Console, elige Oferta de retención a nivel del usuario. Con la API de Google Play Developer, establece targeting en un objeto retentionPerUserRule. Para obtener más información, consulta Cómo segmentar ofertas de retención para suscriptores específicos.
  2. Si acabas de activar la oferta, espera entre 10 y 15 minutos para que se propague el cambio y, luego, borra la caché de la app de Google Play Store.
  3. En el dispositivo de prueba, accede con la cuenta de verificador de licencias y, luego, compra el plan básico en tu app.
  4. Desde tu backend, llama al método purchases.subscriptionsv2.activateOfferTargeting con el nombre del paquete de tu app, el purchaseToken del verificador de licencias y el offerId de la oferta de retención.
  5. En la app de Google Play Store, ve a Pagos y suscripciones > Suscripciones, selecciona la suscripción y presiona Cancelar suscripción. La oferta de retención aparece en el flujo de cancelación.
  6. Acepta la oferta y, luego, confirma que tu backend reciba la RTDN de SUBSCRIPTION_PLAN_TRANSITION_UPDATED y controle la renovación con descuento.

Prueba una oferta de retención basada en reglas

Después de activar una oferta de retención basada en reglas, Google Play puede mostrarla a cualquier suscriptor apto del plan básico. Para evitar exponer la oferta a los usuarios de producción, pruébala en una app de prueba que no sea de producción o en un plan básico de prueba exclusivo al que los usuarios de producción no puedan acceder. Para probar una oferta de retención basada en reglas, haz lo siguiente:

  1. En tu app de prueba o en tu plan básico de prueba, crea una oferta de retención basada en reglas y establece minDuration en P0D (0 días). En Google Play Console, elige Oferta de retención a nivel de cohorte. Con la API de Google Play Developer, establece targeting en un objeto retentionRule. Para obtener más información, consulta Establece reglas de elegibilidad de retención.
  2. Activa la oferta, espera de 10 a 15 minutos para que se propague el cambio y, luego, borra la caché de la app de Google Play Store.
  3. En el dispositivo de prueba, accede con la cuenta de verificador de licencias y, luego, compra el plan básico de prueba.
  4. En la app de Google Play Store, ve a Pagos y suscripciones > Suscripciones, selecciona la suscripción y presiona Cancelar suscripción. Como la oferta no requiere una duración mínima de la suscripción pagada, puedes iniciar el flujo de cancelación justo después de la compra. La oferta de retención aparece en el flujo de cancelación.
  5. Acepta la oferta y, luego, confirma que tu backend reciba la RTDN de SUBSCRIPTION_PLAN_TRANSITION_UPDATED y controle la renovación con descuento.

Después de verificar la integración, crea y activa la oferta de retención basada en reglas en tu plan básico de producción.

Soluciona problemas de las pruebas de ofertas de retención

Si no aparece la oferta de retención, verifica lo siguiente:

  • La oferta de retención está activa y la hora actual se encuentra entre su startTime y endTime, si las configuraste.
  • En el caso de una oferta de retención por usuario, el campo developerTargetedOffers de la respuesta purchases.subscriptionsv2.get para el purchaseToken del verificador de licencias incluye la oferta.
  • La suscripción es única, no una suscripción con complementos.
  • La suscripción no está en período de gracia, en suspensión de la cuenta ni pausada.
  • La suscripción no tiene ningún cambio de plan ni de precio pendiente.
  • La próxima renovación se realizará al precio normal del plan básico. En el caso de las pruebas gratuitas y las ofertas de lanzamiento, la oferta de retención solo está disponible durante el período de facturación final de la prueba o la fase de lanzamiento.
  • Esperaste entre 10 y 15 minutos después de activar o cambiar la oferta, y borraste la caché de la app de Play Store.