Ads CLI Befehle: Komplette Referenz für Meta-Kampagnen

Ads CLI Befehle sind der Schlüssel, um Meta-Werbekampagnen direkt aus dem Terminal zu steuern, statt sich durch den Ads Manager zu klicken. Seit Meta am 29. April 2026 das offizielle Command-Line-Tool veröffentlicht hat, können Entwickler und KI-Agenten Kampagnen, Anzeigengruppen, Creatives und Performance-Daten über strukturierte Befehle verwalten. Dieser Artikel erklärt die wichtigsten Kommandos mit Praxisbeispielen.

Grundstruktur der Meta Ads CLI Befehle

Jeder Befehl folgt einem einheitlichen Muster. Das macht die CLI vorhersagbar und damit ideal für Automatisierung und AI Agents.

Die Syntax lautet immer:

meta-ads <ressource> <aktion> [optionen]

Die verfügbaren Ressourcen decken die gesamte Kampagnenstruktur ab:

1. campaign - Kampagnen erstellen, auflisten, ändern, löschen
2. adset - Anzeigengruppen mit Targeting und Budget verwalten
3. ad - Einzelne Anzeigen steuern
4. creative - Werbemittel hochladen und analysieren
5. insights - Performance-Daten abrufen
6. catalog - Produktkataloge verwalten
7. dataset - Conversion-Daten und Offline-Events

Pro Ressource stehen diese Aktionen zur Verfügung:

Nach der Tabelle wird klar: Wer ein Kommando für Kampagnen kennt, kann es sofort auf Anzeigengruppen oder Creatives übertragen. Dieses einheitliche Schema unterscheidet die CLI deutlich von der API, bei der jede Ressource eigene Endpoints und Parameterformate mitbringt.

Welche Befehle brauche ich für Kampagnen?

Kampagnen bilden die oberste Ebene in der Meta-Ads-Hierarchie. Die campaign-Befehle sind der Startpunkt für jede Arbeit mit dem Tool.

Kampagnen auflisten und filtern

meta-ads campaign list --account-id act_123456 --format table

Dieser Befehl gibt alle Kampagnen im Werbekonto als Tabelle aus. Mit --status ACTIVE lässt sich die Liste auf laufende Kampagnen einschränken. Das ist besonders nützlich, wenn ein KI-Agent nur aktive Kampagnen analysieren soll.

Kampagnendetails abrufen

meta-ads campaign get 120208123456 --format json

Das JSON-Format eignet sich für die Weiterverarbeitung in Skripten. Der Output enthält Name, Status, Budget, Optimierungsziel und Zeitraum.

Kampagne erstellen

meta-ads campaign create --account-id act_123456 \
  --name "Q2 Recruiting DACH" \
  --objective OUTCOME_LEADS \
  --status PAUSED

Neue Kampagnen starten immer im Status PAUSED. Das ist eine bewusste Sicherheitsentscheidung von Meta: Kein CLI-Befehl schaltet versehentlich Budget live. Erst ein explizites update --status ACTIVE aktiviert die Kampagne.

Anzeigengruppen und Ads gezielt steuern

Unterhalb der Kampagne folgen Anzeigengruppen (Ad Sets) und die einzelnen Anzeigen (Ads). Die Befehle funktionieren analog, bieten aber zusätzliche Parameter für Targeting und Budget.

Ad Set mit Budget und Zeitraum erstellen

meta-ads adset create --campaign-id 120208123456 \
  --name "Developer DE 25-45" \
  --daily-budget 5000 \
  --start-time 2026-05-15T00:00:00 \
  --targeting '{"geo_locations":{"countries":["DE"]}}'

Das Budget wird in Cent angegeben. 5000 entspricht 50 Euro Tagesbudget. Targeting wird als JSON übergeben, was die Integration in automatisierte Workflows vereinfacht.

Anzeige einer Ad Group zuordnen

meta-ads ad create --adset-id 120209654321 \
  --creative-id 120210111222 \
  --name "Creative A - Developer" \
  --status PAUSED

Auch hier gilt: Der Status startet bei PAUSED. Erst nach Prüfung durch den Menschen wird live geschaltet. Wer in seinem Unternehmen bereits KI im Marketing einsetzt, erkennt das Muster: Automatisierung übernimmt die Vorbereitung, der Mensch gibt frei.

Wie liest man Insights über die CLI aus?

Performance-Daten abzurufen ist der häufigste Anwendungsfall für die CLI. Der insights-Befehl liefert Metriken wie Impressionen, Klicks, Kosten und Conversions.

Standard-Report für eine Kampagne

meta-ads insights get --campaign-id 120208123456 \
  --date-range last_30d \
  --metrics impressions,clicks,spend,cpc,conversions \
  --format table

Der --date-range Parameter akzeptiert relative Zeiträume wie last_7d, last_30d oder absolute Daten im Format YYYY-MM-DD:YYYY-MM-DD.

Breakdowns für detaillierte Analyse

meta-ads insights get --campaign-id 120208123456 \
  --date-range last_14d \
  --metrics impressions,spend,cpc \
  --breakdowns age,gender \
  --format json

Breakdowns zerlegen die Daten nach Dimensionen wie Alter, Geschlecht, Platzierung oder Gerät. Im JSON-Format kann ein Agent diese Daten direkt weiterverarbeiten, Muster erkennen und Optimierungsvorschläge ableiten.

Insights auf Ad-Ebene vergleichen

meta-ads insights get --adset-id 120209654321 \
  --level ad \
  --metrics impressions,ctr,cpc,conversions \
  --sort-by ctr:desc \
  --format table

Mit --level ad und --sort-by lassen sich die besten Anzeigen einer Gruppe direkt identifizieren. Genau diesen Workflow nutzt auch das in unserem Meta Ads CLI Überblick beschriebene Praxisbeispiel, bei dem ein KI-Agent die Top-Creatives erkennt und daraus neue Entwürfe ableitet.

Welches Output-Format eignet sich für welchen Zweck?

Die CLI unterstützt drei Ausgabeformate. Die Wahl hängt vom Einsatzszenario ab.

Für den Unternehmenseinsatz bedeutet das: Wer ein menschliches Team hat, das im Terminal arbeitet, nutzt table. Wer KI-Agenten oder Skripte einsetzt, arbeitet mit json. Und wer klassische Unix-Pipelines baut, greift zu plain.

Ein konkretes Beispiel für die Kombination:

meta-ads campaign list --format plain | grep ACTIVE | wc -l

Dieser Einzeiler zählt alle aktiven Kampagnen im Konto. Solche Kombinationen machen die CLI zu einem echten Automatisierungswerkzeug.

Wie funktionieren Exit-Codes in der Meta Ads CLI?

Exit-Codes sind für Automatisierung unverzichtbar. Sie signalisieren Skripten und Agenten, ob ein Befehl erfolgreich war oder warum er fehlgeschlagen ist.

In einem Shell-Skript lässt sich damit eine robuste Fehlerbehandlung bauen:

meta-ads campaign list --account-id act_123456 --format json
if [ $? -eq 3 ]; then
  echo "Token erneuern"
  meta-ads auth refresh
fi

Für CI/CD-Pipelines und automatisierte Reporting-Workflows sind diese standardisierten Codes entscheidend. Ein Agent kann bei Exit-Code 3 selbstständig den Token erneuern und den Befehl wiederholen, statt den gesamten Workflow abzubrechen.

Creative- und Catalog-Befehle für E-Commerce

Neben Kampagnensteuerung und Analytics deckt die CLI auch Creative-Management und Produktkataloge ab.

Creative hochladen

meta-ads creative create --account-id act_123456 \
  --name "Banner Q2 Developer" \
  --image-url "https://example.com/banner.jpg" \
  --title "Jetzt bewerben" \
  --body "Wir suchen KI-Entwickler in München"

Katalog-Produkte auflisten

meta-ads catalog list --catalog-id 789012 --format table

Dataset für Offline-Conversions

meta-ads dataset upload --dataset-id 345678 \
  --file conversions.csv \
  --format plain

Catalog- und Dataset-Befehle sind besonders für E-Commerce-Unternehmen relevant, die Produktfeeds und Offline-Conversions automatisiert an Meta übergeben. Statt CSV-Dateien manuell im Business Manager hochzuladen, läuft der Upload als Cronjob oder Agent-Task.

Automatisierung: Ads CLI Befehle in Skripten nutzen

Die eigentliche Stärke der CLI zeigt sich erst in der Kombination mehrerer Befehle. Ein typischer Automatisierungs-Workflow für ein Performance-Team sieht so aus:

1. Aktive Kampagnen auflisten
2. Insights der letzten 7 Tage abrufen
3. Kampagnen mit CPC über Schwellenwert identifizieren
4. Budget dieser Kampagnen reduzieren oder pausieren
5. Report als JSON für das Dashboard exportieren

#!/bin/bash
ACCOUNT="act_123456"

meta-ads insights get --account-id $ACCOUNT \
  --level campaign \
  --date-range last_7d \
  --metrics campaign_id,campaign_name,spend,cpc,conversions \
  --format json > report.json

Dieses Skript erzeugt einen strukturierten Report, den ein Agent oder ein nachgelagertes Tool weiterverarbeiten kann. Die Kombination aus CLI-Befehlen und JSON-Output ist der Grund, warum Meta das Tool explizit für AI Agents konzipiert hat.

Voraussetzungen und häufige Fehler

Bevor die Befehle funktionieren, müssen drei Dinge stimmen:

1. Python 3.12+ muss installiert sein
2. Installation über pip install meta-ads-cli oder uv pip install meta-ads-cli. Die Schritt-für-Schritt-Anleitung finden Sie im Guide Meta Ads CLI installieren.
3. Authentifizierung über meta-ads auth login mit gültigem Access Token

Die häufigsten Fehler bei der Arbeit mit der CLI:

• Exit-Code 3 direkt nach Login: Der Token hat nicht die nötigen Berechtigungen. Im App Dashboard die Permissions ads_management und ads_read prüfen.
• Leere Ergebnisse bei insights: Der angegebene Zeitraum enthält keine Daten. Mit --date-range last_30d testen, ob überhaupt Daten vorliegen.
• Budget wird nicht übernommen: Wert in Cent angeben, nicht in Euro. 5000 Cent = 50 Euro.
• Kampagne startet nicht: Neuerstellte Ressourcen starten immer im Status PAUSED. Explizit mit update --status ACTIVE aktivieren.

Ads CLI Befehle im Überblick

Die Meta Ads CLI bringt Struktur in die Kampagnensteuerung. Statt grafischer Oberfläche arbeiten Sie mit vorhersagbaren Kommandos, maschinenlesbaren Outputs und standardisierten Fehlercodes. Für Teams, die Meta Ads operativ betreuen, bedeutet das: weniger Klicken, mehr Automatisieren. Für KI-Agenten bedeutet es: endlich eine saubere Schnittstelle zu Meta-Werbung, ohne die Umwege über die Marketing API.

Sie möchten KI-gestützte Workflows für Ihr Performance Marketing aufsetzen? Sprechen Sie uns an - wir beraten Sie unverbindlich.