Integração com o Adobe Campaign Classic

O Adobe Campaign permite gerenciar o conteúdo e os formulários de entrega por 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 o Adobe Campaign no AEM inclui a capacidade de enviar emails por meio do Adobe Campaign e está descrita em Trabalhar com o Adobe Campaign. Também inclui o uso de formulários em páginas do AEM para manipular dados.

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

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

Se você estiver estendendo a 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 do AEM e do Adobe Campaign

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

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

1. Comece a criar sua campanha (tanto no Adobe Campaign quanto no AEM).
2. Antes de vincular o conteúdo e a entrega, personalize seu conteúdo no AEM e crie uma entrega no Adobe Campaign.
3. Vincule conteúdo e entrega no Adobe Campaign.

Comece a criar sua campanha

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

Antes de vincular o conteúdo e a entrega

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

No AEM

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

No Adobe Campaign

• Criar uma entrega do tipo aemContent

Vincular conteúdo e configurar entrega

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

Todas essas etapas foram concluídas no Adobe Campaign.

1. Especifique qual instância do 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 no AEM

Se você for novo no AEM, talvez ache os seguintes links úteis para entender o AEM:

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

Configuração do Adobe Campaign

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

1. Instalação do pacote de integração do 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 do AEM
• Uma instância de publicação do AEM
• Uma instância do Adobe Campaign Classic - incluindo um cliente e um servidor
• Internet Explorer 11

Instalação do pacote de integração do AEM

Você deve instalar o pacote de integração do AEM no Adobe Campaign. Para fazer isso:

1. Vá para a instância do Adobe Campaign que você deseja vincular ao AEM.

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

   

3. Clique em Instalar um pacote padrão e selecione o pacote de integração do AEM.

   

4. Clique em Avançar e em Iniciar.

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

   CUIDADO

   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 o AEM a conectar o Adobe Campaign via logon/senha.

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

   

Configurar uma conta externa AEM

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

Para configurar uma conta AEM externa:

1. Vá para o nó Administração > Plataforma > Contas ​​externas.

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

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

   Observação

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

   

4. Verifique se a caixa de seleção Ativado 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 o Adobe Campaign recupere conteúdos do AEM projetados especificamente para serem usados somente 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/campaign/components/newsletter,mcm/campaign/components/campaign_newsletterpage,mcm/neolane/components/newsletter

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

   mcm/campaign/components/newsletter

   

Configuring Adobe Experience Manager

Para configurar o AEM, você deve fazer o seguinte:

• Configure a replicação entre instâncias.
• Conecte o AEM ao Adobe Campaign por meio dos serviços em nuvem.
• Configure o externalizador.

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

O conteúdo criado na instância de criação do 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 para os destinatários do boletim. O agente de replicação deve, portanto, ser configurado para replicar da instância de criação do AEM para a instância de publicação do 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 do AEM:

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

   

   Observação

   Evite usar localhost (ou seja, uma cópia local do 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 do AEM.

   

Conexão do 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 do AEM.

2. Selecione o logotipo do AEM > ícone Ferramentas > Implantação > Serviços ​​em nuvem e, em seguida, Configurar agora 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 à 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 do Adobe Campaign AEM usado para estabelecer o link entre as duas soluções.
   • Senha: Senha do operador do servidor do 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.

   

   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 Solução de problemas da integraçãodo 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 Configurar o externalizador para obter instruções gerais. Para a integração do Adobe Campaign, certifique-se de configurar o servidor de publicação 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 para outro servidor que o Adobe Campaign não consegue 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 e blocos de personalização.
• Desative um bloco de personalização.
• Gerenciar dados de extensão de destino.

Gerenciamento de campos e blocos de personalização

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

Uma lista padrão é fornecida, mas pode ser modificada. Também é possível adicionar ou ocultar campos e blocos de personalização.

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 esquema Adobe Campaign nms:sementeMember da seguinte maneira:

1. Vá para o nó Administração > Configuração > Esquemas de dados na navegação do Adobe Campaign.

2. Selecione Novo.

   

3. Na janela pop-up, selecione Estender os dados na tabela usando um esquema de extensão e clique em Avançar.

   

4. Informe os diferentes parâmetros do esquema estendido:

   • Esquema: selecione o esquema nms:sementeMember . Os outros campos na janela são automaticamente concluídos.
   • Namespace: personalize o namespace do esquema estendido.

5. Edite o código XML do esquema para especificar o campo que deseja adicionar. Para obter mais informações sobre como estender esquemas no Adobe Campaign, consulte o guia Configuração.

6. Salve o esquema e atualize a estrutura do banco de dados do Adobe Campaign por meio do menu Ferramentas > Avançado > Atualizar estrutura do banco de dados no console.

7. Desconecte e reconecte-se ao console do Adobe Campaign para salvar as 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 esquema nms:receipt chamada cus:customer 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 esquema 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 os que já estão disponíveis, você deve estender o esquema nms:sementeMember do Adobe Campaign, conforme detalhado na seção Adicionar um campo de personalização. Aplique as seguintes etapas:

1. Copie o campo que deseja obter do esquema nms:sementeMember no esquema 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 esquema 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ó Recursos > Gerenciamento de campanha > Blocos 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 blocos de personalização disponíveis no Adobe Campaign.

   

Gerenciamento de dados de extensão de destino

Também é possível inserir dados de extensão de destino para personalização. Os dados de extensão do Target (também chamados de "Dados do Target") vêm do enriquecimento ou adição de dados em uma consulta em um fluxo de trabalho de campanha, por exemplo. Para obter mais informações, consulte as seções Criação de consultas e Enriquecimento de dados .