Exportar fragmentos de experiência para 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.

Pré-requisitos

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, é necessário Configurar o Externalizador de links do 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 a Configuração da nuvem do 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 do 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 externalizador
   ATENÇÃO

   O domínio externalizador é opcional.

   Um externalizador do AEM é configurado quando você deseja que o conteúdo exportado aponte para um domínio de publicação específico. Para obter mais detalhes, consulte Configurar o Externalizador de links do 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:

   

5. Salvar e fechar.

Exportar um fragmento de experiência para o Adobe 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. Toque/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. Toque/clique em Exportar sem publicar ou em Publicar, conforme necessário.

   OBSERVAÇÃO

   Selecionar Publicar publicará o fragmento de experiência imediatamente e o enviará para o Target.

5. Toque ou clique em OK na caixa de 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.

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 Target. Consulte a documentação específica do Target para saber mais sobre o que você pode realizar lá.

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 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 atualmente por uma atividade no Target, uma mensagem de erro avisará o usuário do 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 realizar qualquer alteração adicional 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 of the client libraries (css/js) -->
      …
   </head>
   <body>
        <!--/* Actual XF Offer content would appear here... */-->
   </body>
</html>

Em 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 por meio do uso de HTL e pode ser sobreposto copiando-o de:

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

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

Exemplo

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

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 precisarão 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, usaremos a seguinte estrutura:

O conteúdo desses arquivos é o seguinte:

• body.nocloudconfigs.html

  

• head.nocloudconfigs.html

  

• 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

Recursos do Business.Adobe.com

Automated Onboarding Mobile Forms Managed Cloud Dynamic Media Digital Asset Management Content Management System