Prepara Assets per assegnazione tag avanzati configure-asset-tagging-using-the-smart-content-service
Prima di iniziare a assegnare tag alle risorse utilizzando Smart Content Services, è necessario integrare Experience Manager Assets con Adobe Developer Console per utilizzare Smart Service di Adobe Sensei. Una volta configurato, il servizio viene addestrato utilizzando alcune immagini e un tag.
Prima di utilizzare il Servizio di contenuti avanzati, verifica quanto segue:
-
Installa il Experience Manager Service Pack più recente.
ADOBE Aggiornamento SCS per supportare Oauth per Managed Services scs-upgrade-oauth-managed-services
Nuovi utenti
Installare Service Pack 22. Per supportare l'integrazione Oauth in Service Pack 22, è necessario installare Hotfix per Service Pack 22.
Segui le istruzioni riportate in questo articolo per configurare Smart Content Services.
Utenti esistenti
Se è stato eseguito l'aggiornamento al Service Pack 21, installare Hotfix per Service Pack 21 per supportare l'integrazione Oauth. Qualsiasi configurazione esistente viene eliminata automaticamente. Segui le istruzioni riportate in questo articolo per configurare Smart Content Services. Se si esegue l'aggiornamento al Service Pack 22, è necessario installare questo Hotfix per Service Pack 22.
Per Service Pack 20 e versioni precedenti, è necessario eseguire i passaggi per la soluzione alternativa per il supporto dell’integrazione Oauth da parte di SCS. Consulta Risoluzione dei problemi relativi agli smart tag per le credenziali OAuth.
Aggiornamento SCS per supportare Oauth per gli utenti on-premise scs-upgrade-oauth-on-premise
Nuovi utenti
Smart Content Services non è più disponibile per i nuovi utenti locali di Experience Manager Assets.
Utenti esistenti
Gli utenti on-premise esistenti che dispongono già di questa funzionalità possono continuare a utilizzare Smart Content Services.
Se è stato eseguito l'aggiornamento al Service Pack 21, installare Hotfix per Service Pack 21 per supportare l'integrazione Oauth. Qualsiasi configurazione esistente viene eliminata automaticamente. Segui le istruzioni riportate in questo articolo per configurare Smart Content Services. Se si esegue l'aggiornamento al Service Pack 22, è necessario installare questo Hotfix per Service Pack 22.
Per Service Pack 20 e versioni precedenti, è necessario eseguire i passaggi per la soluzione alternativa per il supporto dell’integrazione Oauth da parte di SCS. Consulta Risoluzione dei problemi relativi agli smart tag per le credenziali OAuth.
Integrare con Adobe Developer Console integrate-adobe-io
Quando si esegue l'integrazione con Adobe Developer Console, il server Experience Manager autentica le credenziali del servizio con il gateway di Adobe Developer Console prima di inoltrare la richiesta al Servizio di contenuti avanzati. Per l’integrazione, è necessario un account Adobe ID con privilegi di amministratore per l’organizzazione e una licenza del Servizio di contenuti avanzati acquistata e abilitata per la tua organizzazione.
Per configurare il Servizio di contenuti avanzati, segui questi passaggi di livello principale:
-
Crea un'integrazione in Adobe Developer Console.
-
Crea la configurazione dell'account tecnico IMS utilizzando la chiave API e altre credenziali di Adobe Developer Console.
Creare l’integrazione con Adobe Developer Console create-adobe-io-integration
Per utilizzare le API del Servizio di contenuti avanzati, creare un'integrazione in Adobe Developer Console per ottenere la chiave API (generata nel campo ID CLIENT dell'integrazione di Adobe Developer Console), ID ORGANIZZAZIONE e SEGRETO CLIENT per le impostazioni del Servizio di tag avanzati di Assets della configurazione cloud in Experience Manager.
-
Accedi a https://developer.adobe.com in un browser. Selezionare l'account appropriato e verificare che il ruolo organizzazione associato sia amministratore di sistema.
-
Crea un progetto con il nome desiderato. Fai clic su Aggiungi API.
-
Nella pagina Aggiungi un’API, seleziona Experience Cloud e Contenuti avanzati. Fai clic su Avanti.
-
Selezionare OAuth Server-to-Server. Fai clic su Avanti.
Per informazioni dettagliate su come eseguire questa configurazione, consulta la documentazione di Developer Console, a seconda dei requisiti:-
Panoramica:
-
Creazione di nuove credenziali OAuth:
-
Migrazione di una credenziale JWT esistente a una credenziale OAuth:
-
-
Nella pagina Seleziona profili di prodotto, seleziona Servizi di contenuti avanzati. Fai clic su Salva API configurata.
In una pagina vengono visualizzate ulteriori informazioni sulla configurazione. Tieni aperta questa pagina per copiare e aggiungere questi valori nelle Impostazioni del servizio di assegnazione tag avanzati di Assets della configurazione cloud in Experience Manager per configurare gli smart tag.
Creare la configurazione dell’account tecnico IMS create-ims-account-config
Devi creare la configurazione dell’account tecnico IMS seguendo questi passaggi:
-
Nell’interfaccia utente di Experience Manager, accedi a Strumenti > Sicurezza > Configurazioni Adobe IMS.
-
Fai clic su Crea.
-
Nella finestra di dialogo Configurazione account tecnico IMS, utilizza i seguenti valori:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 Campo Descrizione Soluzione cloud Scegli Tag avanzati dal menu a discesa. Titolo Aggiungi il titolo della configurazione dell’account IMS. Server autorizzazioni Aggiungi https://ims-na1.adobelogin.comID client Da fornire tramite console Adobe Developer. Segreto client Da fornire tramite console Adobe Developer. Ambito Da fornire tramite console Adobe Developer. ID organizzazione Da fornire tramite console Adobe Developer. -
Selezionare la configurazione creata e fare clic su Verifica stato.
-
Confermare la finestra di dialogo Verifica stato e fare clic su Chiudi una volta che la configurazione è nello stato integro.
Crea una nuova configurazione configure-smart-content-service
Per configurare l'integrazione, utilizzare i valori dei campi ID ACCOUNT TECNICO, ID ORGANIZZAZIONE, SEGRETO CLIENT e ID CLIENT dell'integrazione Adobe Developer Console. La creazione di una configurazione cloud di tag avanzati consente l'autenticazione delle richieste API dalla distribuzione Experience Manager.
-
In Experience Manager, passa a Strumenti > Cloud Service > Tag avanzati per aprire Configurazioni smart tag.
-
Fai clic su Crea per creare una nuova configurazione. In caso contrario, fare clic su Proprietà per aggiornare la configurazione esistente.
-
Compila i campi seguenti:
table 0-row-2 1-row-2 2-row-2 3-row-2 Campo Descrizione Titolo Aggiungi il titolo della configurazione dell’account IMS. Configurazione Adobe IMS associata Scegli la configurazione dal menu a discesa. URL del servizio https://smartcontent.adobe.io/<region where your Experience Manager author instance is hosted>. Ad esempio,https://smartcontent.adobe.io/apac. È possibile specificarena,emeaoapaccome aree in cui è ospitata l'istanza Autore Experience Manager.note note NOTE Se il provisioning di Experience Manager Managed Service è stato eseguito prima del 1° settembre 2022, utilizza il seguente URL del servizio: https://mc.adobe.io/marketingcloud/smartcontent -
Fai clic su Salva e chiudi.
Convalidare la configurazione validate-the-configuration
Dopo aver completato la configurazione, puoi utilizzare un MBean JMX per convalidarla. Per eseguire la convalida, effettua le seguenti operazioni.
-
Accedi al server di Experience Manager all’indirizzo
https://[aem_server]:[port]. -
Vai a Strumenti > Operazioni > Console Web per aprire la console OSGi. Fai clic su Principale > JMX.
-
Fai clic su
com.day.cq.dam.similaritysearch.internal.impl (SCS).
-
Fai clic su
validateConfigs(). Nella finestra di dialogo Validate Configurations (Convalida configurazioni), fai clic su Invoke (Richiama).
I risultati della convalida vengono visualizzati nella stessa finestra di dialogo.
Abilitare l'assegnazione tag avanzati nel flusso di lavoro Risorsa di aggiornamento DAM (facoltativo) enable-smart-tagging-in-the-update-asset-workflow-optional
-
In Experience Manager, vai a Strumenti > Flusso di lavoro > Modelli.
-
Nella pagina Modelli flusso di lavoro, seleziona il modello del flusso di lavoro Risorsa di aggiornamento DAM.
-
Fai clic su Modifica nella barra degli strumenti.
-
Per visualizzare i passaggi, espandi il pannello laterale. Trascina il passaggio Risorsa di tag avanzati della sezione Flusso di lavoro DAM e inseriscilo dopo il passaggio Elabora miniature.
-
Apri le proprietà del passaggio per modificare i dettagli. In Impostazioni avanzate, accertati che sia selezionata l’opzione Avanzamento gestore.
-
Nella scheda Argomenti, seleziona Ignora errori se vuoi che il flusso di lavoro venga completato anche con esito negativo del passaggio di assegnazione tag automatica.
Inoltre, per assegnare i tag alle risorse quando vengono caricate, a prescindere dal fatto che l'assegnazione tag avanzati sia abilitata o meno per le cartelle, seleziona Ignora flag di tag avanzati.
-
Fai clic sull'icona Fine
-
Fai clic su Sincronizza per salvare il flusso di lavoro.
Formazione del Servizio di contenuti avanzati training-the-smart-content-service
Affinché il Servizio di contenuti avanzati riconosca la tassonomia aziendale, eseguilo su una serie di risorse che includono già tag rilevanti per la tua azienda. Per assegnare tag efficaci alle immagini del tuo marchio, il Servizio di contenuti avanzati richiede che le immagini di formazione siano conformi a determinate linee guida. Dopo l’addestramento, il servizio può applicare la stessa tassonomia a un set di risorse simile.
Puoi addestrare il servizio più volte per migliorarne la capacità di applicare tag rilevanti. Dopo ogni ciclo di formazione, esegui un flusso di lavoro sui tag e verifica che alle risorse siano assegnati i tag appropriati.
Puoi addestrare il Servizio di contenuti avanzati periodicamente o in base ai requisiti.
Linee guida per la formazione guidelines-for-training
Per ottenere risultati ottimali, le immagini del set di apprendimento sono conformi alle seguenti linee guida:
Quantity and size (Quantità e dimensioni): almeno 30 immagini per tag. Almeno 500 pixel sul lato più lungo.
Coerenza: le immagini utilizzate per un tag specifico sono visivamente simili.
Ad esempio, non è consigliabile assegnare a tutte queste immagini il tag my-party (per la formazione) perché non sono visivamente simili.
Copertura: utilizza una varietà sufficiente di immagini nel corso di formazione. L'idea è quella di fornire alcuni esempi, ma ragionevolmente diversi, in modo che l'Experience Manager apprenda a concentrarsi sulle cose giuste. Se applichi lo stesso tag a immagini visivamente diverse, includi almeno cinque esempi per ogni tipo.
Ad esempio, per il tag model-down-pose, includi più immagini di formazione simili all'immagine evidenziata di seguito affinché il servizio identifichi più accuratamente immagini simili durante l'assegnazione dei tag.
Distrazione/ostruzione: il servizio si addestra meglio alle immagini che hanno meno distrazione (sfondi prominenti, accompagnamenti non correlati, come oggetti/persone con il soggetto principale).
Ad esempio, per il tag casual-shoe, la seconda immagine non è un buon candidato per la formazione.
Completeness (Completezza): se un’immagine è idonea per più tag, aggiungi tutti i tag applicabili prima di includere l’immagine nella formazione. Ad esempio, per tag come raincoat e model-side-view, aggiungi entrambi i tag alla risorsa idonea prima di includerla nella formazione.
Formazione periodica periodic-training
Puoi abilitare il Servizio di contenuti avanzati per la formazione periodica sulle risorse e sui tag associati all’interno di una cartella. Apri la pagina Proprietà della cartella di risorse, seleziona Abilita tag avanzati nella scheda Dettagli e salva le modifiche.
Una volta selezionata questa opzione per una cartella, Experience Manager esegue automaticamente un flusso di lavoro di formazione per addestrare il Servizio di contenuti avanzati sulle risorse della cartella e sui relativi tag. Per impostazione predefinita, il flusso di lavoro di formazione viene eseguito settimanalmente alle 00:30 del sabato.
Formazione on-demand on-demand-training
Puoi addestrare il Servizio di contenuti avanzati quando necessario dalla console Flusso di lavoro.
-
Nell'interfaccia Experience Manager, vai a Strumenti > Flusso di lavoro > Modelli.
-
Dalla pagina Modelli di flusso di lavoro, seleziona il flusso di lavoro Apprendimento dei tag avanzati, quindi fai clic su Avvia flusso di lavoro nella barra degli strumenti.
-
Nella finestra di dialogo Esegui flusso di lavoro, individua la cartella del payload che include le risorse con tag per l'apprendimento del servizio.
-
Specifica un titolo per il flusso di lavoro e aggiungi un commento. Quindi fare clic su Esegui. Le risorse e i tag vengono inviati per la formazione.
Visualizzare i rapporti di formazione viewing-training-reports
Per verificare se il Servizio di contenuti avanzati è stato addestrato sui tag nel set di formazione di risorse, controlla il rapporto sul flusso di lavoro di formazione dalla console Rapporti.
-
Nell'interfaccia Experience Manager, vai a Strumenti > Assets > Rapporti.
-
Nella pagina Rapporti risorse, fai clic su Crea.
-
Seleziona il report Apprendimento dei tag avanzati e fai clic su Avanti nella barra degli strumenti.
-
Specifica un titolo e una descrizione per il rapporto. In Pianifica rapporto, lascia selezionata l’opzione Now (Ora). Se vuoi pianificare il rapporto per un momento successivo, seleziona Later (Più tardi) e specifica una data e un’ora. Quindi fare clic su Crea nella barra degli strumenti.
-
Nella pagina Rapporti su risorse, seleziona il rapporto generato. Per visualizzare il report, fare clic su Visualizza nella barra degli strumenti.
-
Esamina i dettagli del rapporto.
Il rapporto mostra lo stato di formazione per i tag che hai appreso. La presenza del colore verde nella colonna Training Status (Stato formazione) indica che per il tag è stato eseguito il training del servizio di contenuti avanzati. Se invece del verde è presente il colore giallo, il training del servizio di contenuti avanzati non è stato completato per un tag specifico. In questo caso, aggiungi altre immagini che contengono il tag in questione ed esegui il flusso di lavoro di formazione per completare il training del servizio per quel tag.
Se non trovi i tuoi tag in questo rapporto, esegui nuovamente il flusso di lavoro di formazione per questi tag.
-
Per scaricare il report, selezionarlo dall'elenco e fare clic su Scarica nella barra degli strumenti. Il rapporto viene scaricato come foglio di calcolo di Microsoft Excel.
Limitazioni limitations
-
I tag avanzati migliorati si basano su modelli di apprendimento delle immagini e dei relativi tag. Questi modelli non sono sempre perfetti per identificare i tag. La versione corrente del Servizio di contenuti avanzati presenta le seguenti limitazioni:
- Incapacità di riconoscere le sottili differenze nelle immagini. Ad esempio, magliette e magliette normali.
- Impossibilità di identificare i tag in base a modelli/parti minuscole di un’immagine. Ad esempio, i logo sulle magliette.
- L'assegnazione tag è supportata nelle impostazioni internazionali in cui è supportato Experience Manager.
-
Per cercare le risorse con tag avanzati (regolari o migliorati), utilizza l'Omnisearch Assets (ricerca full-text). Non esiste un predicato di ricerca separato per i tag avanzati.