Crea un producto administrado

Con Google Play Billing, puedes ofrecer productos integrados en la aplicación por los que los usuarios deban pagar una sola vez. Estos se conocen como productos administrados y pueden incluir elementos, como bienes virtuales (por ejemplo, niveles de juegos o pociones) y servicios premium, dentro de tu app en Google Play.

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

Disponibilidad

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

Si estás en una ubicación admitida y quieres comenzar a usar las funciones de Google Play Billing en tus apps, configura un perfil de pagos y revisa la documentación de la API de Google Play Billing.

Después de crear un producto administrado, 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 administrado, debes declarar el permiso com.android.vending.BILLING en el archivo de manifiesto del APK de tu app. Si distribuyes tu app a nivel mundial, puedes publicar apps que usen el permiso com.android.vending.BILLING en todos los países.

Crea productos administrados

Cómo crear un solo producto administrado

Antes de crear un producto administrado, asegúrate de planificar los ID del producto con cuidado. Los ID del producto deben ser únicos para tu app y, una vez creados, no se pueden cambiar ni volver a usar.
  • Los ID del producto deben comenzar con una letra minúscula o un número, y deben estar compuestos de letras minúsculas (a-z), números (0-9), guiones bajos (_) y puntos (.) únicamente.
  • Nota: El ID del producto android.test no se encuentra disponible, al igual que todos los ID del producto que comienzan con android.test.

Para crear un producto administrado, sigue estos pasos:

  1. Accede a tu cuenta de Play Console.
  2. Selecciona una app.
  3. En el menú de la izquierda, haz clic en Presencia en Google Play Store > Productos integrados en la aplicación.
  4. Cerca del lado derecho de la pantalla, haz clic en Crear producto administrado.
  5. Ingresa los detalles del producto.
    • Título: Un nombre corto para el elemento (tiene un límite de 55 caracteres, pero se recomienda no superar los 25 a fin de que se muestre correctamente en todos los contextos), como "Poción para dormir".
    • Descripción: Una descripción larga del elemento (hasta 80 caracteres), como "Las criaturas se dormirán instantáneamente".
    • Precio: Ingresa un precio en la moneda local de tu país o selecciona una plantilla de precios.
  6. Junto a "Estado", selecciona Activo o Inactivo.
    • Para que un producto esté disponible para la compra, debe estar activo y su app debe estar publicada.
    • Si estás usando una cuenta de prueba, los elementos activos están disponibles en las apps no publicadas. Para obtener más información, visita nuestro sitio para desarrolladores de Android.
  7. Haz clic en Guardar.

Idiomas y traducciones

Los productos administrados usan el mismo idioma predeterminado que la app a la que pertenecen. Para agregar traducciones a idiomas específicos, selecciona un producto administrado y haz clic en Agregar traduccionesObtén más información sobre cómo traducir tu app.

Cómo crear un lote de varios productos administrados

Para crear varios productos administrados 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 administrados, debes especificar la sintaxis CSV en la primera fila, seguida de los detalles de los productos en las filas siguientes.
Importante: Cada elemento debe aparecer exclusivamente en una sola línea dentro del archivo CSV.

Cómo subir un archivo CSV de productos administrados

  1. Accede a tu cuenta de Play Console.
  2. Selecciona una app.
  3. En el menú de la izquierda, haz clic en Presencia en Google Play Store > Productos integrados en la aplicación.
  4. En la pestaña "Productos administrados", haz clic en Importar/Exportar > Importar productos administrados desde archivo CSV.
    • Para reemplazar productos administrados existentes en la lista de productos, selecciona la casilla de verificación Sobreescribir los productos actuales. Se reemplazarán los productos existentes únicamente si el valor de un ID del producto en el archivo CSV coincide con el ID del producto de un producto administrado existente en la lista. Cuando se reemplaza un producto, no se borran los productos administrados que no están incluidos en el archivo CSV.
  5. Haz clic en Examinar archivos y, luego, selecciona tu archivo CSV.

Cómo exportar un archivo CSV de productos administrados existentes

Si antes creabas los productos administrados de a uno por vez en Play Console, exportar un archivo CSV puede ser una buena forma de comenzar a crearlos a través de un archivo CSV.

  1. Accede a tu cuenta de Play Console.
  2. Selecciona una app.
  3. En el menú de la izquierda, haz clic en Presencia en Google Play Store > Productos integrados en la aplicación.
  4. En la pestaña "Productos administrados", haz clic en Importar/Exportar > Exportar productos integrados en la aplicación a un archivo CSV.

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 administrados:
  • 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 las tasas 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 administrados

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 administrados 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 producto administrado nuevo.

Si especificas un valor para Product ID asignado a un producto administrado que ya existe en una lista de productos y marcaste la casilla de verificación Sobreescribir los productos actuales en el diálogo "Importar productos integrados en la aplicación", los datos del producto administrado existente se reemplazan 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 administrado 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 administrados.

Si quieres proporcionar traducciones del título y la descripción de un producto administrado, especifícalas explícitamente dentro del valor de 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 al agregar traducciones de tu ficha de Play Store.

Nota: Cuando especifiques los valores de Title y Description, usa barras diagonales inversas para establecer un escape en los caracteres de punto y coma (\;) y barra diagonal 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 administrado 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 administrado tiene su propia lista de traducciones. Aunque el primer idioma del valor de Locale de un 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 en true o false. Si un producto administrado usa una plantilla de precios, debes configurar Auto Fill Prices en 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 de 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 el significado de los valores de Country y Price.

Si configuras Auto Fill Prices en 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 administrado es de USD 1.99.
  • Quieres que se completen automáticamente 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 de la siguiente manera: true,1990000,

Cómo configurar tu propio precio por país  

Si, en cambio, configuras Auto Fill Prices en 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 precio para cada país hacia el que está orientada tu app. Para ver y editar la lista de países hacia los que está orientada tu app, abre la página Precios y distribución correspondiente.

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:

  • BR 6.99 en Brasil 
  • RU 129 en Rusia
  • IN 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 en false, y no debes establecer un valor para la columna de Price. Si el elemento no está vinculado a una plantilla de precios, no debes configurar un valor para Pricing Template ID. En cambio, debes establecer los valores de Auto Fill Prices, Country y Price en función de cómo quieres configurar los precios del producto administrado.

Si importas un archivo CSV y marcaste la casilla de verificación Sobreescribir los productos actuales en el diálogo "Importar productos integrados en la aplicación", puedes actualizar los vínculos entre los productos administrados y las plantillas de precios. Para vincular el producto a una plantilla de precios específica, configura el valor de Pricing Template ID con su ID. Para desvincular un producto administrado de todas las plantillas de precios, no configures un valor para Pricing Template ID.

Puedes vincular hasta 1,000 precios de la app o de productos administrados 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.

¿Te resultó útil este artículo?
¿Cómo podemos mejorarla?