Comandos de paywalls

Estos comandos de la CLI de Adapty gestionan los paywalls y los productos que vende cada paywall, y leen sus métricas.

adapty paywalls list

Lista todos los paywalls de una app.

adapty paywalls list --app <app-id>
FlagObligatorioDescripción
--appSíID de la app (UUID)

Acepta flags de paginación.

adapty paywalls get

Obtén los detalles de un paywall específico.

adapty paywalls get --app <app-id> <paywall-id>
ArgumentoDescripción
paywall-idID del paywall (UUID)
FlagObligatorioDescripción
--appSíID de la app (UUID)

adapty paywalls create

Crea un nuevo paywall.

adapty paywalls create --app <app-id> --title "Default Paywall" --products '[{"product_id":"<product-id-1>"},{"product_id":"<product-id-2>"}]'
IndicadorRequeridoDescripción
--appSíID de la app (UUID)
--titleSíTítulo del paywall
--productsSíArray JSON de los productos, en orden de visualización: [{product_id, offer_id, fallback_offer_id, billing_plan_id, flow_product_id}]. Solo se necesita product_id (ID del producto, UUID); las demás claves provienen de la lista de products que imprime paywalls get
--remote-configsNoArray JSON de entradas {locale, data}, donde data es el Remote Config como cadena JSON
--use-paywall-builder-v4NoSi el paywall utiliza el Paywall Builder
--screenshot-idNoID de imagen de la captura de pantalla del paywall (un entero), o null
--builder-screenshot-idNoID de imagen de la captura de pantalla del builder (un entero), o null
--web-purchase-urlNoURL de compra web, o null
--product-idNoObsoleto: usa --products. ID del producto (UUID), repetido por cada producto. Establece productos sin oferta ni plan de facturación y no puede usarse junto con --products

Un campo que omitas obtendrá el valor predeterminado del dashboard: sin Remote Configs, sin builder, sin capturas de pantalla y sin URL de compra web. Las opciones distintas de --app, --title y --product-id requieren la versión 0.20.0 o posterior de la CLI.

adapty paywalls update

Reemplaza todos los campos de un paywall existente.

Important

Una vez que un paywall está vinculado a un placement, sus productos no se pueden cambiar. Para usar productos diferentes en un paywall activo, crea un nuevo paywall y actualiza el placement para que apunte a él.

Para cambiar un solo campo, lee el paywall, edita ese campo en el archivo y envía el archivo completo de vuelta:

adapty paywalls get --app <app-id> <paywall-id> --json > paywall.json
adapty paywalls update --app <app-id> <paywall-id> --file paywall.json

El comando reemplaza todos los campos del paywall, incluida la lista completa de productos y la lista completa de Remote Configs. Todos los campos son obligatorios: si falta algún flag, el comando termina con el código 2, lista los flags que faltan y no envía ninguna solicitud. Requiere la versión 0.20.0 de la CLI o posterior: las versiones anteriores solo admiten --title y --product-id.

ArgumentoDescripción
paywall-idID del paywall (UUID)
IndicadorRequeridoDescripción
--appSíID de la app (UUID)
--fileEn lugar de los indicadores de campoRuta a un archivo JSON con el paywall completo, o - para leer desde stdin. El resultado de paywalls get --json funciona tal cual; su id se ignora. No puede usarse junto con ningún indicador de campo
--titleSin --fileTítulo del paywall
--productsSin --fileArray JSON de productos, como en paywalls create. Envía la lista que imprimió paywalls get para conservar las ofertas y los planes de facturación
--remote-configsSin --fileArray JSON de entradas {locale, data}, donde data es una cadena JSON. [] elimina todos los Remote Configs
--use-paywall-builder-v4 o --no-use-paywall-builder-v4Sin --fileSi el paywall usa el Paywall Builder. Envía el valor de paywalls get: --no-use-paywall-builder-v4 elimina el diseño del builder de los dispositivos
--screenshot-idSin --fileID de imagen de la captura de pantalla del paywall, o null
--builder-screenshot-idSin --fileID de imagen de la captura de pantalla del builder, o null
--web-purchase-urlSin --fileURL de compra web, o null
--product-idNoObsoleto: usa --products. Establece productos sin oferta y sin plan de facturación

adapty paywalls placements

Lista todos los placements que actualmente usan un paywall determinado.

adapty paywalls placements --app <app-id> <paywall-id>
ArgumentoDescripción
paywall-idID del paywall (UUID)
FlagRequeridoDescripción
--appSíID de la app (UUID)

Usa este comando antes de intercambiar un paywall para ver qué placements se verían afectados.

Los elementos de esta lista no incluyen el campo is_active. Para consultar el estado de activación de un placement, usa placements list o placements get.

Lista de métricas de paywalls de adapty

Muestra las métricas de por vida de varios paywalls, una línea por paywall. Estos son los datos de la tabla de paywalls del dashboard.

adapty paywalls metrics list --app <app-id> --ids <paywall-id>,<paywall-id>
FlagRequeridoDescripción
--appSíID de la app (UUID)
--idsSíIDs de los paywalls (UUIDs). Sepáralos con comas o repite el flag
--csvNoImprime CSV: una fila por paywall, con el ID del paywall y las métricas numéricas. No se puede usar junto con --json

Los comandos paywalls metrics leen los datos de la página métricas de paywall y requieren la versión 0.16.0 o posterior de la CLI.

Cada línea muestra el ID del paywall con sus vistas, compras, trials y revenue. --json incluye las 21 métricas completas, como unique_profiles_views, net_revenue y conversion_rate_purchases, además de last_purchases. --csv omite los dos campos que no son numéricos, in_current_state y last_purchases. Una métrica sin datos aparece como 0, nunca como null.

adapty paywalls metrics values

Lista las claves y valores de filtro de un paywall: lo que acepta paywalls metrics get --filter.

adapty paywalls metrics values --app <app-id> <paywall-id>
ArgumentoDescripción
paywall-idID del paywall (UUID)
FlagObligatorioDescripción
--appSíID de la app (UUID)

La salida tiene el mismo formato que flows metrics values: el valor superior de cada grupo es la clave de filtro, y los valores más internos son los que acepta dicha clave.

adapty paywalls metrics get

Muestra las métricas de un paywall para un período, como el árbol de la página de métricas de paywall.

adapty paywalls metrics get --app <app-id> <paywall-id> --date-from 2026-09-01 --date-to 2026-10-21 --date-type purchase_date --based-on placement
ArgumentoDescripción
paywall-idID del paywall (UUID)
IndicadorObligatorioDescripción
--appSíID de la app (UUID)
--based-onSíPor qué divide el primer nivel del árbol: placement o audience. Estas son las vistas basadas en placement y en audiencia de la página de métricas de paywall
--date-typeSíA qué fecha se aplica el período: purchase_date o profile_install_date para filtrar por fecha de instalación
--date-fromSíPrimer día del período, inclusive (YYYY-MM-DD)
--date-toSíÚltimo día del período, inclusive (YYYY-MM-DD)
--group-byNoAgrupa los productos por product, store o country. Por defecto: product
--granularityNoDivide el período en puntos: day, week, month, quarter o year
--filterNoConserva solo los datos con estos valores de una clave de filtro. Repetible. Consulta Filtrar las métricas
--timezoneNoZona horaria IANA de los puntos del período, por ejemplo Europe/Berlin. Sin este parámetro, Adapty usa la zona horaria de la app
--depthNoCuántos niveles del árbol se muestran bajo Total. Por defecto: 1
--csvNoImprime en CSV: una fila por cada nodo del árbol completo. No se puede usar con --json

La CLI termina con código 2 y no envía ninguna solicitud cuando faltan --based-on o --date-type, o cuando solo se proporciona un extremo del período. Sin el período, Adapty rechaza la solicitud y el comando termina con código 4. Adapty valida los valores de --based-on, --date-type, --group-by y --granularity: un valor incorrecto termina con código 4 y el error enumera los valores aceptados.

Leer el resultado

El comando muestra una línea Total, seguida del primer nivel del árbol bajo ella, con las mismas columnas que flows metrics get. Los nodos del primer nivel siempre muestran sus puntos del período, con o sin --granularity.

Los niveles del árbol son: placement o audiencia, luego el paywall o la prueba A/B que se ejecutó allí, y después los grupos de --group-by. Para mostrar más niveles, usa --depth, por ejemplo --depth 4.

Para obtener el árbol completo con todas las métricas, utiliza uno de estos flags:

  • --json imprime la respuesta del servidor sin modificaciones.
  • --csv imprime una fila por cada nodo, incluidos los puntos de periodo. Las columnas son path (los títulos desde Total hasta el nodo, separados por >), level, title y las métricas numéricas. Un árbol de paywall no tiene niveles, por lo que level es root en Total y está vacío en el resto de filas.

Filtrar las métricas

Escribe cada --filter como key=value, con las claves y valores que lista paywalls metrics values. Los filtros siguen las mismas reglas que en flows metrics get:

adapty paywalls metrics get --app <app-id> <paywall-id> --date-from 2026-09-01 --date-to 2026-10-21 \
  --date-type purchase_date --based-on placement --filter state=live

¿Qué sigue?