Configuration par CLI

Actuellement en beta et non disponible pour les utilisateurs en essai. Les utilisateurs payants peuvent demander l'accès à [email protected].

La meilleure façon de commencer avec le CLI (interface en ligne de commande) est de comprendre comment fonctionne Ads Uploader. Le CLI suit exactement la même structure que l'application web. Si tu comprends l'application web et que tu y as déjà téléversé des annonces, l'utilisation du CLI te paraîtra immédiatement naturelle.

Tous les préréglages que tu crées dans l'interface web sont transmis au CLI et accessibles depuis celui-ci. Certains utilisateurs trouvent plus simple de configurer leurs préréglages dans l'application puis de passer au CLI pour le travail quotidien sur les campagnes. Tout reste entièrement personnalisable depuis le CLI.

Pourquoi utiliser le CLI ? Il offre une interface différente avec une approche agentique sur la même infrastructure éprouvée d'Ads Uploader. Charger plusieurs lots est plus rapide, et tu peux utiliser l'IA pour rédiger le copy et assembler des builds d'annonces. C'est une autre façon d'utiliser Ads Uploader.

La plupart des utilisateurs pilotent le CLI via un agent IA comme Claude Code ou Cursor. Consulte Utilisation avec l'IA en bas de cette page pour savoir comment confier le CLI à un agent une fois la configuration faite.

Installation et authentification

Installe le CLI globalement avec npm install -g @adsuploader/cli (nécessite Node.js 18+), puis exécute ads login pour t'authentifier via ton navigateur. Cela utilise ton compte Ads Uploader existant et ta connexion Facebook.

Exécute la commande de login sur le même appareil où tu es déjà connecté à adsuploader.com, car le flux d'authentification ouvre une fenêtre du navigateur pour vérifier ton identité.

Configurer ton compte

Une fois connecté, exécute ads accounts pour voir tous les comptes publicitaires liés à ton compte Meta, puis ads account act_123456789 pour définir ton compte par défaut. C'est le même sélecteur de compte que tu vois dans l'application web.

Explorer ton compte

Avant de créer des annonces, tu peux explorer toute la structure de ton compte depuis le CLI, exactement comme tu cliquerais à travers les campagnes, ensembles de publicités et annonces dans l'application web.

C'est ainsi que tu trouves l'annonce dont tu veux copier les paramètres, ou que tu confirmes quel préréglage utiliser dans ton fichier de spécification.

Téléverser des médias

Téléverse des images et des vidéos dans la bibliothèque de médias de ton compte publicitaire avec ads upload :

ads upload hero.jpg banner.mp4 promo.mp4
ads upload ./my-creatives/

Cela renvoie un ID de lot que tu référenceras lors de la création d'annonces. Exécute ads uploads pour voir tes lots récents.

Le regroupement par variante fonctionne automatiquement si tu nommes tes fichiers avec des suffixes de ratio, exactement comme dans l'application web. Consulte Variantes de format d'image pour savoir comment nommer correctement tes fichiers.

Créer des annonces

La création d'annonces comporte deux étapes : preview et create.

Le fichier de spécification

Un fichier JSON de spécification indique au CLI ce qu'il doit construire. La spécification la plus simple référence un préréglage enregistré et ton lot de téléversement :

{ "adPresetId": "your_preset_id", "uploadId": "batch_abc123" }

Tu peux aussi copier les paramètres d'une annonce existante au lieu d'utiliser un préréglage :

{ "copyFromAd": "120233848667930472", "uploadId": "batch_abc123" }

Pour trouver le bon ID d'annonce, explore ton compte avec ads campaigns, ads campaign <id>, ads adset <id> et ads ad <id>.

Prévisualise d'abord

Prévisualise toujours avant de créer. Exécute ads create:preview spec.json pour voir exactement ce qui serait créé sans toucher à Facebook. Cela permet de détecter les erreurs de configuration avant que quoi que ce soit ne passe en direct.

Créer

Quand tu es satisfait de la prévisualisation, exécute ads create spec.json. Les annonces passent en direct par défaut, comme dans l'application web. Pour les créer en pause, ajoute --status PAUSED ou définis "options": { "status": "PAUSED" } dans la spécification.

Référence complète

Pour le format complet du fichier de spécification, toutes les commandes, tous les flags, la configuration des améliorations créatives, des Carousel Ads et des Flexible Ads, les marqueurs de nommage d'annonces et les modèles courants, consulte la Référence complète du CLI.

Suivi des jobs

La création d'annonces s'exécute en arrière-plan. Le CLI diffuse la progression automatiquement, mais tu peux aussi consulter un job plus tard :

Astuces

• Prévisualise toujours d'abord. create:preview détecte les erreurs de configuration avant de toucher à Facebook.
• Les annonces passent en direct par défaut. Utilise --status PAUSED si tu veux d'abord les vérifier dans Ads Manager.
• Les téléversements sont liés à un compte. L'ID de lot ne fonctionne qu'avec le compte sur lequel tu as téléversé.
• Les préréglages sont transmis depuis l'application web. Crée tes préréglages dans l'UI web, puis référence-les par ID dans le CLI.
• Exécute ads config pour vérifier ta configuration. Affiche ton compte actuel, l'URL de l'API et le chemin des identifiants.

Utilisation avec l'IA

Le CLI est conçu pour être contrôlé par des agents IA comme Claude Code ou Cursor. Une fois installé et authentifié, enregistre le fichier skill pour que ton agent comprenne chaque commande et chaque option de spécification de cette page.

Le fichier skill est livré dans le paquet npm à l'emplacement node_modules/@adsuploader/cli/SKILL.md. Dans Claude Code, configure-le comme une commande slash personnalisée (par exemple, /ads) :

mkdir -p .claude/commands
cp node_modules/@adsuploader/cli/SKILL.md .claude/commands/ads.md

Puis tape /ads dans Claude Code pour charger le skill avant de donner des instructions. Pour d'autres outils IA comme Cursor, ajoute SKILL.md comme fichier de règles ou de contexte.

Sécurité. L'authentification du CLI est liée à ton adresse IP, et un seul job de création d'annonces peut s'exécuter à la fois par compte. Le CLI n'est pas destiné à être intégré à d'autres applications. C'est une interface alternative pour les media buyers avancés.

Exemple de prompt

Une fois configuré, donne à ton agent IA des instructions comme :

J'ai plein de nouveaux créatifs publicitaires dans mon dossier downloads/ads. Téléverse-les et crée des annonces avec les mêmes paramètres que mon préréglage de campagne de ventes/achat. Regroupe-les par ensembles de publicités de cinq nommés avec la date d'aujourd'hui, avec un budget quotidien de 25 $. Écris un copy unique pour chaque image en fonction de son contenu. Mets en pause au niveau de l'ensemble de publicités et prévisualise d'abord.