Criação de formulários do Adobe Campaign no AEM

O AEM permite que você crie e use formulários que interajam com o Adobe Campaign no seu site. Campos específicos podem ser inseridos nos seus formulários e mapeados para o banco de dados do Adobe Campaign.

Você pode gerenciar novas assinaturas de contato, cancelamentos de assinatura e dados de perfis de usuário e, ao mesmo tempo, integrar todos esses dados ao seu banco de dados do Adobe Campaign.

Para usar formulários do Adobe Campaign no AEM, você precisa seguir as etapas descritas neste documento:

  1. Disponibilizar um modelo.
  2. Criar um formulário.
  3. Editar o 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 a 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 independentemente, em um caso de uso típico, você gera um link personalizado para uma página de formulário dentro do conteúdo do informativo, para que os destinatários possam abri-lo e fazer ajustes nos dados do perfil (seja cancelando a assinatura, assinando ou atualizando o perfil).

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

Disponibilizar um modelo

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

To do this, see the Templates documentation.

Criação de um formulário

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

Observação

Verifique se a propriedade acMapping no nó jcr:content da página está definida como mapRecipient ou profile ao usar o Adobe Campaign Classic ou o Adobe Campaign Standard, respectivamente

  1. No AEM, em Sites, navegue até onde você deseja criar uma nova página.

  2. Create a page and select Adobe Campaign Classic Profile or Adobe Campaign Standard Profile and click Next.

    chlimage_1-43

    Observação

    If the desired template is not available, see Template Availability.

  3. No campo Nome, adicione o nome da página. Ele deve ser um nome JCR válido.

  4. No campo Título, insira um título e clique em Criar.

  5. Abra a página e selecione Abrir propriedades e, em Serviços em nuvem, adicione a configuração do Adobe Campaign e selecione a marca de seleção para salvar as alterações.

    chlimage_1-44

  6. Na página, no componente Início do formulário, selecione o tipo de formulário - Assinar, Cancelar assinatura ou Salvar perfil. É possível ter apenas um tipo por formulário. Agora, você pode editar o conteúdo do formulário.

Edição do conteúdo do formulário

Formulários dedicados ao Adobe Campaign têm componentes específicos. Esses componentes têm uma opção para permitir que você vincule cada campo do formulário a um campo no banco de dados do Adobe Campaign.

Observação

If the desired template is not available, see Making a template available.

Esta seção apenas detalha links específicos para o Adobe Campaign. For more information on a more general overview of how to use forms in Adobe Experience Manager, see Editmode components.

  1. Selecione Abrir propriedades e, em Serviços em nuvem, adicione a configuração do Adobe Campaign e selecione a marca de seleção para salvar suas alterações.

    chlimage_1-45

  2. On the page, in the Form Start component, click the Configuration icon.

    chlimage_1-46

  3. Click the Advanced tab and select the type of form it is - Subscribe, Unsubscribe, or Save Profile and click OK. É possível ter apenas um tipo por formulário.

    • Adobe Campaign: salvar perfil: permite criar ou atualizar um destinatário no Adobe Campaign (valor padrão).
    • Adobe Campaign: inscrever-se para os 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.
  4. Você deve ter um componente Chave primária criptografada em cada formulário. Esse componente define qual parâmetro de URL será usado para aceitar a chave primária criptografada de um perfil do Adobe Campaign. Em Componentes, selecione Adobe Campaign para que apenas esses componentes fiquem visíveis.

  5. Drag the component Encrypted Primary Key to the form (anywhere) and click or tap the Configuration icon. Na guia Adobe Campaign, especifique qualquer nome para o parâmetro de URL. Clique ou toque na marca de seleção para salvar as alterações.

    Os links gerados para esse formulário precisam usar esse 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 por URL (porcentagem).

    chlimage_1-47

  6. Adicione componentes ao formulário conforme necessário, como um campo de Texto, um campo de Data, um campo de Caixa de seleção, um campo de Opção e assim por diante. Consulte Componentes de formulário do Adobe Campaign para obter mais informações sobre cada componente.

  7. Clique no ícone Configuração para abrir o componente. For example, in Text Field (Campaign) component, change the title and text.

    Clique em Adobe Campaign para mapear o campo de formulário para uma variável de metadados do Adobe Campaign. Quando você envia o formulário, o campo mapeado é atualizado no Adobe Campaign. Somente campos com tipos correspondentes estão disponíveis no seletor de variáveis (por exemplo, variáveis de sequência de caracteres para campos de texto).

    chlimage_1-48

    Observação

    You can add/remove fields that are displayed in the recipient table by following the instructions here: https://blogs.adobe.com/experiencedelivers/experience-management/aem-campaign-integration/

  8. Clique em Publicar página. A página está ativada no seu site. Você pode visualizá-la acessando a instância de publicação do AEM. Você também pode testar um formulário.

    CUIDADO

    É necessário fornecer permissões de leitura ao usuário anônimo no serviço de nuvem para usar formulários na publicação. No entanto, lembre-se dos possíveis problemas de segurança ao fornecer permissões de leitura ao usuário anônimo e certifique-se de atenuá-lo, por exemplo, configurando o Dispatcher.

Teste de um formulário

Depois de criar um formulário e editar seu conteúdo, convém testar manualmente se ele está funcionando conforme esperado.

Observação

You must have an Encryted Primary Key component on each form. Em Componentes, selecione Adobe Campaign para que apenas esses componentes fiquem visíveis.

Neste procedimento, embora você insira o número da EPK manualmente, na prática os usuários receberiam um link para essa página (para cancelar a assinatura, assinar ou atualizar seu perfil) em um informativo. Com base no usuário, a EPK é atualizada automaticamente.

To create that link, you use the variable Main resource identifier(Adobe Campaign Standard) or Encrypted identifier (Adobe Campaign Classic) (for example, in a Text & Personalization (Campaign) component), which links to the epk in Adobe Campaign.

Para fazer isso, você precisa obter manualmente a EPK de um perfil do Adobe Campaign e, em seguida, anexá-la ao URL:

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

    • In Adobe Campaign Standard - Navigate to Profiles and Audiences > Profiles, which lists the existing profiles. Make sure the table displays the Main Resource Identifier field in a column (This can be configured by clicking/tapping Configure list). Copie o identificador de recursos principal do perfil desejado.
    • In Adobe Campaign Classic, go to Profiles and Targets > Recipients, which lists the existing profiles. Make sure the table displays the Encrypted identifier field in a column (This can be configured by right-clicking on an entry and selecting Configure list…). Copie o identificador criptografado do perfil desejado.
  2. In AEM, open the form page on the publish instance and append the EPK from step 1 as a URL parameter: use the same name that you previously defined in the EPK component when authoring the form (for example: ?epk=...)

  3. O formulário agora pode ser usado para modificar os dados e as assinaturas associadas 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.

Nesta página