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.
Pré-requisitos prerequisites
Várias ações são necessárias:
-
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. -
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.
-
Navegue até o console Fragmentos de experiência.
-
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. -
Selecione a guia Cloud Services.
-
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:
-
Salvar e fechar.
Exportar um fragmento de experiência para o Adobe Target exporting-an-experience-fragment-to-adobe-target
Para exportar um fragmento de experiência do AEM para o Target (depois de especificar a configuração da nuvem):
-
Navegue até o console Fragmento de experiência.
-
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. -
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. -
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. -
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.
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á.
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
.
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:
O conteúdo desses arquivos é o seguinte:
-
body.nocloudconfigs.html
-
head.nocloudconfigs.html
-
nocloudconfigs.html
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