Exportar Fragmentos de experiência para o Adobe Target

Última atualização em 2024-01-08
ATENÇÃO

Algumas funcionalidades desta página exigem a aplicação do AEM 6.5.3.0 (ou posterior).

6.5.3.0:

  • Domínios externalizadores agora pode ser selecionado.
    Nota: Os domínios do externalizador são relevantes somente para o conteúdo do fragmento de experiência que é enviado ao Target, e não para metadados como Exibir conteúdo da oferta.

6.5.2.0

  • Os fragmentos de experiência podem ser exportados para:

    • o espaço de trabalho padrão.
    • um espaço de trabalho nomeado, especificado na Configuração na nuvem.
    • Nota: A exportação para espaços de trabalho específicos exige o Adobe Target Premium.
  • AEM deve ser integrado ao Adobe Target usando IMS.

AEM 6.5.0.0 e 6.5.1.0:

  • Os Fragmentos de experiência do AEM são exportados para o espaço de trabalho padrão do Adobe Target.
  • O AEM deve estar integrado ao Adobe Target, de acordo com as instruções na seção Integração com o Adobe Target.

Você pode exportar Fragmentos de experiência, criado no Adobe Experience Manager (AEM), para o Adobe Target (Target). Eles podem ser usados como ofertas em atividades do Target, para testar e personalizar experiências em escala.

Há três opções de formato disponíveis para exportar um fragmento de experiência para o Adobe Target:

  • HTML (padrão): suporte para entrega de conteúdo da Web e híbrido
  • JSON: suporte para entrega de conteúdo headless
  • HTML e JSON

Os fragmentos de experiência do AEM podem ser exportados para o espaço de trabalho padrão no Adobe Target ou para espaços de trabalho definidos pelo usuário para o Adobe Target. Isso é feito usando o Console do Adobe Developer, para o qual o AEM deve ser integrado ao Adobe Target usando IMS.

OBSERVAÇÃO

Os espaços de trabalho do Adobe Target não existem no próprio Adobe Target. Eles são definidos e gerenciados no Adobe IMS (Identity Management System) e depois selecionados para uso nas soluções que usam integrações do console do Adobe Developer.

OBSERVAÇÃO

Os espaços de trabalho do Adobe Target podem ser usados para permitir que membros de uma organização (grupo) criem e gerenciem ofertas e atividades somente para essa organização, sem conceder acesso a outros usuários. Por exemplo, organizações específicas de cada país dentro de uma preocupação global.

OBSERVAÇÃO

Pré-requisitos

ATENÇÃO

Algumas funcionalidades desta página requerem a aplicação do AEM 6.5.3.0.

Várias ações são necessárias:

  1. Você precisa integrar o AEM ao Adobe Target usando IMS.

  2. Os fragmentos de experiência são exportados da instância do autor do AEM, portanto, Configurar o Externalizador de links de AEM na instância do autor para garantir que todas as referências do fragmento de experiência sejam externalizadas para entrega na Web.

    OBSERVAÇÃO

    Para a regravação de links não coberta por padrão, o Provedor de regravação de link do fragmento de experiência está disponível. Com isso, regras personalizadas podem ser desenvolvidas para sua instância.

Adicionar a configuração da nuvem

Antes de exportar um fragmento, é necessário adicionar o Configuração na nuvem para Adobe Target ao fragmento ou pasta. Isso também permite:

  • especificar as opções de formato a serem usadas para a exportação
  • selecionar um espaço de trabalho do Target como destino
  • selecionar um domínio Externalizador para regravação de referências no Fragmento de experiência (opcional)

As opções necessárias podem ser selecionadas nas Propriedades de página da pasta e/ou fragmento necessários; a especificação será herdada conforme necessário.

  1. Navegue até o console Fragmentos de experiência.

  2. Abra as Propriedades de página da pasta ou fragmento apropriado.

    OBSERVAÇÃO

    Se você adicionar a configuração da nuvem à pasta principal do fragmento de experiência, a configuração será herdada pelas pastas secundárias.

    Se você adicionar a configuração da nuvem ao próprio fragmento de experiência, a configuração será herdada por todas as variações.

  3. Selecione a guia Cloud Services.

  4. Em Configuração do Cloud Service, selecione Adobe Target na lista suspensa.

    OBSERVAÇÃO

    O formato JSON de uma oferta de fragmento de experiência pode ser personalizado. Para fazer isso, defina um componente de Fragmento de experiência do cliente e anote como exportar suas propriedades no componente Modelo do Sling.

    Consulte o componente principal:

    Componentes principais - Fragmentos de experiência

    Em Adobe Target, selecione:

    • a configuração apropriada
    • a opção de formato exigida
    • um espaço de trabalho do Adobe Target
    • se necessário, o domínio Externalizer
    ATENÇÃO

    O domínio Externalizer é opcional.

    Um Externalizador de AEM é configurado quando você deseja que o conteúdo exportado aponte para um publicar domínio. Para obter mais detalhes, consulte Configurar o Externalizador de links de AEM.

    Observe também que os domínios do externalizador são relevantes somente para o conteúdo do fragmento de experiência que é enviado ao Target, e não para metadados como Visualizar conteúdo da oferta.

    Por exemplo, para uma pasta:

    Pasta - Cloud Services
  5. Salvar e fechar.

Exportar um fragmento de experiência para o Adobe Target

ATENÇÃO

Para ativos de mídia, como imagens, somente uma referência é exportada para o Target. O ativo em si permanece armazenado no AEM Assets e é entregue a partir da instância de publicação do AEM.

Por isso, o fragmento de experiência, com todos os ativos relacionados, deve ser publicado antes da exportação para o Target.

Para exportar um fragmento de experiência do AEM para o Target (depois de especificar a configuração da nuvem):

  1. Navegue até o console Fragmento de experiência.

  2. Selecione o fragmento de experiência que deseja exportar para o Target.

    OBSERVAÇÃO

    Ele deve ser uma variação web do fragmento de experiência.

  3. Clique em Exportar para o Adobe Target.

    OBSERVAÇÃO

    Se o fragmento de experiência já tiver sido exportado, selecione Atualizar no Adobe Target.

  4. Clique em Exportar sem publicar ou Publish conforme necessário.

    OBSERVAÇÃO

    Selecionar Publish O publica o fragmento de experiência imediatamente e o envia para o Target.

  5. Clique em OK no diálogo de confirmação.

    Seu fragmento de experiência agora deve estar no Target.

    OBSERVAÇÃO

    Vários detalhes da exportação podem ser vistos na Exibição de lista do console e nas Propriedades.

    OBSERVAÇÃO

    Ao visualizar um fragmento de experiência no Adobe Target, a data da última modificação vista é a data em que o fragmento foi modificado pela última vez no AEM, não a data em que o fragmento foi exportado pela última vez para o Adobe Target.

OBSERVAÇÃO

Como alternativa, você pode executar a exportação a partir do editor de páginas, usando comandos comparáveis no menu Informações da página.

Usar os fragmentos de experiência no Adobe Target

Depois de executar as tarefas anteriores, o Fragmento de experiência é exibido na página Ofertas do Adobe Target. Olhe para o documentação específica do Target para saber mais sobre o que você pode realizar lá.

OBSERVAÇÃO

Ao visualizar um fragmento de experiência no Adobe Target, a data da última modificação vista é a data em que o fragmento foi modificado pela última vez no AEM, não a data em que o fragmento foi exportado pela última vez para o Adobe Target.

Excluir um fragmento de experiência já exportado para o Adobe Target

Excluir um fragmento de experiência que já foi exportado para o Target pode causar problemas se o fragmento já estiver sendo usado em uma oferta no Adobe Target. A exclusão do fragmento tornaria a oferta inutilizável, pois o conteúdo do fragmento estaria sendo entregue pelo AEM.

Para evitar essas situações:

  • Se o fragmento de experiência não estiver sendo usado atualmente em uma atividade, o AEM permite que o usuário exclua o fragmento sem mostrar uma mensagem de aviso.

  • Se o Fragmento de experiência estiver sendo usado por uma atividade no Adobe Target, uma mensagem de erro avisará o usuário AEM sobre as possíveis consequências que a exclusão do fragmento terá na atividade.

    A mensagem de erro no AEM não proíbe que o usuário exclua (à força) o fragmento de experiência. Se o fragmento de experiência for excluído:

    • A oferta do Target com o fragmento de experiência do AEM pode exibir um comportamento indesejado

      • A oferta provavelmente ainda será renderizada, pois o HTML do fragmento de experiência foi enviado para o Target
      • Qualquer referência no fragmento de experiência pode não funcionar corretamente se os ativos referenciados também tiverem sido excluídos no AEM.
    • É impossível fazer mais modificações no fragmento de experiência, pois ele não existe mais no AEM.

Remoção de ClientLibs dos Fragmentos de experiência exportados para o Target

Os Fragmentos de experiência contêm tags html completas e todas as Bibliotecas de clientes (CSS/JS) necessárias para renderizar o fragmento exatamente como ele foi criado pelo Autor de conteúdo do fragmento de experiência. Isto é um projeto.

Ao usar uma Oferta de fragmento de experiência com o Adobe Target em uma página que está sendo entregue pelo AEM, a página Direcionado já contém todas as Bibliotecas de clientes necessárias. Além disso, o html irrelevante na oferta de fragmento de experiência também não é necessário (consulte Considerações).

Veja a seguir um pseudo exemplo do html em uma Oferta de fragmento de experiência:

<!DOCTYPE>
<html>
   <head>
      <title>…</title>
      <!-- all the client libraries (css/js) -->
      …
   </head>
   <body>
        <!--/* Actual XF Offer content would appear here... */-->
   </body>
</html>

Em um alto nível, quando o AEM exporta um fragmento de experiência para o Adobe Target, ele faz isso usando vários seletores Sling adicionais. Por exemplo, o URL do Fragmento de experiência exportado pode ser semelhante ao seguinte (aviso nocloudconfigs.atoffer):

  • http://www.your-aem-instance.com/content/experience-fragments/my-offers/my-xf-offer.nocloudconfigs.atoffer.html

A variável nocloudconfigs O seletor é definido usando HTL e pode ser sobreposto copiando-o de:

  • /libs/cq/experience-fragments/components/xfpage/nocloudconfigs.html

A variável atoffer o seletor é aplicado após o processamento usando Sling Rewriter. Ambos podem ser usados para remover as bibliotecas de clientes.

Exemplo

Para o propósito aqui, vamos ilustrar como fazer isso com nocloudconfigs.

OBSERVAÇÃO

Consulte Modelos editáveis para obter mais detalhes.

Sobreposições

Neste exemplo específico, a variável sobreposições ser incluído removerá as Bibliotecas de clientes e o html irrelevante. Pressupõe-se que você já tenha criado o tipo de modelo do fragmento de experiência. Os arquivos necessários que precisam ser copiados do /libs/cq/experience-fragments/components/xfpage/ incluem:

  • nocloudconfigs.html
  • head.nocloudconfigs.html
  • body.nocloudconfigs.html

Sobreposições do tipo de modelo

Para o propósito deste exemplo, vamos para a seguinte estrutura:

Sobreposições do tipo de modelo

O conteúdo desses arquivos é o seguinte:

  • body.nocloudconfigs.html

    body.nocloudconfigs.html
  • head.nocloudconfigs.html

    head.nocloudconfigs.html
  • nocloudconfigs.html

    nocloudconfigs.html
OBSERVAÇÃO

Para usar data-sly-unwrap para remover a marca body, é necessário nocloudconfigs.html.

Considerações

Se você precisar oferecer suporte a sites AEM e não AEM usando Ofertas de fragmento de experiência no Adobe Target, será necessário criar dois fragmentos de experiência (dois tipos de modelo diferentes):

  • Um com a sobreposição para remover clientlibs/html extra

  • Uma que não tenha a sobreposição e, portanto, inclua as clientlibs necessárias

Nesta página