Criação do Adobe Campaign Forms no AEM creating-adobe-campaign-forms-in-aem
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:
- Disponibilize um modelo.
- Crie um formulário.
- 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.
Criação de um formulário creating-a-form
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 Classic.
-
No AEM, no Sites, navegue até o local em que deseja criar uma página.
-
Crie uma página e selecione Perfil do Adobe Campaign Classic ou Perfil do Adobe Campaign Standard e clique em Próxima.
note note NOTE Se o modelo desejado não estiver disponível, consulte Disponibilidade do modelo. -
No Nome adicione o nome da página. Deve ser um nome válido de JCR.
-
No Título insira um título e clique em Criar.
-
Abra a página e selecione Abrir propriedades e, no Cloud Service, adicione a configuração do Adobe Campaign e selecione a marca de seleção para salvar as alterações.
-
Na página, no campo Início do formulário , selecione o tipo de formulário - Assinar, Cancelar assinatura, ou Salvar perfil. Você só pode ter um tipo por formulário. Agora você pode editar 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.
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.
-
Selecionar Abrir propriedades e, no Cloud Service, adicione a configuração do Adobe Campaign e selecione a marca de seleção para salvar as alterações.
-
Na página, no campo Início do formulário clique no ícone Configuração.
-
Clique em Avançado e selecione o tipo de formulário - Assinar, Cancelar assinatura, ou Salvar perfil e clique em OK. Você só pode ter um tipo por formulário.
- 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.
-
Você deve ter um Chave primária criptografada em cada formulário. Esse componente define qual parâmetro de URL é usado para aceitar a chave primária criptografada de um perfil do Adobe Campaign. Em Componentes, selecione Adobe Campaign para que somente os componentes fiquem visíveis.
-
Arraste o componente Chave primária criptografada ao formulário (em qualquer lugar) e clique no link Configuração ícone. No Adobe Campaign especifique qualquer nome para o parâmetro de URL. Clique na marca de seleção para salvar as alterações.
Os links gerados para este formulário precisam usar este parâmetro de URL e atribuir a ele a chave primária criptografada de um perfil do Adobe Campaign. A chave primária criptografada deve ser corretamente codificada no URL (porcentagem).
-
Adicione componentes ao formulário conforme necessário, como um campo de Texto, campo de Data, campo Caixa de seleção, campo de Opção e assim por diante. Consulte Componentes de formulário do Adobe Campaign para obter mais informações sobre cada componente.
-
Clique no ícone Configuração para abrir o componente. Por exemplo, em Campo de texto (Campanha) componente, altere o título e o texto.
Clique em Adobe Campaign para mapear o campo de formulário para uma variável de metadados Adobe Campaign. Ao enviar o formulário, o campo mapeado é atualizado no Adobe Campaign. Somente os campos com tipos correspondentes estão disponíveis no seletor de variáveis (por exemplo, variáveis de sequência para campos de texto).
note note NOTE Você pode adicionar/remover campos exibidos na tabela de recipients seguindo as instruções aqui: https://blogs.adobe.com/experiencedelivers/experience-management/aem-campaign-integration/ -
Clique em Publicar página. A página é ativada no site. Você pode visualizá-lo acessando a instância de publicação do AEM. Também é possível testar um formulário.
note caution CAUTION Você precisa fornecer permissões de leitura ao usuário anônimo no Cloud Service para usar formulários na publicação. No entanto, esteja ciente dos possíveis problemas de segurança no fornecimento de permissões de leitura ao usuário anônimo e certifique-se de atenuá-los, por exemplo, configurando o dispatcher.
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.
Para fazer isso, é necessário obter manualmente o EPK de um perfil do Adobe Campaign e anexá-lo ao URL:
-
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 Classic, 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.
-
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=...) -
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.