--- title: "Gérer Apple Ads avec un outil de codage IA" description: "Installez la compétence ads-manager pour que Claude Code, Copilot CLI, Codex ou Gemini CLI puissent gérer vos campagnes Apple Ads via l'Adapty CLI." --- La compétence `ads-manager` permet à un outil de codage IA d'opérer votre compte Apple Ads via l'[Adapty CLI](developer-cli-ads-manager). Posez une question en langage naturel, et il détermine quelles commandes y répondent, lit d'abord le compte, puis propose l'écriture avant que quoi que ce soit n'atteigne Apple. Une compétence est un ensemble d'instructions que votre outil IA charge à la demande. Celle-ci couvre les parties de la surface Ads Manager les plus susceptibles d'erreurs : quel identifiant chaque option accepte, quel filtre chaque liste prend, combien de mots-clés tiennent dans un lot, et quels appels coûtent de l'argent. ## Ce que ça gère \{#what-it-handles\} - **Performance de lecture** : Choisit le seul appel qui répond à une question plutôt que de parcourir les résultats page par page. Il sait qu'une question sur les N premiers résultats correspond à un appel ordonné, et que compter des entités ne nécessite aucun appel de métriques. - **Modifications structurelles** : Crée et met à jour des campagnes, groupes d'annonces, annonces et mots-clés dans le bon ordre, en lisant l'entité parente avant d'écrire l'entité enfant. - **Travail sur les mots-clés** : Ajoute et revalorise les mots-clés par lots, et récolte les termes de recherche pour les convertir en mots-clés et mots-clés négatifs. - **Automatisations** : Configure des automatisations basées sur des règles et les exécute en mode test avant qu'elles ne touchent aux enchères en production. - **Recherche concurrentielle** : Récupère les mots-clés sur lesquels les applications concurrentes enchérissent. ## Ce qu'il ne fera pas \{#what-it-will-not-do\} L'outil traite chaque écriture comme irréversible, parce qu'elle l'est — la CLI n'a pas de suppression, et les modifications parviennent à Apple en quelques secondes. - Il lit avant d'écrire, plutôt que de deviner un ID ou un budget. - Il demande confirmation avant toute commande qui engage de l'argent, et laisse en place la propre invite de confirmation de la CLI quand c'est vous qui exécutez la commande. - Il associe une clé d'idempotence à chaque écriture dans une chaîne, afin qu'une nouvelle exécution après un résultat incertain ne crée pas une deuxième campagne. - Il préfère les petits lots, pour qu'un rejet partiel d'Apple reste facile à lire. :::note La compétence recommande et prépare des commandes. La lecture des métriques et les simulations ne coûtent rien, mais vous restez responsable d'approuver tout ce qui modifie un compte publicitaire actif. ::: ## Installer la compétence \{#install-the-skill\} La [compétence ads-manager](https://github.com/adaptyteam/adapty-sdk-integration-skill) apprend à votre outil de codage IA à opérer Apple Ads via les commandes `adapty asa`. Elle connaît l'ordre dans lequel les commandes se composent, ce qu'il faut lire avant d'écrire quoi que ce soit, et quels appels dépensent de l'argent. **Outils compatibles** : Claude Code, GitHub Copilot CLI, OpenAI Codex, Gemini CLI. La compétence pilote l'Adapty CLI — installez et authentifiez d'abord le CLI, voir le [guide de démarrage rapide](developer-cli-quickstart). Les commandes `adapty asa` sont disponibles à partir d'**Adapty CLI 0.4.0** ; sur une version antérieure, elles n'existent pas du tout. Vérifiez avec `adapty asa whoami`, qui vous indique aussi si un compte Apple Ads est connecté et si l'entreprise dispose d'un abonnement Ads Manager actif. Dans un espace de travail Cowork d'entreprise, un administrateur doit ajouter `adapty.io` et `*.adapty.io` à la liste d'autorisation de domaines. Listez les deux : un caractère générique ne couvre pas le domaine apex dans la plupart des implémentations de liste d'autorisation, et c'est là que vit la documentation que la compétence consulte. Tant que les deux ne sont pas autorisés, la compétence ne peut pas accéder à Adapty. Pour l'installer, choisissez le format correspondant à votre outil. La liste complète se trouve dans le [README de la compétence](https://github.com/adaptyteam/adapty-sdk-integration-skill). **Claude Code** ```bash claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill claude plugin install adapty-sdk-integration@adapty ``` Ce plugin contient également la compétence d'intégration SDK. Les deux sont installés ensemble. **GitHub Copilot CLI** ```bash git clone https://github.com/adaptyteam/adapty-sdk-integration-skill.git cp -r adapty-sdk-integration-skill/skills/* ~/.copilot/skills/ ``` **Gemini CLI** ```bash gemini skills install https://github.com/adaptyteam/adapty-sdk-integration-skill ``` **OpenAI Codex ou tout autre outil** — utilisez le [skills CLI](https://skills.sh) (notez que les compétences installées de cette façon ne se mettent pas à jour automatiquement) : ```bash npx skills add adaptyteam/adapty-sdk-integration-skill --all ``` `--all` installe les deux compétences dans chaque agent détecté. Pour cette compétence seule, utilisez `--skill ads-manager`. Vous pouvez aussi cloner le dépôt et copier les répertoires sous `skills/` dans le répertoire de compétences de votre outil — ou juste `skills/ads-manager/` si vous ne voulez que celle-ci. Après l'installation, lancez la compétence dans votre projet : ```bash /ads-manager ``` La lecture des métriques et les simulations (dry runs) sont gratuites. Toute autre commande atteint Apple en quelques secondes, dépense de l'argent réel, et ne peut pas être annulée — la compétence vous demande confirmation avant chacune, et vous devriez en faire autant. ## En quoi il diffère de l'agent IA \{#how-it-differs-from-the-ai-agent\} Adapty Ads Manager dispose également d'un [agent IA](ads-manager-ai-agent) intégré dans le tableau de bord. Les deux répondent à des besoins différents : | | Agent IA | compétence ads-manager | |---|---|---| | Où il s'exécute | Le tableau de bord Adapty | Votre terminal, dans votre outil de développement IA | | Ce qu'il fait | Analyse et recommande | Analyse, recommande et exécute les commandes | | Configuration | Aucune | Adapty CLI et la compétence | Utilisez l'agent IA pour savoir ce qui se passe dans votre compte. Utilisez la compétence lorsque vous souhaitez que la modification soit également effectuée. ## Et ensuite \{#whats-next\} - [Gérer Ads Manager depuis la CLI](developer-cli-ads-manager) — les mêmes tâches manuellement, sans outil IA. - [Commandes Ads Manager](developer-cli-ads-manager-reference) — chaque commande avec ses arguments, ses options et les valeurs acceptées.