Detecta y entrega elementos únicos

En este documento, se describe la detección y entrega de productos únicos en 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 único 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.	2. Haga clic en la pestaña Usar para ver los elementos.	3. Selecciona un elemento y haz clic en Usar puntos para completar la compra.	4. 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 único, debes crear el producto y las promociones de Puntos de Play.

Requisitos de la entrega

Cuando entregas productos únicos en tu juego mediante una promoción de Play Points, debes cumplir con los requisitos que se mencionan esta sección.

Tiempo de entrega

Cuando un jugador intercambia Puntos de Play por un producto único, 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 único 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 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, 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 Detecta y procesa compras para detectar los productos únicos 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: get en tu servidor, verifica si necesitas procesar por separado los elementos de intercambio de recompensas de Play y otros productos únicos según los valores de productId.

• Si usas Onetimeproducts: list en tu servidor, verifica si necesitas separar los elementos de intercambio de recompensas de Play de otros productos únicos mediante valores productId.

• Revisa las siguientes prácticas recomendadas para verificar si necesitas hacer cambios adicionales:

  • Referencia:
    • Cómo combatir los casos de fraude y abuso.
    • Prácticas recomendadas para identificadores únicos.
  • Implementa la verificación de firma del servidor.
  • Asegúrate de que los valores purchaseToken y orderId sean ú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.