Cet article liste toutes les commandes Ads Manager de l’Adapty CLI, avec leurs arguments, indicateurs et valeurs acceptées. Les commandes Ads Manager se trouvent sous le topic adapty asa.

Ces commandes nécessitent un compte Apple Ads connecté et un abonnement Ads Manager actif. Exécutez adapty asa whoami pour vérifier les deux. Pour le reste de la CLI, consultez la référence des commandes.

Indicateurs globaux

Ces indicateurs sont disponibles sur toutes les commandes Ads Manager.

Indicateur	Description
--json	Afficher en JSON plutôt qu’en texte formaté
--help	Afficher l’aide de la commande

Toutes les commandes list acceptent également des indicateurs de pagination :

Indicateur	Défaut	Description
--page	1	Numéro de page
--page-size	100	Éléments par page (max : 1000)

Les pages Ads Manager sont plus grandes que dans le reste du CLI. Préférez une grande page à une boucle de petites.

Toutes les commandes qui modifient votre compte acceptent ces indicateurs :

Indicateur	Description
--yes, -y	Applique sans demander de confirmation. Requis lorsque la sortie est redirigée ou que --json est utilisé
--idempotency-key	Clé fixe pour cette écriture. Une répétition avec la même clé et le même corps dans les 24 heures renvoie le résultat stocké au lieu d’appliquer à nouveau la modification

Les commandes Ads Manager ne prennent pas d’indicateur --app. La portée est l’entreprise à laquelle appartient votre token. --app existe sur certaines commandes list uniquement comme filtre.

Filtres de liste

Les filtres restreignent la requête elle-même, pas la page affichée. Une keywords list sans filtre parcourt tous les mots-clés du compte — limitez donc chaque lecture au niveau dont vous avez besoin.

Filtre	Accepté par
--campaign-group	campaigns, ad-groups, keywords, negative-keywords, search-terms, ads, creatives, product-pages
--app	campaigns, ad-groups, keywords, negative-keywords, search-terms, creatives, product-pages
--campaign	ad-groups, keywords, negative-keywords, search-terms, ads
--ad-group	keywords, negative-keywords, search-terms, ads
--status	campaigns, ad-groups, ads (ENABLED ou PAUSED), keywords (ACTIVE ou PAUSED)
--search	campaigns, ad-groups, keywords, negative-keywords, search-terms, ads. Recherche de sous-chaîne insensible à la casse sur le nom

adapty asa apps list, orgs list, automations list et automations runs n’acceptent aucun filtre. Ils prennent uniquement des options de pagination.

--campaign-group, --app, --campaign et --ad-group prennent les UUID affichés par la commande list correspondante, et chacun est répétable :

adapty asa keywords list --ad-group <ad-group-id> --ad-group <other-ad-group-id>

Un ID appartenant à une autre entreprise ne correspond à rien : la page revient vide au lieu de renvoyer une erreur.

Compte

adapty asa whoami

Affichez l’entreprise, la méthode d’octroi d’accès à Ads Manager et l’état de la connexion Apple Ads.

adapty asa whoami

Exécutez cette commande en premier. Elle indique si les deux prérequis nécessaires à toutes les autres commandes sont satisfaits.

adapty asa connect

Liez un compte Apple Ads à Adapty.

adapty asa connect

La commande affiche un lien d’autorisation Apple et attend qu’Apple signale le compte comme connecté.

Flag	Défaut	Description
--wait / --no-wait	--wait	Attend qu’Apple Ads signale la connexion. --no-wait retourne immédiatement
--timeout	300	Secondes à attendre pour l’étape navigateur

adapty asa orgs list

Listez les groupes de campagnes (organisations Apple Ads) disponibles pour votre entreprise.

adapty asa orgs list

Chaque ligne contient deux identifiants, qui ne sont pas interchangeables :

Champ	Utilisé comme
internal_id	L’UUID qu’accepte --org dans campaigns create, et que --campaign-group accepte comme filtre de liste
org_id	L’identifiant numérique d’organisation Apple. Les deux flags le rejettent

--org existe uniquement dans campaigns create. Aucune commande de liste ne l’accepte.

Accepte les flags de pagination.

adapty asa apps list

Liste les apps promues dans Apple Ads.

adapty asa apps list

Chaque ligne comporte deux identifiants, qui ne sont pas interchangeables :

Champ	Utilisé comme
internal_id	L’UUID que --app accepte en tant que filtre de liste
adam_id	L’identifiant numérique App Store d’Apple, utilisé par --adam-id dans campaigns create et product-pages sync

Accepte les options de pagination.

Campagnes

adapty asa campaigns list

Liste les campagnes. Renvoie uniquement les métadonnées — lisez les chiffres de performance avec asa metrics.

adapty asa campaigns list --app <app-id> --status PAUSED

Accepte les options de pagination ainsi que les filtres de liste --campaign-group, --app, --search et --status.

adapty asa campaigns get

Récupère les détails d’une campagne spécifique.

adapty asa campaigns get <campaign-id>

Argument	Description
campaign-id	Identifiant de la campagne (UUID)

adapty asa campaigns create

Créer une campagne.

adapty asa campaigns create --org <campaign-group-id> --name "Winter push" --adam-id 123456 --country US --daily-budget 50

Paramètre	Requis	Description
--org	Oui	ID du groupe de campagnes (UUID). Voir orgs list
--name	Oui	Nom de la campagne
--adam-id	Oui	ID de l’application App Store (adam_id)
--country	Oui	Code pays ou région. Répéter pour plusieurs : --country US --country CA
--daily-budget	Oui	Budget quotidien en montant brut, par exemple 50 ou 12.50
--budget	Non	Budget total
--target-cpa	Non	Coût cible par acquisition
--currency	Non	Code devise pour les montants de cet appel. Par défaut : USD
--bidding-strategy	Non	MANUAL_CPT ou MAX_CONVERSIONS. Apple utilise MANUAL_CPT par défaut
--ad-channel-type	Non	SEARCH ou DISPLAY. Par défaut : SEARCH
--billing-event	Non	TAPS ou IMPRESSIONS. Par défaut : TAPS
--supply-source	Non	Source d’inventaire, répétable. Par défaut : APPSTORE_SEARCH_RESULTS
--status	Non	Statut initial : ENABLED ou PAUSED

adapty asa campaigns update

Mettre à jour une campagne existante.

adapty asa campaigns update <campaign-id> --daily-budget 80 --status PAUSED

Argument	Description
campaign-id	Identifiant de la campagne (UUID)

Indicateur	Description
--name	Nouveau nom de campagne
--status	ENABLED ou PAUSED
--country	Remplace la liste de pays. Répétez pour plusieurs
--daily-budget	Nouveau budget quotidien
--budget	Nouveau budget total
--target-cpa	Nouveau coût cible par acquisition
--bidding-strategy	MANUAL_CPT ou MAX_CONVERSIONS
--currency	Code devise pour les montants de cet appel. Par défaut : USD

Au moins un indicateur est requis.

Groupes d’annonces

adapty asa ad-groups list

Liste les groupes d’annonces. Retourne uniquement les métadonnées — consultez les performances avec asa metrics.

adapty asa ad-groups list --campaign <campaign-id>

Accepte les options de pagination ainsi que les filtres de liste --campaign-group, --app, --campaign, --search et --status.

adapty asa ad-groups get

Obtenir les détails d’un groupe d’annonces spécifique.

adapty asa ad-groups get <ad-group-id>

Argument	Description
ad-group-id	ID du groupe d’annonces (UUID)

adapty asa ad-groups create

Créez un groupe d’annonces dans une campagne.

adapty asa ad-groups create --campaign <campaign-id> --name "Brand terms" --default-bid 1.20

Indicateur	Requis	Description
--campaign	Oui	ID de campagne (UUID)
--name	Oui	Nom du groupe d’annonces
--default-bid	Oui	Enchère par défaut sous forme de montant simple, par exemple 1.20
--cpa-goal	Non	Objectif de coût par acquisition
--pricing-model	Non	CPC ou CPM. Apple en exige un sur chaque groupe d’annonces. Par défaut : CPC
--start-time	Non	Début de la planification (YYYY-MM-DD). Par défaut : aujourd’hui
--end-time	Non	Fin de la planification (YYYY-MM-DD)
--automated-keywords / --no-automated-keywords	Non	Laisser Apple ajouter des mots-clés automatiquement
--currency	Non	Code devise pour les montants de cet appel. Par défaut : USD
--status	Non	Statut initial : ENABLED ou PAUSED

adapty asa ad-groups update

Mettre à jour un groupe d’annonces existant.

adapty asa ad-groups update <ad-group-id> --default-bid 1.50 --status PAUSED

Argument	Description
ad-group-id	ID du groupe d’annonces (UUID)

Indicateur	Description
--name	Nouveau nom du groupe d’annonces
--status	ENABLED ou PAUSED
--default-bid	Nouveau montant d’enchère par défaut
--cpa-goal	Nouvel objectif de coût par acquisition
--start-time	Début de la planification (YYYY-MM-DD)
--end-time	Fin de la planification (YYYY-MM-DD)
--automated-keywords / --no-automated-keywords	Laisser Apple ajouter des mots-clés automatiquement
--currency	Code de devise pour les montants de cet appel. Par défaut : USD

Au moins un indicateur est requis. La campagne parente est résolue côté serveur et n’est jamais transmise.

Mots-clés

Les commandes de mots-clés sont appliquées par lots de 100 éléments maximum par appel. Voir Gérer les mots-clés pour l’équivalent dans le tableau de bord.

adapty asa keywords list

Liste les mots-clés de ciblage. Retourne uniquement les métadonnées — pour consulter les performances, utilisez asa metrics.

adapty asa keywords list --ad-group <ad-group-id> --status ACTIVE

Accepte les options de pagination ainsi que les filtres de liste --campaign-group, --app, --campaign, --ad-group, --search et --status. Filtrez par --ad-group — sans filtre, il s’agit de la lecture la plus large du sujet.

adapty asa keywords add

Ajoutez des mots-clés de ciblage à un groupe d’annonces.

adapty asa keywords add --ad-group <ad-group-id> --text "running shoes" --text "trail shoes" --bid 1.20

Lisez plutôt les mots-clés depuis un fichier, un par ligne :

adapty asa keywords add --ad-group <ad-group-id> --from-file keywords.txt

Flag	Requis	Description
--ad-group	Oui	ID du groupe d’annonces (UUID). La campagne est déduite à partir de celui-ci
--text	Oui, sauf si --from-file est utilisé	Texte du mot-clé. À répéter pour plusieurs mots-clés
--from-file	Non	Fichier avec un mot-clé par ligne. Combiné avec les valeurs --text éventuelles
--bid	Non	Enchère par mot-clé sous forme de montant brut
--match-type	Non	BROAD ou EXACT. Par défaut : BROAD
--currency	Non	Code de devise pour les montants de cet appel. Par défaut : USD
--status	Non	ACTIVE ou PAUSED. Par défaut : ACTIVE

Une seule ID invalide fait échouer tout le lot avant même qu’Apple soit contacté. Apple peut toujours rejeter des mots-clés individuels, et chaque refus est signalé avec sa raison.

adapty asa keywords update

Modifiez l’enchère, le statut, le texte ou le type de correspondance d’un ou plusieurs mots-clés.

adapty asa keywords update <keyword-id> <keyword-id> --bid 2.00 --status PAUSED

Argument	Description
keyword-id	ID du mot-clé (UUID). Passez-en plusieurs en tant qu’arguments supplémentaires

Flag	Description
--bid	Nouvelle enchère
--status	ACTIVE ou PAUSED
--match-type	BROAD ou EXACT
--text	Nouveau texte du mot-clé. Significatif uniquement pour un seul mot-clé
--currency	Code de devise pour les montants de cet appel. Par défaut : USD

Un seul changement est appliqué à chaque identifiant transmis.

Mots-clés négatifs

adapty asa negative-keywords list

Liste les mots-clés négatifs. Les lignes avec un ad_group_id vide sont au niveau de la campagne.

adapty asa negative-keywords list --campaign <campaign-id>

Flag	Description
--campaign-level-only	Conserver uniquement les lignes au niveau de la campagne

Accepte les flags de pagination ainsi que les filtres de liste --campaign-group, --app, --campaign, --ad-group et --search.

adapty asa negative-keywords add

Ajoutez des mots-clés négatifs à un groupe d’annonces ou à une campagne.

adapty asa negative-keywords add --ad-group <ad-group-id> --text free

Appliquez-les à chaque groupe d’annonces d’une campagne à la place :

adapty asa negative-keywords add --campaign <campaign-id> --all-ad-groups --text free

Indicateur	Requis	Description
--ad-group	L’un de --ad-group ou --campaign	ID du groupe d’annonces (UUID). La campagne en est déduite
--campaign	L’un de --ad-group ou --campaign	ID de la campagne (UUID)
--text	Oui	Texte du mot-clé. À répéter pour en ajouter plusieurs
--all-ad-groups	Non	Applique à tous les groupes d’annonces de la campagne plutôt qu’à la campagne elle-même. Nécessite --campaign
--match-type	Non	BROAD ou EXACT. Par défaut : EXACT
--status	Non	ACTIVE ou PAUSED. Par défaut : ACTIVE

--ad-group et --campaign s’excluent mutuellement. Passez exactement l’un des deux.

Termes de recherche

adapty asa search-terms list

Listez les termes de recherche qui ont déclenché vos publicités. Utilisez-les pour trouver de nouveaux mots-clés et de nouveaux mots-clés à exclure.

adapty asa search-terms list --ad-group <ad-group-id> --date-from 2026-07-01 --date-to 2026-07-31

Option	Par défaut	Description
--date-from	Aujourd’hui	Début de la période de rapport (YYYY-MM-DD)
--date-to	Aujourd’hui	Fin de la période de rapport (YYYY-MM-DD)

Accepte les options de pagination ainsi que les filtres de liste --campaign-group, --app, --campaign, --ad-group et --search.

Cette commande partage un pool d’analyse avec asa metrics. Voir Erreurs.

Publicités

adapty asa ads list

Liste les publicités. Le champ serving_state_reasons explique pourquoi une publicité n’est pas diffusée.

adapty asa ads list --ad-group <ad-group-id>

Accepte les options de pagination et les filtres de liste --campaign-group, --campaign, --ad-group, --search et --status. Cette liste ne dispose pas du filtre --app, car les publicités appartiennent à des groupes de publicités.

adapty asa ads get

Obtenez les détails d’une annonce spécifique.

adapty asa ads get <ad-id>

Argument	Description
ad-id	ID de l’annonce (UUID)

adapty asa ads create

Créer une annonce dans un groupe d’annonces.

adapty asa ads create --ad-group <ad-group-id> --creative-id 4321 --name "Summer ad"

Flag	Requis	Description
--ad-group	Oui	ID du groupe d’annonces (UUID). La campagne est résolue à partir de celui-ci
--creative-id	Oui	ID de création Apple. Voir creatives list
--name	Oui	Nom de l’annonce
--status	Non	Statut initial : ENABLED ou PAUSED

adapty asa ads update

Mettre à jour une publicité existante.

adapty asa ads update <ad-id> --status PAUSED

Argument	Description
ad-id	ID de la publicité (UUID)

Flag	Description
--name	Nouveau nom de la publicité
--status	ENABLED ou PAUSED

Au moins un flag est requis. Le créatif et le groupe de publicités parent sont fixés à la création.

Créatifs

adapty asa creatives list

Liste les créatifs disponibles pour les nouvelles publicités.

adapty asa creatives list --app <app-id>

Le creative_id retourné ici est la valeur --creative-id pour ads create.

Accepte les flags de pagination ainsi que les filtres de liste --campaign-group et --app list filters.

Pages produit

adapty asa product-pages list

Listez les pages produit personnalisées disponibles pour vos applications.

adapty asa product-pages list --app <app-id>

Accepte les options de pagination ainsi que les filtres --campaign-group et --app des filtres de liste.

adapty asa product-pages sync

Actualise les pages produit personnalisées depuis App Store Connect.

adapty asa product-pages sync --adam-id 123456

Flag	Description
--adam-id	Limite l’actualisation à une seule application. Omettez ce flag pour couvrir toutes les applications

L’actualisation est mise en file d’attente plutôt qu’exécutée immédiatement, et la commande confirme avec Sync queued. Si la même actualisation est déjà en cours, elle retourne Already running; nothing new was queued. à la place.

Automations

Le CLI stocke le JSON de règle que vous lui fournissez — il ne construit pas de règles. Consultez Automations pour comprendre ce que fait chaque type de règle, et Exécuter des règles d’automatisation pour savoir comment produire un fichier de règles.

Liste des règles d’automatisation adapty asa

Liste les règles d’automatisation. Le champ status vaut 1 pour actif et 0 pour arrêté.

adapty asa automations list

Accepte les options de pagination.

adapty asa automations get

Récupérez une règle d’automatisation spécifique, y compris ses conditions et actions.

adapty asa automations get <automation-id>

Argument	Description
automation-id	ID de la règle d’automatisation (UUID)

adapty asa automations create

Créez une règle d’automatisation à partir d’un fichier de règles JSON.

adapty asa automations create --file rule.json

Flag	Description
--file	Fichier JSON contenant le corps de la règle, ou - pour lire depuis l’entrée standard
--run-now	Met en file d’attente la première exécution juste après l’enregistrement de la règle

--file est obligatoire.

adapty asa automations update

Modifiez une règle d’automatisation : arrêtez-la, renommez-la ou remplacez certaines de ses parties.

adapty asa automations update <automation-id> --stop

Argument	Description
automation-id	ID de la règle d’automatisation (UUID)

Flag	Description
--start	Activer la règle
--stop	Arrêter la règle et effacer sa prochaine exécution
--name	Nouveau nom de la règle
--file	Fichier JSON contenant les parties à modifier, ou - pour lire depuis l’entrée standard

--start et --stop sont mutuellement exclusifs. Un fichier passé ici ne doit pas contenir internal_id.

adapty asa automations run

Exécute une règle d’automatisation une seule fois, en dehors de son planning.

adapty asa automations run <automation-id> --dry-run

Argument	Description
automation-id	ID de la règle d’automatisation (UUID)

Flag	Description
--dry-run	Évalue la règle et journalise le résultat sans rien modifier dans Apple Ads

L’exécution est mise en file d’attente et la commande affiche un ID d’exécution. Consultez le résultat avec automations runs.

adapty asa automations runs

Liste les exécutions passées d’une règle d’automatisation, y compris les exécutions à blanc.

adapty asa automations runs <automation-id>

Argument	Description
automation-id	ID de la règle d’automatisation (UUID)

Accepte les indicateurs de pagination.

Métriques

adapty asa metrics

Interrogez les métriques pour n’importe quel niveau du compte sur une plage de dates.

adapty asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31

Indicateur	Requis	Description
--entity	Oui	Sur quoi porter le rapport : campaign, ad-group, keyword, ou ad
--date-from	Oui	Début de la période (YYYY-MM-DD)
--date-to	Oui	Fin de la période (YYYY-MM-DD)
--metric	Non	Nom de la métrique, répétable. Omettez pour toutes les métriques
--group-by	Non	Ventiler les lignes par country, day, week, month, quarter, ou year. Répétable
--by-days	Non	Fenêtre de renouvellement en jours pour les métriques de cohorte, répétable. Maximum 16 par appel. Omettez pour les valeurs par défaut du tableau de bord
--order-by	Non	Métrique ou champ selon lequel trier
--order-by-day	Non	Classer par une métrique de cohorte à cette fenêtre de renouvellement. Doit correspondre à l’une des valeurs --by-days
--order	Non	asc ou desc. Par défaut : desc

Accepte les options de pagination. Cette commande ne prend aucun filtre de liste — affinez le rapport par niveau d’entité et par période, puis faites correspondre les lignes aux identifiants issus d’une commande list ciblée.

Chaque ligne correspond à une entité, agrégée côté serveur et triée par --order-by. Une question de type top-N se résume donc à un seul appel — définissez --order-by et --page-size N plutôt que de parcourir les résultats page par page pour les additionner :

adapty asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --order-by spend --page-size 5

--metric prend les noms de métriques suivis par Ads Manager, dans la nomenclature du tableau de bord — par exemple spend, taps ou gross_roas. Consultez Métriques pour la liste complète et le mode de calcul de chacune. Un nom inexistant provoque une erreur qui liste les noms valides.

La durée de la période de rapport est limitée par la valeur --group-by la plus grossière. Pour couvrir une période plus longue, augmentez la granularité du regroupement plutôt que de diviser la requête en plusieurs appels :

--group-by le plus grossier	Période maximale
day, ou sans regroupement par période	90 jours
week	180 jours
month et plus grossier	365 jours

Il n’existe pas de métrique ltv. La valeur vie client est une métrique de cohorte lue à une fenêtre de renouvellement, donc --by-days est la façon de demander la valeur à J-7 ou J-90 :

adapty asa metrics --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --metric roas --by-days 7 --by-days 90

--order-by-day classe les lignes selon l’une de ces fenêtres, ce qui renvoie les meilleures campagnes par ROAS à J-90 en un seul appel.

adapty asa metrics overview

Query totals for a period, bucketed by a unit of time.

adapty asa metrics overview --entity campaign --date-from 2026-07-01 --date-to 2026-07-31 --period-unit week

Indicateur	Requis	Description
--entity	Oui	Entité sur laquelle générer le rapport : campaign, ad-group, keyword ou ad
--date-from	Oui	Début de la période (YYYY-MM-DD)
--date-to	Oui	Fin de la période (YYYY-MM-DD)
--period-unit	Non	Taille des intervalles : day, week, month, quarter ou year. Par défaut : day
--metric	Non	Nom de la métrique, répétable. Omettez ce paramètre pour toutes les métriques
--by-days	Non	Fenêtre de renouvellement en jours pour les métriques de cohorte, répétable. Maximum 16 par appel

Cette commande renvoie les totaux pour l’ensemble du niveau d’entité ainsi qu’une série par période, ce qui permet de répondre à la question « combien ai-je dépensé ou gagné au total » en un seul appel. Elle ne comporte ni indicateurs de tri ni pagination.

Sur cette commande, --metric accepte uniquement les racines de cohorte — revenue, roas et arpu — et non leurs variantes gross_, proceeds_ ou net_.

La durée de la période de rapport est limitée par --period-unit :

--period-unit	Période maximale
day	90 jours
week	180 jours
month et plus grossier	365 jours

Concurrents

adapty asa competitors summary

Résume les mots-clés Apple Ads sur lesquels un ensemble d’applications App Store enchérissent. Cette commande renvoie les mêmes données de concurrents que Market Intelligence dans le tableau de bord.

adapty asa competitors summary --app-ids 1668337467,6503873027

Flag	Requis	Description
--app-ids	Oui	Identifiants Apple App Store (adam_id), séparés par des virgules. Entre 1 et 5 valeurs

La période de rapport et l’ensemble de pays sont fixés côté serveur — le dernier mois complet, pour tous les pays. Cette commande ne dispose d’aucun paramètre de période, de pays ou de pagination.

La commande affiche trois blocs : les totaux de l’analyse, les meilleures applications par performance et les termes les plus disputés. Ajoutez --json pour obtenir le résultat complet, qui détaille également les termes de chaque application par pays.

Le premier appel pour un ensemble d’applications peut prendre plusieurs dizaines de secondes pendant la préparation des données. Les appels suivants pour les mêmes applications sont plus rapides.

Erreurs

Statut	Code	Signification
402	ads_manager_subscription_required	La société n’a pas d’abonnement Ads Manager actif
404	—	L’entité n’existe pas, ou elle appartient à une autre société
409	cli_idempotency_in_progress	Une écriture avec la même clé d’idempotence est toujours en cours
422	cli_idempotency_key_reuse	La même clé d’idempotence a été utilisée avec un corps de requête différent
429	cli_analytics_busy	Le pool d’analytique est occupé. Le délai d’attente est dans l’en-tête Retry-After
429	cli_cooldown_active	Trop de requêtes rejetées ont mis le token en période de refroidissement

Les métriques et la liste des termes de recherche partagent un seul budget d’appels par entreprise : 5 appels par minute, et au maximum 2 sur 10 secondes. Une rafale de 20 requêtes rejetées en 5 minutes déclenche un blocage progressif de 5 minutes, puis 30 minutes, puis 3 heures. Relancer des requêtes pendant la pause ne l’allonge pas, mais la solution est de corriger la requête défaillante plutôt que de la répéter.

La CLI gère les courtes attentes automatiquement. Sur un 429 qui n’est pas un blocage, si Retry-After est inférieur ou égal à 60 secondes, la commande attend ce délai et réessaie une fois, en signalant l’attente sur la sortie d’erreur standard.