Dokumentation · Admin-Referenz

Content Studio-Referenz

Dieses Dokument ist eine Referenz für den Content Studio-Bildschirm des ADP Car Market Hub-Plugins. Content Studio ist der Marketing-Assistent des Plugins: Er verwandelt ein Fahrzeug, das sich bereits in Ihrem Bestand befindet, in sofort einsatzbereite Marketing-Inhalte – Text, Bilder und kurze Videos – für Social Media und andere Kanäle (Facebook, Instagram, TikTok, YouTube, Google Business Profile, WhatsApp, einen Garagen-Newsletter oder Ihre eigene Website). Sie erreichen ihn über CMH Center → Content Studio (admin.php?page=as24ci-content-studio).

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie ein Administrator oder Marketing-Benutzer sind und Folgendes tun müssen:

  • Einen Social-Media- oder Marketing-Beitrag für ein bestimmtes Fahrzeug erstellen – Text, ein Marketing-Bild oder ein kurzes Video.
  • Das richtige Plattformformat auswählen (zum Beispiel einen Facebook-Post im Vergleich zu einer Instagram-Story oder ein Facebook-Reel im Vergleich zu einem YouTube-Short).
  • Ein kurzes Marketing-Video mit Google Veo erstellen, optional mit einem deutschen Voice-over.
  • Den Beitrag in einer oder mehreren Sprachen generieren.
  • Die Standardsprache, den Tonfall und die "Stimme" der Garage für generierte Beiträge festlegen.
  • Den Google-API-Schlüssel speichern, der für die Textgenerierung verwendet wird.
  • Zuvor generierte Inhalte finden, kopieren oder löschen.

Übersicht

Content Studio liest die Daten eines Fahrzeugs aus, das bereits in Ihrem Bestand vorhanden ist, und erstellt ein kanalfertiges Inhaltspaket: Marketingtext (Bildunterschrift, Hashtags und je nach Format ein Call-to-Action), ein Marketing-Bild und – bei Videoformaten – ein kurzes Marketing-Video. Es schreibt immer nur in seine eigenen Content Studio-Datensätze – es ändert keine Fahrzeug-Beiträge, Importe, Leads, Analytics, Suchabos oder Frontend-Seiten. Sie kopieren oder laden die generierten Inhalte aus dem Content Studio herunter und veröffentlichen sie auf dem Kanal Ihrer Wahl; das Plugin veröffentlicht nicht automatisch in den sozialen Netzwerken für Sie.

Die Text- und Bildgenerierung läuft über die generative KI von Google, und kurze Videos werden mit Google Veo erstellt. Ihre Garage stellt den Google-API-Schlüssel bereit und besitzt diesen; er wird verschlüsselt im Plugin gespeichert. Ohne einen Schlüssel können Sie zwar Formate einrichten und Entwurfsaufträge erstellen, es werden jedoch keine Inhalte generiert, bis ein Schlüssel gespeichert ist.

Der Bildschirm ist in drei Abschnitte (Unterregisterkarten) unterteilt, die oben auf der Seite als Pill-Buttons angezeigt werden:

UnterregisterkarteZweck
Beitrag erstellenWählen Sie ein Fahrzeug, ein Format/eine Plattform, den Tonfall sowie die Sprache(n) aus und generieren Sie den Beitrag. Dies ist die Standard-Unterregisterkarte.
BibliothekDurchsuchen, filtern, kopieren und löschen Sie die bereits generierten Beiträge.
EinstellungenSpeichern Sie den Google-API-Schlüssel und legen Sie die Standardsprache, den Tonfall, die Markenstimme sowie Richtlinien für Compliance/Disclaimer fest.

Über den Unterregisterkarten zeigt eine Reihe von Statuskarten eine schnelle Übersicht: Google-Verbindung (Bereit oder Fehlend), Verfügbare Fahrzeuge, Generierte Beiträge, Marketing-Bilder, Marketing-Videos und Gespeicherte Inhalte.

Anforderungen oder Voraussetzungen

  • Ein Benutzer mit der Verwaltungsberechtigung des Plugins (dieselbe Rolle, die auch die anderen CMH-Admin-Seiten öffnen kann).
  • Mindestens ein Fahrzeug im Bestand, über das Inhalte generiert werden können. Siehe Referenz zum Fahrzeug-Importer.
  • Ein Google-API-Schlüssel für die Textgenerierung, der unter der Unterregisterkarte Einstellungen eingetragen ist. Ihre Garage besitzt diesen Schlüssel.
  • Content Studio muss in Ihrer Lizenz enthalten sein. Wenn dies nicht der Fall ist, zeigt die Seite nur eine einzige Karte "Content Studio ist für diese Lizenz nicht aktiv" an, und es werden keine Einstellungen, Schlüsselfelder oder Steuerelemente für die Generierung gerendert. Kontaktieren Sie den Support von ADP Car Market Hub, um es zu aktivieren.


Die drei Content Studio-Unterregisterkarten

1. Beitrag erstellen

Hier erstellen Sie einen Beitrag. Gehen Sie von oben nach unten vor:

  1. Fahrzeug finden. Verwenden Sie die Filterleiste (Marke, Modell, Status und eine Freitextsuche), um die Fahrzeugliste einzugrenzen, und wählen Sie dann das Fahrzeug aus, das Sie bewerben möchten. Die Liste ist bei grossen Beständen paginiert.
  2. Format wählen. Die Formate sind in fünf Kategorien unterteilt. Zu den aktiven Formaten gehören: - Social-Media-Text — Facebook-Beitrag, Instagram-Feed-Bildunterschrift, Instagram-Story-Overlay, TikTok-Hook und -Bildunterschrift, Google Business Profile-Beitrag, WhatsApp-Verkaufsnachricht. - Newsletter & Website — Newsletter-Teaser für die Garage, Website-Teaser-Block. - Bilder — ein generiertes Marketingbild für das Fahrzeug. - Video — kurze Marketingvideos, die mit Google Veo generiert werden: zum Beispiel Facebook Reel, YouTube Short, YouTube-Video und ein Fahrzeug-Galerievideo. Videos sind etwa 8 Sekunden lang und werden je nach Format im Format 9:16 (vertikal) oder 16:9 (Querformat) erstellt. - Voice-over — ein optionales deutsches Voice-over, das einem generierten Video hinzugefügt werden kann.

Einige einzelne Formate sind möglicherweise mit Demnächst verfügbar gekennzeichnet; diese können noch nicht generiert werden, aber der Rest des Formatkatalogs steht zur Verfügung.

  1. Tonalität wählen. Die Tonalität steuert ausschliesslich den Schreibstil. Regionale Automobil-Begriffe (z. B. Schweizer Garage, deutsches Autohaus, französisches concessionnaire) werden automatisch basierend auf der ausgewählten Ausgabesprache angewendet, sodass Sie dies hier nicht einstellen müssen.
  2. Eine oder mehrere Sprachen wählen. Sie können denselben Beitrag in mehreren Sprachen gleichzeitig generieren; pro ausgewählter Sprache wird ein Beitrag erstellt.
  3. Für Videoformate Optionen wählen. Mit einer Referenzfoto-Auswahl können Sie eines der Fotos des Fahrzeugs auswählen, um das Video zu verankern, und Sie können das optionale deutsche Voice-over aktivieren.
  4. Generieren. Wenn Sie auf Beitrag generieren klicken, kehrt die Seite sofort zurück und zeigt ein Fortschrittsbanner an („Ihr Beitrag wird generiert…“). Die Generierung läuft im Hintergrund; wenn sie abgeschlossen ist — in der Regel nach einigen Sekunden pro Sprache für Text, bei Videos länger —, wechselt der Browser automatisch zur Bibliothek und öffnet das fertige Content-Paket, bereit zum Kopieren oder Herunterladen. Sie können auch selbst zur Bibliothek navigieren, während die Generierung noch läuft: Ausstehende Einträge zeigen ein pulsierendes Wird generiert…-Badge und die Seite aktualisiert sich von selbst, sobald der Inhalt bereit ist. Wenn noch kein Schlüssel hinterlegt ist, wird der Auftrag als Entwurf erstellt und ein Hinweis erinnert Sie daran, in den Einstellungen einen Schlüssel hinzuzufügen.

Falls Google kurzzeitig nicht erreichbar ist oder die Anfrage drosselt (Rate-Limiting), versucht das Content Studio es automatisch erneut (bis zu drei Versuche mit einer kurzen Wartezeit dazwischen). Sie sehen einen Fehlgeschlagen-Status nur dann, wenn das Problem dauerhaft ist — zum Beispiel bei einem ungültigen Schlüssel —, und selbst dann können Sie den Auftrag über die Schaltfläche Erneut versuchen auf der Bibliothekskarte nochmals ausführen.

Ein Status-Symbol oben auf dieser Unterregisterkarte zeigt System bereit an, wenn sowohl ein Google-API-Schlüssel als auch mindestens ein Fahrzeug vorhanden sind, andernfalls Einrichtung erforderlich mit einer Verknüpfung zu den Einstellungen.

2. Bibliothek

Die Unterregisterkarte „Bibliothek“ ist Ihr Archiv für generierte Inhalte. Jeder generierte Beitrag wird als Karte mit seinem Fahrzeug, der Plattform, der Sprache und (falls verfügbar) dem generierten Marketingbild angezeigt. Sie können:

  • Nach Fahrzeug, Plattform, Sprache, Status (Bereit, Entwurf, Geplant, Fehlgeschlagen, Archiviert) oder über eine Freitext-Suche filtern.
  • Eine Karte öffnen, um das generierte Content-Paket zu überprüfen und zu kopieren (Vollständigen Beitrag kopieren kopiert alles mit einem Klick), sowie eine Vorschau des generierten Bildes oder Videos anzeigen oder dieses herunterladen.
  • Paket herunterladen (ZIP) — lädt eine ZIP-Datei pro Element herunter, die post.txt (den vollständigen Beitragstext), das generierte Marketingbild oder -video (falls vorhanden) und alt-text.txt mit der Bildbeschreibung enthält. Dies ist der schnellste Weg, um alles auf die Social-Media-Plattform Ihrer Wahl zu übertragen.
  • Ein fehlgeschlagenes Element Erneut versuchen oder ein einzelnes gespeichertes Element, das Sie nicht mehr benötigen, Löschen.

Einträge, die noch generiert werden, zeigen ein pulsierendes Wird generiert…-Badge und werden automatisch aktualisiert — eine manuelle Aktualisierung ist nicht erforderlich. Eine Massenbereinigung ist noch nicht verfügbar; entfernen Sie Elemente einzeln über die Löschaktion auf der jeweiligen Karte.

3. Einstellungen

Die Unterregisterkarte „Einstellungen“ enthält alles, was für jeden generierten Beitrag gilt. Sie ist in drei Karten unterteilt:

  • Google-Verbindung — Geben Sie den Google API-Schlüssel ein (wird verschlüsselt gespeichert; lassen Sie das Feld leer, um den bestehenden Schlüssel zu behalten). Über ein Kontrollkästchen können Sie den gespeicherten Schlüssel entfernen. Die Kopfzeile der Karte zeigt an, ob derzeit ein Schlüssel gespeichert ist. Unter dem Feld erklärt ein Hilfefeld, wie Sie einen Schlüssel erhalten, und verlinkt auf Ihre Google-Nutzungs- und Abrechnungsseiten. Sobald ein Schlüssel gespeichert ist, erscheinen zwei weitere Elemente:
  • Schlüssel überprüfen — eine Ein-Klick-Verbindungsprüfung. Sie sendet eine einzelne kostenlose Metadatenanfrage (es werden keine Token verbraucht, nichts wird in Rechnung gestellt) und meldet entweder „Schlüssel funktioniert“ oder die genaue Fehlermeldung von Google, sodass Schlüsselprobleme bereits bei der Einrichtung und nicht erst bei der ersten Generierung auftreten.
  • Google API-Nutzung — eine kleine Tabelle der letzten drei Monate: generierte Beiträge, verwendete Token und generierte Marketingbilder. Dies sorgt für Transparenz darüber, was das Plugin an Google gesendet hat; die massgebliche Abrechnung erfolgt immer in Ihrem eigenen Google-Konto (die verlinkte Seite „Nutzung & Abrechnung“ in Google AI Studio oder die Abrechnungsseite der Cloud Console für Cloud-Schlüssel).
  • Markenstimme — Legen Sie die Standardsprache, die Standardtonalität und eine optionale Markenstimme der Garage fest (eine kurze, sachliche Beschreibung, wie Ihre Garage normalerweise in Beiträgen kommuniziert, bis zu 800 Zeichen). Tragen Sie hier keine Geheimnisse, Preise oder Finanzierungskonditionen ein.
  • Compliance und Haftungsausschluss — Legen Sie einen optionalen Standard-Haftungsausschluss (bis zu 500 Zeichen, z. B. „Änderungen und Zwischenverkauf vorbehalten“) und optionale Compliance-Hinweise fest (bis zu 1000 Zeichen, z. B. „Niemals spezifische Finanzierungssätze nennen“). Diese zwingenden Regeln überschreiben immer sowohl die Tonalität als auch die Markenstimme.


Setting up the Google API key

Content Studio generiert Texte und Bilder mit Google Gemini sowie kurze Videos mit Google Veo und verwendet dafür einen API-Key, der Ihrer Garage gehört. Dies unterscheidet sich vom AI Assistant auf der Seite AI Assistant-Referenz, der einen von AD Promotion bereitgestellten, verwalteten Key nutzt. Für Content Studio stellen und verwalten Sie den Key selbst, und jegliche Google-Nutzung oder -Abrechnung läuft über Ihr eigenes Google-Konto.

1. Google API-Key (Gemini API) erhalten

Der empfohlene Weg führt über Google AI Studio:

  1. Gehen Sie zu Google AI Studio (https://aistudio.google.com/apikey) und melden Sie sich mit dem Google-Konto an, das Sie für die Abrechnung und Nutzung verwenden möchten.
  2. Wählen Sie Create API key (erstellen oder wählen Sie bei Aufforderung ein Google Cloud-Projekt).
  3. Kopieren Sie den generierten Key. Behandeln Sie ihn wie ein Passwort – jeder, der den Key besitzt, kann Ihr Google-Kontingent nutzen.

Keys, die direkt in der Google Cloud Console erstellt wurden (einschliesslich der neueren, an Dienstkonten gebundenen Keys, die mit AQ. beginnen), funktionieren ebenfalls, solange die Gemini API (Generative Language API) für den Key aktiviert ist. Wichtig: Fügen Sie dem Key keine HTTP-Referrer-Einschränkung hinzu – dies blockiert Serveranfragen von WordPress. Schränken Sie stattdessen nach API (Gemini API) oder nach Server-IP ein.

Google ändert gelegentlich den genauen Wortlaut und das Layout dieser Bildschirme. Wenn die Schritte abweichen, suchen Sie in Google AI Studio nach "Gemini API" / "API key".

2. Key in Content Studio speichern

  1. Öffnen Sie in WordPress CMH Center → Content Studio und klicken Sie auf den Unterreiter Settings.
  2. Fügen Sie den Key im Bereich Google connection in das Feld Google API key ein.
  3. Klicken Sie auf Save Google connection. Der Key wird verschlüsselt gespeichert; aus Sicherheitsgründen wird der vollständige Key nie wieder angezeigt – der Bereich meldet lediglich, dass ein Key gespeichert ist.

3. Aktivierung bestätigen

  • Klicken Sie im Bereich "Google connection" auf Verify key: Eine kostenlose Metadaten-Anfrage bestätigt, ob der Key die Gemini API erreicht ("Key works — N text models available."). Wenn der Key ungültig oder eingeschränkt ist oder die Gemini API nicht aktiviert ist, wird stattdessen die genaue Google-Fehlermeldung angezeigt.
  • Der Statusbereich Google connection oben im Content Studio wechselt von Missing auf Ready.
  • Der Unterreiter Create post zeigt nicht mehr "Setup required" an; sobald auch ein Fahrzeug verfügbar ist, steht dort System ready.

Key ersetzen oder entfernen

  • Ersetzen: Geben Sie einen neuen Key ein und speichern Sie. Wenn Sie das Feld beim Speichern leer lassen, bleibt der bestehende Key erhalten (sodass das Speichern anderer Einstellungen ihn nie löscht).
  • Entfernen: Aktivieren Sie das Kontrollkästchen Remove stored key und speichern Sie. Die Generierung ist dann deaktiviert, bis ein neuer Key gespeichert wird; Ihre bereits generierten Inhalte bleiben unberührt.

Wenn Sie einen Beitrag generieren, bevor ein Key gespeichert ist, erstellt Content Studio den Auftrag dennoch als Entwurf und zeigt den Hinweis "Add a Google API key in settings to enable generation." an.

Configuration reference

EinstellungWoHinweise
Google API keySettings → Google connectionGehört Ihrer Garage, verschlüsselt gespeichert. Erforderlich für die Textgenerierung.
Default languageSettings → Brand voiceDie auf dem Unterreiter "Create post" vorausgewählte Sprache.
Default toneSettings → Brand voiceNur der Schreibstil; regionale Formulierungen folgen der Ausgabesprache.
Dealer brand voiceSettings → Brand voiceOptional, max. 800 Zeichen. Wird durch Compliance-Regeln überschrieben.
Default disclaimer textSettings → Compliance and disclaimerOptional, max. 500 Zeichen. Wird immer angewendet.
Compliance notesSettings → Compliance and disclaimerOptional, max. 1000 Zeichen. Überschreiben Tonfall und Brand Voice immer.

Operational notes

  • Content Studio verhält sich gegenüber dem Rest des Plugins lesend (read-only): Es liest Fahrzeugdaten und schreibt ausschliesslich in seine eigenen Content Studio-Datensätze. Das Generieren von Inhalten ändert niemals ein Fahrzeug, einen Lead oder eine veröffentlichte Seite.
  • Das Plugin postet nicht in soziale Netzwerke. Content Studio erstellt Texte, Marketingbilder und kurze Videos (optional mit deutschem Voice-over), die Sie kopieren – oder als ZIP-Paket herunterladen – und manuell veröffentlichen.
  • Die Generierung läuft asynchron: Die Seite blockiert nie, während auf Google gewartet wird. Temporäre Probleme (Rate-Limits, kurze Ausfälle) werden automatisch bis zu dreimal wiederholt, bevor ein Element als Failed markiert wird.
  • Das KI-Modell ist durch das Plugin fest vorgegeben (derzeit Gemini Flash, das schnelle und kostengünstige Textmodell). Es gibt absichtlich keine Modellauswahl in der Benutzeroberfläche; Integratoren können das Modell im Code über den Filter as24ci_content_studio_google_text_model überschreiben.
  • Die Social-Sharing-Buttons, die Besucher auf den Fahrzeugseiten sehen, sind eine separate Funktion, die unter Design & Styles konfiguriert wird, nicht im Content Studio. Siehe Referenz für Design & Styles.

Troubleshooting

  • Der Statusbereich zeigt "Google connection: Missing". Öffnen Sie den Unterreiter Settings und geben Sie einen gültigen Google API-Key ein.
  • Ich bin mir nicht sicher, ob mein Key richtig eingerichtet ist. Nutzen Sie Verify key unter Settings → Google connection. Dies kostet nichts und zeigt entweder "Key works" oder den genauen Fehler von Google an (Key ungültig, Gemini API nicht aktiviert, Referrer-Einschränkung, …).
  • Die Schaltfläche "Create post" meldet "Setup required". Entweder ist kein Google API-Key gespeichert oder es befinden sich keine Fahrzeuge im Bestand. Fügen Sie einen Key in den Einstellungen hinzu und bestätigen Sie, dass mindestens ein Fahrzeug importiert wurde.
  • Ein generiertes Element zeigt "Failed" an. Temporäre Probleme werden automatisch wiederholt. Ein "Failed"-Status bedeutet also, dass das Problem weiterhin bestand (meistens ein ungültiger oder eingeschränkter Key). Führen Sie Verify key aus, beheben Sie die Ursache und nutzen Sie dann Retry im Library-Bereich.
  • Ein Eintrag bleibt ungewöhnlich lange auf "Generating…". Google hat wahrscheinlich die Rate-Limits angewendet; Content Studio wartet und versucht es selbstständig erneut. Wenn es nach einigen Minuten immer noch nicht fertig ist, laden Sie die Seite neu und überprüfen Sie das Content Studio-Protokoll unter Protokolle.
  • Die gesamte Seite zeigt "Content Studio is not active for this license". Content Studio ist in Ihrer aktuellen Lizenz nicht enthalten. Kontaktieren Sie den Support von ADP Car Market Hub, um es zu aktivieren.
  • Generierte Formulierungen ignorieren meine Brand Voice. Compliance-Hinweise und der Disclaimer überschreiben die Brand Voice immer. Überprüfen Sie, ob Ihre Brand-Voice-Vorgaben nicht im Widerspruch zu einer Compliance-Regel stehen.