DokumentationCommerceKatalogverwaltung

Hinzufügen von Produktvideos

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Einsteiger
  • Fortgeschrittener
  • Admin
  • Führungskraft
  • Benutzende

Um ein Produktvideo hinzuzufügen, müssen Sie zunächst einen API-Schlüssel von Ihrem Google-Konto abrufen und ihn in die Konfiguration Ihres Stores eingeben. Anschließend können Sie vom Produkt aus eine Verknüpfung zum Video herstellen.

Schritt 1: YouTube-API-Schlüssel abrufen

  1. Melden Sie sich bei Ihrem Google-Konto an und besuchen Sie die Google Developers Console.

  2. Geben Sie oben im Suchfeld YouTube Data API v3 ein und klicken Sie auf das Suchsymbol.

  3. Wenn die API-Seite angezeigt wird, stellen Sie sicher, dass sie aktiviert ist.

  4. Wählen Sie im linken Bedienfeld Credentials aus.

  5. Führen Sie je nachdem, ob Sie über Anmeldeinformationen verfügen oder nicht, einen der folgenden Schritte aus:

    • Wenn Sie bereits über die erforderlichen Anmeldeinformationen verfügen, kopieren Sie den Schlüssel in die Tabelle API-Schlüssel .

    • Wenn Sie noch keine Anmeldeinformationen für diese API haben, klicken Sie oben auf Create Credentials und befolgen Sie die Anweisungen zum Erstellen der erforderlichen Anmeldeinformationen. Kopieren unter " abrufen“ den API-Schlüssel und klicken Sie auf Done.

  6. Kopieren Sie den API-Schlüssel in die Zwischenablage.

  7. Klicken Sie auf das Symbol Bearbeiten auf der rechten Seite und legen Sie die Einschränkungen fest, um sicherzustellen, dass der API-Schlüssel auf die richtigen Referrer beschränkt ist.

  8. Warten Sie einige Augenblicke, während der Schlüssel generiert wird, und kopieren Sie dann den Schlüssel in die Zwischenablage.

    Im nächsten Schritt fügen Sie den Schlüssel in die Konfiguration Ihres Stores ein.

Schritt 2: Konfigurieren des Schlüssels in Commerce

  1. Navigieren Sie in Admin-Seitenleiste zu Stores > Settings>Configuration.

  2. Erweitern Sie im linken Bereich Catalog und wählen Sie darunter Catalog.

  3. Erweitern Sie Erweiterungsauswahl den Abschnitt Product Video ​und fügen Sie Ihre YouTube API key ​ein.

    Konfiguration des Produktvideos {width="600" modal="regular"}

  4. Klicken Sie abschließend auf Save Config.

  5. Aktualisieren Sie bei Aufforderung den Cache.

  1. Öffnen Sie ein Produkt im Bearbeitungsmodus.

  2. Scrollen Sie zum Abschnitt Images and Videos ​und erweitern Sie ihn.

    Bilder und Videos {width="600" modal="regular"}

  3. Klicken Sie auf Add Video.

    Wenn Sie Ihren YouTube-API-Schlüssel noch nicht konfiguriert haben, klicken Sie auf OK , um fortzufahren. Sie können keine Verknüpfung zu einem YouTube-Video herstellen, aber Sie können den Prozess durchlaufen.

  4. Geben Sie Url die URL des YouTube- oder Vimeo-Videos ein.

    Neues Video für Produkt {width="600" modal="regular"}

  5. Klicken Sie außerhalb des Felds und warten Sie auf Feedback zum API-Schlüssel oder Video.

    Wenn alles ausgecheckt wird, stellt YouTube Basisinformationen zum Video bereit

  6. Geben Sie die Title und Description des Videos ein.

  7. Um ein Preview Image hochzuladen, navigieren Sie zum Bild und wählen Sie die Datei aus.

    note note
    NOTE
    Nach dem Hochladen wird das angezeigte Vorschaubild automatisch von einem externen Videodienstanbieter generiert. Das Bild kann nicht über die Adobe Commerce Admin bearbeitet werden.

  8. Wenn Sie die Video-Metadaten lieber verwenden möchten, klicken Sie auf Get Video Information.

  9. Um zu bestimmen, wie das Video im Store verwendet wird, aktivieren Sie das Kontrollkästchen jedes entsprechenden Role:

    • Base Image
    • Small Image
    • Swatch Image
    • Thumbnail
    • Hide from Product Page

  10. Klicken Sie abschließend auf Save.

    note note
    NOTE
    Wenn die Autostart base video ​Konfigurationsoption auf Yes festgelegt ist, das Video jedoch nicht automatisch wiedergegeben wird, kann dies an den automatischen Wiedergaberichtlinien liegen, die vom Browser erzwungen werden und nicht von Adobe Commerce gesteuert werden können. Jeder unterstützte Browser verfügt über seine eigenen Richtlinien zur automatischen Wiedergabe, die sich im Laufe der Zeit ändern können, und Ihr Video wird in Zukunft möglicherweise nicht automatisch wiedergegeben. Als Best Practice wird empfohlen, sich nicht auf die automatische Wiedergabe für geschäftskritische Funktionen zu verlassen und das Verhalten der automatischen Videowiedergabe in Ihrem Store mit jedem unterstützten Browser zu testen.

API-Zugriff verwalten

Gemäß den Google-[ (Nutzungsbedingungen] kann YouTube den API-Zugriff für Konten deaktivieren, die seit mehr als 90 Tagen inaktiv sind. Dieses Ereignis kann dazu führen, dass Ihre Videos nicht angezeigt werden. Um den API-Zugriff auf dem neuesten Stand zu halten, verwenden Sie einen Cron-Auftrag, um die API in regelmäßigen Abständen anzupingen:

30 10 1 * * curl -i -G -e https://yourdomain.com/ -d "part=snippet&maxResults=1&q=test&key=YOUTUBEAPIKEY" https://www.googleapis.com/youtube/v3/search >/dev/null 2>&1

Feldverweis

Feld
Beschreibung
URL
Die URL des zugehörigen Videos.
Title
Der Videotitel.
Description
Die Videobeschreibung.
Preview Image
Ein hochgeladenes Bild, das als Vorschau des Videos in Ihrem Store verwendet wird.
Get Video Information
Ruft die Video-Metadaten ab, die auf dem Host-Server gespeichert sind. Sie können die Originaldaten verwenden oder bei Bedarf aktualisieren.
Role
Legt fest, wie das Vorschaubild in Ihrem Store verwendet wird. Sie können eine beliebige Kombination von Optionen auswählen: Base Image, Small Image, Thumbnail, Swatch Image, Hide from Product Page
recommendation-more-help
af062d56-f22c-4537-813d-bedf8b92a071