Crea un producto integrado en la aplicación

Con el sistema de facturación de Google Play, puedes ofrecer productos integrados en la aplicación por los que los usuarios deban pagar una sola vez. Los productos integrados en la aplicación pueden incluir elementos como artículos virtuales (por ejemplo, partes o niveles de juegos) y servicios premium dentro de la app en Google Play.

También puedes crear una suscripción, que les cobra a los usuarios de forma periódica.

Importante: Las Políticas del programa para desarrolladores de Google Play y los cargos del servicio se aplican a todos los productos integrados en la aplicación, entre los que se incluyen las suscripciones y los productos únicos.

Disponibilidad

Si estás en una ubicación que admite el registro de comercios, puedes usar el sistema de facturación de Google Play.

Si estás en una ubicación admitida y quieres comenzar a usar las funciones del sistema de facturación de Google Play en tus apps, configura un perfil de pagos y visita el sitio de Android Developers para obtener información sobre cómo configurar el sistema de facturación de Google Play.

Para que un producto integrado en la aplicación esté disponible para la compra, debe estar activo, y la app debe estar orientada al país o la región del usuario. Los productos integrados en la aplicación estarán disponibles para la compra mientras estén activos, incluso si la app no está publicada. Si no quieres que un producto integrado en la aplicación esté disponible, debes desactivarlo.

Si usas una cuenta de prueba, ve al sitio de Android Developers y obtén más información para probar la integración de la Biblioteca de Facturación Google Play.

Una vez que hayas creado un producto integrado en la aplicación, este se encontrará disponible para los usuarios que ejecuten la versión más reciente de Google Play Store.

Permisos necesarios

Para ofrecer un producto integrado en la aplicación, debes declarar el permiso com.android.vending.BILLING en el archivo de manifiesto del APK de la app. Si distribuyes tu app a nivel mundial, también puedes publicar apps que usen el permiso com.android.vending.BILLING en todos los países.

Crea productos integrados en la aplicación

Crea un producto único integrado en la aplicación

Antes de crear un producto, asegúrate de planificar los IDs del producto con cuidado. Los IDs del producto deben ser únicos para tu app y, una vez que se crean, no se pueden cambiar ni volver a usar.

• Deben comenzar con un número o una letra minúscula, y pueden contener números (0-9), letras minúsculas (a-z), guiones bajos (_) y puntos (.).
• Una vez que se cree el producto, no podrás cambiar ni volver a usar su ID.
• Nota: El ID de producto android.test no se encuentra disponible, al igual que todos los IDs de producto que comienzan con android.test.

Para crear un producto integrado en la aplicación, sigue estos pasos:

1. Abre Play Console.
2. Ve a la página Productos integrados en la aplicación (Monetización > Productos > Productos integrados en la aplicación).
3. Haz clic en Crear producto.
4. Ingresa los detalles del producto.
   • ID del producto: Es un ID único para tu producto integrado en la aplicación.
   • Título: Es un nombre corto para el elemento (tiene un límite de 55 caracteres, pero se recomienda no superar los 25 para que se muestre correctamente en todos los contextos), como "Poción para dormir".
   • Descripción: Es una descripción larga del elemento (hasta 200 caracteres), como "Las criaturas se dormirán al instante".
   • Ícono: Es una imagen única y precisa del producto. No incluyas texto, promociones ni elementos de la marca. El ícono del producto se muestra en tu ficha de Play Store y durante el flujo de compra.
     • PNG de 32 bits
     • 512 x 512 píxeles
     • Hasta 1 MB
   • Precio: Ingresa un precio en la moneda local de tu país o selecciona una plantilla de precios.
   • Varias cantidades: Permite la confirmación de la compra de varias cantidades de este producto. Los usuarios podrán realizar compras de múltiples cantidades dentro del umbral de su país o región. Ten en cuenta la siguiente información:
     • Para configurar la confirmación de la compra de varias cantidades en Play Console, tu app debe tener la Biblioteca de Facturación Google Play 4.0. Visita el sitio para desarrolladores de Android para obtener información sobre cómo integrar la Biblioteca de Facturación Google Play a tu app.
     • La confirmación de compras de varias cantidades no está disponible en algunos países o regiones.
     • En la mayoría de los países o regiones donde está disponible la confirmación de compras de varias cantidades, el umbral de precio del SKU es de alrededor de USD 100. Para permitir la confirmación de compras de varias cantidades, deberás ajustar el precio (sin impuestos) por debajo del umbral en cada país o región.
   • Exclusivo para Play Points: Haz que tu producto esté disponible únicamente en el programa Google Play Points.
5. Guarda los cambios y haz clic en Activar para que los productos integrados en la aplicación estén disponibles para los usuarios.

Idiomas y traducciones

Los productos integrados en la aplicación usan el mismo idioma predeterminado que la app a la que pertenecen. Para agregar traducciones en idiomas específicos, selecciona un producto integrado en la aplicación, haz clic en Administrar traducciones y aplica los idiomas que quieras. Si deseas obtener más información para brindar una experiencia localizada a los usuarios, lee el artículo Traduce y localiza tu app.

Cómo crear un lote de varios productos integrados en la aplicación

Para crear varios productos integrados en la aplicación a la vez, puedes subir un archivo CSV que incluya detalles de cada uno de ellos.

En los archivos CSV, se usan la coma (,) y el punto y coma (;) para separar los valores de datos. La coma separa los valores de datos primarios, y el punto y coma separa los valores secundarios.

Cuando creas un archivo CSV con productos integrados en la aplicación, debes especificar la sintaxis CSV en la primera fila, seguida de los detalles de los productos en las filas subsiguientes.

Importante: Cada elemento debe aparecer exclusivamente en una sola línea dentro del archivo CSV.

Cómo subir un archivo CSV de productos integrados en la aplicación

Para subir un archivo CSV, sigue estos pasos:

1. Abre Play Console.
2. Ve a la página Productos integrados en la aplicación (Monetización > Productos > Productos integrados en la aplicación).
3. Haz clic en Importar.
   • Si importas varios productos mediante la carga de un archivo CSV, se sobrescribirán los existentes solo si un valor de Product ID del archivo CSV coincide con uno de Product ID de un producto integrado en la aplicación existente en la lista correspondiente. Cuando se reemplaza un producto, no se borran los productos integrados en la aplicación que no se incluyen en el archivo CSV.
4. Suelta el archivo CSV que quieras subir o haz clic en Subir.

Cómo exportar un archivo CSV de productos integrados en la aplicación existentes

Para exportar un archivo CSV, sigue estos pasos:

1. Abre Play Console.
2. Ve a la página Productos integrados en la aplicación (Monetización > Productos > Productos integrados en la aplicación).
3. Haz clic en Exportar.

Cómo visualizar un ejemplo de un archivo CSV

Aquí se incluye un ejemplo de la sintaxis CSV que se debe usar y tres ejemplos de productos integrados en la aplicación:

• El primer ejemplo define un título y una descripción en dos idiomas diferentes (en_US y es_ES). El precio del elemento se define con una plantilla de precios.
• En el segundo ejemplo, no se usa una plantilla de precios. En su lugar, se especifica un precio para el país predeterminado (EE.UU.). Play Console usa los tipos de cambio actuales y patrones de precios relevantes a nivel local para establecer los precios automáticamente en todos los demás países donde se distribuye la app.
• En el tercer ejemplo, tampoco se usa una plantilla de precios. El precio del elemento se especifica manualmente para cada país donde se distribuye la app.

Ejemplo de sintaxis CSV

Product ID,Published State,Purchase Type,Auto Translate,Locale; Title; Description,Auto Fill Prices,Price,Pricing Template ID

Ejemplos de productos integrados en la aplicación

Ejemplo 1

basic_sleeping_potion,published,managed_by_android,false,en_US; Basic Sleeping Potion; Puts small creatures to sleep.; es_ES; Poción básica de dormir; Causa las criaturas pequeñas ir a dormir.,false,,4637138456024710495

Ejemplo 2

standard_sleeping_potion, published,managed_by_android,false,en_US; Standard Sleeping Potion; Puts all creatures to sleep for 2 minutes.,true, 1990000,

Ejemplo 3

invisibility_potion,published, managed_by_android,false,en_US; Invisibility Potion; Invisible to all enemies for 5 minutes.,false, US; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000,

Valores de datos para archivos CSV

Cada fila de un archivo CSV de productos integrados en la aplicación puede contener los siguientes valores, pero al menos uno de estos valores no está definido en cada fila:

Product ID	La configuración de este valor en el archivo CSV tiene el mismo efecto que ingresar un ID del producto cuando se crea un nuevo producto integrado en la aplicación. Si especificas un valor de Product ID asignado a un producto integrado en la aplicación que ya existe en una lista de productos, los datos del producto existente se reemplazarán por los valores especificados en el archivo CSV.
Publish State	Este valor se debe configurar como published o unpublished. Esto es igual que configurar un producto integrado en la aplicación como Activo o Inactivo.
Purchase Type	Este valor se debe configurar como managed_by_android.
Auto Translate	Este valor se debe configurar como false porque no se admite la traducción automática de los detalles de productos integrados en la aplicación. Si quieres proporcionar traducciones del título y la descripción de un producto integrado en la aplicación, especifica estas traducciones explícitamente dentro del valor Locale.
Locale, Title y Description	Si incluyes un solo idioma para un elemento, debes especificar el idioma predeterminado de tu app, así como el título y descripción predeterminados del elemento: app_default_locale; item_default_title; item_default_description; Cuando configuras el valor de Locale, puedes usar cualquiera de los códigos de idioma que aparecen cuando agregas traducciones de tu ficha de Play Store. Nota: Cuando especifiques los valores de Title y Description, usa barras inversas para establecer un escape en los caracteres de punto y coma (\;) y barra inversa (\\). Si quieres agregar versiones traducidas del título y la descripción del elemento, debes incluir el idioma, título y descripción predeterminados, seguidos de los idiomas, títulos y descripciones para cada traducción. En el siguiente ejemplo, el producto integrado en la aplicación usa en_US (inglés de Estados Unidos) como el idioma predeterminado y es_ES (español de España) como traducción: en_US; Invisibility Cloak; Makes you invisible.; es_ES; Capote Invisible; Se vuelven invisible. Nota: Las apps contienen un solo idioma predeterminado, pero cada producto integrado en la aplicación tiene su propia lista de traducciones. Aunque el primer idioma del valor de Locale de cada elemento debe ser igual en todo el archivo CSV, los demás idiomas pueden diferir entre los elementos.
Auto-fill Prices, Country y Price	Puedes configurar Auto-fill Prices como true o false. Si un producto integrado en la aplicación usa una plantilla de precios, debes configurar Auto-fill Prices como false y no debes establecer un valor para Price. Nota: Cuando especificas el precio de un elemento en un archivo CSV, debes proporcionarlo en microunidades, donde 1,000,000 microunidades equivalen a 1 unidad de moneda real. Cómo usar precios autocompletados En las siguientes secciones, se describe cómo afecta el valor de Auto-fill Prices a la sintaxis y al significado de los valores de Country y Price. Si configuras Auto-fill Prices como true, solo se especifica el precio predeterminado del elemento, y no se incluye un valor de Country. Por ejemplo, en las siguientes condiciones: El idioma predeterminado de tu app es en_US. El precio predeterminado sin impuestos de un producto integrado en la aplicación es de USD 1.99. Quieres que se autocompleten los precios de otros países. Debes configurar los valores de Auto-fill prices y Price al final de una fila en el archivo CSV con el formato true,1990000,. Cómo configurar tu propio precio por país Si, en cambio, configuras Auto-fill Prices como false, puedes especificar una serie de valores de Country y Price para todos los países en los que distribuyes tu app, incluido el país que corresponde al idioma predeterminado. Cada valor de Country es el código ISO de país conformado por dos letras mayúsculas que representa un país en el que se distribuye tu app. Nota: Debes proporcionar un código de país y un precio para cada país al que se oriente tu app. Para ver y editar la lista de países a los que se orienta la app, usa la pestaña Países o regiones de la página Producción. Cada valor de price representa el costo del elemento en microunidades de la moneda que se usa en ese país. Por ejemplo, si ofreces tu app con los siguientes precios (todos los impuestos incluidos) en otros países: BRL 6.99 en Brasil RUB 129 en Rusia IDR 130 en la India ID 27,000 en Indonesia MX 37 en México Puedes configurar los valores de Auto-fill Prices, Country y Price al final de una fila en el archivo CSV de la siguiente manera: false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;
Pricing Template ID	Si un elemento está vinculado a una plantilla de precios, debes configurar Auto-fill Prices como false y no debes establecer un valor para la columna Price. Si el elemento no está vinculado a una plantilla de precios, no debes configurar un valor para Pricing Template ID. En cambio, debes configurar Auto-fill Prices, Country y Price en función de la forma en que quieras definir los precios del producto integrado en la aplicación. Si importas un archivo CSV, puedes actualizar los vínculos entre los productos integrados en la aplicación y las plantillas de precios. Para vincular el producto a una plantilla de precios específica, configura el valor de Pricing Template ID con el ID de esa plantilla. Para desvincular un producto integrado en la aplicación de todas las plantillas de precios, no establezcas un valor para Pricing Template ID. Puedes vincular hasta 1,000 precios de la app o de productos integrados en la aplicación con una plantilla de precios en particular. Por lo tanto, no especifiques el mismo valor de Pricing Template ID en más de 1,000 filas de un archivo CSV.
EEA Withdrawal Right Type	Si distribuyes tu producto a usuarios del Espacio Económico Europeo (EEE), aquí debes establecer el valor para DIGITAL_CONTENT o SERVICE.
Reducción en las tasas de IVA	Los desarrolladores que venden noticias, revistas, periódicos, libros, videos, música, audios o audiolibros digitales en distintos países o regiones pueden ser aptos para obtener reducciones en las tasas de IVA. Para que se reduzcan las tasas, los valores de este campo deberán seguir el siguiente formato: CountryCode;VATRate; Cada par de país y tasa debe ir seguido de punto y coma antes de agregar un nuevo par de país y tasa. Por ejemplo: CA;BOOKS_1 establecería una tasa reducida para libros de nivel 1 en Canadá. FR; NEWS_1; GR; NEWS_2 establecería una tasa reducida para noticias de nivel 1 en Francia y para noticias de nivel 2 en Grecia. Los niveles se pueden configurar como BOOKS_1, NEWS_1, NEWS_2, MUSIC_OR_AUDIO_1, LIVE_OR_BROADCAST_1 (mayúsculas o minúsculas).
Communications and amusement taxes	Si deseas recaudar los impuestos estatales aplicables sobre comunicaciones y entretenimiento, debes especificar que tu app o producto es un producto de transmisión y establecer este campo como ELIGIBLE o, de lo contrario, dejarlo en blanco. Actualmente, el único país para el que se admite este tipo de impuestos es EE.UU. El valor de este campo siempre se establece como: CountryCode;Eligibility;Rate Por ejemplo: US;ELIGIBLE;VIDEO_RENTAL Si se admite, puedes configurar el campo según las siguientes categorías: VIDEO_RENTAL, para transmisión de video por Internet: suscripción, alquiler o pago por visualización VIDEO_SALES, para transmisión de video por Internet: ventas VIDEO_MULTI_CHANNEL para transmisión de video por Internet: multicanal AUDIO_RENTAL para reproducción de audio: suscripciones o alquiler AUDIO_SALES para reproducción de audio: ventas AUDIO_MULTI_CHANNEL para reproducción de audio: multicanal