Exportar Fragmentos de experiência para o Adobe Target exporting-experience-fragments-to-adobe-target

Você pode exportar Fragmentos de experiência criados 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 Adobe Developer Console, para o qual AEM deve ser integrado ao Adobe Target usando IMS.

NOTE
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 da Adobe Developer Console.
NOTE
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.
NOTE
Para obter mais informações, consulte também:

Pré-requisitos prerequisites

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

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

    note note
    NOTE
    As integrações IMS agora estão configuradas com S2S OAut.
    Configurações anteriores foram feitas com Credenciais JWT que agora estão sujeitas a desativação no Adobe Developer Console.
  2. Os fragmentos de experiência são exportados da instância do autor AEM, portanto, você deve Configurar o Externalizador de links AEM na instância do autor para garantir que todas as referências do fragmento de experiência sejam externalizadas para entrega na Web.

    note note
    NOTE
    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 add-the-cloud-configuration

Antes de exportar um fragmento, adicione 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.

    note note
    NOTE
    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.

    note note
    NOTE
    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
    note caution
    CAUTION
    O domínio Externalizer é opcional.
    Um Externalizador de AEM é configurado quando você deseja que o conteúdo exportado aponte para um domínio publicar específico. Para obter mais detalhes, consulte Configurando o Externalizador de Link 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 exporting-an-experience-fragment-to-adobe-target

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

    note note
    NOTE
    Ele deve ser uma variação web do fragmento de experiência.
  3. Clique em Exportar para o Adobe Target.

    note note
    NOTE
    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.

    note note
    NOTE
    Selecionar Publish 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.

    note note
    NOTE
    Vários detalhes da exportação podem ser vistos na Exibição de lista do console e nas Propriedades.
    note note
    NOTE
    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.
NOTE
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 using-your-experience-fragments-in-adobe-target

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

NOTE
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 deleting-an-experience-fragment-already-exported-to-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 removing-clientlibs-from-fragments-exported-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, a URL do Fragmento de experiência exportado pode ser semelhante à seguinte (aviso nocloudconfigs.atoffer):

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

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

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

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

Exemplo example

Para este fim aqui, vamos ilustrar como fazer isso com nocloudconfigs.

NOTE
Consulte Modelos editáveis para obter mais detalhes.

Sobreposições overlays

Neste exemplo específico, as sobreposições incluídas removerão 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 de /libs/cq/experience-fragments/components/xfpage/ incluem:

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

Sobreposições do tipo de modelo template-type-overlays

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

Sobreposições de 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

NOTE
Para usar data-sly-unwrap para remover a marca de corpo, você precisa de nocloudconfigs.html.

Considerações considerations

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

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2