Configuração manual da integração com o Adobe Target

Você pode modificar as configurações do assistente de aceitação que você fez ao usar o assistente ou pode fazer a integração manualmente com o Adobe Target sem usar o assistente.

Modificar as configurações do Assistente de aceitação

O Assistente de opt-in that integra AEM ao Adobe Target O cria automaticamente uma configuração de nuvem do Target chamada Configuração do Target provisionada. O assistente também cria uma estrutura do Target para a configuração de nuvem chamada Estrutura do Target Provisionada. Você pode modificar as propriedades da configuração e da estrutura da nuvem, se necessário.

Você também pode configurar o Adobe Target para usar o Adobe Target como fonte de relatórios ao direcionar conteúdo configurando a configuração do A4T Analytics Cloud.

Para localizar a configuração de nuvem e a estrutura, acesse Cloud Services via Ferramentas > Implantação > Cloud. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html) Abaixo do Adobe Target, clique ou toque Mostrar configurações.

Propriedades de Configuração do Target Provisionado

Os seguintes valores de propriedade são usados na configuração da nuvem Configuração do Target Provisionada que o assistente de Opt-in cria:

  • Código do cliente: Conforme inserido no assistente de Opt-in.

  • E-mail: Conforme inserido no assistente de Opt-in.

  • Senha: Conforme inserido no assistente de Opt-in.

  • Tipo de API: REST

  • Sincronizar segmentos do Adobe Target: Selecionado.

  • Biblioteca do cliente: mbox.js.

  • Use o DTM para fornecer a biblioteca do cliente: Não selecionado. Selecione esta opção se você usar o DTM ou outro sistema de gerenciamento de tags para hospedar o arquivo mbox.js ou AT.js. O Adobe recomenda usar o DTM em vez de AEM para entregar a biblioteca do .

  • Mbox.js personalizada: Nenhum especificado para que o arquivo mbox.js padrão seja usado. Especifique um arquivo mbox.js personalizado para usar, conforme necessário. Somente será exibido se tiver selecionado mbox.js.

  • AT.js personalizada: Nenhum especificado para que o arquivo AT.js padrão seja usado. Especifique um arquivo AT.js personalizado para usar, conforme necessário. Somente será exibido se tiver selecionado AT.js.

OBSERVAÇÃO

No AEM 6.3, é possível selecionar o arquivo da Biblioteca do Target, AT.JS, que é uma nova biblioteca de implementação do Adobe Target, projetada para implementações típicas da Web e aplicativos de página única.

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, target.js não é mais chamada

Propriedades da Estrutura do Target Provisionada

A Estrutura do Target provisionada que o assistente de Opt-in cria é configurada para enviar dados de contexto do armazenamento de dados do perfil. A idade e os itens de dados de gênero da loja são enviados para o Target por padrão. Sua solução provavelmente requer que parâmetros adicionais sejam enviados.

chlimage_1-158

Você pode configurar a estrutura para enviar informações de contexto adicionais ao Target, conforme descrito em Adicionar uma estrutura do Target.

Configuração do A4T Analytics Cloud

Você pode configurar o Adobe Target para usar o Adobe Analytics como fonte de relatórios ao direcionar conteúdo.

OBSERVAÇÃO

A Autenticação de Credenciais de Usuário (herdada) não funciona com o A4T (para Target e Analytics). Dessa forma, os clientes devem usar a autenticação IMS em vez da autenticação User-Credential.

Para fazer isso, você precisa especificar a configuração da nuvem A4T com a qual conectar a configuração da nuvem do Adobe Target:

  1. Navegar para Cloud Services através da Logotipo AEM > Ferramentas > Implantação > Cloud Services.

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

  3. Reconecte-se à configuração do Adobe Target.

  4. No Configuração do A4T Analytics Cloud selecione a estrutura no menu suspenso.

    OBSERVAÇÃO

    Somente as configurações do Analytics que estão habilitadas para A4T estão disponíveis.

    Ao configurar o A4T com AEM, você pode ver uma entrada ausente de referência de configuração. Para selecionar a estrutura do analytics, faça o seguinte:

    1. Navegar para Ferramentas > Geral > CRXDE Lite.
    2. Navegue até o Caixa de diálogo de configuração do A4T Analytics (veja abaixo)
    3. Definir a propriedade disable para false.
    4. Toque ou clique Salvar tudo.

Caixa de diálogo de configuração do A4T Analytics

/libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig

AdobeTargetSettings

Clique em OK. Ao direcionar conteúdo com o Adobe Target, você pode selecione sua fonte de relatórios.

Integração manual com o Adobe Target

Integre manualmente o ao Adobe Target em vez de usar o assistente de aceitação.

OBSERVAÇÃO

O arquivo da Biblioteca do Target, AT.JSO é uma nova biblioteca de implementação do Adobe Target, projetada para implementações típicas da Web e aplicativos de página única. O Adobe recomenda usar a AT.js em vez da mbox.js como a biblioteca do cliente.
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, target.js não é mais chamada
    Você pode selecionar AT.js ou mbox.js no Biblioteca do cliente menu suspenso.

Criação de uma configuração da nuvem do Target

Para permitir que o AEM interaja com o Adobe Target, crie uma configuração de 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ê cria a configuração da nuvem do Target apenas uma vez, pois pode associar a configuração a várias campanhas AEM. Se você tiver vários códigos de cliente Adobe Target, crie uma configuração para cada código de cliente.

É possível configurar 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 de nuvem do Target no AEM:

  1. Navegar para Cloud Services através da Logotipo AEM > Ferramentas > Implantação > Cloud Services. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

    O Adobe Marketing Cloud a página de visão geral é aberta.

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

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

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

    A caixa de diálogo Editar é aberta.

    AdobeTargetSettings

    OBSERVAÇÃO

    Ao configurar o A4T com AEM, você pode ver uma entrada ausente de referência de configuração. Para selecionar a estrutura do analytics, faça o seguinte:

    1. Navegar para Ferramentas > Geral > CRXDE Lite.
    2. Navegar para /libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig
    3. Definir a propriedade disable para false.
    4. Toque ou clique Salvar tudo.
  4. Na caixa de diálogo , forneça valores para essas propriedades.

    • Código do cliente: o Código do cliente da conta do Target

    • E-mail: o email da conta do Target.

    • Senha: a senha da conta do Target.

    • Tipo de API: REST ou XML

    • Configuração do A4T Analytics Cloud: Selecione a configuração de 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. Se você não vir a configuração da nuvem, consulte a observação em Configuração do A4T Analytics Cloud.

    • Usar direcionamento preciso: Por padrão, essa caixa de seleção está marcada. Se selecionada, a configuração do serviço de nuvem aguardará o contexto carregar 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 para usá-los em AEM. Você deve selecionar 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. (Observe que o termo AEM de "segmento" equivale ao "público-alvo" do Target.)

    • Biblioteca do cliente: Selecione se deseja a biblioteca do cliente mbox.js ou AT.js.

    • Usar o DTM para fornecer a biblioteca do cliente - Selecione essa opção para usar AT.js ou mbox.js do DTM ou de outro sistema de gerenciamento de tags. Você deve configurar a integração do DTM para usar essa opção. O Adobe recomenda usar o DTM em vez de AEM para entregar a biblioteca do .

    • Mbox.js personalizada: Deixe em branco caso tenha marcado a caixa do DTM ou para usar a mbox.js padrão. Como alternativa, carregue seu mbox.js personalizado. Somente será exibido se tiver selecionado mbox.js.

    • AT.js personalizada: Deixe em branco se tiver marcado a caixa do DTM ou para usar o AT.js padrão. Como alternativa, carregue sua AT.js personalizada. Somente será exibido se tiver selecionado AT.js.

    OBSERVAÇÃO

    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 serviço de nuvem 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 serviço de nuvem (http://localhost:4502/etc/cloudservices.html). Você também pode ativar e desativar o direcionamento preciso para componentes individuais, independentemente da sua configuração na configuração do serviço de nuvem.
    Se tiver componentes direcionados criados e você altera essa configuração, suas alterações não afetam esses componentes. Você deve fazer alterações diretamente nesses componentes.

  5. Clique em Conectar-se ao Target para inicializar a conexão com o Target. Se a conexão for bem-sucedida, a mensagem Conexão bem-sucedida é exibida. Clique em OK na mensagem e depois OK na caixa de diálogo.

    Se não conseguir se conectar ao Target, consulte a solução de problemas seção.

Adicionar uma estrutura do Target

Após configurar 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 do Contexto do cliente ou ContextHub componentes. 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 diferente de parâmetros para o 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 seu site à estrutura apropriada. Observe que uma página da Web pode usar somente uma estrutura de cada vez.

  1. Na página Configuração do Target , clique no botão + (sinal de mais) ao lado de Frameworks disponíveis.

  2. Na caixa de diálogo Criar estrutura , especifique um Título, selecione o Adobe Target Framework e clique em Criar.

    chlimage_1-161

    A página da estrutura é aberta. O Sidekick fornece componentes que representam informações da Contexto do cliente ou ContextHub que podem mapear.

    chlimage_1-162

  3. Arraste o componente Contexto do Cliente que representa os dados que você deseja usar para mapear para o destino de soltar. Como alternativa, arraste a Armazenamento do ContextHub para a estrutura.

    OBSERVAÇÃO

    Ao mapear, os parâmetros são enviados para uma mbox por meio de strings simples. Não é possível mapear matrizes do ContextHub.

    Por exemplo, para usar Dados do perfil sobre os visitantes do seu site para controlar sua campanha do Target, arraste o Dados do perfil para a página. As variáveis de dados de perfil disponíveis para mapeamento para parâmetros do Target são exibidas.

    chlimage_1-163

  4. Selecione as variáveis que você deseja tornar visíveis para o sistema Adobe Target selecionando o Compartilhar caixa de seleção nas colunas apropriadas.

    chlimage_1-164

    OBSERVAÇÃO

    A sincronização de parâmetros é uma única maneira - do AEM ao Adobe Target.

Sua estrutura foi criada. Para replicar a estrutura para a instância de publicação, use o Ativar estrutura no sidekick.

Associar atividades à configuração da nuvem do Target

Associe seu Atividades AEM com a configuração da nuvem do Target , para que você possa espelhar as atividades no Adobe Target.

OBSERVAÇÃO

Os tipos de atividades disponíveis são determinados pelo seguinte:

  • Se a opção xt_only estiver ativada no inquilino do Adobe Target (clientcode) usado no lado do AEM para se conectar ao Adobe Target, você poderá criar apenas atividades XT no AEM.
  • Se a opção xt_only não estiver ativada no inquilino do Adobe Target (clientcode), você poderá criar ​atividades XT e A/B no AEM.
    Observação adicional: a opção xt_only é uma configuração aplicada em um determinado inquilino do Target (clientcode) e só pode ser modificada diretamente no Adobe Target. Não é possível ativar ou desativar essa opção no AEM.

Associar a estrutura do Target ao seu site

Depois de criar uma estrutura do Target no AEM, associe suas páginas da Web à estrutura. Os componentes direcionados nas páginas enviam os dados definidos pela estrutura para o Adobe Target para rastreamento. (Consulte Direcionamento de conteúdo.)

Quando você associa uma página à estrutura, as páginas filhas herdam a associação.

  1. No Sites , navegue até o site que deseja configurar.

  2. Usar uma ações rápidas ou modo de seleção, selecione Propriedades da exibição.

  3. Selecione o Cloud Services guia .

  4. Toque/clique Editar.

  5. Toque/clique Adicionar configuração under Configurações de Cloud Service e selecione Adobe Target.

    chlimage_1-165

  6. Selecione a estrutura desejada em Referência de configuração.

    OBSERVAÇÃO

    Certifique-se de selecionar o estrutura que você criou, e não a configuração da nuvem do Target na qual ela foi criada.

  7. Toque/clique Concluído.

  8. Ative a página raiz do site para replicá-la no servidor de publicação. (Consulte Como Publicar Páginas.)

    OBSERVAÇÃO

    Se a estrutura anexada à página ainda não tiver sido ativada, um assistente será aberto e você poderá publicá-la também.

Solução de problemas de conexão do Target

Execute as seguintes tarefas para solucionar problemas que ocorrem ao se conectar ao Target:

  • Certifique-se de que as credenciais de usuário fornecidas estejam corretas.
  • Certifique-se de que a instância de AEM possa se conectar ao servidor do Target. Por exemplo, verifique se as regras de firewall não estão bloqueando as conexões de AEM de saída ou se AEM configurado para usar os proxies necessários.
  • Procure mensagens úteis no log de erros do AEM. O arquivo error.log está localizado na variável crx-quickstart/logs diretório onde o AEM está instalado.
  • Ao editar a atividade no Adobe Target, o URL aponta para localhost. Solucione isso definindo o AEM externalizador para o URL correto.

Nesta página