Preparar Assets para marcação inteligente

Antes de poder marcar seus ativos com o uso do Smart Content Services, integre Experience ManageR Assets ao 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.

Antes de usar o Serviço de conteúdo inteligente, verifique o seguinte:

• Integração com o Console do desenvolvedor.

• Treinar o Serviço de conteúdo inteligente.

• Instale o service pack mais recente Experience Manager.

Integração com o Console do desenvolvedor

Quando você se integra ao Console do desenvolvedor do Adobe, o servidor Experience Manager autentica suas credenciais de serviço no gateway do Console do desenvolvedor do Adobe antes de encaminhar sua solicitação ao Serviço de conteúdo inteligente. Para integrar 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 sua organização.

Para configurar o Serviço de conteúdo inteligente, siga estas etapas de nível superior:

1. Crie uma configuração do Smart Content Service em Experience Manager para gerar uma chave pública. 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. Configure sua implantação usando a chave da API e outras credenciais do Adobe Developer Console.

4. Teste a configuração.

5. Como opção, habilite a marcação automática no upload de ativos.

Criar configuração do Smart Content Service para obter certificado público

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

1. Na interface do usuário Experience Manager, acesse Ferramentas > Cloud Services > Cloud Services herdados.

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

3. Na caixa de diálogo Criar configuração, especifique um título e um nome para a configuração de Tags inteligentes. Clique em Criar.

4. Na caixa de diálogo AEM Smart Content Service, use os seguintes valores:

   URL do 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.

   

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

   OBSERVAÇÃO

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

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

   

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

Reconfigurar 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 novo 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 na guia Keystore.

3. 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 novo 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 Integração OAuth.

6. Acesse https://console.adobe.io e navegue até os Serviços de conteúdo inteligente existentes na página Integrações. Carregue o novo certificado. Para obter mais informações, consulte as instruções em Create Adobe Developer Console integration.

Criar integração do Console do desenvolvedor do Adobe

Para usar APIs do Smart Content Service, crie uma integração no Console do Desenvolvedor do Adobe para obter chave da API (gerada no campo ID CLIENTE da integração do Console do Desenvolvedor do Adobe), ID DA CONTA TÉCNICA, ID da ORGANIZAÇÃO e <a SECRET/>CLIENT T] para Configurações do serviço de marcação inteligente de ativos da configuração de 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.

   A página Criar uma nova credencial de conta de serviço (JWT) exibe a chave pública da conta de serviço recém-configurada.

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 de nuvem em Experience Manager para configurar tags inteligentes.

   

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

Configurar o Serviço de Conteúdo Inteligente

Para configurar a integração, use os valores dos campos ID DA CONTA TÉCNICA, ID da ORGANIZAÇÃO, CLIENT SECRET e ID CLIENTE da integração do Console do desenvolvedor do Adobe. A criação de uma configuração em nuvem de Tags inteligentes permite a autenticação de solicitações de API da implantação Experience Manager.

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

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ção e Segredo do Cliente, copie e utilize os seguintes valores gerados em integração do Console do Desenvolvedor do Adobe.

   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

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

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

2. Vá para Ferramentas > Operações > Console Web para abrir o console OSGi. Clique em Main > JMX.

3. Clique em com.day.cq.dam.similaritysearch.internal.impl. Ele abre SimilaridadePesquisar Tarefas Diversas.

4. Clique em validateConfigs(). Na caixa de diálogo Validar configurações, clique em Chamar.

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

Habilitar marcação inteligente no fluxo de trabalho DAM Update Asset (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.

   

   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.

   

   Figura: Configurar o fluxo de trabalho do Ativo de atualização do DAM e adicionar a etapa da 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.

   

   Figura: Configurar o fluxo de trabalho do Ativo de atualização do DAM para adicionar a etapa da 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.

   

   Figura: Configurar o fluxo de trabalho do Ativo de atualização do DAM para adicionar a etapa da tag inteligente e selecionar ignorar sinalizador da 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 a taxonomia de sua empresa, execute-a em um conjunto de ativos que já incluem tags relevantes para sua empresa. Para marcar com eficácia as imagens de 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 em um conjunto de ativos semelhante.

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 seus ativos estão marcados corretamente.

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

Diretrizes para treinamento

Para obter melhores resultados, as imagens em seu conjunto de treinamento devem estar 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 de uma tag devem ser 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: Deve haver uma variedade suficiente de imagens no 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.

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

Por exemplo, para a tag casual-shoe, a segunda imagem não é um bom candidato a 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 no ativo elegível antes de incluí-lo para treinamento.

Treinamento periódico

Você pode ativar o Serviço de conteúdo inteligente para treinar periodicamente nos ativos e tags associadas em uma pasta. Abra a página Propriedades da sua pasta de ativos, selecione Ativar Tags Inteligentes na guia Detalhes e salve as alterações.

Depois que essa opção é selecionada para uma pasta, Experience Manager 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 do sábado.

Treinamento sob demanda

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

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

2. Na página Modelos de Fluxo de Trabalho, selecione o fluxo de trabalho Treinamento de Tags Inteligentes e clique em Fluxo de Trabalho do Start na barra de ferramentas.

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

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

   

Relatórios de treinamento de visualização

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

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

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

3. Selecione o relatório Treinamento de 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 visualização do relatório, clique em Visualização 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 Download na barra de ferramentas. O relatório é baixado como uma planilha do Microsoft Excel.

Limitações

• Tags inteligentes aprimoradas são baseadas em modelos de aprendizado 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, camisas finas versus camisetas comuns.
  • Incapacidade de identificar tags com base em pequenos padrões/partes de uma imagem. Por exemplo, logotipos em camisetas.
  • A marcação é suportada nas localidades em que Experience Manager é suportado. Para obter uma lista de idiomas, consulte Notas de versão do Smart Content Services.

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