Integração com a Adobe Campaign Standard

Observação

Esta documentação descreve como integrar AEM com a Adobe Campaign Standard, a solução baseada em subscrições. Se você estiver usando o Adobe Campaign 6.1, consulte Integração com o Adobe Campaign 6.1 para obter essas instruções.

A Adobe Campaign permite gerenciar o conteúdo e os formulários dos delivery de email diretamente no Adobe Experience Manager.

Para usar as duas soluções juntas ao mesmo tempo, primeiro configure-as para se conectarem umas às outras. Isso envolve etapas de configuração no Adobe Campaign e no Adobe Experience Manager. Essas etapas são descritas detalhadamente neste documento.

Trabalhar com a Adobe Campaign no AEM inclui a capacidade de enviar emails e formulários via Adobe Campaign e está descrita em Trabalhar com a Adobe Campaign.

Além disso, os seguintes tópicos podem ser de interesse ao integrar AEM com o Adobe Campaign:

Se você estiver estendendo sua integração com o Adobe Campaign, talvez deseje ver as seguintes páginas:

Configuração do Adobe Campaign

A configuração do Adobe Campaign envolve o seguinte:

  1. Configuração do usuário aemserver .
  2. Criando uma conta externa dedicada.
  3. Verificação da opção AEMResourceTypeFilter.
  4. Criando um template do delivery dedicado.
Observação

Para executar essas operações, é necessário ter a função de administração no Adobe Campaign.

Pré-requisitos

Verifique se você tem os seguintes elementos antecipadamente:

CUIDADO

As operações detalhadas nas seções Configuração do Adobe Campaign e Configuração do Adobe Experience Manager são necessárias para que as funcionalidades de integração entre o AEM e o Adobe Campaign funcionem corretamente.

Configuração do usuário aemserver

O usuário aemserver deve estar configurado no Adobe Campaign. O aemserver é um usuário técnico que será usado para conectar o servidor AEM à Adobe Campaign.

Vá até Administração > Usuários e segurança > Usuários e selecione o usuário aemserver . Clique nele para abrir as configurações do usuário.

  • É necessário definir uma senha para este usuário. Isso não pode ser feito por meio da interface do usuário. Essa configuração deve ser feita em REST por um administrador técnico.
  • Você pode atribuir funções específicas a esse usuário, como deliveryPrepare, que permite que o usuário crie e edite delivery.

Configuração de uma conta externa Adobe Experience Manager

Você deve configurar uma conta externa que permita conectar o Adobe Campaign à sua instância AEM.

Observação

Em AEM, certifique-se de definir a senha para o usuário remoto da campanha. É necessário definir essa senha para conectar o Adobe Campaign com o AEM. Faça logon como administrador e no console de administração do usuário, procure o usuário remoto-campanha e clique em Definir senha.

Para configurar uma conta externa AEM:

  1. Vá até Administração > Configurações ​do aplicativo > Conta externa.

    chlimage_1-124

  2. Selecione a conta externa aemInstance padrão ou crie uma nova clicando no botão Criar .

  3. Selecione Adobe Experience Manager no campo Tipo e insira os parâmetros de acesso usados para sua instância de criação de AEM: endereço do servidor, nome da conta e senha.

    Observação

    Certifique-se de que não adicione uma barra final / no final do URL ou a conexão não funcionará.

  4. Verifique se a caixa de seleção Ativado está selecionada e clique em Salvar para salvar suas modificações.

Verificação da opção AEMResourceTypeFilter

A opção AEMResourceTypeFilter é usada para filtrar tipos de recursos AEM que podem ser usados no Adobe Campaign. Isso permite que a Adobe Campaign recupere AEM conteúdo especificamente projetado para ser usado apenas no Adobe Campaign.

Essa opção vem pré-configurada; no entanto, se você alterar essa opção, ela poderá resultar em uma integração inoperante.

Para verificar se a opção AEMResourceTypeFilter está configurada:

  1. Vá até Administração > Configurações ​do aplicativo > Opções.
  2. Na lista, você pode garantir que a opção AEMResourceTypeFilter esteja listada e que os caminhos estejam corretos.

Criação de um template do delivery de email específico para AEM

Por padrão, o recurso AEM não está ativado nos modelos de e-mail da Adobe Campaign. Você pode configurar um novo template do delivery de email que será usado para criar emails com conteúdo AEM.

Para criar um template do delivery de email específico para AEM:

  1. Vá para Recursos > Modelos > Templates do delivery.

  2. Ative a seleção clicando na marca de seleção na barra de ações e selecionando o modelo padrão de e-mail padrão (e-mail) existente, em seguida, duplicado-o clicando no ícone Copiar e clicando em Confirmar.

  3. Desative o modo de seleção clicando no x e abra o modelo recém-criado Copiar do padrão de e-mail (e-mail) , em seguida, selecione Editar propriedades na barra de ação do painel de modelo.

    Você pode modificar o Rótulo do modelo.

  4. Na seção Propriedades de conteúdo , altere a fonte ​de conteúdo para Adobe Experience Manager. Em seguida, selecione a conta externa criada anteriormente e clique em Confirmar.

    Salve as modificações clicando em Confirmar e em Salvar.

    Os delivery de e-mail criados a partir deste modelo terão o recurso de conteúdo AEM ativado.

    chlimage_1-125

Configuring Adobe Experience Manager

Para configurar o AEM, faça o seguinte:

  • Configure a replicação entre instâncias.
  • Conecte AEM ao Adobe Campaign.
  • Configure o externalizador.

Configuração da replicação entre instâncias AEM

O conteúdo criado da instância de criação de AEM é enviado primeiro para a instância de publicação. Essa instância de publicação transfere o conteúdo para a Adobe Campaign. O agente de replicação deve, portanto, ser configurado para replicar da instância de criação AEM para a instância de publicação AEM.

Observação

Se você não quiser usar o URL de replicação, mas usar o URL voltado para o público, poderá definir o URL ​público na seguinte configuração no OSGi (Ferramentas > Console da Web > Configuração OSGi > Integração de Campanha AEM - Configuração):
URL público: com.day.cq.mcm.campanha.impl.IntegrationConfigImpl#aem.mcm.campanha.publicUrl

Essa etapa também é necessária para replicar determinadas configurações de instância de criação na instância de publicação.

Para configurar a replicação entre instâncias AEM:

  1. Na instância de criação, selecione AEM logotipo> Ferramentas ícone > Implantação > Replicação > Agentes do autor e clique em Agente ​padrão.

    chlimage_1-126

    Observação

    Evite usar localhost (ou seja, uma cópia local de AEM) ao configurar sua integração com o Adobe Campaign, a menos que as instâncias de publicação e autor estejam ambas no mesmo computador.

  2. Clique em Editar e selecione a guia Transporte .

  3. Configure o URI substituindo localhost pelo endereço IP ou pelo endereço da instância de publicação AEM.

    chlimage_1-129

Conectando AEM ao Adobe Campaign

Antes de poder usar o AEM e o Adobe Campaign juntos, você deve estabelecer o link entre as duas soluções para que elas possam se comunicar.

  1. Conecte-se à sua instância de criação de AEM.

  2. Selecione Ferramentas > Operações > Nuvem > Cloud Services, em seguida, Configurar agora na seção Adobe Campaign.

    chlimage_1-128

  3. Crie uma nova configuração inserindo um Título e clique em Criar, ou escolha a configuração existente que deseja vincular à sua instância do Adobe Campaign.

  4. Edite a configuração para que ela corresponda aos parâmetros da sua instância do Adobe Campaign.

    • Nome de usuário: aemserver, o operador do pacote de Integração de AEM da Adobe Campaign usado para estabelecer o link entre as duas soluções.
    • Senha: Senha do operador do servidor Adobe Campaign. Talvez seja necessário especificar novamente a senha desse operador diretamente no Adobe Campaign.
    • Ponto final da API: URL da instância do Adobe Campaign.
  5. Selecione Conectar-se ao Adobe Campaign e clique em OK.

    chlimage_1-127

    Observação

    Depois de criar seu email e publicá-lo, você precisa publicar novamente a configuração na instância de publicação.

    chlimage_1-130

Observação

Se a conexão falhar, verifique o seguinte:

  • Você pode encontrar um problema de certificado ao usar uma conexão segura com uma instância do Adobe Campaign (https). Será necessário adicionar o certificado de instância do Adobe Campaign ao arquivo cacerts do seu JDK.
  • Além disso, consulte Solução de problemas da integraçãoAEM/Adobe Campaign.

Configuração do externalizador

É necessário configurar o externalizador em AEM na instância do autor. O Externalizador é um serviço OSGi que permite transformar um caminho de recurso em um URL externo e absoluto. Este serviço fornece um local central para configurar esses URLs externos e criá-los.

Consulte Configurar o externalizador para obter instruções gerais. Para a integração com o Adobe Campaign, certifique-se de configurar o servidor de publicação https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImpl não apontar para localhost:4503 , mas para um servidor que possa ser acessado pelo console do Adobe Campaign.

Se ele apontar para localhost:4503 ou para outro servidor que a Adobe Campaign não pode acessar, suas imagens não aparecerão no console do Adobe Campaign.

chlimage_1-131

Nesta página