Integração com o Adobe Campaign Classic

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 via Adobe Campaign e está descrita em Trabalhar com a Adobe Campaign. Também inclui o uso de formulários em páginas AEM para manipular dados.

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

• Práticas recomendadas para modelos de e-mail
• Solução de problemas da integração com o Adobe Campaign

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

• Criação de extensões personalizadas
• Criação de mapeamentos de formulário personalizados

Fluxo de trabalho de integração AEM e Adobe Campaign

Esta seção descreve um fluxo de trabalho típico entre AEM e Adobe Campaign ao criar campanhas e fornecer conteúdo.

O fluxo de trabalho típico envolve o seguinte e é descrito em detalhes:

1. Start que cria sua campanha (tanto no Adobe Campaign quanto no AEM).
2. Antes de vincular o conteúdo e o delivery, personalize seu conteúdo no AEM e crie um delivery no Adobe Campaign.
3. Vincule conteúdo e delivery no Adobe Campaign.

Start que cria sua campanha

Você start construindo uma campanha a qualquer momento. Antes de vincular o conteúdo, o AEM e o AC são independentes, o que significa que os profissionais de marketing podem criar suas campanhas e segmentar no Adobe Campaign, enquanto os criadores de conteúdo estão trabalhando no design no AEM.

Antes de vincular conteúdo e delivery

Antes de vincular o conteúdo e criar um mecanismo de delivery, é necessário fazer o seguinte:

Em AEM

• Personalize usando os campos de personalização no componente Texto e personalização

No Adobe Campaign

• Crie um delivery do tipo aemContent

Vincular conteúdo e configurar delivery

Depois de preparar o conteúdo para vinculação e delivery, você determina exatamente como e onde vincular o conteúdo.

Todas essas etapas foram concluídas no Adobe Campaign.

1. Especifique qual instância AEM usar.
2. Sincronize o conteúdo clicando no botão Sincronizar.
3. Abra o seletor de conteúdo para selecionar seu conteúdo.

Se você for novo em AEM

Se você for novo em AEM, poderá achar os seguintes links úteis para entender a AEM:

• Iniciando AEM
• Noções básicas sobre os agentes de replicação
• Como localizar e trabalhar com arquivos de registro
• Introdução à plataforma AEM

Configurando o Adobe Campaign

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

1. Instalação do pacote de integração AEM no Adobe Campaign.
2. Configuração de uma conta externa.
3. Verificando se AEMResourceTypeFilter está configurado corretamente.

Além disso, há configurações avançadas que você pode fazer, incluindo:

• Gerenciamento de blocos de conteúdo
• Gerenciamento de campos de personalização

Consulte Configurações avançadas.

Pré-requisitos

Verifique se você tem os seguintes elementos antecipadamente:

• Uma instância de criação de AEM
• Uma instância de publicação AEM
• Uma instância do Adobe Campaign Classic - incluindo um cliente e um servidor
• Internet Explorer 11

Instalando o Pacote de Integração AEM

Você deve instalar o pacote AEM Integration no Adobe Campaign. Para fazer isso:

1. Vá para a instância do Adobe Campaign com a qual você gostaria de vincular AEM.

2. Selecione Ferramentas > Avançado > Importar pacote….

   

3. Clique em Instalar um pacote padrão e selecione o pacote AEM Integration.

   

4. Clique em Próximo e em Start.

   Este pacote contém o operador aemserver que será usado para conectar o servidor AEM à Adobe Campaign.

   ATENÇÃO

   Por padrão, nenhuma zona de segurança está configurada para esse operador. Para se conectar ao Adobe Campaign via AEM, é necessário selecionar um.

   No arquivo serverConf.xml, o atributo allowUserPassword da zona de segurança selecionada deve ser definido como true para autorizar AEM a conectar a Adobe Campaign via login/senha.

   Recomendamos criar uma zona de segurança dedicada à AEM para evitar problemas de segurança. Para obter mais informações, consulte o Guia de instalação.

   

Configuração de uma conta externa AEM

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

Para configurar uma conta AEM externa:

1. Vá para o nó Administration > Platform > Conta externa.

2. Crie uma nova conta externa e selecione o tipo AEM.

3. Insira os parâmetros de acesso para a instância de criação de AEM: o endereço do servidor, bem como a ID e a senha usadas para conectar-se a essa instância. A senha da conta de usuário de api de campanha é a mesma do usuário remoto de campanha para o qual você definiu uma senha no AEM.

   OBSERVAÇÃO

   Certifique-se de que o endereço do servidor não termine em uma barra à direita. Por exemplo, digite https://yourserver:4502 em vez de https://yourserver:4502/

   

4. Verifique se a caixa de seleção Enabled está selecionada.

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 deve vir 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 Plataforma >Opções.

2. Na opção AEMResourceTypeFilter, verifique se os caminhos estão corretos. Este campo deve conter o valor:

   mcm/campanha/componentes/newsletter,mcm/campanha/components/campanha_newsletterpage,mcm/neolane/components/newsletter

   Ou, em alguns casos, o valor é o seguinte:

   mcm/campanha/componentes/newsletter

   

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 via Cloud Services.
• 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. É necessário publicar para que as imagens no boletim informativo estejam disponíveis na instância de publicação e nos recipient do boletim informativo. 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.

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 logo> ícone Ferramentas > Implantação > Replicação > Agentes no autor e clique em Agente Predefinido.

   

   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. Toque ou 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.

   

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 AEM logo > Ferramentas ícone > Implantação > Cloud Services e Configure now na seção Adobe Campaign.

   

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.

   

   OBSERVAÇÃO

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

   

Além disso, consulte Resolução de problemas da 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.ExternalizerImplnão aponte 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.

Configurações avançadas

Você também pode executar algumas configurações avançadas, a saber:

• Gerencie campos de personalização e blocos.
• Desative um bloco de personalização.
• Gerencie dados de extensão do target.

Gerenciamento de campos de personalização e blocos

Os campos e blocos disponíveis para adicionar personalização ao seu conteúdo de email no AEM são gerenciados pela Adobe Campaign.

Uma lista padrão é fornecida, mas pode ser modificada. Você também pode adicionar ou ocultar campos de personalização e blocos.

Adicionar um campo de personalização

Para adicionar um novo campo de personalização àqueles que já estão disponíveis, é necessário estender o schema Adobe Campaign nms:sementeMember da seguinte maneira:

1. Vá para o nó Administration > Configuration > schemas de dados na navegação do Adobe Campaign.

2. Selecione Novo.

   

3. Na janela pop-up, selecione Estender os dados na tabela usando um schema de extensão e clique em Próximo.

   

4. Insira os diferentes parâmetros do schema estendido:

   • Schema: selecione os nms: sementeMemberschema. Os outros campos na janela são automaticamente concluídos.
   • Namespace: personalize a namespace do schema estendido.

5. Edite o código XML do schema para especificar o campo que deseja adicionar. Para obter mais informações sobre como estender schemas no Adobe Campaign, consulte o Guia de configuração.

6. Salve seu schema e atualize a estrutura do banco de dados Adobe Campaign pelo menu Ferramentas > Avançado > Atualizar estrutura do banco de dados no console.

7. Desconecte e reconecte-se ao console do Adobe Campaign para salvar suas alterações. O novo campo agora aparece na lista de campos de personalização disponíveis no AEM.

Exemplo

Para adicionar um campo Número de Registro, você deve ter os seguintes elementos:

• A extensão de schema nms:recipient chamada cus:recipient contém:

<element desc="Recipient table (profiles)" img="nms:recipient.png" label="Recipients" labelSingular="Recipient" name="recipient">

  <attribute dataPolicy="smartCase" desc="Recipient registration number"
  label="Registration Number"
  length="50" name="registrationNumber" type="string"/>

</element>

A extensão de schema nms:sementeMember chamada cus:sementeMember contém:

<element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">

  <element name="custom_nms_recipient">
    <attribute name="registrationNumber"
    template="cus:recipient:recipient/@registrationNumber"/>
  </element>

</element>

O campo Número de Registro agora faz parte dos campos de personalização disponíveis:

Ocultar um campo de personalização

Para ocultar um campo de personalização entre aqueles que já estão disponíveis, você deve estender o schema Adobe Campaign nms:sementeMember, conforme detalhado na seção Adicionar um campo de personalização. Aplique as seguintes etapas:

1. Copie o campo que você deseja retirar do schema nms:sementeMember no schema estendido (cus:sementeMember por exemplo).

2. Adicione o atributo XML advanced="true" ao campo. Ela não aparece mais na lista de campos de personalização disponíveis no AEM.

   Por exemplo, para ocultar o campo Nome do Meio, o schema cud:sementeMember deve conter o seguinte elemento:

   <element desc="Seed to insert in the export files" img="nms:unknownad.png" label="Seed addresses" labelSingular="Seed" name="seedMember">
   
     <element name="custom_nms_recipient">
       <attribute advanced="true" name="middleName"/>
     </element>
   
   </element>
   

Desativação de um bloco de personalização

Para desativar um bloco de personalização entre os disponíveis:

1. Vá para o nó Resources > Gestão de campanha > Alocos de personalização na navegação do Adobe Campaign.

2. Selecione o bloco de personalização que deseja desativar no AEM.

3. Desmarque a caixa de seleção Visível nos menus de personalização e salve as alterações. O bloco não aparece mais na lista de alocos de personalização disponíveis no Adobe Campaign.

   

Gerenciamento de dados de extensão do target

Você também pode inserir dados de extensão do target para personalização. Os dados de extensão do target (também chamados de "Dados de Público alvo") vêm do enriquecimento ou adição de dados em um query em um fluxo de trabalho de campanha, por exemplo. Para obter mais informações, consulte as seções Criação de query e Enriquecimento de dados.