En este documento, se describe la detección y entrega de productos integrados en la aplicación de tu juego una vez que los jugadores los compren con Puntos de Play en la app de Google Play.
Cuando los usuarios canjean sus Puntos de Play por un producto integrado en la aplicación en la app de Google Play, los elementos deben entregarse de inmediato en tu juego. A continuación, se muestran los pasos para comprar elementos con Puntos de Play.
| 1. Haz clic en Puntos de Play. | 1. Haga clic en la pestaña Usar para ver los elementos. | 2. Selecciona un elemento y haz clic en Usar puntos para completar la compra. | 3. Recibe el elemento. |
|
|
|
|
En el ejemplo, el juego no se ejecuta mientras se compra el producto. Los usuarios también pueden intercambiar Puntos de Play por productos cuando el juego no está instalado en su dispositivo. Por lo tanto, debes diseñar tu juego para manejar la entrega de elementos integrados en la app desde fuera de la tienda del juego.
Antes de comenzar
Antes de detectar y entregar un producto integrado en la aplicación, debes crear el producto y las promociones de Puntos de Play.
Requisitos de la entrega
Cuando entregas productos integrados en la aplicación en tu juego mediante una promoción de Puntos de Play, debes cumplir con los requisitos que se mencionan esta sección.
Tiempo de entrega
Cuando un jugador intercambia Puntos de Play por un producto integrado en la aplicación, usa la Biblioteca de Facturación Google Play para entregar el elemento de manera oportuna.
Mensaje de entrega
Cuando el usuario regrese a tu juego después de haber comprado un producto integrado en la aplicación fuera de él, debes mostrar una confirmación de que el producto se canjeó correctamente dentro del juego. El mensaje debe aparecer como un diálogo emergente o un mensaje integrado en el juego. Los usuarios no deberían tener que realizar ningún paso adicional para recibir el elemento.
Este es el formato de mensajería requerido:
Un mensaje claro que indique que se recibió el elemento.
Menciona el nombre del elemento con claridad y haz referencia a los "Puntos de Play" para asegurarte de que los usuarios puedan distinguirlo de otro contenido que reciban.
Si existen elementos similares con varias denominaciones, el nombre del elemento también debe incluir la denominación correcta del elemento.
El usuario debería poder ver el diálogo emergente, el mensaje o la notificación dentro del juego hasta que haga clic en una confirmación, como Continuar o Aceptar. No debe haber un botón de cancelación, ya que este mensaje solo tiene como objetivo notificar a los usuarios sobre el elemento que recibieron en el juego. Si no hay un botón de confirmación, el mensaje debe ser visible para los usuarios durante al menos 3 segundos antes de desaparecer para garantizar que sepan que recibieron su elemento.
El siguiente es un ejemplo de mensaje:
"Elemento recibido. Acabas de recibir 100 gemas con Puntos de Play. Continúa."
Los usuarios deberían ver una animación o confirmación visual que muestre el aumento en el saldo de la moneda del juego. Si el elemento es uno integrado en la app duradero o consumible, se debe dirigir a los usuarios a la ubicación en la que se desbloqueó o está disponible dentro del juego.
Detecta los elementos que se recibieron fuera del juego
Si tu juego usa el sistema de facturación de Google Play, consulta Cómo detectar y procesar compras para detectar los productos integrados en la aplicación que se reciben fuera del juego.
Muestra una confirmación de entrega
Cuando los usuarios canjean Puntos de Play y reciben un elemento de intercambio, esperan que el juego muestre un mensaje dentro del juego o use algún tipo de notificación para informarles que el juego recibió y procesó correctamente el elemento. Consulta Notifica al usuario para confirmar la compra exitosa.
Actualizaciones para motores de juegos específicos
Estas son algunas consideraciones que debes tener en cuenta para los motores de juegos específicos:
Si tu juego se compiló con Unity, te recomendamos verificar si la implementación de CDA que estás usando ya admite promociones de Puntos de Play.
Si tu juego se compiló con Cocos2d-x o Unreal Engine (C/C++), es probable que debas escribir el código JNI que llama a las API de Java desde tu código C/C++.
Prácticas recomendadas del servidor
Esta sección contiene prácticas recomendadas del servidor que puedes usar para las promociones de Puntos de Play:
Si llamas a
Purchases.products: geten tu servidor, verifica si necesitas procesar por separado los elementos de intercambio de recompensas de Play y otros productos integrados en la aplicación según los valores deproductId.Si usas
Inappproducts: listen tu servidor, verifica si necesitas separar los elementos de intercambio de recompensas de Play de otros productos integrados en la aplicación mediante valoresproductId.Revisa las siguientes prácticas recomendadas para verificar si necesitas hacer cambios adicionales:
- Referencia:
- Implementa la verificación de firma del servidor.
- Asegúrate de que los valores
purchaseTokenyorderIdsean únicos y no se hayan usado antes.
Solución de problemas
En esta sección, se incluyen recomendaciones para situaciones que pueden generar consultas de los clientes.
Múltiples cuentas de usuario
Si un usuario tiene varias Cuentas de Google en su dispositivo y canjea Puntos de Play en la cuenta incorrecta, Google no puede transferir los elementos a esas otras cuentas. Del mismo modo, tu app no puede transferir el elemento mediante una llamada al método getPurchases(). En esta situación, considera proporcionar los elementos integrados en la app de forma manual al usuario mediante tus operaciones de asistencia al cliente.
Faltan elementos o hay elementos retrasados
Si los jugadores notan que faltan elementos o que hay elementos retrasados, consulta la guía de solución de problemas para compras directas desde la aplicación en la documentación de ayuda de Google Play.