Exportar fragmentos de experiência para o Adobe Target exporting-experience-fragments-to-adobe-target
- 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 criados no Adobe Experience Manager as a Cloud Service (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 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
Para preparar sua instância para exportar fragmentos de experiência do AEM para o Adobe Target, é necessário:
Depois disso, será possível:
Os fragmentos de experiência podem ser exportados para o espaço de trabalho padrão no Adobe Target ou para espaços de trabalho definidos pelo usuário.
Pré-requisitos prerequisites
Várias ações são necessárias:
-
Você precisa integrar o AEM ao Adobe Target.
-
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.
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, é 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 da 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 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
note caution CAUTION 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:
-
Salvar e fechar.
Adicionar a configuração herdada add-the-legacy-configuration
Depois de adicionar a Configuração da nuvem para usar a Experience Platform Launch para integrar inicialmente o AEM com o Adobe Target, também é necessário integrar manualmente ao Adobe Target usando uma configuração herdada.
Criação de uma configuração da nuvem do Target creating-a-target-cloud-configuration
Para permitir que o AEM interaja com o Adobe Target, crie uma configuração da nuvem do Target. Para criar a configuração, forneça o código de cliente do Adobe Target e as credenciais do usuário.
Você precisa criar a configuração da nuvem do Target apenas uma vez, pois é possível associá-la a várias campanhas do AEM. Se você tiver vários códigos de cliente do Adobe Target, crie uma configuração para cada código de cliente.
É possível definir a configuração da nuvem para sincronizar segmentos do Adobe Target. Se você habilitar a sincronização, os segmentos serão importados do Target em segundo plano assim que a configuração da nuvem for salva.
Use o procedimento a seguir para criar uma configuração da nuvem do Target no AEM:
-
Navegue até Cloud Services herdados através da Logotipo do AEM > Ferramentas > Cloud Services > Cloud Services herdados.
Por exemplo: (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)A página de visão geral da Adobe Experience Cloud é aberta.
-
Na seção Adobe Target, clique em Configurar agora.
-
Na caixa de diálogo Criar configuração:
- Forneça um Título à configuração.
- Selecione o modelo da Configuração do Adobe Target.
- Clique em Criar.
Agora é possível selecionar a nova configuração para edição.
-
A caixa de diálogo de edição é aberta.
-
Na caixa de diálogo Configurações do Adobe Target, forneça valores para essas propriedades.
-
Autenticação: o padrão é IMS (o método Credenciais de usuário foi descontinuado)
-
Código do cliente: o código do cliente da conta do Target
-
ID do locatário: a ID do locatário
-
Configuração do IMS: selecione a configuração necessária na lista suspensa
-
Tipo de API: o padrão é REST (o XML foi descontinuado)
-
Configuração da nuvem do A4T Analytics: selecione a configuração da nuvem do Analytics usada para métricas e metas de atividade do Target. Isso é necessário se estiver usando o Adobe Analytics como fonte de relatórios ao direcionar conteúdo.
-
Usar direcionamento preciso: por padrão, essa caixa de seleção está marcada. Se selecionada, a configuração do Cloud Service aguardará o carregamento do contexto antes de carregar o conteúdo. Veja a observação a seguir.
-
Sincronizar segmentos do Adobe Target: selecione essa opção para baixar segmentos definidos no Target e usá-los no AEM. Selecione essa opção quando a propriedade Tipo de API for REST, pois os segmentos em linha não são compatíveis e você sempre precisa usar segmentos do Target. (O termo AEM de "segmento" é equivalente ao termo "público-alvo" do Target.)
-
Biblioteca do cliente: o padrão é a AT.js (a mbox.js foi descontinuada)
note note NOTE O arquivo da biblioteca do Target, AT.JS, é uma nova biblioteca de implementação do Adobe Target, projetada para implementações típicas da Web e aplicativos de página única. A mbox.js foi descontinuada e será removida em um estágio posterior. A Adobe recomenda usar a AT.js como a biblioteca de cliente, em vez da mbox.js. A AT.js oferece várias melhorias em relação à biblioteca mbox.js: - Tempos de carregamento de página aprimorados para implementações da Web
- Segurança aprimorada
- Melhores opções de implementação para aplicativos de página única
- A AT.js contém os componentes que foram incluídos na target.js, portanto, a target.js não é mais chamada
É possível selecionar AT.js ou mbox.js no menu suspenso Biblioteca do cliente. -
Usar o sistema de gerenciamento de tags para fornecer a biblioteca do cliente - selecione essa opção para usar a biblioteca do cliente do Adobe Launch ou outro sistema de gerenciamento de tags (ou DTM, que foi descontinuado).
-
AT.js personalizada: procure e faça upload de sua AT.js personalizada. Deixe em branco para usar a biblioteca padrão.
note note NOTE Por padrão, quando você opta pelo assistente de configuração do Adobe Target, o Direcionamento preciso é ativado. Direcionamento preciso significa que a configuração do Cloud Service aguarda o contexto ser carregado antes de carregar o conteúdo. Como resultado, em termos de desempenho, o direcionamento preciso pode criar um atraso de alguns milissegundos antes de carregar o conteúdo. O direcionamento preciso é sempre ativado na instância do autor. No entanto, na instância de publicação, é possível desativar o direcionamento preciso globalmente, limpando a marca de seleção ao lado de Direcionamento preciso na configuração do Cloud Service (http://localhost:4502/etc/cloudservices.html). Você também pode ativar e desativar o direcionamento preciso para componentes individuais, independentemente das suas definições na configuração do Cloud Service. Se você já tiver criado componentes direcionados e alterar essa configuração, suas alterações não afetarão esses componentes. Você deve alterar esses componentes diretamente.
-
-
Clique em Conectar-se ao Adobe Target para inicializar a conexão com o Target. Se a conexão for bem-sucedida, a mensagem Conexão bem-sucedida será exibida. Clique em OK na mensagem e, em seguida, em OK na caixa de diálogo.
Adicionar uma estrutura do Target adding-a-target-framework
Após definir a configuração da nuvem do Target, adicione uma estrutura do Target. A estrutura identifica os parâmetros padrão enviados para o Adobe Target a partir dos componentes do ContextHub disponíveis. O Target usa os parâmetros para determinar os segmentos que se aplicam ao contexto atual.
Você pode criar várias estruturas para uma única configuração do Target. Várias estruturas são úteis quando você precisa enviar um conjunto de parâmetros diferentes ao Target para diferentes seções do seu site. Crie uma estrutura para cada conjunto de parâmetros que você precisa enviar. Associe cada seção do site à estrutura apropriada. Observe que uma página da Web pode usar somente uma estrutura de cada vez.
-
Na página de configuração do Target, clique no + (sinal de adição) ao lado de Configurações disponíveis.
-
Na caixa de diálogo Criar estrutura, especifique um Título, selecione a estrutura do Adobe Target e clique em Criar.
A página de estrutura é aberta. O Sidekick fornece componentes que representam informações do ContextHub que podem ser mapeadas.
-
Arraste o componente Contexto do cliente que representa os dados que você deseja usar para mapear até a zona de destino. Como alternativa, arraste o componente de Armazenamento do ContextHub para a estrutura.
note note NOTE Ao mapear, os parâmetros são enviados para uma mbox por meio de sequências de caracteres simples. Não é possível mapear matrizes do ContextHub. Por exemplo, para usar os dados de perfil dos visitantes do seu site para controlar sua campanha do Target, arraste o componente Dados de perfil para a página. As variáveis de dados de perfil disponíveis para mapeamento para parâmetros do Target são exibidas.
-
Selecione as variáveis que você deseja tornar visíveis para o sistema do Adobe Target marcando a caixa de seleção Compartilhar nas colunas apropriadas.
note note NOTE A sincronização de parâmetros é uma via de mão única - do AEM para o Adobe Target.
Sua estrutura foi criada. Para replicar a estrutura para a instância de publicação, use a opção Ativar estrutura no sidekick.
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. -
Selecione Exportar para o Adobe Target.
note note NOTE Se o fragmento de experiência já tiver sido exportado, selecione Atualizar no Adobe Target. -
Selecione Exportar sem publicar ou Publish, conforme necessário.
note note NOTE Selecionar Publicar publicará o fragmento de experiência imediatamente e o enviará para o Target. -
Selecione 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 Target. Consulte a documentação específica do Target para saber mais sobre o que é possível 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 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.
-