Configuração manual da integração com o Adobe Target manually-configuring-the-integration-with-adobe-target
Você pode modificar as configurações do assistente de aceitação feitas ao usar o assistente ou integrar manualmente ao Adobe Target sem usar o assistente.
Modificação das configurações do assistente de aceitação modifying-the-opt-in-wizard-configurations
O Assistente de aceitação que integra o AEM com o Adobe Target cria automaticamente uma configuração de nuvem do Target chamada Configuração do destino provisionado. O assistente também cria uma estrutura do Target para a configuração da 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 definindo a Configuração do Analytics Cloud A4T.
Para localizar a configuração da nuvem e a estrutura, navegue até Cloud Service por meio de Ferramentas > Implantação > Nuvem. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)
Abaixo do Adobe Target, clique em Mostrar configurações.
Propriedades de Configuração do Alvo Provisionado provisioned-target-configuration-properties
Os seguintes valores de propriedade são usados na configuração da nuvem da Configuração do Target provisionada criada pelo assistente de Opt-in:
-
Código do cliente: conforme inserido no assistente de Opt-in.
-
Email: Conforme inserido no assistente de aceitação.
-
Senha: conforme inserido no assistente de Opt-in.
-
Tipo de API: REST
-
Sincronizar Segmentos Do Adobe Target: Selecionados.
-
Biblioteca do cliente: mbox.js.
-
Usar DTM para entregar a biblioteca do cliente: Não selecionado. Selecione esta opção se você usa o DTM ou outro sistema de gerenciamento de tags para hospedar o arquivo mbox.js ou AT.js. A Adobe recomenda usar o DTM em vez do AEM para fornecer a biblioteca.
-
Mbox.js personalizada: nenhuma especificada para que o arquivo mbox.js padrão seja usado. Especifique um arquivo mbox.js personalizado que deseja usar, conforme necessário. Aparece somente se você selecionou mbox.js.
-
AT.js personalizada: nenhuma especificada para que o arquivo AT.js padrão seja usado. Especifique um arquivo AT.js personalizado que deseja usar, conforme necessário. Aparece somente se tiver selecionado AT.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, não é mais chamada para o target.
Propriedades da Estrutura de Destino Provisionada provisioned-target-framework-properties
A Estrutura de destino provisionada que o assistente de Opt-in cria está configurada para enviar dados de contexto do armazenamento de Dados do perfil. A idade e os itens de dados de gênero do armazenamento são enviados para o Target por padrão. Sua solução provavelmente requer o envio de parâmetros adicionais.
Você pode configurar a estrutura para enviar informações de contexto adicionais ao Target conforme descrito em Adicionando uma Estrutura de Destino.
Definição da Configuração do A4T Analytics Cloud configuring-a-t-analytics-cloud-configuration
Você pode configurar o Adobe Target para usar o Adobe Analytics como fonte de relatórios ao direcionar conteúdo.
Para fazer isso, você especifica com qual configuração de nuvem do A4T deve se conectar à configuração de nuvem do Adobe Target:
-
Navegue até Cloud Service por meio do logotipo do AEM > Ferramentas > Implantação > Cloud Service.
-
Na seção Adobe Target, clique em Configurar agora.
-
Reconecte-se à configuração do Adobe Target.
-
No menu suspenso Configuração do Analytics Cloud A4T, selecione a estrutura.
note note NOTE Somente as configurações do Analytics habilitadas para A4T estão disponíveis. Ao configurar o A4T com AEM, você pode ver uma entrada ausente na referência Configuração. Para poder selecionar a estrutura de análise, faça o seguinte: - Navegue até Ferramentas > Geral > CRXDE Lite.
- Navegue até a Caixa de diálogo de configuração do A4T Analytics (veja abaixo)
- Defina a propriedade disable como false.
- Clique em Salvar tudo.
Caixa de diálogo Configuração do A4T Analytics a4t-analytics-config-dialog
/libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig
Clique em OK. Ao direcionar conteúdo com o Adobe Target, você pode selecionar sua fonte de relatório.
Integração manual com o Adobe Target manually-integrating-with-adobe-target
Integrar manualmente ao Adobe Target em vez de usar o assistente de aceitação.
- 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
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 quando 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 Service por meio do logotipo do AEM > Ferramentas > Cloud Service > Cloud Service herdados. (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)
A página de visão geral Cloud Service é 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.
A caixa de diálogo de edição é aberta.
note note NOTE Ao configurar o A4T com AEM, você pode ver uma entrada ausente na referência Configuração. Para poder selecionar a estrutura de análise, faça o seguinte: - Navegue até Ferramentas > Geral > CRXDE Lite.
- Navegue até /libs/cq/analytics/components/testandtargetpage/dialog/items/tabs/items/tab1_general/items/a4tAnalyticsConfig
- Defina a propriedade disable como false.
- Clique em Salvar tudo.
-
Na caixa de diálogo, forneça valores para essas propriedades.
-
Código do cliente: o código do cliente da conta do Target
-
Email: 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 do Analytics Cloud usada para métricas e metas de atividade de destino. Essa configuração é necessária 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 Configurando a configuração A4T do Analytics Cloud.
-
Usar direcionamento preciso: por padrão, essa caixa de seleção está marcada. Se selecionada, a configuração do Cloud Service aguarda o contexto ser carregado antes de carregar o conteúdo. Veja a observação a seguir.
-
Sincronizar segmentos do Adobe Target: selecione esta 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ê deve usar segmentos do Target. (O termo AEM de "segmento" é equivalente ao termo "público-alvo" do Target.)
-
Biblioteca do cliente: selecione se deseja a biblioteca do cliente mbox.js ou AT.js.
-
Usar DTM para fornecer biblioteca do cliente - Selecione essa opção para usar AT.js ou mbox.js do DTM ou outro sistema de gerenciamento de tags. Configure a integração do DTM para usar essa opção. A Adobe recomenda usar o DTM em vez do AEM para fornecer a biblioteca.
-
Mbox.js personalizada: deixe em branco se você marcou a caixa do DTM ou para usar o mbox.js padrão. Como alternativa, carregue a mbox.js personalizada. Aparece somente se você selecionou mbox.js.
-
AT.js personalizada: deixe em branco se você marcou a caixa do DTM ou para usar a AT.js padrão. Como alternativa, faça upload do seu AT.js personalizado. Aparece somente se tiver selecionado AT.js.
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. Altere esses componentes diretamente. -
-
Clique em Conectar ao Destino para inicializar a conexão com o Destino. 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.
Se não conseguir se conectar ao Target, consulte a seção solução de problemas.
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 Client Context ou 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ê deve enviar um conjunto diferente de parâmetros ao Target para diferentes seções do seu site. Crie uma estrutura para cada conjunto de parâmetros enviados. Associe cada seção do site à estrutura apropriada. Uma página da Web pode usar somente uma estrutura por vez.
-
Na página de configuração do Target, clique no + (sinal de adição) ao lado de Estruturas 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 Client Context ou do ContextHub que você pode mapear.
-
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 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 sobre os 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.
Associação de atividades com a configuração de nuvem do Target associating-activities-with-the-target-cloud-configuration
Associe suas atividades de AEM à configuração de nuvem do Target para que você possa espelhar as atividades no Adobe Target.
-
Se a opção xt_only estiver habilitada no locatário do Adobe Target (clientcode) usado no lado do AEM para se conectar ao Adobe Target AEM, você poderá criar atividades de XT somente no.
-
Se a opção xt_only estiver not habilitada no locatário do Adobe Target (clientcode), você poderá criar ambas atividades XT e A/B no AEM.
Associar a estrutura do Target ao seu site associating-the-target-framework-with-your-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 secundárias herdam a associação.
-
No console Sites, navegue até o site que deseja configurar.
-
Usando as ações rápidas ou o modo de seleção, selecione Exibir Propriedades.
-
Selecione a guia Cloud Services.
-
Clique em Editar.
-
Clique em Adicionar configuração em Configurações de Cloud Service e selecione Adobe Target.
-
Selecione a estrutura desejada em Referência de Configuração.
note note NOTE Selecione a estrutura específica que você criou e não a configuração de nuvem do Target sob a qual ela foi criada. -
Clique em Concluído.
-
Ative a página raiz do site para replicá-la no servidor de publicação. (Consulte Como Acessar Páginas Do Publish.)
note note NOTE Se a estrutura anexada à página ainda não tiver sido ativada, um assistente será aberto, permitindo que você também a publique.
Resolução de Problemas de Conexão do Target troubleshooting-target-connection-problems
Para solucionar problemas que ocorrem ao se conectar ao Target, você pode executar as seguintes tarefas:
- Verifique se as credenciais de usuário fornecidas estão corretas.
- Verifique se a instância do AEM pode se conectar ao servidor do Target. Por exemplo, verifique se as regras de firewall não estão bloqueando as conexões de saída com o AEM ou se o AEM está configurado para usar os proxies necessários.
- Procure mensagens úteis no registro de erros do AEM. O arquivo error.log está no diretório crx-quickstart/logs, onde o AEM está instalado.
- Ao editar a atividade no Adobe Target, o URL aponta para o host local. Resolva esse problema definindo o Externalizador de AEM para o URL correto.