Esta documentação descreve como integrar AEM com a Adobe Campaign Classic, a solução local. Se você estiver usando o Adobe Campaign Standard, consulte Integração com o Adobe Campaign Standard 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 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:
Se você estiver estendendo sua integração com o Adobe Campaign, talvez deseje ver as seguintes páginas:
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:
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 o conteúdo e criar um mecanismo de delivery, é necessário fazer o seguinte:
Em AEM
No Adobe Campaign
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.
Se você for novo em AEM, poderá achar os seguintes links úteis para entender a AEM:
A configuração do Adobe Campaign envolve o seguinte:
Além disso, há configurações avançadas que você pode fazer, incluindo:
Consulte Configurações avançadas.
Para executar essas operações, você deve ter a função administration no Adobe Campaign.
Verifique se você tem os seguintes elementos antecipadamente:
Se você estiver executando uma versão anterior ao Adobe Campaign Classic build 8640, consulte a documentação de atualização para obter mais informações. Observe que tanto o cliente quanto o banco de dados precisam ser atualizados para a mesma compilaçã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.
Você deve instalar o pacote AEM Integration no Adobe Campaign. Para fazer isso:
Vá para a instância do Adobe Campaign com a qual você gostaria de vincular AEM.
Selecione Ferramentas > Avançado > Importar pacote….
Clique em Instalar um pacote padrão e selecione o pacote AEM Integration.
Clique em Próximo e em Start.
Este pacote contém o operador aemserver que será usado para conectar o servidor AEM à Adobe Campaign.
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.
Você deve configurar uma conta externa que permita conectar o Adobe Campaign à sua instância AEM.
Para configurar uma conta AEM externa:
Vá para o nó Administration > Platform > Conta externa.
Crie uma nova conta externa e selecione o tipo AEM.
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.
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/
Verifique se a caixa de seleção Enabled está selecionada.
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:
Vá para Plataforma >Opções.
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
Para configurar o AEM, faça o seguinte:
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.
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 (AEM logo > ícone Ferramentas > Operações > Console Web > Configuração do OSGi > AEM Integração de Campanha - 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:
Na instância de criação, selecione AEM logo> ícone Ferramentas > Implantação > Replicação > Agentes no autor e clique em Agente Predefinido.
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.
Toque ou clique em Editar e selecione a guia Transporte.
Configure o URI substituindo localhost pelo endereço IP ou pelo endereço da instância de publicação AEM.
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.
Conecte-se à sua instância de criação de AEM.
Selecione AEM logo > Ferramentas ícone > Implantação > Cloud Services e Configure now na seção Adobe Campaign.
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.
Edite a configuração para que ela corresponda aos parâmetros da sua instância do Adobe Campaign.
Selecione Ligar ao Adobe Campaign e clique em OK.
Depois de criar seu email e publicá-lo, você precisa publicar novamente a configuração na instância de publicação.
Se a conexão falhar, verifique o seguinte:
Além disso, consulte Resolução de problemas da integração AEM/Adobe Campaign.
É 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 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.
Você também pode executar algumas configurações avançadas, a saber:
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.
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:
O campo que você precisa adicionar já deve ter sido adicionado por meio de uma extensão de schema de recipient (nms:recipient). Para obter mais informações, consulte o guia Configuração.
Vá para o nó Administration > Configuration > schemas de dados na navegação do Adobe Campaign.
Selecione Novo.
Na janela pop-up, selecione Estender os dados na tabela usando um schema de extensão e clique em Próximo.
Insira os diferentes parâmetros do schema estendido:
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.
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.
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.
Para adicionar um campo Número de Registro, você deve ter os seguintes elementos:
<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:
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:
Copie o campo que você deseja retirar do schema nms:sementeMember no schema estendido (cus:sementeMember por exemplo).
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>
Para desativar um bloco de personalização entre os disponíveis:
Vá para o nó Resources > Gestão de campanha > Alocos de personalização na navegação do Adobe Campaign.
Selecione o bloco de personalização que deseja desativar no AEM.
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.
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.
Os dados no público alvo só estarão disponíveis se o conteúdo do AEM for sincronizado com um delivery Adobe Campaign. Consulte Sincronizar conteúdo criado em AEM com um delivery do Adobe Campaign.