Play Billing Lab es una app complementaria que te ayuda a probar las integraciones con el sistema de Facturación Google Play. Puedes usar las pruebas de versión preliminar de compras fuera de la app (OOAP) de Play Billing Lab para validar que tu backend esté configurado correctamente para controlar los elementos adquiridos fuera de tu app, incluidas las recompensas de Play Juegos.
Con la función de versión preliminar de OOAP, puedes seleccionar un producto o una oferta específicos para mostrarlos en plataformas fuera de la app, como la página de detalles de la app en Google Play, y verificar el flujo de adquisición y entrega de derechos de extremo a extremo.
Requisitos previos
Antes de usar Play Billing Lab para probar los flujos de compras fuera de la app (OOAP) y validar tu configuración de Recompensas de Play Games, asegúrate de cumplir con los siguientes requisitos:
- Inscríbete en el programa de acceso anticipado de recompensas de Play Juegos.
Estado de verificador con licencia: Tu cuenta de prueba debe estar registrada como verificador con licencia para el juego. Para obtener más detalles, consulta la documentación sobre verificadores con licencia de Google Play.
Nota: Si bien cualquier usuario puede ver la app de Play Billing Lab, solo los verificadores con licencia de los desarrolladores del EAP que se encuentran en la lista de entidades permitidas pueden configurar y activar las anulaciones de OOAP.
Coherencia de la cuenta en todas las plataformas: Debes acceder a Play Billing Lab y a Google Play Store con la misma cuenta de verificador con licencia. Si hay una discrepancia en la cuenta, es posible que Play Store no muestre el producto o la oferta de prueba anulados, o que no complete la compra de prueba.
Descargar e instalar
Puedes descargar e instalar Play Billing Lab desde Google Play:
- Google Play Store (Android): App de Play Billing Lab
- Canal de pruebas web: Aceptación de la Web de Play Billing Lab. Para usar este canal, sigue estos pasos:_userEnglish: Web testing track:Play Billing Lab web opt-in. Para usar este canal, sigue estos pasos:_userEnglish: Web testing track:Play Billing Lab web opt-in. Para usar este canal, sigue estos pasos:_userEnglish: Web testing track:Play Billing Lab web opt-in. Para usar este canal, sigue estos pasos:_userEnglish: Web testing track:Play Billing Lab web opt-in. Para usar este canal, sigue estos pasos:_userEnglish: Web testing track:Play Billing Lab web opt-in. Para usar este canal, sigue estos pasos:_userEnglish:
Guía paso a paso para la integración y las pruebas del EAP
En los siguientes pasos, se detalla cómo integrar y probar las recompensas de Play Juegos con Play Billing Lab.
Paso 1: Inicia Play Billing Lab y accede
Cuando abras Play Billing Lab por primera vez después de la instalación, ocurrirá lo siguiente:
- Presiona Acceder con Google.
- Selecciona la Cuenta de Google registrada como verificador con licencia para tu app.
- Después de acceder, verás el Panel principal.
Paso 2: Navega a las pruebas de compras fuera de la app (OOAP)
- En el Panel, busca la tarjeta Compras fuera de la app.
- Presiona Probar para abrir la pantalla de configuración de OOAP.
Paso 3: Especifica el nombre del paquete de la app y el ID del producto
En la pantalla de configuración de OOAP, ingresa los identificadores de la app requeridos:
- Nombre del paquete: Es el nombre exacto del paquete de Android de tu app (por ejemplo,
com.example.app). - Tipo de producto: Usa el menú desplegable para seleccionar Producto único (elemento integrado en la app) o Suscripción.
- ID del producto (SKU): Es el ID del producto o la suscripción integrados en la aplicación que quieres probar.
Paso 4: Selecciona una oferta apta
Después de ingresar el nombre del paquete, el ID del producto y el tipo de producto, Play Billing Lab consulta el backend y muestra una lista de las ofertas disponibles para ese producto.
En el caso de los productos únicos, selecciona la opción de compra o la oferta correspondiente.
Selecciona una oferta apta.
Paso 5: Inicia la prueba de OOAP
Después de seleccionar la oferta, presiona Iniciar prueba. La configuración se guarda y se sincroniza con los servidores de backend de Google Play.
Después de la activación, el panel muestra una insignia Activa en la tarjeta Compras fuera de la app, que indica el nombre del paquete configurado, el ID del producto (SKU) y la duración restante.
- Período de prueba: Las configuraciones de prueba de OOAP activas permanecen activas durante 2 horas de forma predeterminada antes de vencer automáticamente.
Anulación del backend: Mientras está activa, la configuración se muestra como la prioridad más alta en las distintas plataformas de OOAP (como la página de detalles de la app en Play Store).
Inicia la prueba de OOAP.
Paso 6: Prueba el flujo de adquisición de extremo a extremo para las ofertas fuera de la app
Mientras la prueba de OOAP esté activa en Play Billing Lab, abre la app de Google Play Store con la misma cuenta de verificador con licencia:
- Borra la caché de Google Play Store:
- Abre la aplicación Configuración en el dispositivo.
- Presiona Apps > Google Play Store.
- Presiona Almacenamiento y caché y, luego, Borrar caché y Liberar espacio de almacenamiento.
- Abre la app de Google Play Store.
- Navega a la página de detalles de la app.
Completa la compra de prueba (superposición de Play Express): Presiona la tarjeta del elemento. La hoja inferior nativa de la confirmación de compra rápida de Google Play se superpone en Play Store.
- Revisa el precio, el instrumento de pago (instrumento de prueba para verificadores con licencia) y los detalles de la oferta.
- Presiona Comprar con 1 toque para completar la transacción.
Prueba el flujo de adquisición de extremo a extremo. Verifica la integración del backend:
- Después de una compra exitosa, verifica que Google Play envíe una notificación para desarrolladores en tiempo real (RTDN) a tu servidor de backend.
- Nota: Las recompensas también envían una RTDN.
- Verifica que tu servidor llame a la API de Google Play Developer para confirmar la compra y otorgar el derecho al usuario.
- Verifica el historial de compras del usuario en la app de Play Store para confirmar que se haya registrado el pedido de prueba.
- Después de una compra exitosa, verifica que Google Play envíe una notificación para desarrolladores en tiempo real (RTDN) a tu servidor de backend.
Paso 7: Detén y borra la prueba de OOAP
Cuando termines de realizar las pruebas, haz lo siguiente:
- Ve a la página Compras fuera de la app.
- Presiona Borrar prueba para detener la prueba de OOAP y borrar su configuración.
Modifica las configuraciones de prueba
No puedes cambiar el nombre del paquete, el ID del producto, la selección de la oferta ni la anulación del país de Play Store mientras se ejecuta activamente una prueba de vista previa de OOAP.
Para ello, se debe detener y borrar la prueba de OOAP actual.
Cómo editar el producto o la oferta
Si actualmente estás ejecutando una prueba de OOAP y quieres probar un producto o una oferta diferentes, sigue estos pasos:
- Abre Play Billing Lab y presiona Ver en la tarjeta activa Compras fuera de la app.
- Presiona Editar para modificar el nombre del paquete, el ID del producto o la oferta de prueba.
- Confirma la opción Detener prueba cuando se te solicite. Se detendrá la prueba y se borrarán todas las entradas pertinentes.
- Ingresa tu producto nuevo o selecciona la oferta nueva, y reinicia la prueba.
Cómo probar los precios localizados con anulaciones por país
Play Billing Lab te permite anular el país de Google Play Store para probar los precios regionales y el formato de la moneda. Sin embargo, los cambios de país deben sincronizarse de forma limpia con las pruebas de OOAP:
Detén la prueba activa de OOAP: Si intentas editar la anulación de país mientras una prueba de OOAP está activa, ya sea desde el panel o la página de compras fuera de la app, Play Billing Lab mostrará una advertencia que te solicitará que primero detengas la prueba. Si confirmas la acción presionando Detener prueba, se detendrá la prueba de OOAP actual y se borrarán las entradas de prueba.
Establecer la anulación de país: Después de detener la prueba de OOAP, puedes editar el parámetro de configuración de país en la página Parámetros de configuración. Selecciona el país objetivo (por ejemplo, Japón o Reino Unido) y presiona Aplicar.
Reinicia la prueba de OOAP: Una vez que se active la anulación del país, regresa a la tarjeta Compras fuera de la app, selecciona tu producto y oferta, y presiona Iniciar prueba.
En el panel, ahora se mostrarán una anulación de país activa y una prueba de OOAP activa.
Verifica el precio localizado en Play Store: Abre Play Store y visita la página de detalles de tu app. La tarjeta de la IU que aparece y la hoja inferior de Play Express ahora mostrarán el precio del producto con el formato de la moneda local del país que anulaste.
Solución de problemas y preguntas frecuentes
¿Por qué no aparece la oferta de prueba que configuré en la página de detalles de la app en Play Store?
- Coherencia de la cuenta: Verifica que la cuenta con la que accediste a la app de Play Store sea exactamente la misma con la que accediste a Play Billing Lab.
- Lista de entidades permitidas del EAP y estado de verificador con licencia: Verifica que tu cuenta de desarrollador esté incluida en la lista de entidades permitidas para el EAP de la versión preliminar de OOAP de Play Billing Lab y que tu cuenta aparezca como verificador con licencia activo en Play Console.
- Vencimiento: Las pruebas de OOAP activas vencen después de 2 horas. Abre Play Billing Lab para verificar si la etiqueta de prueba cambió a Vencida. Si es así, inicia una prueba nueva.
¿Por qué no puedo seleccionar ni ver ninguna oferta cuando configuro un producto en Play Billing Lab?
- Elegibilidad de la oferta: Play Billing Lab solo muestra las ofertas que tu cuenta de verificador específica puede comprar en este momento.
¿Por qué falló mi compra de prueba en la superposición de Play Express?
- Asegúrate de que tu dispositivo de prueba ejecute Android 12 (nivel de API 31) o una versión posterior, y de que tenga instalada la versión más reciente de Google Play Store.
- Verifica el webhook de RTDN del backend de tu app y la integración de la API. Cuando realizas pruebas a través de Play Store, las compras se realizan fuera de la IU estándar de tu app. Tu servidor de backend debe recibir de forma confiable los mensajes de RTDN de Google Play y confirmar las compras de forma asíncrona.
¿Cómo detengo o borro una prueba activa antes de que venza el temporizador de 2 horas?
- Abre Play Billing Lab, busca la tarjeta activa (Compras fuera de la app o Parámetros de configuración) y presiona Detener o Borrar. Cuando se te solicite, confirma tu elección. La anulación se quita de inmediato de los servidores de Google Play.