Configurar marcação de ativos usando o Serviço de conteúdo inteligente

Você pode integrar Adobe Experience Manager ao Serviço de conteúdo inteligente usando Adobe Developer Console. Use essa configuração para acessar o Serviço de conteúdo inteligente de dentro de Experience Manager.

O artigo detalha as seguintes tarefas principais que são necessárias para configurar o Serviço de conteúdo inteligente. No back-end, o servidor Experience Manager autentica suas credenciais de serviço no gateway Adobe Developer Console antes de encaminhar sua solicitação ao Serviço de conteúdo inteligente.

  1. Crie uma configuração do Serviço de conteúdo inteligente no 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. Opcionalmente, ative a marcação automática no upload de ativos.

Pré-requisitos

Antes de usar o Serviço de conteúdo inteligente, verifique o seguinte para criar uma integração em Adobe Developer Console:

  • Existência de uma Adobe ID com privilégios de administrador para a organização.

  • O Serviço de conteúdo inteligente está habilitado para sua organização.

Para ativar as Tags inteligentes aprimoradas, além do acima, instale também o Experience Manager service pack mais recente.

Criar configuração do Serviço de conteúdo inteligente para obter o certificado público

Um certificado público permite autenticar seu perfil em Adobe Developer Console.

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

  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 Serviço de Conteúdo Inteligente, 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.

    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 via navegador e gera um erro 404. A configuração funciona bem com o mesmo valor do parâmetro Service URL. 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 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 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 Armazenamento de chaves.

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

    Exclua a entrada similaritysearch existente no Armazenamento de chaves para adicionar um novo certificado de segurança

    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. Faça upload do novo certificado. Para obter mais informações, consulte as instruções em Criar integração do Console do Desenvolvedor do Adobe.

Criar integração do Console do Desenvolvedor do Adobe

Para usar APIs do Serviço de conteúdo inteligente, crie uma integração no Console do desenvolvedor do Adobe para obter Chave da API (gerada no campo ID do CLIENTE da integração do Console do desenvolvedor do Adobe), ID DA CONTA TÉCNICA, ID DA ORGANIZAÇÃO e 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 selecione 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 essa 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.

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

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

Configurar o Serviço de Conteúdo Inteligente

Para configurar a integração, use os valores dos campos TECHNICAL ACCOUNT ID, ORGANIZATION ID, CLIENT SECRET e CLIENT ID da integração do Console do Desenvolvedor do Adobe. Criar uma configuração de 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 do Assets, 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 use os seguintes valores gerados em Integração do Console do Desenvolvedor.

    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, use 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 Tools > Operations > Web Console para abrir o console OSGi. Clique em Principal > JMX.

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

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

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

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

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now