Preparar Assets para marcação inteligente configure-asset-tagging-using-the-smart-content-service
Antes de começar a marcar seus ativos usando os Serviços de Conteúdo Inteligente, integre o Experience Manager Assets ao Adobe Developer Console para usar o serviço inteligente do Adobe Sensei. Depois de configurado, treine o serviço usando algumas imagens e uma tag.
- Os Serviços de Conteúdo Inteligente não estão mais disponíveis para novos Experience Manager Assets clientes locais. Os clientes locais existentes que já têm esse recurso ativado podem continuar usando os Serviços de conteúdo inteligente.
- Os Serviços de Conteúdo Inteligente estão disponíveis para Experience Manager Assets clientes atuais do Managed Services que já têm esse recurso habilitado.
- Os novos clientes do Managed Services Experience Manager Assets podem seguir as instruções mencionadas neste artigo para configurar os Serviços de Conteúdo Inteligente.
Antes de usar o Serviço de conteúdo inteligente, verifique o seguinte:
-
Instale o Experience Manager Service Pack mais recente.
Integrar ao Adobe Developer Console integrate-adobe-io
Quando você integra com o Adobe Developer Console, o servidor do Experience Manager autentica suas credenciais de serviço no gateway do Adobe Developer Console antes de encaminhar sua solicitação ao Serviço de Conteúdo Inteligente. Para integrar o, é necessário ter uma conta do Adobe ID com privilégios de administrador para a organização e uma licença do Serviço de conteúdo inteligente adquirida e ativada para a organização.
Para configurar o Serviço de conteúdo inteligente, siga estas etapas de nível superior:
-
Para gerar uma chave pública, Crie uma configuração do Serviço de Conteúdo Inteligente em Experience Manager. Obtenha um certificado público para a integração OAuth.
-
Crie uma integração no Console do desenvolvedor e faça upload da chave pública gerada.
-
Configure sua implantação usando a chave de API e outras credenciais da Adobe Developer Console.
-
Opcionalmente, habilite a marcação automática no carregamento de ativos.
Obter certificado público criando uma configuração do Serviço de conteúdo inteligente obtain-public-certificate
Um certificado público permite autenticar seu perfil no Adobe Developer Console.
-
Na interface de usuário do Experience Manager, acesse Ferramentas > Cloud Service > Cloud Service herdados.
-
Na página Cloud Service, clique em Configurar agora em Tags inteligentes da Assets.
-
Na caixa de diálogo Criar Configuração, especifique um título e nome para a configuração de Tags Inteligentes. Clique em Criar.
-
Na caixa de diálogo Serviço de Conteúdo Inteligente do AEM, use os seguintes valores:
URL de Serviço:
https://smartcontent.adobe.io/<region where your Experience Manager author instance is hosted>
Por exemplo,
https://smartcontent.adobe.io/apac
. Você pode especificarna
,emea
ouapac
como as regiões onde a instância do autor do Experience Manager está hospedada.note note NOTE Se o Serviço gerenciado de Experience Manager for provisionado antes de 1° de setembro de 2022, use o seguinte URL de serviço: https://mc.adobe.io/marketingcloud/smartcontent
Servidor de autorização:
https://ims-na1.adobelogin.com
Deixe os outros campos em branco por enquanto (a serem fornecidos posteriormente). Clique em OK.
Figura: caixa de diálogo Serviço de Conteúdo Inteligente para fornecer a URL do serviço de conteúdo
note note NOTE A URL fornecida como URL de Serviço não pode ser acessada pelo navegador e gera um erro 404. A configuração funciona bem com o mesmo valor do parâmetro URL de Serviço. Para obter o status geral do serviço e o agendamento de manutenção, consulte https://status.adobe.com. -
Clique em Baixar Certificado Público para Integração com o OAuth e baixe o arquivo de certificado público
AEM-SmartTags.crt
.Figura: Configurações do serviço de marcação inteligente.
Reconfigure quando um certificado expirar certrenew
Depois que um certificado expira, ele deixa de ser confiável. Não é possível renovar um certificado expirado. Para adicionar um certificado, siga estas etapas.
-
Faça logon na implantação do Experience Manager como administrador. Clique em Ferramentas > Segurança > Usuários.
-
Localize o usuário dam-update-service e clique nele. Clique na guia Armazenamento de chaves.
-
Exclua o armazenamento de chaves similaritysearch existente com o certificado expirado. Clique em Salvar e fechar.
Figura: exclua a entrada
similaritysearch
existente no Armazenamento de Chaves para adicionar um certificado de segurança. -
Navegue até Ferramentas > Serviços da nuvem > Serviços da nuvem herdados. Clique em Tags inteligentes de ativos > Mostrar configuração > Configurações disponíveis. Clique na configuração necessária.
-
Para baixar um certificado público, clique em Baixar Certificado Público para Integração com o OAuth.
-
Acesse https://console.adobe.io e navegue até os Serviços de Conteúdo Inteligente existentes na página Integrações. Faça upload do novo certificado. Para obter mais informações, consulte as instruções em Criar integração com o Adobe Developer Console.
Criar integração do Adobe Developer Console create-adobe-i-o-integration
Para usar APIs do Serviço de Conteúdo Inteligente, crie uma integração no Adobe Developer Console para obter a Chave de API (gerada no campo ID do CLIENTE da integração com o Adobe Developer Console), a ID da CONTA TÉCNICA, a ID DA ORGANIZAÇÃO e o SEGREDO DO CLIENTE para as Configurações do Serviço de Marcação Inteligente da Assets da configuração de nuvem em Experience Manager.
-
Acesse https://console.adobe.io em um navegador. Selecione a conta e verifique se a organização associada tem a função de administrador do sistema.
-
Crie um projeto com o nome que quiser. Clique em Adicionar API.
-
Na página Adicionar uma API, selecione Experience Cloud e escolha Conteúdo inteligente. Clique em Avançar.
-
Selecione Fazer upload da sua chave pública. Forneça o arquivo de certificado baixado do Experience Manager. Será exibida a mensagem Chave(s) pública(s) carregada(s) com êxito. Clique em Avançar.
A página Criar uma nova credencial de conta de serviço (JWT) exibe a chave pública da conta de serviço.
-
Clique em Avançar.
-
Na página Selecionar perfis de produtos, selecione Serviços de conteúdo inteligente. Clique em Salvar API configurada.
Uma página exibe mais informações sobre a configuração. Mantenha esta página aberta para copiar e adicionar esses valores nas Configurações do Serviço de Marcação Inteligente da Assets da configuração de nuvem no Experience Manager para configurar marcas inteligentes.
Figura: Detalhes da integração no Adobe Developer Console
Configurar o serviço de conteúdo inteligente configure-smart-content-service
Consulte Configuração de integrações IMS para AEM
Consulte Etapas para configurar o OAuth para usuários locais
Consulte Solução de problemas de tags inteligentes para credenciais do OAuth
Para configurar a integração, use os valores dos campos ID DA CONTA TÉCNICA, ID DA ORGANIZAÇÃO, SEGREDO DO CLIENTE e ID DO CLIENTE da integração com o Adobe Developer Console. Criar uma configuração de nuvem de Tags Inteligentes permite a autenticação de solicitações de API da implantação Experience Manager.
-
Em Experience Manager, navegue até Ferramentas > Cloud Service > Cloud Services herdados para abrir o console Cloud Services.
-
Nas Tags inteligentes do Assets, abra a configuração criada acima. Na página de configurações do serviço, clique em Editar.
-
Na caixa de diálogo Serviço de conteúdo inteligente do AEM, use os valores pré-preenchidos nos campos URL do serviço e Servidor de autorização.
-
Para os campos Chave da API, ID da Conta Técnica, ID da Organização e Segredo do Cliente, copie e use os seguintes valores gerados na integração com o Adobe Developer Console.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Configurações do Serviço de Marcação Inteligente do Assets Campos de integração do Adobe Developer Console Chave de API ID DO CLIENTE ID da Conta Técnica ID DA CONTA TÉCNICA ID da Organização ID DA ORGANIZAÇÃO Segredo do cliente SEGREDO DO CLIENTE
Configurar OAuth para usuários locais config-oauth-onprem
Pré-requisitos prereqs-config-oauth-onprem
Um escopo de autorização é uma cadeia de caracteres OAuth que contém os seguintes pré-requisitos:
-
Crie uma nova integração OAuth no Developer Console usando o
ClientID
,ClientSecretID
eOrgID
. -
Adicionar os seguintes arquivos no caminho
/apps/system/config in crx/de
:com.adobe.granite.auth.oauth.accesstoken.provider.<randomnumbers>.config
com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl.<randomnumber>.config
Configurar OAuth para usuários locais steps-config-oauth-onprem
-
Adicionar ou atualizar as propriedades abaixo em
com.adobe.granite.auth.oauth.accesstoken.provider.<randomnumbers>.config
:-
auth.token.provider.authorization.grants="client_credentials"
-
auth.token.provider.orgId="<OrgID>"
-
auth.token.provider.default.claims=("\"iss\"\ :\ \"<OrgID>\"")
-
auth.token.provider.scope="read_pc.dma_smart_content,\ openid,\ AdobeID,\ additional_info.projectedProductContext"
auth.token.validator.type="adobe-ims-similaritysearch"
-
Atualize o
auth.token.provider.client.id
com a ID de cliente da nova configuração OAuth. -
Atualizar
auth.access.token.request
para"https://ims-na1.adobelogin.com/ims/token/v3"
-
-
Renomeie o arquivo para
com.adobe.granite.auth.oauth.accesstoken.provider-<randomnumber>.config
. -
Execute as etapas abaixo em
com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl.<randomnumber>.config
:- Atualize a propriedade auth.ims.client.secret com o Segredo do cliente da nova integração OAuth.
- Renomear o arquivo para
com.adobe.granite.auth.ims.impl.IMSAccessTokenRequestCustomizerImpl-<randomnumber>.config
-
Salve todas as alterações no console de desenvolvimento do repositório de conteúdo, por exemplo, CRXDE.
-
Navegue até
/system/console/configMgr
e substitua a configuração OSGi de.<randomnumber>
até-<randomnumber>
. -
Exclua a configuração antiga para
"Access Token provider name: adobe-ims-similaritysearch"
em/system/console/configMgr
. -
Reinicie o console.
Validar a configuração validate-the-configuration
Após concluir a configuração, você pode usar um MBean JMX para validar a configuração. Para validar, siga estas etapas.
-
Acesse seu servidor Experience Manager em
https://[aem_server]:[port]
. -
Acesse Ferramentas > Operações > Console da Web para abrir o console OSGi. Clique em Principal > JMX.
-
Clique em
com.day.cq.dam.similaritysearch.internal.impl
. Ele abre Tarefas Diversas de SimilaritySearch. -
Clique em
validateConfigs()
. Na caixa de diálogo Validar Configurações, clique em Chamar.
Os resultados da validação são exibidos no mesmo diálogo.
Habilitar marcação inteligente no fluxo de trabalho Ativo de atualização do DAM (opcional) enable-smart-tagging-in-the-update-asset-workflow-optional
-
Em Experience Manager, vá para Ferramentas > Fluxo de Trabalho > Modelos.
-
Na página Modelos de fluxo de trabalho, selecione o modelo de fluxo de trabalho Ativo de atualização DAM.
-
Clique em Editar na barra de ferramentas.
-
Expanda o painel lateral para exibir as etapas. Arraste a etapa Ativo de tag inteligente disponível na seção Fluxo de trabalho do DAM e coloque-a após a etapa Processar miniaturas.
Figura: etapa para adicionar ativo de marca inteligente após a etapa de miniatura do processo no fluxo de trabalho Ativo de atualização DAM.
-
Abra a etapa no modo de edição. Em Configurações avançadas, verifique se a opção Avanço do manipulador está selecionada.
Figura: configurar o fluxo de trabalho Atualizar ativo do DAM e adicionar a etapa de marca inteligente
-
Na guia Argumentos, selecione Ignorar erros se desejar que o fluxo de trabalho seja concluído mesmo se a etapa de marcação automática falhar.
Figura: configure o fluxo de trabalho do Ativo de atualização do DAM para adicionar a etapa de marca inteligente e selecione o manipulador avançado
Para marcar os ativos quando eles forem carregados independentemente de a marcação inteligente estar ativada nas pastas, selecione Ignorar sinalizador de tag inteligente.
Figura: configure o fluxo de trabalho do Ativo de atualização do DAM para adicionar a etapa de marca inteligente e selecione Ignorar sinalizador de Marca Inteligente.
-
Clique em OK para fechar a etapa do processo e salve o fluxo de trabalho.
Treinar o serviço de conteúdo inteligente training-the-smart-content-service
Para que o Serviço de conteúdo inteligente reconheça sua taxonomia comercial, execute-a em um conjunto de ativos que já incluem tags relevantes para sua empresa. Para marcar com eficiência as imagens da sua marca, o Serviço de conteúdo inteligente exige que as imagens de treinamento estejam em conformidade com determinadas diretrizes. Após o treinamento, o serviço pode aplicar a mesma taxonomia a um conjunto semelhante de ativos.
Você pode treinar o serviço várias vezes para melhorar sua capacidade de aplicar tags relevantes. Após cada ciclo de treinamento, execute um fluxo de trabalho de marcação e verifique se os ativos estão marcados corretamente.
Você pode treinar o Serviço de conteúdo inteligente periodicamente ou conforme necessário.
Diretrizes para treinamento guidelines-for-training
Para obter melhores resultados, as imagens no seu conjunto de treinamento estão em conformidade com as seguintes diretrizes:
Quantidade e tamanho: mínimo de 30 imagens por tag. Mínimo de 500 pixels no lado maior.
Coerência: imagens usadas para uma marca específica são visualmente semelhantes.
Por exemplo, não é uma boa ideia marcar todas essas imagens como my-party
(para treinamento) porque elas não são visualmente semelhantes.
Cobertura: use variedade suficiente nas imagens do treinamento. A ideia é fornecer alguns exemplos, mas razoavelmente diversos, para que o Experience Manager aprenda a focar nas coisas certas. Se você estiver aplicando a mesma tag em imagens visualmente diferentes, inclua pelo menos cinco exemplos de cada tipo.
Por exemplo, para a tag model-down-pose, inclua mais imagens de treinamento semelhantes à imagem destacada abaixo para que o serviço identifique imagens semelhantes com mais precisão durante a marcação.
Distração/obstrução: o serviço treina melhor imagens que têm menos distração (planos de fundo proeminentes, acompanhamentos não relacionados, como objetos/pessoas com o assunto principal).
Por exemplo, para a tag casual-shoes, a segunda imagem não é um bom candidato para treinamento.
Integridade: se uma imagem se qualificar para mais de uma tag, adicione todas as tags aplicáveis antes de incluir a imagem para treinamento. Por exemplo, para tags, como raincoat
e model-side-view
, adicione ambas as tags ao ativo elegível antes de incluí-lo para treinamento.
Formação periódica periodic-training
Você pode ativar o Serviço de conteúdo inteligente para treinar periodicamente nos ativos e nas tags associadas em uma pasta. Abra a página Propriedades da pasta de ativos, selecione Habilitar Tags Inteligentes na guia Detalhes e salve as alterações.
Depois que essa opção é selecionada para uma pasta, o Experience Manager executa automaticamente um fluxo de trabalho de treinamento para treinar o Serviço de Conteúdo Inteligente nos ativos da pasta e suas marcas. Por padrão, o fluxo de trabalho de treinamento é executado semanalmente às 12h30 aos sábados.
Treinamento sob demanda on-demand-training
Você pode treinar o Serviço de conteúdo inteligente sempre que necessário no console Fluxo de trabalho.
-
Na interface do Experience Manager, vá para Ferramentas > Fluxo de Trabalho > Modelos.
-
Na página Modelos de Fluxo de Trabalho, selecione o fluxo de trabalho Treinamento de Tags Inteligentes e clique em Iniciar Fluxo de Trabalho na barra de ferramentas.
-
Na caixa de diálogo Executar Fluxo de Trabalho, navegue até a pasta de carga que inclui os ativos marcados para treinar o serviço.
-
Especifique um título para o fluxo de trabalho e adicione um comentário. Em seguida, clique em Executar. Os ativos e as tags são enviados para treinamento.
Exibir relatórios de treinamento viewing-training-reports
Para verificar se o Serviço de conteúdo inteligente é treinado em suas tags no conjunto de ativos de treinamento, revise o relatório de fluxo de trabalho de treinamento no console Relatórios.
-
Na interface do Experience Manager, vá para Ferramentas > Assets > Relatórios.
-
Na página Relatórios de ativos, clique em Criar.
-
Selecione o relatório Treinamento de Tags Inteligentes e clique em Avançar na barra de ferramentas.
-
Especifique um título e uma descrição para o relatório. Em Agendar relatório, deixe a opção Agora selecionada. Se desejar agendar o relatório para posteriormente, selecione Posteriormente e especifique uma data e hora. Em seguida, clique em Criar na barra de ferramentas.
-
Na página Relatórios de ativos, selecione o relatório gerado. Para exibir o relatório, clique em Exibir na barra de ferramentas.
-
Revise os detalhes do relatório.
O relatório exibe o status do treinamento das tags que você treinou. A cor verde na coluna Status de treinamento indica que o Serviço de conteúdo inteligente foi treinado para a tag. A cor amarela indica que o serviço não é completamente treinado para uma tag específica. Nesse caso, adicione mais imagens com a tag específica e execute o fluxo de trabalho de treinamento para treinar o serviço completamente na tag.
Se você não vir suas tags neste relatório, execute o fluxo de trabalho de treinamento novamente para essas tags.
-
Para baixar o relatório, selecione-o na lista e clique em Baixar na barra de ferramentas. O relatório é baixado como uma planilha do Microsoft Excel.
Limitações limitations
-
As tags inteligentes aprimoradas se baseiam em modelos de aprendizagem de imagens e suas tags. Esses modelos nem sempre são perfeitos para identificar tags. A versão atual do Serviço de conteúdo inteligente tem as seguintes limitações:
- Incapacidade de reconhecer diferenças sutis nas imagens. Por exemplo, camisetas finas versus camisetas convencionais.
- Incapacidade de identificar tags com base em pequenos padrões/partes de uma imagem. Por exemplo, logotipos em camisetas.
- Há suporte para marcação nas localidades nas quais Experience Manager tem suporte.
-
Para pesquisar ativos com marcas inteligentes (comuns ou aprimoradas), use o Assets Omnisearch (pesquisa de texto completo). Não há predicado de pesquisa separado para tags inteligentes.