Creatives ohne GUI in GAM hochladen:
MCP Inline vs CLI Multipart

Warum Creatives programmatisch hochladen?

Die Google Ad Manager-Oberfläche ist für manuelle Nutzung ausgelegt. Sobald Dutzende Banner (A/B-Varianten, Format-Deklinierungen, mehrsprachige Creatives) importiert werden müssen, wird die manuelle Bedienung zum Engpass. CI/CD-Workflows und KI-Agenten benötigen eine zuverlässige programmatische Oberfläche.

OrbiAds stellt hierfür zwei Zugriffspunkte bereit — jeweils für einen anderen Kontext optimiert:

Vergleichstabelle: Formate und Größenlimits

MCP-Beispiel: Inline-Image-Upload über Claude

In einer Claude-Sitzung mit installiertem OrbiAds-Plugin können Sie den Agenten bitten, ein Creative hochzuladen. Der Agent ruft creative_assets mit action="create_image" auf. Die Datei wird lokal gelesen, als base64 kodiert und im JSON-Payload an die GAM-API übertragen.

# In Claude — OrbiAds MCP plugin
creative_assets(
  action="create_image",
  params={
    "name": "Banner 300x250 — Summer Campaign",
    "advertiser_id": 12345,
    "image_bytes": "<base64-encoded PNG>",   # max ~1.1 MB decoded
    "width": 300,
    "height": 250,
    "destination_url": "https://example.com/landing"
  }
)

CLI-Beispiel: Multipart-Upload mit einem Befehl

Die OrbiAds CLI erkennt den Creative-Typ automatisch aus der Dateiendung. Für ein Image-Banner geben Sie die Größe mit --size WxH an:

# Standard image banner
orbiads creatives upload ./banner-300x250.png \
  --name "Banner 300x250 — Summer Campaign" \
  --advertiser-id 12345 \
  --size 300x250 \
  --destination-url "https://example.com/landing"

# HTML5 ZIP (auto-detected from .zip extension)
orbiads creatives upload ./rich-media.zip \
  --name "Rich Media 970x250 — Summer Campaign" \
  --advertiser-id 12345 \
  --size 970x250

# Video pre-roll (requires --duration-ms)
orbiads creatives upload ./preroll-30s.mp4 \
  --name "Pre-roll 30s — Summer Campaign" \
  --advertiser-id 12345 \
  --duration-ms 30000

Welches Tool wählen?

Die Entscheidungsregel ist einfach:

• MCP (Claude / LLM) — Wenn Sie sich bereits in einer KI-Agenten-Sitzung befinden, die Datei kleiner als 1 MB ist und Sie kein Terminal öffnen möchten.
• CLI — Sobald die Datei 1 MB überschreitet, Sie Video oder Audio hochladen oder den Upload in eine CI/CD-Pipeline integrieren (GitHub Actions, Bash-Skripte).

Beide nutzen dasselbe OrbiAds-Backend und erzeugen dasselbe GAM-Creative-Objekt. Der Unterschied liegt rein im Transport: base64-JSON vs. multipart/form-data.

Mit dem programmatischen Creative-Upload beginnen

Installieren Sie OrbiAds als Claude Code-Plugin (claude plugin install orbiads) oder die PyPI-CLI (pip install orbiads-cli). Beide Tools teilen dasselbe OrbiAds-Konto und dieselben Credits.