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 Editando o 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 sobre 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 Avançar.
note note NOTE Se o modelo desejado não estiver disponível, consulte Disponibilidade de Modelo. -
No campo Nome, adicione o nome da página. Deve ser um nome válido de JCR.
-
No campo Título, insira um título e clique em Criar.
-
Abra a página e selecione Abrir propriedades e, em Cloud Service, adicione a configuração do Adobe Campaign e marque a marca de seleção para salvar as alterações.
-
Na página, no componente Início do Formulário, selecione o tipo de formulário que é - 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.
-
Selecione Abrir propriedades e, no Cloud Service, adicione a configuração do Adobe Campaign e marque a marca de seleção para salvar as alterações.
-
Na página, no componente Início do formulário, clique no ícone Configuração.
-
Clique na guia Avançado e selecione o tipo de formulário que é - Assinar, Cancelar Inscrição ou Salvar Perfil e clique em OK. Só é possível ter um tipo por formulário.
- Adobe Campaign: Salvar perfil: permite criar ou atualizar um destinatário no Adobe Campaign (valor padrão).
- Adobe Campaign: Assinar Serviços: permite gerenciar as assinaturas de um destinatário no Adobe Campaign.
- Adobe Campaign: cancelar a assinatura dos serviços: permite cancelar as assinaturas de um destinatário no Adobe Campaign.
-
Você deve ter um componente de 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 para o formulário (em qualquer lugar) e clique no ícone Configuração. Na guia 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ários do Adobe Campaign para obter mais informações sobre cada componente.
-
Clique no ícone Configuração para abrir o componente. Por exemplo, no componente Campo de texto (Campanha), altere o título e o texto.
Clique em Adobe Campaign para mapear o campo de formulário para uma variável de metadados do 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 destinatários seguindo as instruções aqui: https://blogs.adobe.com/experiencedelivers/experience-management/aem-campaign-integration/ -
Clique em Página do Publish. A página é ativada no site. Você pode visualizá-lo acessando a instância de publicação do AEM. Você também pode 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 campo Identificador de Recurso Principal em uma coluna (Isso pode ser configurado ao clicar/tocar em Configurar lista). Copie o identificador de recurso principal do perfil desejado.
- No Adobe Campaign Classic, vá para Profiles and Targets > Recipients, que lista os perfis existentes. Verifique se a tabela exibe o campo Identificador criptografado em uma coluna (isso pode ser configurado ao clicar com o botão direito do mouse em uma entrada e selecionar 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.