Überblick
Die Social-Media-Kampagnen-API ermöglicht automatisierte Marketingkampagnen für Ihre Fahrzeuginserate auf den wichtigsten sozialen Plattformen. Starten Sie Multi-Platform-Kampagnen, verfolgen Sie Performance-Metriken und verwalten Sie das Werbebudget direkt in Steer AI.Unterstützte Plattformen
Facebook Marketplace- und News-Feed-Anzeigen
Instagram-Feed- und Stories-Anzeigen
TikTok
TikTok For You-Page-Anzeigen (in Kürze)
Voraussetzungen
Bevor Sie die Campaigns-API nutzen, müssen Sie:- Ihre Social-Media-Konten über den upload-post-Service verbinden
- Ein aktives Facebook Business Manager-Konto haben
- Zahlungsmethoden für Werbekonten einrichten
Endpunkte
Facebook-Seiten abrufen
/ads/facebook/pages
Facebook-Seiten-ID
Anzeigename der Seite
URL des Profilbilds
Zugehörige Facebook-Werbekonto-ID
Dieser Endpunkt ist 5 Minuten gecacht, um die Performance zu verbessern.
Kampagne aktivieren
/ads/campaigns/activate
Kampagnen-UUID aus Ihrem Marketing-System
Array der Plattformnamen:
facebook, instagram, tiktok. Mindestens eine Plattform erforderlich.Array plattformspezifischer Ergebnisse
Ob die Kampagne auf dieser Plattform erfolgreich gestartet wurde
Plattform-spezifische Kampagnen-ID
Plattform-spezifische Anzeigengruppen-ID
Plattform-spezifische Anzeigen-ID
Plattformname (facebook, instagram, tiktok)
Fehlermeldung, falls die Kampagne fehlschlug
Kampagnenmetriken abrufen
/ads/campaigns//metrics
Kampagnen-UUID
Plattform für die Metriken:
facebook, instagram, tiktokAnzahl der Anzeigen-Impressionen
Anzahl der Klicks
Anzahl erfolgreicher Conversions (Leads, Anfragen usw.)
Gesamtbetrag der Ausgaben (Kontowährung)
Klickrate in Prozent
Kosten pro Klick
Kosten pro tausend Impressionen (Mille)
Einzigartige Nutzer, die die Anzeige gesehen haben
Durchschnittliche Anzeigenhäufigkeit pro Nutzer
Prozentsatz der Klicks, die konvertiert haben
Metriken sind 1 Minute gecacht. Daten können 24–48 Stunden benötigen, um sich auf Plattformseite zu stabilisieren.
Kampagne pausieren
/ads/campaigns//pause
Kampagnen-UUID
Plattform zum Pausieren:
facebook, instagram, tiktokKampagnen-Workflow
Best Practices für Kampagnen
Zielgruppen-Targeting
Konfigurieren Sie Kampagnen für optimale Reichweite:- Standort: Zielstädte oder Regionen, in denen Sie aktiv sind
- Altersbereich: Typischerweise 25–54 für Autokäufe
- Interessen: Autoenthusiasten, Neuwagenkäufer, Premiumfahrzeuge
- Verhalten: In-market für Fahrzeuge, kürzlich umgezogen, neuer Job
Budget-Empfehlungen
| Kampagnentyp | Tagesbudget | Laufzeit | Erwartete Ergebnisse |
|---|---|---|---|
| Lokale Bekanntheit | $20-50 | 7-14 Tage | 5.000-15.000 Reichweite |
| Lead-Generierung | $50-100 | 14-30 Tage | 50-150 Leads |
| Bestands-Showcase | $100-200 | 30-60 Tage | 100-300 Anfragen |
| Sonderaktion | $200-500 | 7-14 Tage | 200-500 Leads |
Kreativ-Richtlinien
Bilder:- Hochwertige Fahrzeugfotos (1080x1080 empfohlen)
- Mehrere Winkel von außen und innen
- Professionelle Beleuchtung und saubere Hintergründe
- Preis oder Sonderangebot als Overlay
- Klare, prägnante Botschaft (125 Zeichen oder weniger)
- Marke, Modell, Jahr nennen
- Wichtige Features oder Vorteile hervorheben
- Starker Call-to-Action (“Testfahrt vereinbaren”, “Details ansehen”)
- 15-30 Sekunden optimale Länge
- Fahrzeug in Bewegung und Details zeigen
- Untertitel hinzufügen (80% schauen ohne Ton)
- Branding am Anfang und Ende
Anwendungsfälle
Beispiel 1: Multi-Platform-Kampagne starten
Beispiel 2: Kampagnen-Performance überwachen
Beispiel 3: Schwache Kampagne pausieren
Fehlercodes
| Code | Status | Beschreibung |
|---|---|---|
USER_NOT_REGISTERED | 400 | Nutzer nicht beim upload-post-Service registriert |
ACCOUNT_NOT_CONNECTED | 400 | Social-Media-Konto nicht verbunden |
CAMPAIGN_NOT_FOUND | 404 | Kampagnen-ID existiert nicht |
INVALID_PLATFORM | 400 | Nicht unterstützte Plattform angegeben |
INSUFFICIENT_AD_CREDIT | 402 | Nicht genug Guthaben im Werbekonto |
PAGE_NOT_FOUND | 404 | Facebook-Seite nicht gefunden oder nicht zugänglich |
PERMISSION_DENIED | 403 | Fehlende erforderliche Berechtigungen |
CAMPAIGN_ALREADY_ACTIVE | 400 | Kampagne läuft bereits |
Plattform-spezifische Hinweise
Facebook/Instagram
- Erfordert Facebook Business Manager-Konto
- Werbekonto muss eine Zahlungsmethode eingerichtet haben
- Seite benötigt mindestens 30 Follower für Boosted Posts
- Review-Zeiten: typischerweise 24 Stunden, bis zu 48 Stunden bei komplexen Anzeigen
- Mindest-Tagesbudget: $5 USD äquivalent
TikTok
- Derzeit in Entwicklung
- Erfordert TikTok Business-Konto
- Mindest-Tagesbudget: $20 USD äquivalent
- Review-Zeiten: bis zu 24 Stunden