Integração com o Adobe Campaign Classic integrating-with-adobe-campaign-classic
O Adobe Campaign permite gerenciar o conteúdo e os formulários de delivery de email diretamente no Adobe Experience Manager.
Para usar ambas as soluções em conjunto ao mesmo tempo, primeiro você deve configurá-las para se conectarem. 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 pelo Adobe Campaign e está descrita em Trabalhar com o 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 estiver estendendo sua integração com o Adobe Campaign, você pode querer ver as seguintes páginas:
Fluxo de trabalho de integração do AEM e Adobe Campaign aem-and-adobe-campaign-integration-workflow
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 detalhadamente:
- Comece a criar sua campanha (tanto no Adobe Campaign quanto no AEM).
- Antes de vincular o conteúdo e o delivery, personalize o conteúdo no AEM e crie um delivery no Adobe Campaign.
- Vincule o conteúdo e o delivery no Adobe Campaign.
Comece a criar sua campanha start-building-your-campaign
Você começa a criar 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 começar a criar campanhas e direcionar no Adobe Campaign, enquanto os criadores de conteúdo estão trabalhando no design no AEM.
Antes de vincular conteúdo e delivery before-linking-content-and-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 Texto e personalização componente
No Adobe Campaign
- Criar um delivery do tipo aemContent
Vinculação de conteúdo e definição de delivery linking-content-and-setting-delivery
Após preparar o conteúdo para vinculação e entrega, você determinará exatamente como e onde vincular o conteúdo.
Todas essas etapas são concluídas no Adobe Campaign.
- Especifique qual instância de AEM usar.
- Sincronize o conteúdo clicando no botão Synchronize .
- Abra o seletor de conteúdo para escolher seu conteúdo.
Se você é novo em AEM if-you-are-new-to-aem
Se você nunca AEM, poderá achar os seguintes links úteis para entender AEM:
Configuração do Adobe Campaign configuring-adobe-campaign
A configuração do Adobe Campaign envolve o seguinte:
- Instalação do pacote de integração de AEM no Adobe Campaign.
- Configuração de uma conta externa.
- 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 prerequisites
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
Instalação do pacote de integração AEM installing-the-aem-integration-package
Você deve instalar o Integração de AEM no Adobe Campaign. Para fazer isso:
-
Vá para a instância do Adobe Campaign que deseja vincular com o AEM.
-
Selecione Ferramentas > Avançado > Importar pacote….
-
Clique em Instale um pacote padrão, em seguida, selecione o Integração de AEM pacote.
-
Clique em Próximo e depois Iniciar.
Este pacote contém aemserver operador que será usado para conectar o servidor AEM ao Adobe Campaign.
note caution CAUTION Por padrão, nenhuma zona de segurança é configurada para esse operador. Para se conectar ao Adobe Campaign por meio do AEM, é necessário selecionar um. No serverConf.xml , o allowUserPassword deve ser definido como true autorizar AEM a conectar o Adobe Campaign via login/senha. É altamente recomendável criar uma zona de segurança dedicada ao AEM para evitar problemas de segurança. Para obter mais informações, consulte Guia de instalação.
Configuração de uma conta externa AEM configuring-an-aem-external-account
Você deve configurar uma conta externa que permita conectar o Adobe Campaign à instância do AEM.
- Ao instalar o Integração de AEM , uma conta AEM externa é criada. Você pode configurar a conexão com a instância do 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 pelo usuário remoto da campanha e clique em Definir senha.
Para configurar uma conta AEM externa:
-
Vá para o Administração > Plataforma > Contas externas nó .
-
Crie uma nova conta externa e selecione o AEM tipo .
-
Insira 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 da api de campanha é a mesma do usuário remoto de campanha para o qual você definiu uma senha no AEM.
note note NOTE Certifique-se de que o endereço do servidor not termine em uma barra à direita. Por exemplo, insira https://yourserver:4502
em vez dehttps://yourserver:4502/
-
Certifique-se de que a variável Ativado está marcada.
Verificação da opção AEMResourceTypeFilter verifying-the-aemresourcetypefilter-option
O AEMResourceTypeFilter é usada para filtrar tipos de recursos AEM que podem ser usados no Adobe Campaign. Isso permite que o Adobe Campaign recupere AEM conteúdo especificamente projetado para ser usado somente no Adobe Campaign.
Essa opção deve vir pré-configurada; no entanto, se você alterar essa opção, ela poderá levar a uma integração inoperante.
Para verificar a AEMResourceTypeFilter está configurada:
-
Ir para Plataforma >Opções.
-
No 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
Configuração do Adobe Experience Manager 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 via Cloud Services.
- Configure o externalizador.
Configuração da replicação entre instâncias AEM configuring-replication-between-aem-instances
O conteúdo criado da instância de criação do AEM é enviado primeiro para a instância de publicação. Você precisa publicar para que as imagens no boletim informativo estejam disponíveis na instância de publicação e nos destinatários do boletim informativo. Portanto, o agente de replicação deve ser configurado para replicar da instância de criação de AEM para a instância de publicação de AEM.
URL público: com.day.cq.mcm.campaign.impl.IntegrationConfigImpl#aem.mcm.campaign.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 Logotipo AEM> Ferramentas ícone > Implantação > Replicação > Agentes do autor, depois clique em Agente padrão.
note note NOTE Evite usar o host local (que é uma cópia local do AEM) ao configurar sua integração com o Adobe Campaign, a menos que a instância de publicação e autor esteja no mesmo computador. -
Toque ou clique Editar em seguida, selecione o Transportes guia .
-
Configure o URI substituindo localhost com o endereço IP ou o endereço da instância de publicação AEM.
Conectando AEM ao Adobe Campaign connecting-aem-to-adobe-campaign
Antes de 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.
-
Selecionar Logotipo AEM > Ferramentas ícone > Implantação > Cloud Services, em seguida Configurar agora na seção Adobe Campaign .
-
Crie uma nova configuração inserindo uma Título e clique em Criar ou escolha a configuração existente que deseja vincular à instância do Adobe Campaign.
-
Edite a configuração para que corresponda aos parâmetros da instância do Adobe Campaign.
- Nome do 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.
-
Selecionar Conectar-se ao Adobe Campaign e clique em OK.
note note NOTE Depois de crie seu email e publique-o, é necessário republicar a configuração na instância de publicação.
- 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 da instância do Adobe Campaign à variável acertos arquivo do JDK da instância do AEM.
- Uma zona de segurança deve ser configurada para a variável operador aemserver no Adobe Campaign. Além disso, no serverConf.xml , o allowUserPassword deve ser definido como true para autorizar AEM conexão com o Adobe Campaign usando o modo de logon/senha.
Configurar o externalizador configuring-the-externalizer
Você precisa 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. Esse serviço fornece um local central para configurar esses URLs externos e criá-los.
Consulte Configurar o externalizador para instruções gerais. Para a integração do 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 pode ser acessado pelo console do Adobe Campaign.
Se ela apontar para localhost:4503
Para outro servidor que não possa ser acessado pelo Adobe Campaign, as imagens não serão exibidas no console Adobe Campaign.
Configurações avançadas advanced-configurations
Você também pode executar algumas configurações avançadas, a saber:
- Gerenciar campos e blocos de personalização.
- Desativar um bloco de personalização.
- Gerenciar dados de extensão do target.
Gerenciamento de campos e blocos de personalização managing-personalization-fields-and-blocks
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.
Adição de um campo de personalização adding-a-personalization-field
Para adicionar um novo campo de personalização àqueles que já estão disponíveis, é necessário estender o Adobe Campaign nms:seedMember schema como mostrado a seguir:
-
Vá para o Administração > Configuração > Schemas de dados na navegação do Adobe Campaign.
-
Selecionar 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:
- Esquema: selecione o nms:seedMember esquema. Os outros campos na janela são automaticamente preenchidos.
- Namespace: personalize o namespace do schema estendido.
-
Edite o código XML do schema para especificar o campo que deseja adicionar lá. Para obter mais informações sobre a extensão de schemas no Adobe Campaign, consulte Guia de configuração.
-
Salve o schema e atualize a estrutura do banco de dados do Adobe Campaign por meio do Ferramentas > Avançado > Atualizar estrutura do banco de dados no console.
-
Desconecte e reconecte ao console Adobe Campaign para salvar as alterações. O novo campo agora aparece na lista de campos de personalização disponíveis no AEM.
Exemplo example
Para adicionar uma Número de registro , você deve ter os seguintes elementos:
- O nms:recipient extensão de 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>
O nms:seedMember extensão de schema chamada cus:seedMember 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 Número de registro agora faz parte dos campos de personalização disponíveis:
Ocultar um campo de personalização hiding-a-personalization-field
Para ocultar um campo de personalização entre aqueles já disponíveis, é necessário estender o Adobe Campaign nms:seedMember conforme detalhado na Adição de um campo de personalização seção. Siga as etapas abaixo:
-
Copie o campo que deseja remover do nms:seedMember no schema estendido (cus:seedMember por exemplo).
-
Adicione o advanced="true" Atributo XML ao campo. Ela não é mais exibida na lista de campos de personalização disponíveis no AEM.
Por exemplo, para ocultar a variável Nome do meio , o cud:seedMember schema deve conter o seguinte elemento:
code language-xml <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 deactivating-a-personalization-block
Para desativar um bloco de personalização entre os disponíveis:
-
Vá para o Recursos > Campaign Management > Blocos de personalização na navegação do Adobe Campaign.
-
Selecione o bloco de personalização que deseja desativar no AEM.
-
Limpe o Visível nos menus de personalização e salve as alterações. O bloco não é mais exibido na lista de blocos de personalização disponíveis no Adobe Campaign.
Gerenciamento de dados de extensão do target managing-target-extension-data
Você também pode inserir dados de extensão do target para personalização. Os dados de extensão do Target (também chamados "Dados do Target") são provenientes do enriquecimento ou adição de dados em um query em um workflow de campanha, por exemplo. Para obter mais informações, consulte Criação de consultas e Enriquecimento de dados seções.