KappS Base de conocimiento · Blog

Planes base y ofertas de suscripción de Google Play

Blog Tutorial

Dos preguntas determinan lo que paga realmente un suscriptor de Google Play, y se responden en dos lugares distintos. El plan base responde "¿qué periodo de facturación, a qué precio, con renovación automática o prepago?". La oferta responde "¿quién puede acceder a un inicio más barato y durante cuánto tiempo?". Si modelas mal las ofertas de suscripción, cada petición de marketing de una prueba gratuita se convierte en un producto de suscripción nuevo, lo que fragmenta tu catálogo, divide tus informes entre productos que nunca se podrán eliminar una vez que alguien los haya comprado y deja al cliente con una lógica de compra que nadie se atreve a tocar.

Este tutorial sigue el orden que imponen realmente Play Console y la Billing Library: crear el producto, configurar los planes base, añadir ofertas con elegibilidad, leer los tokens de oferta en el cliente, gestionar los cambios de plan con el modo de reemplazo correcto y, por último, verificar el derecho de uso en tu servidor. Hay tres cosas que hacen tropezar a los equipos una y otra vez en el camino: el token de oferta que el cliente debe pasar explícitamente, el modo de prorrateo elegido en una actualización y la comprobación en el servidor que determina si una prueba gratuita es real. Las últimas secciones cubren las trampas que solo aparecen después del lanzamiento: brechas en los precios regionales, ofertas que nunca se pueden mostrar y un cambio de precio que en silencio se convierte en un segundo plan base.


1. El modelo de tres capas: producto, plan base, oferta

Una suscripción de Google Play se compone de tres capas, y sus vigencias son completamente distintas. Eso es lo que determina si una decisión de hoy se podrá cambiar dentro de dos años.

  • Producto: la entrada del catálogo, identificada por un ID de producto. El ID no se puede cambiar después de crearlo, y un producto que alguien haya comprado no se puede eliminar, solo desactivar. Nómbralo desde el primer día por lo que es, no por la promoción de este trimestre: "first_month_half_price" es un ID permanente para una idea temporal.
  • Plan base: la capa que fija realmente la economía: periodo de facturación (semanal, mensual, 3 meses, 6 meses, anual), tipo de renovación (renovación automática o prepago), precio por país, además del periodo de gracia y el comportamiento de la retención de cuenta. Un mismo producto puede tener varios planes base, que es justo cómo se venden mensual y anual en paralelo sin un segundo producto.
  • Oferta — un tratamiento de precio asociado a un plan base: una prueba gratuita, un precio introductorio, un descuento de reactivación. Cada oferta lleva una condición de elegibilidad y solo la ven los usuarios elegibles.

Hay una consecuencia técnica que conviene memorizar: el offerToken que usa el cliente para comprar es la credencial de un par específico de "plan base + oferta". En cuanto un producto tiene más de un plan base, o cualquier oferta, el token debe pasarse explícitamente: no hay valor predeterminado. La sección 5 es donde esa regla deja de ser una curiosidad y empieza a explicar fallos reales.

2. Paso 1 — crear el producto de suscripción

En Play Console, ve a Monetizar con Play → Productos → Suscripciones y crea una suscripción. Este paso hace cuatro cosas, y cada una es irreversible o costosa más adelante.

  1. ID de producto: letras minúsculas, dígitos y guiones bajos, único dentro de la app, inmutable y nunca reutilizable, ni siquiera tras su eliminación. Cambiarle el nombre implica crear un producto nuevo, lo que significa un ID nuevo y una ruta de compra nueva.
  2. Nombre: para que reconozcas la fila en la consola. Lo que el comprador ve en la hoja de compra lo genera Play a partir del plan base y la oferta.
  3. Descripción y beneficios: qué incluye la suscripción. Este texto aparece en algunas pantallas de la tienda y es lo que el soporte te citará de vuelta.
  4. Guardar — has guardado un borrador. El producto solo se vuelve comprable cuando existe al menos un plan base y está activo.

El error estructural más común es crear productos separados para el plan mensual y el anual. Así acabas manteniendo dos flujos de compra, dos conjuntos de estados y dos rutas de cancelación, cuando Play se diseñó para alojar ambos como planes base dentro de un mismo producto. Cambiarlo después es doloroso, así que hazlo bien desde el principio.

3. Paso 2: configura los planes base

Los planes base son donde reside la economía de la suscripción. Cada producto necesita al menos uno; la mayoría necesita dos (mensual y anual).

Elige primero el tipo de renovación. Un plan base de renovación automática vuelve a cobrar al final de cada periodo, que es lo que necesitan la mayoría de las suscripciones de contenido y utilidades. Un plan base de prepago vende un periodo fijo por adelantado y exige que el usuario vuelva a recargar cuando termina: encaja bien en mercados de precios bajos y con usuarios que no quieren un cargo recurrente. Los dos no se mezclan: un plan de prepago no tiene ciclo de renovación, ni concepto de periodo de gracia, y no admite una prueba gratuita. Si las pruebas forman parte de tu plan de crecimiento, el plan principal tiene que ser de renovación automática.

Después, define el periodo y los precios. El periodo establece el ritmo de facturación; los precios se introducen por país y región. Esta es la fuente más fiable de tickets de soporte: Play te permite poner precio solo a algunos países, y un país sin precio simplemente no se puede comprar. Los compradores de allí ven "artículo no disponible en tu país", lo que les parece un error y en tu consola no parece nada en absoluto. Antes del lanzamiento, completa todos los mercados objetivo y comprueba que el precio mostrado cumple las normas locales de representación fiscal.

Por último, la configuración del ciclo de vida: decide qué ocurre cuando un cobro falla, no cuando tiene éxito:

  • Periodo de gracia: una ventana tras un cobro fallido en la que el usuario conserva el derecho, ganando tiempo para corregir el método de pago.
  • Retención de cuenta: cuando el periodo de gracia termina sin pago, el derecho se suspende pero se conserva el registro de la suscripción, de modo que pagar más tarde lo restablece.
  • Volver a suscribirse: permite que un usuario que canceló vuelva con el mismo plan en lugar de recorrer de nuevo el flujo de compra.

Los valores predeterminados aquí no son automáticamente los correctos. Las apps utilitarias suelen querer un periodo de gracia y una retención de cuenta; las apps de contenido pueden preferir una degradación más rápida. Elijas lo que elijas, la asignación en el servidor debe coincidir, porque la API de estado de suscripción distingue el periodo de gracia de la retención de cuenta: fusionar ambos en "válido" descarta esa información.

4. Paso 3: añade ofertas y criterios de elegibilidad

Las ofertas son la palanca de conversión y la capa que más a menudo se configura mal. Toda oferta incluye tres elementos: un ID de oferta, una o varias fases y una condición de elegibilidad.

Las fases determinan cómo se desarrolla la oferta en el tiempo. Una fase es una prueba gratuita (precio cero, un número de días) o un precio con descuento (un número de periodos a un importe determinado). Las fases se pueden encadenar, por ejemplo "7 días gratis y luego un 50 % de descuento el primer mes", pero el orden de las fases es el orden en que el usuario paga realmente, así que invertirlas significa cobrar primero y regalar después, lo que atrae tanto tickets de soporte como preguntas en la revisión.

La elegibilidad es el interruptor que decide quién llega a ver la oferta. Play te da tres condiciones:

  • Nuevo suscriptor: nunca se ha suscrito a este producto. La condición habitual para una prueba gratuita.
  • Mejora: actualmente tiene otra suscripción que cumple como destino de mejora.
  • Recuperación — suscribieron antes y luego cancelaron o caducaron. Mucho más preciso que un cupón general, y no contamina el precio que ven los usuarios nuevos.

Las etiquetas de oferta no son un adorno. Acompañan a la compra y son la única forma limpia de separar más adelante las conversiones de prueba de las compras a precio completo en tus propios informes y en la lógica de tu servidor. Si las omites, tres meses después no podrás responder si las pruebas conservaron usuarios.

Una oferta solo afecta a las compras nuevas. Editarla o desactivarla no cambia la facturación de los suscriptores que ya están dentro de ella. A la inversa, para dar un precio nuevo a los suscriptores existentes necesitas el flujo de cambio de precio, no otra oferta.

Vale la pena dejar por escrito dos límites. Cada plan base solo puede llevar un número limitado de ofertas, así que conviene reutilizar las promociones en lugar de crearlas sin fin. Y cuando un plan base está inactivo, todas las ofertas que dependen de él no se pueden vender: cuando una oferta «no aparece», revisa primero el estado del plan base, después la elegibilidad y por último el código del cliente.

5. Paso 4: lee el token de oferta correcto en el cliente

Los detalles del producto devuelven una lista, no un precio único. Al consultar una suscripción se obtiene subscriptionOfferDetails, donde cada entrada es una combinación de "plan base + oferta" que lleva un basePlanId, un offerId (que puede estar vacío, lo que significa la ruta a precio completo del propio plan base) y un offerToken.

Comprar significa entregar explícitamente al flujo de facturación una entrada de esa lista: crea el ProductDetailsParams para la compra y establece en él el offerToken seleccionado. La regla es simple, y el coste de incumplirla es inmediato:

  • Un plan base y sin ofertas: el token puede omitirse, aunque pasarlo explícitamente es más seguro entre versiones de la biblioteca.
  • Varios planes base, o cualquier oferta — omitir el token hace fallar la compra. Esta es la causa raíz del clásico "el mensual funciona, el anual da error".
  • El precio que se muestra en la interfaz debe provenir de la entrada que seleccionaste, nunca del primer elemento de la lista. Mostrar $4.99 y cobrar $49.99 es el error más caro de este artículo.

Escribe la regla de selección en lugar de confiar en el orden de la lista: localiza el plan base por el basePlanId que reconozcas, luego elige dentro de él la oferta de mayor prioridad que la lista devuelta contenga realmente y, cuando no haya ninguna oferta disponible, recurre a la entrada de precio completo del plan base. Determinar la elegibilidad es tarea de Play: la lista que recibes ya es "lo que este usuario puede comprar ahora mismo", así que no reimplementes las reglas de elegibilidad localmente ni hagas suposiciones.

Durante las pruebas, usa una cuenta de prueba de licencia y recuerda que la elegibilidad también se aplica a los testers: una cuenta que ya se ha suscrito no verá una oferta para nuevos suscriptores. Ese es el comportamiento esperado, no un fallo del código. Para verificar que se muestra una prueba, una cuenta nueva es la vía más rápida.

6. Paso 5: mejoras, degradaciones y modos de sustitución

Pasar a un usuario de mensual a anual, o de un nivel básico a uno premium, es un reemplazo, no una segunda compra. Cómo se comporta ese reemplazo lo decide el modo de reemplazo, y elegir mal significa cobrar dos veces al usuario o dejar dinero sobre la mesa durante un periodo completo.

  • Con prorrateo por tiempo: se aplica de inmediato y abona el valor restante de la suscripción anterior a la nueva, de modo que el usuario paga ahora la diferencia.
  • Cobrar el precio prorrateado: se aplica de inmediato y cobra el importe prorrateado al momento; se usa habitualmente para reducciones de plan, de modo que el usuario no consume primero y paga después.
  • Cobrar el precio completo — se aplica de inmediato al precio completo del nuevo plan, sin crédito por el tiempo restante; solo es razonable cuando el importe en juego es menor que el costo de prorratearlo.
  • Sin prorrateo — se aplica de inmediato, la nueva suscripción se factura desde el siguiente ciclo y el resto del periodo anterior simplemente se agota. Lo más amable para el usuario, lo menos rentable para ti y un valor predeterminado sensato para las reducciones de plan.

In Billing Library 8 the entry point is unified as setSubscriptionReplacementMode; the older method names from earlier library versions are deprecated. If your code still calls them, the compile error is a gift — cheaper than discovering mid-rollout that the semantics differ.

Los planes base de prepago no participan en la sustitución: no tienen ciclo de renovación y caducan según su propio calendario. Cualquier aviso de «cambiar de mensual a anual» debe excluir a los usuarios de prepago, o les mostrarás un botón que nunca podrá completarse.

Una regla de orden: una solicitud de reemplazo o falla o surte efecto, nunca a medias. Así que no concedas el derecho local en el cliente antes de enviarla: espera a que el servidor tenga la nueva credencial de compra y luego desbloquea.

7. Paso 6 — verifica y confirma en tu servidor

Lo único que devuelve el cliente es "el usuario dice que lo compró". El derecho de acceso se decide en el servidor: llama a la consulta de suscripción (purchases.subscriptionsv2) con el token de compra, toma el estado y la caducidad autoritativos y escríbelos en tu propia tabla de derechos.

El campo de estado te indica en qué segmento está el usuario: activo, en periodo de gracia, en espera, en pausa, cancelado, caducado, pendiente. Se corresponden directamente con las ramas de derechos: el periodo de gracia suele mantener el acceso, la retención de cuenta suele restringirlo y la pausa debería detener el servicio conservando los datos. Codificar la correspondencia en "válido o no válido" desaprovecha precisamente las distinciones que ofrece Play.

Después, dos acciones que se olvidan con facilidad. Confirma la compra en un plazo de tres días o se reembolsará automáticamente; hacerlo desde el servidor es más fiable que confiar en el cliente. Y configura las notificaciones en tiempo real para desarrolladores para que te lleguen las renovaciones, cancelaciones, entradas en periodo de gracia, recuperaciones y confirmaciones de cambio de precio. Una notificación es una señal para ir a comprobar, no el estado final: consulta después la suscripción completa, elimina duplicados por el ID del mensaje y procesa de forma idempotente.

Si aciertas en esas tres capas, el ciclo se cierra: el cliente inicia, el servidor resuelve y las notificaciones lo mantienen a tiempo.

8. Las trampas que solo aparecen después del lanzamiento

Estos rara vez aparecen en las pruebas y llegan todos a la vez con tráfico real.

  • Huecos en los precios regionales — se añade un mercado nuevo y no se completa la tabla de precios, así que los compradores de allí ven «no disponible». Recorrer la hoja de compra una vez con una cuenta de esa región es mejor que fiarse de una tabla de la consola.
  • Cambiar el precio de la forma equivocada: editar un plan base existente inicia el flujo de cambio de precio, en el que los suscriptores actuales deben confirmar antes de que se aplique el nuevo precio. Si el objetivo es que «los usuarios antiguos conserven el precio anterior y los nuevos paguen el nuevo», la respuesta habitual es crear un nuevo plan base y cambiar lo que vendes, no editar. Decide qué resultado quieres antes de tocar el precio.
  • Desactivar una oferta con suscriptores activos — la desactivación solo bloquea las compras nuevas; los suscriptores existentes conservan la oferta hasta que finalice el periodo. No es un fallo, pero conviene tener preparado un guion de soporte.
  • Convertir cada promoción en un producto nuevo — acabas con productos que no se pueden eliminar, informes fragmentados y una lógica de cliente que nadie va a refactorizar.
  • Olvidar las etiquetas de oferta: sin ellas no puedes separar las conversiones de pruebas de las compras directas, así que no puedes decir qué promoción retuvo de verdad.
  • Visible para los testers, invisible para los usuarios — la elegibilidad también se aplica a las cuentas de prueba. Verificar con una cuenta limpia es la vía de depuración más rápida que tienes.

9. Dónde encaja KappS

La configuración de suscripciones es una decisión de producto, pero se apoya en cuentas que deben mantenerse en regla durante años: perfil de pagos, información fiscal, estado de la verificación de desarrollador. Si cualquiera de ellos falla, la cadena de ingresos se rompe en el peor momento posible. KappS prepara y envía el material conforme a las políticas y mantiene las cuentas y el estado de publicación en buen estado, para que esas condiciones previas dejen de ser una variable.

  • Coherencia entre cuenta y pagos: identidad del desarrollador, perfil de pagos y beneficiario real alineados, para que la liquidación no se atasque por datos que no coinciden.
  • Revisión de la configuración fiscal y regional — W-8BEN/W-9, tasas de retención y mercados objetivo comprobados antes del lanzamiento, no después de que llegue un pago corto.
  • Una segunda opinión sobre la configuración — planes base, elegibilidad de ofertas y gestión de tokens en el cliente, especialmente en carteras con múltiples productos, regiones e idiomas.

No ofrecemos nada que eluda las reglas de las plataformas: los precios y las pruebas tienen que ser reales, la elegibilidad debe seguir las definiciones de Play y cada compra tiene que superar la verificación del lado del servidor. Esas son las reglas y también la única versión de esto que sigue funcionando.

Fuentes (documentación de Google): Ayuda de Play Console — crear y configurar suscripciones, planes base, ofertas y elegibilidad, planes de prepago; Android Developers — integración de Play Billing, modos de reemplazo de suscripciones, verificación del lado del servidor, notificaciones de desarrollador en tiempo real.

¿Gestionas cuentas de desarrollador a escala? Nosotros nos encargamos de la parte operativa.

Haz clic para elegir un archivo · clic derecho → Pegar, o pulsa Ctrl/⌘+V para pegar una captura de pantalla

También puedes arrastrar un archivo a este cuadro.

Respondemos al correo que nos proporciones. Tus datos se quedan con KappS.

✔ Enviado

Hemos recibido tu mensaje y responderemos en un plazo de 24 horas.


← Volver a editar