DocumentaçãoAEM 6.5Guia do usuário

Criação do Adobe Campaign Forms no AEM creating-adobe-campaign-forms-in-aem

Last update: Wed Apr 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • User

O AEM permite criar e usar formulários que interagem com o Adobe Campaign em seu site. Campos específicos podem ser inseridos em seus formulários e mapeados para o banco de dados do Adobe Campaign.

É possível gerenciar novas assinaturas de contatos, assinaturas canceladas e dados de perfil do usuário, tudo isso enquanto integra os dados dessas assinaturas ao banco de dados do Adobe Campaign.

Para usar os formulários do Adobe Campaign no AEM, é necessário seguir estas etapas, descritas neste documento:

  1. Disponibilize um modelo.
  2. Crie um formulário.
  3. Editar conteúdo do formulário.

Três tipos de formulários, específicos para o Adobe Campaign, estão disponíveis por padrão:

  • Salvar um perfil
  • Assinar um serviço
  • Cancelar assinatura de um serviço

Esses formulários definem um parâmetro de URL que aceita a chave primária criptografada de um perfil do Adobe Campaign. Com base nesse parâmetro de URL, o formulário atualiza os dados do perfil do Adobe Campaign associado.

Embora esses formulários sejam criados de maneira independente, em um caso de uso típico, você gera um link personalizado para uma página de formulário dentro do conteúdo do boletim informativo, para que os destinatários possam abrir o link e fazer ajustes nos dados de perfil (seja para cancelar a assinatura, assinar ou atualizar o perfil).

O formulário é atualizado automaticamente com base no usuário. Consulte Editar conteúdo do formulário para obter mais informações.

Disponibilizar um modelo making-a-template-available

Antes de criar formulários específicos para o Adobe Campaign, você deve disponibilizar os diferentes modelos no aplicativo AEM.

Para fazer isso, consulte a Documentação de modelos.

Primeiro, verifique se a conexão entre as instâncias de autor e publicação e o Adobe Campaign está funcionando. Consulte Integração com o Adobe Campaign Standard ou Integração com o Adobe Campaign 6.1.

NOTE
Verifique se acMapping na página do jcr:content o nó está definido como mapRecipient ou perfil ao usar o Adobe Campaign 6.1.x ou Adobe Campaign Standard, respectivamente

Criação de um formulário creating-a-form

  1. Inicie no siteadmin.

  2. Percorra a estrutura de árvore para chegar ao local em que deseja criar o formulário no site escolhido.

  3. Selecionar Novo > Nova página….

  4. Selecione Perfil do Adobe Campaign (AC 6.1) ou Perfil do Adobe Campaign (ACS) e insira as propriedades da página.

    note note
    NOTE
    Se o template não estiver disponível, consulte o Disponibilização de um template seção.

  5. Clique em Criar para criar o formulário.

    chlimage_1-187

    Você pode então editar e configurar o conteúdo do formulário.

Editar conteúdo do formulário editing-form-content

O Forms dedicado ao Adobe Campaign tem componentes específicos. Esses componentes têm uma opção para permitir vincular cada campo do formulário a um campo no banco de dados do Adobe Campaign.

NOTE
Se o modelo desejado não estiver disponível, consulte Disponibilização de um template.

Esta seção só detalha links específicos para o Adobe Campaign. Para obter mais informações sobre uma visão geral de como usar formulários no Adobe Experience Manager, consulte Componentes do modo de edição.

  1. Navegue até o formulário que deseja editar.

  2. Na caixa de ferramentas, selecione Página > Página Propriedades… em seguida, acesse o Cloud Service da janela pop-up.

  3. Adicione o serviço Adobe Campaign clicando em Adicionar serviço e, em seguida, selecionando a configuração que corresponde à sua instância do Adobe Campaign na lista suspensa do serviço. Essa configuração é realizada ao configurar a conexão entre suas instâncias. Para obter mais informações, consulte Conectar o AEM ao Adobe Campaign.

    note note
    NOTE
    Se necessário, desbloqueie a configuração clicando no ícone de cadeado para poder adicionar o serviço Adobe Campaign.

  4. Acesse os parâmetros gerais do formulário usando o Editar botão encontrado no início do formulário. A variável Formulário permite selecionar uma página de agradecimento para a qual o usuário será redirecionado após validar o formulário.

    A variável Avançado form permite selecionar o tipo de formulário. A variável Opções de publicação fornece a escolha entre três tipos de formulários do Adobe Campaign:

    • Adobe Campaign: salvar perfil: permite criar ou atualizar um recipient no Adobe Campaign (valor padrão).
    • Adobe Campaign: assinar os serviços: permite gerenciar as assinaturas de um recipient no Adobe Campaign.
    • Adobe Campaign: cancelar a assinatura dos serviços: permite cancelar as subscrições de um recipient no Adobe Campaign.

    A variável Configuração de ação permite especificar se você deseja ou não criar o perfil do recipient no banco de dados do Adobe Campaign se ele ainda não existir. Para fazer isso, marque a opção Criar usuário se não existir opção.

  5. Adicione os componentes selecionados arrastando-os da caixa de ferramentas e soltando-os no formulário. Para obter mais informações sobre os componentes específicos disponíveis do Adobe Campaign, consulte Componentes de forma do Adobe.

    chlimage_1-188

  6. Configure os campos adicionados clicando duas vezes neles. A variável Adobe Campaign permite vincular o campo a um campo na tabela de recipients do Adobe Campaign. Você também pode especificar se o campo faz parte da chave de reconciliação, que permite que os recipients que já estão presentes no banco de dados do Adobe Campaign sejam reconhecidos.

    note caution
    CAUTION
    A variável Nome do elemento deve ser diferente para cada campo de formulário. Altere-o se necessário.
    Cada formulário deve conter um Chave primária criptografada para gerenciar corretamente os recipients no banco de dados do Adobe Campaign.

  7. Ativar a página selecionando Página > Ativar página na caixa de ferramentas. A página é ativada no site. Você pode visualizá-lo acessando a instância de publicação do AEM. Os dados no banco de dados do Adobe Campaign são atualizados assim que um formulário é validado.

Testando um formulário testing-a-form

Depois de criar um formulário e editar o conteúdo do formulário, você pode testar manualmente se o formulário está funcionando como esperado.

NOTE
Você deve ter um Chave primária criptografada em cada formulário. Em Componentes, selecione Adobe Campaign para que somente os componentes fiquem visíveis.
Embora neste procedimento você insira o número epk manualmente, na prática, os usuários obteriam um link para esta página (se cancelariam a inscrição, assinariam ou atualizariam seu perfil) em um boletim informativo. Com base no usuário, o epk é atualizado automaticamente.
Para criar esse link, use a variável Identificador de recurso principal(Adobe Campaign Standard) ou Identificador criptografado (Adobe Campaign 6.1) (por exemplo, em uma Texto e personalização (Campanha) componente), que vincula ao epk no Adobe Campaign.

Para fazer isso, é necessário obter manualmente o EPK de um perfil do Adobe Campaign e anexá-lo ao URL:

  1. Para obter a chave primária criptografada (EPK) de um perfil do Adobe Campaign:

    • No Adobe Campaign Standard - Navegue até Perfis e públicos-alvo > Perfis, que lista os perfis existentes. Verifique se a tabela exibe o Identificador de recurso principal em uma coluna (pode ser configurado clicando/tocando em Configurar lista). Copie o identificador de recurso principal do perfil desejado.
    • No Adobe Campaign 6.11, acesse Perfis e públicos alvo > Destinatários, que lista os perfis existentes. Verifique se a tabela exibe o Identificador criptografado em uma coluna (Isso pode ser configurado clicando com o botão direito do mouse em uma entrada e selecionando Configurar lista…). Copie o identificador criptografado do perfil desejado.

  2. No AEM, abra a página de formulário na instância de publicação e anexe o EPK da etapa 1 como um parâmetro de URL: use o mesmo nome definido anteriormente no componente EPK ao criar o formulário (por exemplo: ?epk=...)

  3. O formulário agora pode ser usado para modificar os dados e as assinaturas associados ao perfil vinculado do Adobe Campaign. Depois de modificar alguns campos e enviar o formulário, você pode verificar no Adobe Campaign se os dados apropriados foram atualizados.

Os dados no banco de dados do Adobe Campaign são atualizados assim que um formulário é validado.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2