Integração com a Adobe Campaign Classic

Observação

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 e-mail 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 o Adobe Campaign:

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

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 construindo 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

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

No Adobe Campaign

  • Criar 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:

Configuração do 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.

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:

Observação

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.

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.

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

Você deve instalar o pacote de integração ​AEM 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….

    chlimage_1-132

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

    chlimage_1-133

  4. Clique em Avançar e em Start.

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

    CUIDADO

    Por padrão, nenhuma zona de segurança está configurada para esse operador. Para conectar-se 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 o 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.

    chlimage_1-134

Configuração de uma conta externa AEM

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

Observação
  • Ao instalar o pacote de integração ​AEM, uma conta AEM externa é criada. Você pode configurar a conexão com sua instância AEM a partir dela ou criar uma nova.
  • 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 AEM externa:

  1. Vá para o nó Administração > Plataforma > Conta externa .

  2. Crie uma nova conta externa e selecione o tipo de 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

    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/

    chlimage_1-135 chlimage_1-136

  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 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

    chlimage_1-137

Configuring 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.

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. É 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.

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 (AEM logotipo > ícone Ferramentas > Operações > Console da ​**​** Web > OSGi Configuration > Integração de CampanhaAEM - 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> ícone Ferramentas > Implantação > Replicação > Agentes do autor e clique em Agente padrão.

    chlimage_1-138

    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.

    chlimage_1-139

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 logotipo > ícone Ferramentas > Implantação > Cloud Services e, em seguida, Configurar agora na seção Adobe Campaign.

    chlimage_1-140

  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-141

    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-142

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 JDK da instância AEM.
  • Uma zona de segurança deve ser configurada para o operador aemserver no Adobe Campaign. Além disso, no arquivo serverConf.xml , o atributo allowUserPassword da zona de segurança deve ser definido como true para autorizar AEM conexão com o Adobe Campaign usando o modo de logon/senha.

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.ExternalizerImplnã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-143

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:

CUIDADO

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 .

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

  2. Selecione Novo.

    chlimage_1-144

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

    chlimage_1-145

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

    • Schema: selecione o schema nms:sementeMember . 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 Configuração.

  6. Salve seu schema 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 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 nms:recipient schema 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>

As nms:extensionMember do schema denominado 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:

chlimage_1-146

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 ​médio, 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ó Recursos > 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.

    chlimage_1-147

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 .

Observação

Os dados no público alvo só estarão disponíveis se o conteúdo do AEM for sincronizado com um delivery Adobe Campaign. See Synchronizing content created in AEM with a delivery from Adobe Campaign.

chlimage_1-148

Nesta página