Exportar fragmentos de conteúdo para o Adobe Target exporting-content-fragments-to-adobe-target

CAUTION
  • Os Fragmentos de conteúdo 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 conteúdo 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á a opção disponível para exportar um fragmento de conteúdo para o Adobe Target:

  • JSON: suporte para entrega de conteúdo headless

Para preparar sua instância para exportar Fragmentos de conteúdo do AEM para o Adobe Target, é necessário:

Depois disso, será possível:

Os Fragmentos de conteúdo 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.

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 utilizam o console do Adobe Developer.
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.

Pré-requisitos prerequisites

A seguinte ação é necessária:

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 conteúdo (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 Ativos.

  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 conteúdo, a configuração será herdada por todas as pastas secundárias.
    Se você adicionar a configuração de nuvem ao próprio Fragmento de conteúdo, 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 conteúdo pode ser personalizado. Para fazer isso, defina um componente de Fragmento de conteúdo do cliente e anote como exportar suas propriedades no modelo Sling do componente.
    Consulte o componente principal: Componentes principais - Fragmentos de conteúdo
  5. 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 conteúdo que é enviado ao Target, e não para metadados como Visualizar conteúdo da oferta.

    Por exemplo, para uma pasta:

    Pasta - Cloud Services

  6. Salvar e fechar.

Adicionar a configuração herdada add-the-legacy-configuration

IMPORTANT
Adicionar uma nova configuração herdada é um cenário de caso especial, permitido apenas na exportação de Fragmentos de conteúdo.

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:

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

  2. Na seção Adobe Target, clique em Configurar agora.

  3. Na caixa de diálogo Criar configuração:

    1. Forneça um Título à configuração.
    2. Selecione o modelo da Configuração do Adobe Target.
    3. Clique em Criar.

Agora é possível selecionar a nova configuração para edição.

  1. A caixa de diálogo de edição é aberta.

    config-target-settings-dialog

  2. 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ê tiver criado componentes direcionados e alterar essa configuração, suas alterações não afetarão esses componentes. Você deve alterar esses componentes diretamente.
  3. 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.

  1. Na página de configuração do Target, clique no + (sinal de adição) ao lado de Configurações disponíveis.

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

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

  4. 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 conteúdo para o Adobe Target exporting-a-content-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.
Devido a isso, o fragmento de conteúdo, com todos os ativos relacionados, deve ser publicado antes da exportação para o Target.

Para exportar um Fragmento de conteúdo do AEM para o Target (depois de especificar a configuração de nuvem):

  1. Navegue até o Fragmento de conteúdo no console Ativos.

  2. Selecione o Fragmento de conteúdo que deseja exportar para o Target.

  3. Selecione Exportar para Ofertas da Adobe Target.

    Exportar para o Adobe Target

  4. Selecione Exportar sem publicar ou Publish, conforme necessário.

    note note
    NOTE
    As ações reais mostradas dependerão do status do fragmento e dos ativos relacionados.
    Se tudo já tiver sido publicado e nada tiver sido modificado desde então, essa etapa será ignorada.
    note note
    NOTE
    Selecionar Publicar publicará o Fragmento de conteúdo imediatamente e o enviará para o Target.
  5. Selecione OK no diálogo de confirmação.

    Seu Fragmento de conteúdo 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 conteúdo 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.

Utilização de Fragmentos de conteúdo no Adobe Target using-your-content-fragments-in-adobe-target

Depois de executar as tarefas anteriores, o Fragmento de conteúdo é exibido na página Ofertas, no 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 conteúdo 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 conteúdo já exportado para o Adobe Target deleting-a-content-fragment-already-exported-to-adobe-target

Assim como na exportação, a exclusão de um Fragmento de conteúdo no Adobe Target também pode ser selecionada na barra de ferramentas superior do console Ativos assim que o fragmento for selecionado:

Excluir no Adobe Target

Excluir um Fragmento de conteúdo 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 conteúdo 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 conteúdo 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 conteúdo. Se o Fragmento de conteúdo for excluído:

    • A oferta do Target com o Fragmento de conteúdo do AEM poderá exibir um comportamento indesejado

      • A oferta provavelmente ainda será renderizada, pois o Fragmento de conteúdo foi enviado para o Target
      • Qualquer referência no Fragmento de conteúdo 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 conteúdo, pois ele não existe mais no AEM.

Recursos adicionais further-resources

Para obter mais informações, consulte o seguinte:

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab