Ви переглядаєте довідкову інформацію для версії:

AEM lets you create and use forms that interact with Adobe Campaign on your website. Specific fields can be inserted into your forms and mapped to the Adobe Campaign database.

You can manage new contact subscriptions, unsubscriptions, and user profile data, all while integrating their data into your Adobe Campaign database.

To use Adobe Campaign forms in AEM, you need to follow these steps, described in this document:

  1. Make a template available.
  2. Create a form.
  3. Edit form content.

Three types of forms, specific to Adobe Campaign, are available by default:

  • Save a profile
  • Subscribe to a service
  • Unsubscribe from a service

These forms define a URL parameter that accepts the encrypted primary key of an Adobe Campaign profile. Based on this URL parameter, the form updates the data of the associated Adobe Campaign profile.

Although you create these forms independently, in a typical use case, you generate a personalized link to a form page inside the newsletter content, so that recipients can open the link and make adjustments to their profile data (whether unsubscribing, subscribing, or updating their profile).

The form automatically updates based on the user. See Editing Form Content for more information.

Making a Template Available

Before being able to create forms that are specific to Adobe Campaign, you must make the different templates available in your AEM application.

To do this, see the Templates documentation.

Creating a Form

First of all, check the connection between the author and publish instances and Adobe Campaign is working. See Integrating with Adobe Campaign Standard or Integrating with Adobe Campaign 6.1.

You can create forms in both the classic and touch-optimized UI. 

Примітка.

Make sure the acMapping property on the page's jcr:content node is set to mapRecipient or profile when using Adobe Campaign 6.1.x or Adobe Campaign Standard, respectively

 

Creating a Form in the Touch-optimized User Interface

To create a form in the touch-optimized UI:

  1. In AEM, in Sites, navigate to where you want to create a new page.

  2. Create a page and select Adobe Campaign Profile (AC 6.1) or Adobe Campaign Profile (ACS) and click Next.

    chlImage_1

    Примітка.

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

  3. In the Name field, add the name of the page. It must be a valid JCR name.

  4. In the Title field, enter a title and click Create.

  5. Open the page and select Open Properties and in Cloud Services add the Adobe Campaign configuration and select the checkmark to save your changes.

    chlImage_1
  6. On the page, in the Form Start component, select the type of form it is - Subscribe, Unsubscribe, or Save Profile. You can only have one type per form. You can now edit the form's content

Creating a Form in the Classic User Interface

To create a form in the classic UI:

  1. In Adobe Experience Manager, in Sites, if necessary, switch to Classic UI mode..

    chlImage_1
  2. Scroll through the tree structure to get to the place you would like to create the form in your chosen website.

  3. Select New > New page....

  4. Select either Adobe Campaign Profile (AC 6.1) or Adobe Campaign Profile (ACS) template and enter the page properties.

    Примітка.

    If the template is not available, refer to the Making a template available section.

  5. Click Create to create the form.

    chlImage_1

Editing Form Content

Forms dedicated to Adobe Campaign have specific components. These components have an option to allow you to link each field of the form to a field in the Adobe Campaign database.

Примітка.

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

This section only details specific links to Adobe Campaign. For more information on a more general overview of how to use forms in Adobe Experience Manager, see Editmode components.

Editing Form Content in the Touch-optimized UI

To edit form content in the touch-optimized UI:

  1. Select Open Properties and in Cloud Services add the Adobe Campaign configuration and select the checkmark to save your changes.

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

    chlImage_1
  3. Click the Advanced tab and select the type of form it is - Subscribe, Unsubscribe, or Save Profile and click OK. You can only have one type per form.

    • Adobe Campaign: Save profile: lets you create or update a recipient in Adobe Campaign (default value).
    • Adobe Campaign: Subscribe to Services: lets you manage the subscriptions of a recipient in Adobe Campaign.
    • Adobe Campaign: Unsubscribe from Services: lets you cancel the subscriptions of a recipient in Adobe Campaign.
  4. You must have an Encrypted Primary Key component on each form. This component defines which URL parameter will be used to accept the encrypted primary key of an Adobe Campaign profile. In Components, select Adobe Campaign so only those componente are visible. 

  5. Drag the component Encrypted Primary Key to the form (anywhere) and click or tap the Configuration icon. In the Adobe Campaign tab, specify any name for the URL parameter. Click or tap the check mark to save your changes.

    Generated links to this form need to use this URL parameter and assign it the encrypted primary key of an Adobe Campaign profile. The encrypted primary key must be properly URL (percent) encoded.

    chlImage_1
  6. Add components to the form as needed, such as a Text field, Date field, Checkbox field, Option field, and so on. See Adobe Campaign Form Components for more information on each component.

  7. Click the Configuration icon to open the component. For example, in Text Field (Campaign) component, change the title and text.

    Click Adobe Campaign to map the form field to an Adobe Campaign metadata variable. When you submit the form, the mapped field is updated in Adobe Campaign. Only fields with matching types are available in the variable picker (for example, string variables for text fields).

    chlImage_1

    Примітка.

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

  8. Click Publish Page. The page is activated on your site. You can view it by going to your AEM publication instance. You can also test a form.

    Увага!

    You need to provide read permisssions to the anonymous user on the cloud service to use forms on publish. However, be aware of the potential security issues with providing read permissions to the anonymous user and be sure to mitigate it by, for example, configuring the dispatcher.

Editing Form Content in the Classic UI

To edit form content in the classic UI:

  1. Navigate to the form you want to edit.

  2. In the toolbox, select Page > Page Properties... then go to the Cloud Services tab of the pop-up window.

  3. Add the Adobe Campaign service by clicking Add service, and then selecting the configuration that corresponds to your Adobe Campaign instance in the service's drop down list. This configuration is carried out when setting up the connection between your instances. For more information, see Connecting AEM to Adobe Campaign.

    Примітка.

    If necessary, unlock the configuration by clicking the padlock icon to be able to add the Adobe Campaign service.

    chlImage_1
  4. Access the form's general parameters using the Edit button found at the start of the form. The Form tab allows you to select a thank you page to which the user will be redirected after having validated the form.

    The Advanced form allows you to select the type of form. The Post Options field gives you the choice between three types of Adobe Campaign forms:

    • Adobe Campaign: Save profile: lets you create or update a recipient in Adobe Campaign (default value).
    • Adobe Campaign: Subscribe to Services: lets you manage the subscriptions of a recipient in Adobe Campaign.
    • Adobe Campaign: Unsubscribe from Services: lets you cancel the subscriptions of a recipient in Adobe Campaign.

    The Action Configuration field lets you specify whether or not you would like to create the recipient profile in the Adobe Campaign database if it does not yet exist. To do this, check the Create user if not existing option.

  5. Add your selected components by dragging them from the toolbox and dropping them into the form. For more information on the available Adobe Campaign specific components, see Adobe Form Components.

    chlImage_1
  6. Configure the added fields by double clicking them. The Adobe Campaign tab lets you link the field to a field in the Adobe Campaign recipient table. You can also specify whether the field is part of the reconciliation key which allows recipients that are already present in the Adobe Campaign database to be recognized.

    Увага!

    The Element Name must be different for each form field. Change it if necessary.

    Each form must contain an Encrypted Primary Key component in order to correctly manage recipients in the Adobe Campaign database.

  7. Activate the page by selecting Page > Activate Page in the toolbox. The page is activated on your site. You can view it by going to your AEM publication instance. The data in the Adobe Campaign database is updated once a form is validated.

Testing a Form

After you create a form and edit form content, you may want to manually test that the form is working as expected.

Примітка.

You must have an Encryted Primary Key component on each form. In Components, select Adobe Campaign so only those componente are visible. 

Although in this procedure you enter the epk number manually, in practice, users would get a link to this page (whether to unsubscribe, subscribe, or update your profile) within a newsletter. Based on the user, the epk automatically updates.

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

To do this, you need to manually get the EPK of an Adobe Campaign profile and then append it to the URL:

  1. To get the encrypted primarly key (EPK) of an Adobe Campaign profile:

    • 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). Copy the main resource identifier of the desired profile.
    • In Adobe Campaign 6.11, 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...). Copy the encrypted identifier of the desired profile.
  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. The form can now be used to modify the data and subscriptions associated to the linked Adobe Campaign profile. After you modify some fields and submit the form, you can verify inside Adobe Campaign that the appropriate data has been updated.

The data in the Adobe Campaign database is updated once a form is validated.

Цей документ захищено ліцензією Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Публікації Twitter™ і Facebook не підпадають під умови ліцензії Creative Commons.

Юридична інформація   |   Політика мережевої конфіденційності