Integração com o 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 Adobe Campaign:

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

Configurando o Adobe Campaign

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

  1. Configurando o 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, você deve ter a função administration no Adobe Campaign.

Pré-requisitos

Verifique se você tem os seguintes elementos antecipadamente:

ATENÇÃO

As operações detalhadas nas seções Configurar o Adobe Campaign e Configurar o 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á para Administração > Utilizadores e Segurança > Utilizadores e selecione o utilizador 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á para Administração > Definições da aplicação > Conta externa.

    chlimage_1-124

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

  3. Selecione Adobe Experience Manager i no campo Type e introduza os parâmetros de acesso utilizados para a instância de criação AEM: endereço do servidor, nome da conta e senha.

    OBSERVAÇÃO

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

  4. Verifique se a caixa de seleção Enabled 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á para Administração > Definições da aplicação > Opções.
  2. Na lista, você pode garantir que a opção AEMResourceTypeFilter esteja listada e que os caminhos estejam corretos.

Criando 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 Resources > 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 (e-mail) padrão 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 Cópia do e-mail padrão (mail), em seguida, selecione Editar propriedades na barra de ação do painel de modelo.

    Você pode modificar o Label do modelo.

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

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

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

    chlimage_1-125

Configurando o 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.

Configurando a 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 em vez disso 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 do OSGi > Integração de Campanhas 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 logotipo AEM> Ferramentas ​ ícone > Implantação > Replicação > Agentes no 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-127

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 e Configure now 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 Ligar ao Adobe Campaign e clique em OK.

    chlimage_1-129

    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 Resolução de problemas da sua integração AEM/Adobe Campaign.

Configuração do externalizador

É necessário configurar o externalizador no 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 Configure o externalizador para obter instruções gerais. Para a integração com o Adobe Campaign, certifique-se de configurar o servidor de publicação em 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 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