Preparare Assets per assegnazione tag avanzati

Prima di iniziare a assegnare tag alle risorse utilizzando Smart Content Services, è necessario integrare Experience Manager Assets con Adobe Developer Console per sfruttare il servizio intelligente di Adobe Sensei. Una volta configurato, assicurati di addestrare il servizio utilizzando alcune immagini e un tag.

NOTA
  • I servizi di contenuti avanzati non sono più disponibili per la nuova Experience Manager Assets Clienti on-premise. I clienti on-premise esistenti che dispongono già di questa funzionalità abilitata possono continuare a utilizzare i Servizi di contenuti avanzati.
  • Smart Content Services è disponibile per i servizi esistenti Experience Manager Assets Clienti Managed Services che dispongono già di questa funzionalità abilitata.
  • Nuovo Experience Manager Assets I clienti Managed Services possono seguire le istruzioni riportate in questo articolo per configurare i servizi per contenuti avanzati.

Prima di utilizzare il Servizio di contenuti avanzati, verifica quanto segue:

Integrare con Adobe Developer Console

Quando ti integri con Adobe Developer Console, la Experience Manager prima di inoltrare la richiesta al Servizio di contenuti avanzati, il server autentica le credenziali del servizio con il gateway della console Adobe Developer. Per eseguire l’integrazione, è necessario un account Adobe ID con privilegi di amministratore per l’organizzazione e la licenza Servizio di contenuti avanzati acquistata e abilitata per l’organizzazione.

Per configurare il Servizio di contenuti avanzati, segui questi passaggi principali:

  1. Per generare una chiave pubblica, Creare un servizio di contenuti avanzati configurazione in Experience Manager. Ottieni un certificato pubblico per l’integrazione di OAuth.

  2. Crea un’integrazione in Adobe Developer Console e carica la chiave pubblica generata.

  3. Configurare la distribuzione utilizzando la chiave API e altre credenziali dalla console Adobe Developer.

  4. Verifica la configurazione.

  5. Facoltativamente, abilitare l’assegnazione tag automatica al caricamento delle risorse.

Ottenere un certificato pubblico creando la configurazione del Servizio di contenuti avanzati

Un certificato pubblico ti consente di autenticare il profilo su Adobe Developer Console.

  1. Nell’interfaccia di Experience Manager, accedi a Strumenti > Cloud Services > Servizi cloud precedenti.

  2. Nella pagina Cloud Services, fai clic su Configura ora sotto Tag avanzati risorse.

  3. Nella finestra di dialogo Crea configurazione, specifica un titolo e un nome per la configurazione di tag avanzati. Fai clic su Crea.

  4. Nella finestra di dialogo Servizio di contenuti avanzati AEM, usa i seguenti valori:

    URL servizio: https://smartcontent.adobe.io/<region where your Experience Manager author instance is hosted>

    Esempio: https://smartcontent.adobe.io/apac. Puoi specificare na, emeaoppure apac come aree in cui è ospitata l’istanza di authoring di Experience Manager.

    NOTA

    Se il provisioning di Experience Manager Managed Service è precedente al 10 settembre 2022, utilizza il seguente URL di servizio:
    https://mc.adobe.io/marketingcloud/smartcontent

    Server autorizzazioni: https://ims-na1.adobelogin.com

    Lascia vuoti gli altri campi per il momento (dovranno essere riempiti successivamente). Fai clic su OK.

    Finestra di dialogo Servizio di contenuti avanzati di Experience Manager per fornire l’URL del servizio di contenuti

    Figura: Finestra di dialogo Servizio di contenuti avanzati per fornire l’URL del servizio di contenuti

    NOTA

    L’URL fornito come URL servizio non è accessibile tramite browser e genera un errore 404. La configurazione funziona correttamente con lo stesso valore del URL servizio parametro . Per informazioni sullo stato generale del servizio e sul programma di manutenzione, consulta https://status.adobe.com.

  5. Fai clic su Scarica certificato pubblico per integrazione OAuth e scarica il file del certificato pubblico AEM-SmartTags.crt.

    Una rappresentazione delle impostazioni create per il servizio assegnazione tag avanzati

    Figura: Impostazioni per il servizio di assegnazione tag avanzati.

Riconfigura alla scadenza del certificato

Dopo la scadenza di un certificato, non è più attendibile. Non è possibile rinnovare un certificato scaduto. Per aggiungere un certificato, effettua le seguenti operazioni.

  1. Accedi alla tua implementazione di Experience Manager come amministratore. Fai clic su Strumenti > Protezione > Utenti.

  2. Individua e fai clic sull’utente dam-update-service. Fai clic su Keystore scheda .

  3. Elimina il registro chiavi esistente similaritysearch con il certificato scaduto. Fai clic su Salva e chiudi.

    Elimina la voce di ricerca per similarità esistente in Registro chiavi per aggiungere un certificato di sicurezza

    Figura: Elimina l'esistente similaritysearch voce in Registro chiavi per aggiungere un certificato di sicurezza.

  4. Vai a Strumenti > Cloud Services > Servizi cloud precedenti. Fai clic su Tag avanzati risorse > Mostra configurazioni > Configurazioni disponibili. Seleziona la configurazione richiesta.

  5. Per scaricare un certificato pubblico, fai clic su Scarica certificato pubblico per integrazione OAuth.

  6. Accedi a https://console.adobe.io e passa ai Servizi di contenuti avanzati esistenti nella pagina Integrazioni. Carica il nuovo certificato. Per ulteriori informazioni, consulta le istruzioni in Creare l’integrazione con la console Adobe Developer.

Creare l’integrazione con la console Adobe Developer

Per utilizzare le API del Servizio di contenuti avanzati, crea un’integrazione nella console Adobe Developer per ottenere Chiave API (generato in ID CLIENT campo dell’integrazione della console Adobe Developer), ID ACCOUNT TECNICO, ID ORGANIZZAZIONEe SEGRETO CLIENT per Impostazioni del servizio di assegnazione tag avanzati delle risorse della configurazione cloud in Experience Manager.

  1. Accedi a https://console.adobe.io in un browser. Seleziona l’account appropriato e verifica che il ruolo aziendale associato sia quello di amministratore di sistema.

  2. Crea un progetto con il nome desiderato. Fai clic su Aggiungi API.

  3. Nella pagina Aggiungi un’API, seleziona Experience Cloud e Contenuti avanzati. Fai clic su Avanti.

  4. Seleziona Carica la chiave pubblica. Fornisci il file del certificato scaricato da Experience Manager. Viene visualizzato il messaggio Chiavi pubbliche caricate correttamente. Fai clic su Avanti.

    Creare una nuova credenziale dell’account di servizio (JWT) visualizza la chiave pubblica per l’account del servizio.

  5. Fai clic su Avanti.

  6. Nella pagina per la selezione dei 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 in Impostazioni del servizio di assegnazione tag avanzati delle risorse della configurazione cloud in Experience Manager per configurare tag avanzati.

    Nella scheda Panoramica, puoi esaminare le informazioni fornite sull’integrazione.

    Figura: Dettagli dell’integrazione nella console Adobe Developer

Configurare il Servizio di contenuti avanzati

Per configurare l’integrazione, utilizza i valori di ID ACCOUNT TECNICO, ID ORGANIZZAZIONE, SEGRETO CLIENTe ID CLIENT campi dell’integrazione della console Adobe Developer. La creazione di una configurazione cloud di tag avanzati consente l’autenticazione delle richieste API da Experience Manager distribuzione.

  1. In Experience Manager, passa a Strumenti > Cloud Service > Cloud Services legacy per aprire Cloud Services console.

  2. In Tag avanzati risorse, apri la configurazione creata in precedenza. Nella pagina delle impostazioni del servizio, fai clic su Modifica.

  3. Nella finestra di dialogo Servizio di contenuti avanzati AEM, utilizza i valori precompilati per i campi URL servizio e Server autorizzazioni.

  4. Per i campi Chiave Api, ID account tecnico, ID organizzazionee Segreto client, copia e utilizza i seguenti valori generati in Integrazione con la console Adobe Developer.

    Impostazioni servizio tag avanzati di Assets Adobe Developer Console campi di integrazione
    Chiave API ID CLIENT
    ID account tecnico ID ACCOUNT TECNICO
    ID organizzazione ID ORGANIZZAZIONE
    Segreto client SEGRETO CLIENT

Convalidare la configurazione

Dopo aver completato la configurazione, puoi utilizzare un MBean JMX per convalidare la configurazione. Per eseguire la convalida, effettua le seguenti operazioni.

  1. Accedi al server di Experience Manager all’indirizzo https://[aem_server]:[port].

  2. Vai a Strumenti > Operazioni > Console web per aprire la console OSGi. Fai clic su Principale > JMX.

  3. Clic com.day.cq.dam.similaritysearch.internal.impl. Si apre Attività varie SimilaritySearch.

  4. Clic 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 nella Risorsa di aggiornamento DAM workflow (facoltativo)

  1. In Experience Manager, vai a Strumenti > Flusso di lavoro > Modelli.

  2. Nella pagina Modelli flusso di lavoro, seleziona il modello del flusso di lavoro Risorsa di aggiornamento DAM.

  3. Fai clic su Modifica nella barra degli strumenti.

  4. 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.

    Aggiungi il passaggio Risorsa di tag avanzati dopo il passaggio Elabora miniature nel flusso di lavoro Aggiorna risorsa DAM

    Figura: Aggiungi il passaggio Risorsa di tag avanzati dopo il passaggio Elabora miniature nel flusso di lavoro Aggiorna risorsa DAM.

  5. Apri il passaggio in modalità di modifica. In Impostazioni avanzate, accertati che sia selezionata l’opzione Avanzamento gestore.

    Configura il flusso di lavoro Aggiorna risorsa DAM e aggiungi il passaggio tag avanzati

    Figura: Configura il flusso di lavoro Aggiorna risorsa DAM e aggiungi il passaggio tag avanzati

  6. 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.

    Configura il flusso di lavoro Aggiorna risorsa DAM per aggiungere il passaggio tag avanzati e selezionare l'avanzamento del gestore

    Figura: Configura il flusso di lavoro Aggiorna risorsa DAM per aggiungere il passaggio tag avanzati e selezionare l'avanzamento del gestore

    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.

    Configura il flusso di lavoro Risorsa di aggiornamento DAM per aggiungere il passaggio tag avanzati e selezionare ignora il flag di tag avanzati

    Figura: Configura il flusso di lavoro Aggiorna risorsa DAM per aggiungere il passaggio tag avanzati e seleziona ignora il flag Tag avanzati.

  7. Fai clic su OK per chiudere il passaggio del processo, quindi salva il flusso di lavoro.

Formazione del Servizio di contenuti avanzati

Affinché il Servizio di contenuti avanzati riconosca la tassonomia aziendale, eseguilo su un set di risorse che già includono tag rilevanti per la tua azienda. Per assegnare efficacemente tag alle immagini del tuo marchio, il Servizio di contenuti avanzati richiede che le immagini di formazione siano conformi a determinate linee guida. Dopo la formazione, il servizio può applicare la stessa tassonomia su un set di risorse simile.

È possibile addestrare il servizio più volte per migliorarne la capacità di applicare tag pertinenti. Dopo ogni ciclo di formazione, esegui un flusso di lavoro di assegnazione tag e verifica se le risorse sono state contrassegnate in modo appropriato.

Puoi addestrare il Servizio di contenuti avanzati periodicamente o su richiesta.

NOTA

Il flusso di lavoro di formazione viene eseguito solo sulle cartelle.

Orientamenti per la formazione

Per ottenere i migliori risultati, le immagini del set di formazione 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.

Immagini illustrative per esemplificare le linee guida per la formazione

Copertura: Utilizza una varietà sufficiente nelle immagini del corso di formazione. L'idea è quella di fornire alcuni esempi, ma abbastanza diversi, in modo che l'Experience Manager impari a concentrarsi sulle cose giuste. Se applichi lo stesso tag a immagini visivamente diverse, includi almeno cinque esempi di ogni tipo.

Ad esempio, per il tag modello in giù, includi più immagini di formazione simili all’immagine evidenziata qui sotto per consentire al servizio di identificare immagini simili con maggiore precisione durante l’assegnazione tag.

Immagini illustrative per esemplificare le linee guida per la formazione

Distrazione/ostruzione: Il servizio si allena meglio sulle immagini che hanno meno distrazioni (sfondi ben visibili, accompagnamento indipendenti, come oggetti/persone con il soggetto principale).

Ad esempio, per il tag scarpa casuale, la seconda immagine non è un buon candidato per la formazione.

Immagini illustrative per esemplificare le linee guida 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 quali raincoat e model-side-view, aggiungi entrambi i tag alla risorsa idonea prima di includerla nella formazione.

Immagini illustrative per esemplificare le linee guida per la formazione

NOTA

La capacità del Servizio di contenuti avanzati di addestrare i tag e applicarli ad altre immagini dipende dalla qualità delle immagini utilizzate per la formazione. Per ottenere risultati ottimali, l’Adobe consiglia di utilizzare immagini visivamente simili per addestrare il servizio per ogni tag.

Formazione periodica

Puoi abilitare il Servizio di contenuti avanzati per addestrare periodicamente le risorse e i tag associati all’interno di una cartella. Apri Proprietà nella pagina della cartella risorse, seleziona Abilita tag avanzati in Dettagli e salva le modifiche.

enable_smart_tags

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 delle cartelle e sui relativi tag. Per impostazione predefinita, il flusso di lavoro di formazione viene eseguito settimanalmente alle 12:30 del sabato.

Formazione on-demand

Puoi addestrare il Servizio di contenuti avanzati tutte le volte che lo desideri dalla console Flusso di lavoro.

  1. In Experience Manager interfaccia, vai a Strumenti > Flusso di lavoro > Modelli.

  2. Da Modelli di flusso di lavoro , seleziona la Formazione sui tag avanzati , quindi fai clic su Avvia flusso di lavoro dalla barra degli strumenti.

  3. In Esegui flusso di lavoro , individua la cartella payload che include le risorse con tag per la formazione del servizio.

  4. Specifica un titolo per il flusso di lavoro e aggiungi un commento. Quindi, fai clic su Esegui. Le risorse e i tag vengono inviati per la formazione.

    workflow_dialog

NOTA

Una volta elaborate le risorse di una cartella per la formazione, solo le risorse modificate vengono elaborate nei cicli di formazione successivi.

Visualizzare i rapporti di formazione

Per verificare se il Servizio di contenuti avanzati è addestrato sui tag nel set di risorse di formazione, controlla il rapporto del flusso di lavoro di formazione dalla console Rapporti.

  1. In Experience Manager interfaccia, vai a Strumenti > Risorse > Rapporti.

  2. In Rapporti sulle risorse pagina, fai clic su Crea.

  3. Seleziona la Formazione sui tag avanzati , quindi fai clic su Successivo dalla barra degli strumenti.

  4. 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, fai clic su Crea dalla barra degli strumenti.

  5. Nella pagina Rapporti su risorse, seleziona il rapporto generato. Per visualizzare il rapporto, fai clic su Visualizza dalla barra degli strumenti.

  6. Rivedi 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 i tag non vengono visualizzati in questo rapporto, esegui nuovamente il flusso di lavoro di formazione per questi tag.

  7. Per scaricare il rapporto, selezionalo dall’elenco e fai clic su Scarica dalla barra degli strumenti. Il rapporto viene scaricato come foglio di calcolo di Microsoft Excel.

Limitazioni

  • Gli smart tag 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 sottili differenze nelle immagini. Ad esempio, camicie sottili o regolari.
    • Incapacità di identificare i tag in base a piccoli pattern/parti di un’immagine. Ad esempio, i loghi sulle T-shirt.
    • L’assegnazione tag è supportata nelle impostazioni internazionali che Experience Manager è supportato in . Per un elenco delle lingue, vedi Note sulla versione di Smart Content Services.
  • Per cercare le risorse con tag avanzati (regolari o migliorati), utilizza la funzione Assets Omnisearch (ricerca full-text). Non esiste un predicato di ricerca separato per gli smart tag.

In questa pagina