Configurazione via CLI

Attualmente in beta e non disponibile per gli utenti in prova. Gli utenti paganti possono richiedere l'accesso a [email protected].

Il modo migliore per iniziare con il CLI (interfaccia a riga di comando) è capire come funziona Ads Uploader. Il CLI segue esattamente la stessa struttura dell'applicazione web. Se capisci l'applicazione web e ci hai già caricato annunci, usare il CLI ti risulterà immediato.

Tutti i preset che crei nell'interfaccia web vengono portati nel CLI e sono accessibili da lì. Alcuni utenti trovano più semplice configurare i propri preset nell'applicazione e poi passare al CLI per il lavoro quotidiano sulle campagne. Tutto rimane comunque completamente personalizzabile dal CLI.

Perché usare il CLI? Offre un'interfaccia diversa con un approccio agentico sulla stessa infrastruttura collaudata di Ads Uploader. Caricare più batch è più veloce, e puoi usare l'IA per scrivere il copy e assemblare i build degli annunci. È un altro modo di usare Ads Uploader.

La maggior parte degli utenti pilota il CLI tramite un agente IA come Claude Code o Cursor. Vedi Uso con l'IA in fondo a questa pagina per sapere come consegnare il CLI a un agente una volta configurato.

Installazione e autenticazione

Installa il CLI globalmente con npm install -g @adsuploader/cli (richiede Node.js 18+), poi esegui ads login per autenticarti tramite il browser. Questo usa il tuo account Ads Uploader esistente e la tua connessione Facebook.

Esegui il comando di login sullo stesso dispositivo in cui hai già effettuato l'accesso a adsuploader.com, perché il flusso di autenticazione apre una finestra del browser per verificare la tua identità.

Configurare il tuo account

Una volta effettuato l'accesso, esegui ads accounts per vedere tutti gli account pubblicitari collegati al tuo account Meta, poi ads account act_123456789 per impostare il tuo account predefinito. È lo stesso selettore di account che vedi nell'applicazione web.

Esplorare il tuo account

Prima di creare annunci, puoi esplorare l'intera struttura del tuo account dal CLI, proprio come navigheresti tra campagne, gruppi di inserzioni e annunci nell'applicazione web.

È così che trovi l'annuncio di cui vuoi copiare le impostazioni, o confermi quale preset usare nel tuo file di specifica.

Caricare i media

Carica immagini e video nella libreria media del tuo account pubblicitario con ads upload:

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

Questo restituisce un ID batch a cui farai riferimento quando creerai gli annunci. Esegui ads uploads per vedere i tuoi batch recenti.

Il raggruppamento per varianti funziona automaticamente se nomini i file con suffissi di rapporto, proprio come nell'applicazione web. Consulta Varianti di formato immagine per sapere come nominare correttamente i tuoi file.

Creare annunci

La creazione degli annunci ha due passi: preview e create.

Il file di specifica

Un file JSON di specifica dice al CLI cosa costruire. La specifica più semplice fa riferimento a un preset salvato e al tuo batch di caricamento:

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

Puoi anche copiare le impostazioni da un annuncio esistente invece di usare un preset:

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

Per trovare l'ID annuncio giusto, esplora il tuo account con ads campaigns, ads campaign <id>, ads adset <id> e ads ad <id>.

Prima il preview

Fai sempre il preview prima di creare. Esegui ads create:preview spec.json per vedere esattamente cosa verrebbe creato senza toccare Facebook. Questo intercetta gli errori di configurazione prima che qualcosa vada in diretta.

Creare

Quando sei soddisfatto del preview, esegui ads create spec.json. Gli annunci vanno in diretta per impostazione predefinita, come nell'applicazione web. Per crearli in pausa, aggiungi --status PAUSED o imposta "options": { "status": "PAUSED" } nella specifica.

Riferimento completo

Per il formato completo del file di specifica, tutti i comandi, i flag, la configurazione di miglioramenti creativi, Carousel Ads e Flexible Ads, i segnaposti di denominazione degli annunci e i pattern comuni, consulta il Riferimento completo del CLI.

Monitoraggio dei job

La creazione degli annunci viene eseguita in background. Il CLI trasmette automaticamente l'avanzamento, ma puoi anche controllare un job in un secondo momento:

Suggerimenti

• Fai sempre prima il preview. create:preview intercetta gli errori di configurazione prima di toccare Facebook.
• Gli annunci vanno in diretta per impostazione predefinita. Usa --status PAUSED se vuoi prima controllarli in Ads Manager.
• I caricamenti sono legati a un account. L'ID batch funziona solo con l'account su cui hai caricato.
• I preset vengono trasmessi dall'applicazione web. Crea i tuoi preset nell'UI web e poi referenziali per ID nel CLI.
• Esegui ads config per controllare la tua configurazione. Mostra il tuo account attuale, l'URL API e il percorso delle credenziali.

Uso con l'IA

Il CLI è progettato per essere controllato da agenti IA come Claude Code o Cursor. Una volta installato e autenticato, registra il file skill in modo che il tuo agente capisca ogni comando e ogni opzione di specifica su questa pagina.

Il file skill è incluso nel pacchetto npm in node_modules/@adsuploader/cli/SKILL.md. In Claude Code, configuralo come uno slash command personalizzato (ad esempio, /ads):

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

Poi scrivi /ads in Claude Code per caricare lo skill prima di dare istruzioni. Per altri strumenti IA come Cursor, aggiungi SKILL.md come file di regole o di contesto.

Sicurezza. L'autenticazione del CLI è legata al tuo indirizzo IP e può essere eseguito un solo job di creazione annunci alla volta per account. Il CLI non è pensato per essere integrato in altre applicazioni. È un'interfaccia alternativa per media buyer avanzati.

Esempio di prompt

Una volta configurato, dai al tuo agente IA istruzioni come:

Ho un sacco di nuovi creativi per annunci nella mia cartella downloads/ads. Caricali e crea annunci con le stesse impostazioni del mio preset di campagna vendite/acquisto. Raggruppali in gruppi di inserzioni da cinque nominati con la data di oggi, con un budget giornaliero di 25 $. Scrivi un copy unico per ogni immagine in base al contenuto dell'immagine. Metti in pausa a livello di gruppo di inserzioni e fai prima il preview.