DocumentazioneCommerceGestione catalogo

Aggiungi video di prodotto

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

Creato per:

  • Principiante
  • Intermedio
  • Amministratore
  • Leader
  • Utente

Per aggiungere un video di prodotto, devi prima ottenere una chiave API dal tuo account Google e immetterla nella configurazione dello store. Quindi puoi collegare il prodotto al video.

Passaggio 1: ottenere la chiave API di YouTube

  1. Accedi al tuo account Google e visita la console per sviluppatori di Google.

  2. Nel campo di ricerca nella parte superiore, immettere YouTube Data API v3 e fare clic sull'icona di ricerca.

  3. Quando viene visualizzata la pagina API, accertati che sia abilitata.

  4. Nel pannello a sinistra, scegli Credentials.

  5. A seconda che si disponga di credenziali o meno, eseguire una delle operazioni seguenti:

    • Se disponi già delle credenziali necessarie, copia la chiave nella tabella Chiavi API.

    • Se non si dispone già delle credenziali per questa API, fare clic su Create Credentials nella parte superiore e seguire le istruzioni per creare le credenziali necessarie. In Ottieni le tue credenziali, copia la chiave API e fai clic su Done.

  6. Copia la chiave API negli Appunti.

  7. Fai clic sull’icona Modifica a destra e imposta le restrizioni per assicurarti che la chiave API sia limitata ai referenti corretti.

  8. Attendi alcuni istanti mentre viene generata la chiave, quindi copiala negli Appunti.

    Nel passaggio successivo, incollerai la chiave nella configurazione del tuo archivio.

Passaggio 2: configurare la chiave in Commerce

  1. Nella barra laterale Admin, passa a Stores > Settings>Configuration.

  2. Nel pannello a sinistra, espandi Catalog e scegli Catalog sotto.

  3. Espandi Il selettore di espansione nella sezione Product Video ​e incolla YouTube API key.

    Configurazione video prodotto {width="600" modal="regular"}

  4. Al termine, fare clic su Save Config.

  5. Quando richiesto, aggiorna la cache.

Passaggio 3: collegamento al video

  1. Apri un prodotto in modalità di modifica.

  2. Scorri fino alla sezione Images and Videos ​ed espandila.

    Immagini e video {width="600" modal="regular"}

  3. fare clic su Add Video.

    Se non hai ancora configurato la chiave API di YouTube, fai clic su OK per continuare. Non puoi effettuare il collegamento a un video YouTube, ma puoi seguire la procedura.

  4. Per Url, immetti l'URL del video YouTube o Vimeo.

    Nuovo video per il prodotto {width="600" modal="regular"}

  5. Fai clic all’esterno del campo e attendi il feedback sulla chiave API o sul video.

    Se tutto viene estratto, YouTube fornisce le informazioni di base del video

  6. Immetti Title e Description del video.

  7. Per caricare un Preview Image, individuare l'immagine e selezionare il file.

    note note
    NOTE
    Dopo il caricamento, l’immagine di anteprima visualizzata viene generata automaticamente da un provider di servizi video esterno. Non è possibile modificare l’immagine dall’amministratore di Adobe Commerce.

  8. Se si preferisce utilizzare i metadati video, fare clic su Get Video Information.

  9. Per determinare la modalità di utilizzo del video nell'archivio, selezionare la casella di controllo di ogni Role applicabile:

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

  10. Al termine, fare clic su Save.

    note note
    NOTE
    Se l'opzione di configurazione Autostart base video ​è impostata su Yes ma il video non inizia a essere riprodotto automaticamente, ciò potrebbe essere dovuto ai criteri di riproduzione automatica applicati dal browser e non controllabili da Adobe Commerce. Ogni browser supportato dispone di criteri di riproduzione automatica che possono cambiare nel tempo e il video potrebbe non essere riprodotto automaticamente in futuro. Come best practice consigliata, non affidarti alla riproduzione automatica per le funzionalità business critical e verifica il comportamento di riproduzione automatica del video nel tuo store con ogni browser supportato.

Gestisci accesso API

In base ai Termini e condizioni per gli sviluppatori di Google, YouTube potrebbe disabilitare l'accesso API per gli account inattivi da più di 90 giorni. Questa occorrenza potrebbe impedire la visualizzazione dei video. Per mantenere aggiornato l’accesso API, utilizza un processo cron per eseguire il ping dell’API a intervalli regolari:

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

Riferimento campo

Campo
Descrizione
URL
URL del video associato.
Title
Titolo del video.
Description
Descrizione del video.
Preview Image
Un’immagine caricata che viene utilizzata come anteprima del video nel tuo store.
Get Video Information
Recupera i metadati video memorizzati sul server host. Puoi utilizzare i dati originali o aggiornarli in base alle esigenze.
Role
Determina il modo in cui l'immagine di anteprima viene utilizzata nell'archivio. È possibile scegliere qualsiasi combinazione di opzioni: Base Image, Small Image, Thumbnail, Swatch Image, Hide from Product Page
recommendation-more-help
af062d56-f22c-4537-813d-bedf8b92a071