Samsung IAP (In-App Purchase) es la herramienta perfecta para aumentar tus ingresos y ofrecer experiencias de juego excepcionales a través de su integración en Unreal Engine 5. Ofrece a tus usuarios productos digitales dentro de tus aplicaciones o juegos, como monedas virtuales, artículos premium, suscripciones o funciones desbloqueables mediante diversos métodos de pago disponibles en Samsung Galaxy Store (tarjetas de crédito, PayPal, Samsung Pay o facturación directa del operador).

Asimismo, Unreal Engine 5, la última versión del popular motor de juegos de Epic Games, complementa esta potente herramienta al proporcionar un rendimiento y calidad gráfica sin igual. Ofrece herramientas innovadoras que permiten crear mundos virtuales realistas y envolventes, lo que sin duda contribuirá a la satisfacción de tus usuarios y al éxito de tus proyectos de desarrollo de juegos.

¿Listo para aprender a integrar Samsung IAP en Unreal Engine 5 y empezar a monetizar tu creatividad? ¡Sigue estos pasos!

1. Regístrate como desarrollador de Samsung y configura tu proyecto

Para comenzar, necesitas tener una cuenta de desarrollador de Samsung para poder registrar tu aplicación o juego en la Samsung Galaxy Store y obtener una clave de API para verificar las transacciones y garantizar la seguridad.

Una vez hecho eso, es importante configurar tu proyecto de juego de Unreal Engine para descargar e instalar el plugin de Samsung IAP. Para ello, en la configuración global tienes que verificar que hayas definido la versión del SDK de destino, la versión mínima del SDK, la ubicación del SDK de Android, la ubicación del NDK de Android, la ubicación de Java, el nivel de API del SDK y el nivel de API del NDK para tu proyecto.

Abre un proyecto existente de Unreal Engine o crea un proyecto nuevo. Ve a Editar > Configuración del proyecto > Plataformas > Android y establece las siguientes propiedades:

• Nombre del paquete de Android: Define el nombre del paquete para tu proyecto.
• Versión mínima del SDK: La versión debe ser 26 o superior.
• Versión del SDK de destino: La versión debe ser 32 o superior.
• Agrupar los datos del juego dentro del APK: Marca la casilla. Esto es necesario porque el Samsung Galaxy Store Seller Portal solo admite la carga de archivos APK individuales.

2. Descarga e instala el plugin de Samsung IAP para Unreal Engine 5

El plugin de Samsung IAP para Unreal Engine 5 es un complemento esencial que facilita la integración de Samsung IAP en tus proyectos. Este plugin ofrece una interfaz simple y consistente para acceder a las funciones de Samsung IAP, como iniciar compras, consultar productos disponibles, verificar recibos y restaurar compras. También maneja cualquier error o excepción que puedas encontrar durante el proceso de compra.

Para poder instalarlo tienes que extraer el contenido del archivo descargado en una carpeta vacía dentro de la carpeta Plugins* de tu directorio de proyecto. Si la carpeta <carpeta del proyecto>/Plugins/ no existe, debes crearla.

En la <carpeta del proyecto>/Source/<Nombre del Proyecto>/, abre el archivo <nombre del proyecto>.build.cs.

Para agregar el complemento Samsung IAP a las dependencias del proyecto, en la sección PublicDependencyModuleNames.AddRange(), agrega SamsungIAP a la lista:

Para habilitar el complemento dentro de Unreal Engine, vuelve a iniciar Unreal Engine. Ve a Editar > Complementos > Instalados > Servicio y marca la casilla junto a "Complemento Samsung IAP".

Vuelve a iniciar Unreal Engine para asegurarte de que el complemento esté habilitado y listo para usar en tu proyecto.

Después, antes de que las funcionalidades de Samsung IAP se puedan integrar, debes registrar el juego y sus objetos de compra integrada (IAP) en el Samsung Galaxy Store Seller Portal de la siguiente manera:

1. En Unreal Engine, ve a Editar > Configuración del proyecto > Plataformas > Android y asegúrate de haber definido el Nombre del paquete de Android para el proyecto y de que la opción "Empaquetar datos del juego dentro del .apk" esté habilitada.
2. Para generar el archivo .APK, en la barra de herramientas de Unreal Engine, selecciona Plataformas > Android > Empaquetar Proyecto.
3. Registra tu aplicación de juego en el Samsung Galaxy Store Seller Portal, completando la información requerida.
4. En la pestaña Binary del Seller Portal, carga el archivo APK de tu juego.
5. Para habilitar las pruebas de las funcionalidades de IAP mientras desarrollas el juego, crea una prueba beta cerrada. En la pestaña Binary, selecciona Add Beta Test y registra a los que lo vayan a probar y el canal de feedback para la prueba beta cerrada.
6. En la pestaña Compra en la aplicación, crea tus objetos de compra integrada (IAP) y actívalos.
7. Para guardar los detalles de tu juego y los objetos de compra integrada (IAP), selecciona Guardar.

3. Configura el plugin de Samsung IAP para Unreal Engine 5

Una vez que tengas el plugin instalado, configúralo para que funcione a la perfección con tu aplicación o juego en Samsung Galaxy Store. Especifica el ID de la aplicación, la clave de API y los IDs de los productos que deseas ofrecer en tu juego. Todos estos detalles se encuentran en el panel de control del desarrollador de Samsung.

4. Implementa la lógica de juego para compras en juegos

Con el plugin de Samsung IAP configurado, es hora de implementar la lógica de juego para compras en juegos. Esto implica la creación de elementos de interfaz de usuario que permitan a los jugadores acceder a la tienda del juego, ver los productos disponibles y sus precios, iniciar compras y mostrar los resultados. También debes asegurarte de que se pueda restaurar compras anteriores en caso de que un usuario reinstale el juego o cambie de dispositivo.

Para esta etapa, puedes utilizar el sistema de Blueprints o el lenguaje C++ de Unreal Engine 5. El plugin de Samsung IAP ofrece una serie de nodos y funciones que puedes llamar desde los Blueprints o el código C++ para interactuar con Samsung IAP. Estos nodos o funciones incluyen:

• Initialize IAP: Activa el plugin y verifica si el dispositivo es compatible con Samsung IAP.
• Get Product List: Obtiene la lista de productos disponibles y sus detalles desde Samsung Galaxy Store.
• Start Purchase: Inicia la compra del producto seleccionado por el usuario y muestra la pantalla de pago.
• Get Purchase Result: Obtiene el resultado de la compra y verifica si fue exitosa o no.
• Consume Purchase: Consume el producto comprado para que pueda ser comprado nuevamente.
• Get Owned Product List: Obtiene la lista de productos que el usuario ha comprado previamente y que no han sido consumidos.
• Restore Purchase: Restaura las compras anteriores del usuario y las otorga en el juego.

5. Prueba y publica tu juego con Samsung IAP

Finalmente, asegúrate de probar tu juego utilizando el modo de prueba de Samsung IAP, que te permite simular compras sin realizar cargos reales. Cuando estés satisfecho con el resultado podrás publicar tu juego subiendo el archivo APK al panel de control del desarrollador de Samsung, enviándolo para su revisión. Una vez aprobado, tu juego estará disponible para su descarga en la Samsung Galaxy Store.

Beneficios de la Integración de Samsung IAP

• Monetización: Los desarrolladores pueden potenciar sus ingresos ofreciendo compras dentro de la aplicación. Esto se convierte en una herramienta valiosa, especialmente para aplicaciones freemium o aquellas que ofrecen contenido premium.
• Experiencia del Usuario: Los usuarios pueden realizar compras sin abandonar la aplicación, lo que no solo agiliza el proceso, sino que también aumenta la satisfacción y las conversiones.
• Seguridad y Confianza: Samsung IAP garantiza que todas las transacciones sean seguras y cumplan con las regulaciones de privacidad y seguridad, brindando tranquilidad tanto a los desarrolladores como a los usuarios finales.

Con Samsung IAP y Unreal Engine 5, estás listo para monetizar tu creatividad y ofrecer a los jugadores una experiencia de juego excepcional.

Samsung Dev Spain es la comunidad oficial de Samsung para desarrolladores españoles. Si te das de alta, puedes conseguir entrar en nuestro programa de préstamos - y conseguir dispositivos para desarrollar apps para nuestro ecosistema -, acceder a material gratuito como la Guía de optimización de apps para foldables, participar en promociones como dispositivos por apps o acudir gratis a eventos formativos como Samsung Dev Day o disfrutar de ventajas exclusivas en Samsung PLUS.