Preparar Assets para marcação inteligente

Antes de começar a marcar seus ativos usando os Serviços de conteúdo inteligente, integre Experience Manager Assets com o Adobe Developer Console para aproveitar o serviço inteligente de Adobe Sensei. Depois de configurado, treine o serviço usando algumas imagens e uma tag .

OBSERVAÇÃO
  • Os Serviços de conteúdo inteligente não estão mais disponíveis para novos Experience Manager Assets Clientes locais. Os clientes existentes no local, 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 Managed Services que já tenham esse recurso ativado.
  • Novo Experience Manager Assets Os clientes do Managed Services 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:

Integração com o Console do desenvolvedor

Ao fazer a integração com o Console do Adobe Developer, a variável Experience Manager O servidor autentica suas credenciais de serviço no gateway do Console do Adobe Developer antes de encaminhar sua solicitação ao Serviço de conteúdo inteligente. Para fazer a integração, você precisa de uma conta da Adobe ID que tenha privilégios de administrador para a organização e a 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:

  1. Para gerar uma chave pública, Criar um serviço de conteúdo inteligente configuração em Experience Manager. Obtenha um certificado público para a integração OAuth.

  2. Crie uma integração no Console do desenvolvedor e faça upload da chave pública gerada.

  3. Configurar a implantação usando a chave da API e outras credenciais do Adobe Developer Console.

  4. Teste a configuração.

  5. Opcionalmente, ativar a marcação automática no upload de ativos.

Obter certificado público criando a configuração do Serviço de conteúdo inteligente

Um certificado público permite autenticar seu perfil no Console do desenvolvedor.

  1. No Experience Manager interface do usuário, acesso Ferramentas > Cloud Services > Cloud Services herdados.

  2. Na página Cloud Services, clique em Configurar agora under Tags inteligentes de ativos.

  3. No Criar configuração , especifique um título e nome para a configuração de Tags inteligentes. Clique em Criar.

  4. No Serviço de conteúdo inteligente AEM use os seguintes valores:

    URL do serviço: https://smartcontent.adobe.io/<region where your Experience Manager author instance is hosted>

    Por exemplo, https://smartcontent.adobe.io/apac. Você pode especificar na, emeaou, apac como as regiões onde a instância do autor de Experience Manager está hospedada.

    OBSERVAÇÃO

    Se o Experience Manager Managed Service 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 ser fornecido posteriormente). Clique em OK.

    Caixa de diálogo Serviço de conteúdo inteligente do Experience Manager para fornecer URL de serviço de conteúdo

    Figura: Caixa de diálogo Serviço de conteúdo inteligente para fornecer URL de serviço de conteúdo

    OBSERVAÇÃO

    O URL fornecido como URL de serviço não é acessível por meio do navegador e gera um erro 404. A configuração funciona bem com o mesmo valor da variável URL de serviço parâmetro. Para obter o status geral do serviço e o cronograma de manutenção, consulte https://status.adobe.com.

  5. Clique em Baixar certificado público para a integração OAuth e baixe o arquivo de certificado público AEM-SmartTags.crt.

    Uma representação das configurações criadas para o serviço de marcação inteligente

    Figura: Configurações do serviço de marcação inteligente.

Reconfigure quando um certificado expirar

Depois que um certificado expira, ele não é mais confiável. Não é possível renovar um certificado expirado. Para adicionar um certificado, siga estas etapas.

  1. Faça logon na implantação do Experience Manager como administrador. Clique em Ferramentas > Segurança > Usuários.

  2. Localize o usuário dam-update-service e clique nele. Clique em Armazenamento de chaves guia .

  3. Exclua o armazenamento de chaves similaritysearch existente com o certificado expirado. Clique em Salvar e fechar.

    Exclua a entrada de pesquisa de similaridade existente no Armazenamento de chaves para adicionar um certificado de segurança

    Figura: Exclua as similaritysearch no Armazenamento de chaves para adicionar um certificado de segurança.

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

  5. Para baixar um certificado público, clique em Baixar certificado público para a integração OAuth.

  6. Acesso https://console.adobe.io e navegue até os Serviços de conteúdo inteligente existentes no Integrações página. 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 com o Adobe Developer Console

Para usar APIs do Serviço de conteúdo inteligente, crie uma integração no Console do Adobe Developer para obter Chave da API (gerado em ID DO CLIENTE campo da integração do Adobe Developer Console), ID DA CONTA TÉCNICA, ID DA ORGANIZAÇÃOe SEGREDO DO CLIENTE para Configurações do serviço de marcação inteligente de ativos da configuração da nuvem em Experience Manager.

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

  2. Crie um projeto com o nome que quiser. Clique em Adicionar API.

  3. Na página Adicionar uma API, selecione Experience Cloud e escolha Conteúdo inteligente. Clique em Avançar.

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

    Criar uma nova credencial de conta de serviço (JWT) exibe a chave pública para a conta de serviço.

  5. Clique em Avançar.

  6. 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 em Configurações do serviço de marcação inteligente de ativos da configuração da nuvem em Experience Manager para configurar tags inteligentes.

    Na guia Visão geral, é possível revisar as informações da integração.

    Figura: Detalhes da integração no Console do Adobe Developer

Configurar o Serviço de Conteúdo Inteligente

Para configurar a integração, use os valores de ID DA CONTA TÉCNICA, ID DA ORGANIZAÇÃO, SEGREDO DO CLIENTEe ID DO CLIENTE da integração com o Adobe Developer Console. A criação de uma configuração de nuvem de Tags inteligentes permite a autenticação de solicitações de API do Experience Manager implantação.

  1. Em Experience Manager, navegue até Ferramentas > Cloud Service > Cloud Services herdados para abrir o Cloud Services console.

  2. Em Tags inteligentes de ativos, abra a configuração criada acima. Na página de configurações do serviço, clique em Editar.

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

  4. Para os campos Chave Da Api, ID da conta técnica, ID da organizaçãoe Segredo do cliente, copie e use os seguintes valores gerados em Integração com o Adobe Developer Console.

    Configurações do serviço de marcação inteligente de ativos Adobe Developer Console campos de integração
    Chave da API ID DO CLIENTE
    ID da conta técnica ID DA CONTA TÉCNICA
    ID da organização ID DA ORGANIZAÇÃO
    Client Secret SEGREDO DO CLIENTE

Validar a configuração

Após concluir a configuração, você pode usar um MBean JMX para validar a configuração. Para validar, siga estas etapas.

  1. Acesse seu Experience Manager servidor em https://[aem_server]:[port].

  2. Ir para Ferramentas > Operações > Console da Web para abrir o console OSGi. Clique em Principal > JMX.

  3. Clique em com.day.cq.dam.similaritysearch.internal.impl. Ele abre SemelhançaPesquisar diversas tarefas.

  4. Clique em validateConfigs(). No Validar configurações , clique em Invocar.

Os resultados da validação são exibidos na mesma caixa de diálogo.

Ativar a marcação inteligente na Ativo de atualização DAM workflow (opcional)

  1. Em Experience Manager, vá para Ferramentas > Fluxo de trabalho > Modelos.

  2. Na página Modelos de fluxo de trabalho, selecione o modelo de fluxo de trabalho Ativo de atualização DAM.

  3. Clique em Editar na barra de ferramentas.

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

    Etapa para adicionar ativo de tag inteligente após a etapa de miniatura do processo no fluxo de trabalho Ativo de atualização DAM

    Figura: etapa para adicionar ativo de tag inteligente após a etapa de miniatura do processo no fluxo de trabalho Ativo de atualização DAM

  5. Abra a etapa no modo de edição. Em Configurações avançadas, verifique se a opção Avanço do manipulador está selecionada.

    Configurar o fluxo de trabalho do Ativo de atualização do DAM e adicionar etapa de tag inteligente

    Figura: Configurar o fluxo de trabalho do Ativo de atualização do DAM e adicionar etapa de tag inteligente

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

    Configure o fluxo de trabalho Ativo de atualização do DAM para adicionar a etapa de tag inteligente e selecionar avanço do manipulador

    Figura: Configure o fluxo de trabalho Ativo de atualização do DAM para adicionar a etapa de tag inteligente e selecionar avanço do manipulador

    Para marcar os ativos quando eles forem carregados independentemente de a marcação inteligente estar ativada nas pastas, selecione Ignorar sinalizador de tag inteligente.

    Configure o fluxo de trabalho Ativo de atualização do DAM para adicionar a etapa de tag inteligente e selecione ignorar sinalizador de tag inteligente

    Figura: Configure o fluxo de trabalho Ativo de atualização do DAM para adicionar a etapa de tag inteligente e selecione ignorar sinalizador de tag inteligente.

  7. Clique em OK para fechar a etapa do processo e salve o fluxo de trabalho.

Treinar o Serviço de conteúdo inteligente

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 as imagens de sua marca com eficácia, 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 em 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 adequadamente.

Você pode treinar o Serviço de conteúdo inteligente periodicamente ou de acordo com requisitos.

OBSERVAÇÃO

O fluxo de trabalho de treinamento é executado somente em pastas.

Orientações para a formação

Para obter melhores resultados, as imagens em 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: As imagens usadas para uma tag específica são visualmente semelhantes.

Por exemplo, não é uma boa ideia marcar todas essas imagens como my-party (para treinamento) porque não são visualmente semelhantes.

Imagens ilustrativas para exemplificar as diretrizes de treinamento

Cobertura: Use a variedade suficiente nas imagens do treinamento. A ideia é fornecer alguns exemplos, mas razoavelmente diversos, para que a Experience Manager aprenda a se concentrar 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 realçada abaixo para que o serviço identifique imagens semelhantes com mais precisão durante a marcação.

Imagens ilustrativas para exemplificar as diretrizes de treinamento

Desvio/obstrução: O serviço se concentra melhor em imagens com menos distração (planos de fundo proeminentes, acompanhamento não relacionado, como objetos/pessoas com o assunto principal).

Por exemplo, para a tag sapato casual, a segunda imagem não é um bom candidato à formação.

Imagens ilustrativas para exemplificar as diretrizes de 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.

Imagens ilustrativas para exemplificar as diretrizes de treinamento

OBSERVAÇÃO

A capacidade do Serviço de conteúdo inteligente de treinar em suas tags e aplicá-las em outras imagens depende da qualidade das imagens usadas no treinamento. Para obter melhores resultados, o Adobe recomenda o uso de imagens visualmente semelhantes para treinar o serviço para cada tag.

Formação contínua

Você pode habilitar o Serviço de conteúdo inteligente para treinar periodicamente nos ativos e tags associadas em uma pasta. Abra o Propriedades da pasta de ativos, selecione Ativar Tags inteligentes nos termos do Detalhes e salve as alterações.

enable_smart_tags

Depois que essa opção é selecionada para uma pasta, Experience Manager O executa um fluxo de trabalho de treinamento automaticamente para treinar o Serviço de conteúdo inteligente nos ativos da pasta e suas tags. Por padrão, o fluxo de trabalho de treinamento é executado semanalmente às 12h30 dos sábados.

Treinamento sob demanda

Você pode treinar o Serviço de conteúdo inteligente sempre que necessário no console Fluxo de trabalho.

  1. Em Experience Manager interface, vá para Ferramentas > Fluxo de trabalho > Modelos.

  2. No Modelos de fluxo de trabalho selecione o Treinamento em Tags inteligentes e clique em Iniciar fluxo de trabalho na barra de ferramentas.

  3. No Executar fluxo de trabalho navegue até a pasta de carga que inclui os ativos marcados para treinar o serviço.

  4. Especifique um título para o fluxo de trabalho e adicione um comentário. Em seguida, clique em Executar. Os ativos e tags são enviados para treinamento.

    workflow_dialog

OBSERVAÇÃO

Depois que os ativos em uma pasta forem processados para treinamento, somente os ativos modificados serão processados em ciclos de treinamento subsequentes.

Exibir relatórios de treinamento

Para verificar se o Serviço de conteúdo inteligente é treinado em suas tags no conjunto de ativos de treinamento, analise o relatório do fluxo de trabalho de treinamento no console Relatórios .

  1. Em Experience Manager interface, vá para Ferramentas > Ativos > Relatórios.

  2. No Relatórios de ativos página, clique em Criar.

  3. Selecione o Treinamento em Tags inteligentes e clique em Próximo na barra de ferramentas.

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

  5. Na página Relatórios de ativos, selecione o relatório gerado. Para exibir o relatório, clique em Exibir na barra de ferramentas.

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

  7. 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 Excel do Microsoft.

Limitações

  • As tags inteligentes aprimoradas são baseadas em modelos de aprendizagem de imagens e suas tags. Esses modelos nem sempre são perfeitos na identificação de tags. A versão atual do Serviço de conteúdo inteligente tem as seguintes limitações:

    • Incapacidade de reconhecer sutis diferenças em imagens. Por exemplo, camisas finas versus camisas fixas regulares.
    • Incapacidade de identificar tags com base em pequenos padrões/partes de uma imagem. Por exemplo, logotipos em T-shirts.
    • A marcação é compatível com as localidades que Experience Manager O é compatível com o . Para obter uma lista de idiomas, consulte Notas de versão dos Serviços de conteúdo inteligente.
  • Para pesquisar ativos com tags inteligentes (regulares ou aprimoradas), use o Assets Omnisearch (pesquisa de texto completo). Não há predicado de pesquisa separado para tags inteligentes.

Nesta página