Commandes Flows
Les flows sont les paywalls et onboardings que vous créez dans le Flow & Paywall Builder. Le CLI gère l’enregistrement du flow, sa configuration builder, sa publication et l’historique des versions. Une configuration builder est un document JSON volumineux que le Flow & Paywall Builder produit normalement — le CLI n’en génère pas. Pour créer ou modifier une configuration depuis le terminal, utilisez le skill flow-generator, qui pilote ces commandes à votre place. Avant la publication, le skill flow-audit vérifie si le flow est prêt pour la production. Les commandes flows metrics lisent les données de la page métriques de flow et nécessitent la version 0.15.0 ou ultérieure du CLI. Les commandes flows funnel lisent le funnel de flow et nécessitent la version 0.19.0 ou ultérieure du CLI. Les commandes sont listées ici à titre de référence.
adapty flows list
Lister tous les flows d’une application.
adapty flows list --app <app-id>
| Flag | Required | Description |
|---|---|---|
--app | Yes | App ID (UUID) |
Accepte les flags de pagination.
adapty flows get
Obtenir les détails d’un flow spécifique.
adapty flows get --app <app-id> <flow-id>
| Argument | Description |
|---|---|
flow-id | ID du flow (UUID) |
| Flag | Requis | Description |
|---|---|---|
--app | Oui | ID de l’app (UUID) |
La réponse contient id, name, status, published_flow_version_id et updated_at. published_flow_version_id est l’ID de la version en production, ou null si le flow n’a jamais été publié. Le statut est l’un des suivants :
| Statut | Signification |
|---|---|
draft | Le flow n’a jamais été publié |
published | La version actuelle est en ligne |
dirty | Le flow a déjà été publié, et la version actuelle comporte des modifications non publiées. Les utilisateurs continuent de voir la dernière version publiée |
publishing | La publication est en cours |
publication_failed | La dernière publication a échoué. Corrigez la configuration et publiez à nouveau |
archived | Le flow est archivé |
adapty flows create
Créer un flow. Le nouveau flow a un nom et pas de configuration. Pour ajouter une configuration, utilisez flows config update.
adapty flows create --app <app-id> --name "Onboarding"
| Flag | Requis | Description |
|---|---|---|
--app | Oui | ID de l’app (UUID) |
--name | Oui | Nom du flow |
adapty flows update
Renommer un flow.
adapty flows update --app <app-id> <flow-id> --name "Onboarding v2"
| Argument | Description |
|---|---|
flow-id | Identifiant du flow (UUID) |
| Flag | Requis | Description |
|---|---|---|
--app | Oui | Identifiant de l’app (UUID) |
--name | Oui | Nouveau nom du flow |
adapty flows publish
Publiez la version actuelle d’un flow auprès de vos utilisateurs.
adapty flows publish --app <app-id> <flow-id>
| Argument | Description |
|---|---|
flow-id | ID du flow (UUID) |
| Flag | Requis | Description |
|---|---|---|
--app | Oui | ID de l’app (UUID) |
--yes, -y | Non | Publier sans demander de confirmation. Requis lorsque la sortie est redirigée ou que --json est utilisé |
Comme la publication modifie ce que voient vos utilisateurs, la commande affiche le nom du flow et demande une confirmation. Toute réponse autre que y annule la commande avec le code de sortie 1. Avec --json ou dans un pipe, la commande refuse avec le code de sortie 2 plutôt que d’attendre une réponse ; passez donc --yes dans les scripts et les sessions d’agent.
La publication est asynchrone : la réponse indique status: publishing, et le flow n’est pas encore actif. Interrogez flows get jusqu’à ce que le statut devienne published ou publication_failed. En cas de publication_failed, flows config get indique la raison de l’échec.
La publication échoue avec une erreur HTTP 400 si le flow n’a pas de configuration, si la configuration n’est pas publiable, ou si la version actuelle est déjà active. Pour vérifier une configuration avant de la publier, utilisez flows config validate.
adapty flows config get
Lit la configuration du builder d’un flow.
adapty flows config get --app <app-id> <flow-id>
| Argument | Description |
|---|---|
flow-id | ID du flow (UUID) |
| Flag | Requis | Description |
|---|---|---|
--app | Oui | ID de l’app (UUID) |
La réponse contient config, remote_configs, status et updated_at. updated_at est un horodatage en millisecondes de la dernière modification de la configuration. Passez-le à flows config update via --expected-updated-at pour éviter d’écraser une modification concurrente. Un flow dont la configuration n’a jamais été écrite renvoie une erreur 404.
Après une tentative de publication, la réponse contient également trois champs décrivant le résultat. Lisez-les lorsque flows get indique publication_failed :
| Champ | Description |
|---|---|
publication_status | État d’avancement de la publication de cette version du flow : transforming, transformed, uploading, uploaded, published, ou failed |
transform_error | L’erreur brute de transformation — soit un payload JSON listant les problèmes, soit une chaîne récapitulative |
publication_error | Un message lisible en cas d’échec de publication |
adapty flows config update
Écrit la configuration du builder d’un flow et ses Remote Configs.
adapty flows config get --app <app-id> <flow-id> --json > flow.json
adapty flows config update --app <app-id> <flow-id> --file flow.json
| Argument | Description |
|---|---|
flow-id | Identifiant du flow (UUID) |
| Indicateur | Requis | Description |
|---|---|---|
--app | Oui | ID de l’app (UUID) |
--file | À la place de --config, --config-file et --remote-configs | Chemin vers un fichier JSON contenant config et remote_configs, ou - pour lire depuis stdin. La sortie de flows config get --json fonctionne telle quelle. Les autres clés sont ignorées |
--config | Sans --file : l’un de --config et --config-file | Configuration du builder en tant que chaîne JSON |
--config-file | Sans --file : l’un de --config et --config-file | Chemin vers un fichier JSON contenant la configuration du builder, ou - pour lire depuis stdin |
--remote-configs | Sans --file | Tableau JSON d’entrées {locale, data}, où data est le Remote Config sous forme de chaîne. [] supprime tous les Remote Configs |
--expected-updated-at | Non | La valeur updated_at issue d’un précédent flows config get. Si la configuration a changé après cette lecture, la commande échoue au lieu d’écraser la modification. Omettez ce paramètre pour écraser sans condition |
Une écriture remplace la config et la liste complète des Remote Configs. Pour conserver les Remote Configs existants, envoyez les remote_configs issus de flows config get --json. Sans --file, la commande exige à la fois la config et --remote-configs : si l’un des deux est absent, elle se termine avec le code 2 sans envoyer de requête. Le flag --file et l’option --remote-configs requièrent la version 0.20.0 ou ultérieure de la CLI.
Pour écrire la première config d’un nouveau flow, passez une liste vide de Remote Configs :
adapty flows config update --app <app-id> <flow-id> --config-file config.json --remote-configs '[]'
La sauvegarde de la config crée un brouillon et ne publie pas le flow. Sur un flow déjà publié, l’écriture crée une nouvelle version : le statut du flow passe à dirty, et les utilisateurs continuent de voir la version publiée jusqu’à ce que vous exécutiez flows publish.
adapty flows config validate
Vérifie si une configuration de builder est publiable, sans la sauvegarder.
adapty flows config validate --app <app-id> <flow-id> --config-file config.json
| Argument | Description |
|---|---|
flow-id | ID du flow (UUID) |
| Flag | Requis | Description |
|---|---|---|
--app | Oui | ID de l’app (UUID) |
--config | L’un des deux | Configuration du builder sous forme de chaîne JSON |
--config-file | L’un des deux | Chemin vers un fichier JSON contenant la configuration du builder, ou - pour lire depuis stdin |
La réponse contient valid et une liste de issues. Lorsque la config n’est pas publiable, la commande quitte avec le code 1, ce qui permet aux scripts de s’en servir comme condition.
adapty flows config preview
Affiche un fichier de configuration local dans le navigateur. Cette commande n’effectue aucun appel API et n’accepte pas l’option --app.
adapty flows config preview ./config.json --screen <screen-id> --device iphone-14 --orientation portrait
| Argument | Description |
|---|---|
config-file | Chemin vers un fichier JSON de configuration du builder local |
| Option | Défaut | Description |
|---|---|---|
--screen | Premier écran du flow | ID de l’écran à afficher |
--device | iphone-14 | Cadre de l’appareil à utiliser pour le rendu |
--orientation | portrait | portrait ou landscape |
Dans un terminal, la commande ouvre la prévisualisation dans votre navigateur. Avec --json ou dans un pipeline, elle affiche l’URL à la place. L’URL contient toute la configuration et peut être très longue : redirigez-la vers un outil de capture d’écran plutôt que de l’afficher. Les configurations de plus de 32 Ko environ s’affichent lentement.
adapty flows media upload
Téléversez une image à utiliser dans une configuration de flow.
adapty flows media upload --app <app-id> ./hero.png
| Argument | Description |
|---|---|
file | Chemin vers le fichier image |
| Flag | Obligatoire | Description |
|---|---|---|
--app | Oui | ID de l’app (UUID) |
Formats acceptés : PNG, JPEG, WebP et SVG. La réponse contient l’id, le name et l’url CDN de l’image à référencer depuis la configuration. Pour téléverser une vidéo, utilisez flows media upload-video.
adapty flows media upload-video
Téléversez une vidéo à utiliser dans une configuration de flow.
adapty flows media upload-video --app <app-id> ./intro.mp4
| Argument | Description |
|---|---|
file | Chemin vers le fichier vidéo |
| Flag | Requis | Description |
|---|---|---|
--app | Oui | ID de l’application (UUID) |
Formats acceptés : MP4 et WebM. La vidéo doit durer au maximum 30 secondes, peser au maximum 50 Mo, et sa largeur ainsi que sa hauteur doivent être chacune d’au moins 640 pixels. Le format GIF n’est pas pris en charge, et la commande ne convertit pas une image animée en vidéo.
La réponse contient l’URL de la vidéo (une playlist HLS), l’URL de l’image de prévisualisation, ainsi que la width et la height de la vidéo. Dans la config, un élément vidéo les prend en charge via videoUrl, previewUrl, width et height.
adapty flows versions list
Liste les versions d’un flow, de la plus récente à la plus ancienne. Ce sont les versions de l’historique des versions dans le Flow & Paywall Builder.
adapty flows versions list --app <app-id> <flow-id>
| Argument | Description |
|---|---|
flow-id | ID du flow (UUID) |
| Flag | Requis | Description |
|---|---|---|
--app | Oui | ID de l’application (UUID) |
--search | Non | Affiche uniquement les versions dont le titre contient ce texte. La casse n’a pas d’importance, et une partie du mot suffit : friday trouve Black Friday |
Chaque ligne affiche le titre, l’état, la date et l’ID d’une version. Le titre correspond au nom de la version, ou Version N si la version n’a pas de nom. L’état est l’un des suivants :
| État | Signification |
|---|---|
draft | La version que vous modifiez. Un flow a un seul brouillon, ou aucun. Pendant la publication du brouillon, sa ligne se termine par Publishing… ; en cas d’échec, elle se termine par Publish failed |
live | La version visible par vos utilisateurs |
previous | Une version antérieure. Elle était live auparavant, ou une version plus récente l’a remplacée avant qu’elle soit publiée |
La date d’une version live ou previous correspond au début de sa publication. Pour le brouillon et pour une version previous qui n’a jamais été publiée, c’est la date de création de la version.
Pour un flow qui n’a jamais été publié, la commande affiche History will appear after the first publish. et la ligne de brouillon en dessous. L’historique des versions dans le tableau de bord ne montre aucune ligne pour ce type de flow. Lorsqu’aucune version ne correspond à --search, la commande affiche No versions match the search.
La commande liste toujours toutes les versions et n’accepte aucun flag de pagination.
Avec --json, la commande affiche {data, meta} tel quel depuis Adapty, avec les lignes dans data. Chaque ligne contient flow_version_id, version, name, title, state, is_current, publication_status, published_at, created_at, updated_at et last_edited_by. updated_at est un horodatage en millisecondes de la dernière modification du contenu de la version : passez la valeur updated_at du brouillon à flows versions restore via --expected-updated-at. last_edited_by indique l’utilisateur qui a modifié la version en dernier, ou vaut null si Adapty ne connaît pas l’utilisateur.
adapty flows versions get
Lire une version d’un flow. La lecture d’une version ne change rien : le brouillon et la version en production restent tels quels.
La commande affiche le titre, l’ID, le numéro, l’état et la date de la version, l’utilisateur qui l’a modifiée en dernier, ainsi que son lien Test on device. Le contenu complet de la version — sa configuration builder avec chaque layout, ses Remote Configs et ses paywalls — se trouve dans la sortie de --json, et dans le fichier de --output.
adapty flows versions get --app <app-id> <flow-id> <version-id> --output version.json
| Argument | Description |
|---|---|
flow-id | ID du flow (UUID) |
version-id | ID de version (UUID), depuis flows versions list |
| Flag | Requis | Description |
|---|---|---|
--app | Oui | ID de l’application (UUID) |
--output | Non | Écrit le contenu complet de la version dans ce fichier en JSON |
--yes, -y | Non | Remplace un fichier --output existant sans demander de confirmation. Requis avec --json ou dans un pipe lorsque le fichier existe |
Si le CLI ne peut pas écrire le fichier --output, par exemple parce que son dossier n’existe pas, la commande affiche Could not write <path> (<errno>). et se termine avec le code 1.
adapty flows versions preview
Affiche le lien Test on device d’une version. Ouvrez le lien sur votre appareil de test pour voir la version dans l’application mobile Adapty. N’importe quelle version fonctionne : le brouillon, la version live ou une version antérieure.
adapty flows versions preview --app <app-id> <flow-id> <version-id>
| Argument | Description |
|---|---|
flow-id | Identifiant du flow (UUID) |
version-id | Identifiant de la version (UUID) |
| Flag | Requis | Description |
|---|---|---|
--app | Oui | Identifiant de l’application (UUID) |
adapty flows versions rename
Renommez une version. Vous pouvez renommer la version brouillon, la version live et les versions antérieures.
adapty flows versions rename --app <app-id> <flow-id> <version-id> --name "Black Friday"
| Argument | Description |
|---|---|
flow-id | ID du flow (UUID) |
version-id | ID de la version (UUID) |
| Flag | Requis | Description |
|---|---|---|
--app | Oui | ID de l’application (UUID) |
--name | Oui | Nouveau nom de la version. Passez --name "" pour supprimer le nom et que la version affiche à nouveau Version N. Un nom composé uniquement d’espaces le supprime également |
La commande affiche l’ID de version et le nouveau titre. Adapty supprime les espaces en début et fin de nom. Deux versions peuvent avoir le même nom. Un renommage ne modifie ni le contenu ni le champ updated_at de la version, il n’entre donc pas en conflit avec une sauvegarde ultérieure du brouillon.
adapty flows versions restore
Restaurer une version en tant que brouillon du même flow. C’est l’option Duplicate as draft dans l’historique des versions. La version restaurée n’est pas visible par vos utilisateurs tant que vous ne la publiez pas.
Une restauration remplace le brouillon en cours. Pour le conserver, dupliquez-le d’abord dans un nouveau flow avec flows duplicate.
adapty flows versions restore --app <app-id> <flow-id> <version-id>
| Argument | Description |
|---|---|
flow-id | Identifiant du flow (UUID) |
version-id | Identifiant de version (UUID) d’une version live ou previous |
| Flag | Obligatoire | Description |
|---|---|---|
--app | Oui | Identifiant de l’app (UUID) |
--expected-updated-at | Avec --yes, quand le flow a un brouillon | La valeur updated_at du brouillon, récupérée via flows versions list --json. Si le brouillon a été modifié après cette lecture, la commande échoue au lieu de remplacer la modification |
--yes, -y | Non | Remplacer le brouillon sans demander de confirmation. Obligatoire avec --json ou dans un pipe quand le flow a un brouillon |
La commande lit d’abord les versions du flow :
- Le flow n’a pas de brouillon : La commande ne demande rien. Adapty crée un nouveau brouillon avec le numéro de version suivant, sans nom, et avec tout le contenu de la version. La version en ligne et la version que vous restaurez restent telles quelles.
- Le flow a un brouillon : La commande demande
Replace the draft '<draft>' (last change <time> by <user>) with '<version>'? To keep the draft, duplicate it to a new flow first., puisApply? [y/N]. Si vous répondezy, le brouillon conserve son ID, son numéro et son nom, et reçoit le contenu de la version. Aucune version n’est ajoutée. Toute autre réponse quitte avec le code 1 et n’envoie rien.
Avec --json, dans un pipe, ou sans terminal, la commande ne peut pas poser de question. Quand le flow a un brouillon, elle n’envoie rien et quitte avec le code 6, sauf si vous passez --yes. Son message pose la question et ajoute To replace it, re-run with --yes --expected-updated-at <ms> (the draft's updated_at)., avec le updated_at du brouillon à la place de <ms>. Avec --yes, passez aussi --expected-updated-at : sans ça, la commande quitte avec le code 6 et n’envoie rien. Dans un terminal sans --expected-updated-at, la commande prend le updated_at du brouillon qu’elle vous affiche dans la question.
Après une restauration, la commande affiche Restored '<version>' as the draft '<draft>' (<draft-id>). Nothing is published.
Adapty refuse la restauration et ne modifie rien dans ces cas. La commande affiche le message d’Adapty, indique la marche à suivre pour certains d’entre eux, puis se termine avec le code 4 :
| Message | Que faire |
|---|---|
This flow version is already the current draft. | Choisissez une autre version. |
Flow version does not exist. | L’ID de version n’est pas dans la liste des versions de ce flow. Récupérez l’ID depuis flows versions list. |
Flow version is already being published. | Attendez la fin de la publication, puis relancez la restauration. |
This flow version uses deleted products: … | Choisissez une version qui n’utilise pas ces produits. |
This flow configuration was already updated by … | Un membre de votre équipe a modifié le brouillon après que vous l’avez lu. Listez à nouveau les versions et réessayez. |
Flow is deleted. | Le flow est archivé. Restaurez-le depuis l’archive dans le tableau de bord d’abord. |
adapty flows duplicate
Copiez un flow, ou l’une de ses versions, dans un nouveau flow. Il s’agit de Duplicate flow sous le bouton d’actions du flow dans la barre supérieure du Flow & Paywall Builder (voir Copier des flows), et de Duplicate as new flow dans l’historique des versions.
adapty flows duplicate --app <app-id> <flow-id> --version <version-id>
| Argument | Description |
|---|---|
flow-id | ID du flow (UUID) |
| Flag | Obligatoire | Description |
|---|---|---|
--app | Oui | ID de l’application (UUID) |
--version | Non | ID de version (UUID) à copier, depuis flows versions list. N’importe quelle version convient, y compris le brouillon. Sans cette option, la commande copie le brouillon, ou la version en production si le flow n’a pas de brouillon |
La commande affiche New flow '<name>' (<flow-id>), not published. Le nouveau flow porte le nom du flow source suivi de _copy. Il n’est pas publié et contient un seul brouillon avec le contenu de la version. Le flow source, son brouillon et son historique restent inchangés. Vous pouvez dupliquer un flow pendant sa publication.
Adapty refuse de copier une version qui utilise un produit supprimé, ainsi que de copier un flow archivé. Les messages sont identiques à ceux de flows versions restore.
adapty flows metrics list
Affiche les métriques sur toute la durée de vie de plusieurs flows, une ligne par flow. Ce sont les données du tableau des flows dans le tableau de bord.
adapty flows metrics list --app <app-id> --ids <flow-id>,<flow-id>
| Flag | Requis | Description |
|---|---|---|
--app | Oui | ID de l’app (UUID) |
--ids | Oui | IDs des flows (UUIDs). Séparez-les avec des virgules ou répétez le flag |
--csv | Non | Affiche le CSV : une ligne par flow, avec l’ID du flow et les 27 métriques. Incompatible avec --json |
Chaque ligne affiche l’ID du flow avec ses vues, achats, essais et revenus. --json et --csv incluent les 27 métriques de la page métriques de flow, comme unique_profiles_views, net_revenue et conversion_rate_purchases. Une métrique sans données vaut 0, jamais null. Pour chaque flow qui n’a jamais été publié, la commande affiche <flow-id>: No data: the flow was never published. sous le tableau. --json ajoute note: "never_published" à la ligne de ce flow, et avec --csv les notes sont envoyées vers stderr, afin que le CSV reste propre.
adapty flows metrics values
Liste les clés et valeurs de filtre d’un flow : ce que flows metrics get --filter accepte.
adapty flows metrics values --app <app-id> <flow-id>
| Argument | Description |
|---|---|
flow-id | ID du flow (UUID) |
| Flag | Requis | Description |
|---|---|---|
--app | Oui | ID de l’app (UUID) |
Chaque ligne affiche un libellé et, entre parenthèses, la valeur à passer. Les valeurs sont imbriquées de la même façon que les filtres du tableau de bord :
Country (country)
Americas (Americas)
United States (US)
Europe (Europe)
Germany (DE)
Store (store)
App Store (app_store)
Google Play (play_store)
La valeur en tête de chaque groupe est la clé de filtre, et les valeurs les plus imbriquées sont celles qu’accepte cette clé. Dans l’exemple, --filter country=US conserve les États-Unis, et --filter store=play_store conserve Google Play.
adapty flows metrics get
Affiche les métriques d’un flow pour une période donnée, sous forme d’arborescence comme sur la page métriques de flow.
adapty flows metrics get --app <app-id> <flow-id> --date-from 2026-09-01 --date-to 2026-10-21 --date-type purchase_date --based-on placement
| Argument | Description |
|---|---|
flow-id | ID du flow (UUID) |
| Indicateur | Requis | Description |
|---|---|---|
--app | Oui | ID de l’app (UUID) |
--based-on | Oui | Ce sur quoi se base le premier niveau de l’arborescence : placement ou audience. Il s’agit des vues par placement et par audience de la page métriques de flow |
--date-type | Oui | La date à laquelle la période s’applique : purchase_date, ou profile_install_date pour filtrer par date d’installation |
--date-from | Non | Premier jour de la période, inclus (YYYY-MM-DD). À utiliser avec --date-to |
--date-to | Non | Dernier jour de la période, inclus (YYYY-MM-DD). À utiliser avec --date-from |
--granularity | Non | Découpe la période en points : day, week, month, quarter, ou year |
--filter | Non | Ne conserve que les données correspondant à ces valeurs de clé de filtre. Répétable. Voir Filtrer les métriques |
--timezone | Non | Fuseau horaire IANA des points de la période, par exemple Europe/Berlin. Sans cela, Adapty utilise le fuseau horaire de l’app |
--depth | Non | Nombre de niveaux de l’arborescence à afficher sous Total. Par défaut : 1 |
--csv | Non | Affiche le CSV : une ligne par nœud de l’arborescence complète. Incompatible avec --json |
Pour un flow qui n’a jamais été publié, la commande affiche la note No data: the flow was never published. au-dessus des chiffres, et --json ajoute note: "never_published". Avec --csv, la note est envoyée sur stderr, ce qui garde le CSV propre.
Pour obtenir les revenus d’un flow, exécutez adapty analytics chart --app <app-id> --chart revenue --date-from <YYYY-MM-DD> --date-to <YYYY-MM-DD> --filter flow_id=<flow-id>. Voir Commandes Analytics.
La CLI quitte avec le code 2 et n’envoie aucune requête lorsque --based-on ou --date-type est absent, ou lorsqu’une seule borne de la période est fournie. Adapty valide les valeurs de --based-on, --date-type et --granularity : une valeur incorrecte entraîne une sortie avec le code 4, et l’erreur liste les valeurs acceptées.
Lire le résultat
La commande affiche une ligne Total, puis le premier niveau de l’arborescence en dessous. Chaque ligne indique les vues, les achats, les essais et le revenu. Avec --granularity, les points de la période apparaissent directement sous leur nœud :
Total views 19 purchases 7 trials 4 revenue 241.93
Onboarding views 10 purchases 7 trials 0 revenue 241.93
2026-09-01 views 0 purchases 0 trials 0 revenue 0.00
2026-10-01 views 10 purchases 0 trials 0 revenue 241.93
Settings views 0 purchases 0 trials 0 revenue 0.00
Les niveaux de l’arborescence correspondent aux niveaux du tableau de bord : placement, audience, test A/B, variante de flow, écran et produit. Avec --based-on audience, le niveau placement est omis. Pour afficher plus de niveaux, utilisez --depth, par exemple --depth 3.
Pour l’arborescence complète avec les 27 métriques, utilisez l’un de ces flags :
--jsonaffiche la réponse du serveur sans modification.--csvaffiche une ligne par nœud, points de période inclus. Les colonnes sontpath(les titres deTotaljusqu’au nœud, séparés par>),level,title, puis les métriques.
Filtrer les métriques
Écrivez chaque --filter sous la forme key=value, avec les clés et valeurs listées par flows metrics values. Pour conserver plusieurs valeurs, séparez-les par des virgules ou répétez le flag avec la même clé. Les filtres avec des clés différentes se combinent, les données doivent donc correspondre à tous :
adapty flows metrics get --app <app-id> <flow-id> --date-from 2026-09-01 --date-to 2026-10-21 \
--date-type purchase_date --based-on placement --filter country=US,DE --filter store=app_store
Le CLI envoie chaque valeur exactement telle qu’elle est écrite. Pour inclure une virgule dans une valeur, utilisez \,. Une valeur vide est aussi une valeur : attribution_channel= conserve la donnée sans canal, que flows metrics values affiche comme No Data.
adapty flows funnel values
Liste les clés et valeurs de filtre d’un funnel de flow : ce que flows funnel get --filter accepte.
adapty flows funnel values --app <app-id> <flow-id>
| Argument | Description |
|---|---|
flow-id | ID du flow (UUID) |
| Flag | Requis | Description |
|---|---|---|
--app | Oui | ID de l’app (UUID) |
La sortie a la même forme que flows metrics values.
adapty flows funnel get
Affiche l’écran sur lequel les utilisateurs quittent un flow : le funnel d’une version de flow, étape par étape et écran par écran, comme dans l’onglet Funnel du flow.
adapty flows funnel get --app <app-id> <flow-id> --date-from 2026-09-01 --date-to 2026-10-21 --date-type purchase_date
| Argument | Description |
|---|---|
flow-id | Identifiant du flow (UUID) |
| Flag | Requis | Description |
|---|---|---|
--app | Oui | ID de l’application (UUID) |
--date-from | Oui | Premier jour de la période, inclus (YYYY-MM-DD), dans le fuseau horaire --timezone ou celui de l’application |
--date-to | Oui | Dernier jour de la période, inclus (YYYY-MM-DD), dans le fuseau horaire --timezone ou celui de l’application |
--date-type | Oui | Date à laquelle la période s’applique : purchase_date ou profile_install_date |
--flow-version-id | Non | ID de version du flow (UUID) à lire. Sans ce paramètre, la CLI lit la version publiée |
--filter | Non | Ne conserver que les utilisateurs ayant ces valeurs pour une clé de filtre, au format key=value. Répétable. Les clés et valeurs proviennent de flows funnel values et fonctionnent comme dans Filtrer les métriques |
--timezone | Non | Fuseau horaire IANA des jours, par exemple Europe/Berlin. Sans ce paramètre, Adapty utilise le fuseau horaire de l’application |
--csv | Non | Affiche le fichier CSV que le tableau de bord télécharge, avec la ligne de total en premier. Incompatible avec --json |
La commande affiche la version du flow, la période, une ligne récapitulative et un tableau. Le récapitulatif indique combien d’utilisateurs ont commencé le flow, combien l’ont terminé, le taux d’abandon et le revenu. Le tableau contient une ligne par étape, avec les colonnes Step, Type, Reached, Completed, Drop rate et Revenue. Une étape comportant plusieurs écrans génère aussi une ligne par écran. Une valeur qui ne s’applique pas, comme le revenu d’un écran d’onboarding, est affichée sous la forme —.
When no users entered the flow in the period, the table lists the screens of the version with zeros. For every field of the answer, use --json.
Et maintenant ?
- Référence des commandes — tous les sujets CLI, les options globales et les options de pagination.
- Historique des versions de flow — les mêmes versions dans le Flow & Paywall Builder.