51ºÚÁϲ»´òìÈ

DocumentationAEM 6.4Administering Guide

Integrating with 51ºÚÁϲ»´òìÈ Campaign Classic integrating-with-adobe-campaign-classic

Last update: Wed May 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our . Find the supported versions here.
NOTE
This documentation describes how to integrate AEM with 51ºÚÁϲ»´òìÈ Campaign Classic, the on-premise solution. If you are using 51ºÚÁϲ»´òìÈ Campaign Standard, see Integrating with 51ºÚÁϲ»´òìÈ Campaign Standard for those instructions.

51ºÚÁϲ»´òìÈ Campaign lets you manage email delivery content and forms directly in 51ºÚÁϲ»´òìÈ Experience Manager.

To use both solutions together at the same time, you must first configure them to connect to one another. This involves configuration steps in both 51ºÚÁϲ»´òìÈ Campaign and 51ºÚÁϲ»´òìÈ Experience Manager. These steps are described in detail in this document.

Working with 51ºÚÁϲ»´òìÈ Campaign in AEM includes the ability to send email via 51ºÚÁϲ»´òìÈ Campaign and is described at Working with 51ºÚÁϲ»´òìÈ Campaign. It also includes using forms on AEM pages to manipulate data.

In addition, the following topics may be of interest when integrating AEM with :

If you are extending your integration with 51ºÚÁϲ»´òìÈ Campaign, you may want to see the following pages:

AEM and 51ºÚÁϲ»´òìÈ Campaign Integration Workflow aem-and-adobe-campaign-integration-workflow

This section describes a typical workflow between AEM and 51ºÚÁϲ»´òìÈ Campaign when creating campaigns and delivering content.

The typical workflow involves the following and is described in detail:

  1. Start building your campaign (both in 51ºÚÁϲ»´òìÈ Campaign and AEM).
  2. Before you link the content and delivery, personalize your content in AEM and create a delivery in 51ºÚÁϲ»´òìÈ Campaign.
  3. Link content and delivery in 51ºÚÁϲ»´òìÈ Campaign.

Start building your campaign start-building-your-campaign

You start building a campaign at any time. Before you link the content, AEM and AC are independent That means marketers can start creating their campaigns and targeting in 51ºÚÁϲ»´òìÈ Campaign, while content creators are working on the design in AEM.

Before linking content and delivery before-linking-content-and-delivery

Before you link the content and create a delivery mechanism, you need to do the following:

In AEM

  • Personalize using the personalization fields in the Text & Personalization component

In 51ºÚÁϲ»´òìÈ Campaign

  • Create a delivery of type aemContent

Linking content and setting delivery linking-content-and-setting-delivery

After you have prepared the content for linking and delivery, you determine exactly how and where to link content.

All these steps are completed in 51ºÚÁϲ»´òìÈ Campaign.

  1. Specify which AEM instance to use.
  2. Synchronize the content by clicking the Synchronize button.
  3. Open the content picker to pick your content.

If you are new to AEM if-you-are-new-to-aem

If you are new to AEM, you may find the following links helpful to understand AEM:

Configuring 51ºÚÁϲ»´òìÈ Campaign configuring-adobe-campaign

Configuring 51ºÚÁϲ»´òìÈ Campaign involves the following:

  1. Installing the AEM integration package in 51ºÚÁϲ»´òìÈ Campaign.
  2. Configuring an external account.
  3. Verifying that the AEMResourceTypeFilter is configured correctly.

In addition, there are advanced configurations that you can make, including :

  • Managing content blocks
  • Managing personalization fields

See Advanced Configurations.

NOTE
To perform these operations, you must have the administration role in 51ºÚÁϲ»´òìÈ Campaign.

Prerequisites prerequisites

Make sure you have the following elements beforehand:

NOTE
If you are running a version earlier than 51ºÚÁϲ»´òìÈ Campaign Classic build 8640, see the for more information. Note that both client and database have to be upgraded to the same build.
CAUTION
Operations detailed in the Configuring 51ºÚÁϲ»´òìÈ Campaign and Configuring 51ºÚÁϲ»´òìÈ Experience Manager sections are necessary for the integration functionalities between AEM and 51ºÚÁϲ»´òìÈ Campaign to work correctly.

Installing the AEM Integration Package installing-the-aem-integration-package

You must install the AEM Integration package in 51ºÚÁϲ»´òìÈ Campaign. To do this:

  1. Go to the 51ºÚÁϲ»´òìÈ Campaign instance that you would like to link with AEM.

  2. Select Tools > Advanced > Import package….

    chlimage_1-132

  3. Click Install a standard package, then select the AEM Integration package.

    chlimage_1-133

  4. Click Next, and then Start.

    This package contains the aemserver operator that will be used to connect the AEM server to 51ºÚÁϲ»´òìÈ Campaign.

    note caution
    CAUTION
    By default, no security zone is configured for this operator. To connect to 51ºÚÁϲ»´òìÈ Campaign via AEM, you must select one.
    In the serverConf.xml file, the allowUserPassword attribute of the selected security zone must be set to true to authorize AEM to connect 51ºÚÁϲ»´òìÈ Campaign via login/password.
    We strongly recommend creating a security zone dedicated to AEM to avoid any security problems. For more on this, refer to the .

    chlimage_1-134

Configuring an AEM external account configuring-an-aem-external-account

You must configure an external account that allows you to connect 51ºÚÁϲ»´òìÈ Campaign to your AEM instance.

NOTE
  • When installing the AEM Integration package, an external AEM account is created. You can configure the connection to your AEM instance from it or create a new one.
  • In AEM, be sure that you set the password for the campaign-remote user. You need to set this password to connect 51ºÚÁϲ»´òìÈ Campaign with AEM. Log in as administrator and in the user administration console, search for the campaign-remote user and click Set Password.

To configure an external AEM account:

  1. Go to the Administration > Platform > External Accounts node.

  2. Create a new external account and select the AEM type.

  3. Enter the access parameters for your AEM authoring instance: the server address as well as the ID and password used to connect to this instance. The campaign-api user account password is the same as the campaign-remote user that you set a password for in AEM.

    note note
    NOTE
    Make sure that the server address does not end in a trailing slash. For example, enter https://yourserver:4502 instead of https://yourserver:4502/

    chlimage_1-135 chlimage_1-136

  4. Make sure that the Enabled checkbox is selected.

Verifying the AEMResourceTypeFilter option verifying-the-aemresourcetypefilter-option

The AEMResourceTypeFilter option is used to filter types of AEM resources that can be used in 51ºÚÁϲ»´òìÈ Campaign. This allows 51ºÚÁϲ»´òìÈ Campaign to retrieve AEM contents that are specifically designed to be used in 51ºÚÁϲ»´òìÈ Campaign only.

This option should come pre-configured; however, if you change this option, it may lead to a non-functioning integration.

To verify the AEMResourceTypeFilter option is configured:

  1. Go to Platform >Options.

  2. In the AEMResourceTypeFilter option, check that the paths are correct. This field must contain the value:

    mcm/campaign/components/newsletter,mcm/campaign/components/campaign_newsletterpage,mcm/neolane/components/newsletter

    Or in some cases, the value is as follows:

    mcm/campaign/components/newsletter

    chlimage_1-137

Configuring 51ºÚÁϲ»´òìÈ Experience Manager configuring-adobe-experience-manager

To configure AEM, you must do the following:

  • Configure replication between instances.
  • Connect AEM to 51ºÚÁϲ»´òìÈ Campaign via Cloud Services.
  • Configure the externalizer.

Configuring replication between AEM instances configuring-replication-between-aem-instances

Content created from the AEM authoring instance is first sent to the publishing instance. You need to publish so that the images in the newsletter are available on the publish instance and to newsletter recipients. The replication agent must therefore be configured to replicate from the AEM authoring instance to the AEM publishing instance.

NOTE
If you do not want to use the replication URL but instead use the public-facing URL, you can set the Public URL in the following configuration setting in the OSGi (AEM logo > Tools icon > Operations > Web Console > OSGi Configuration > AEM Campaign Integration - Configuration):
Public URL: com.day.cq.mcm.campaign.impl.IntegrationConfigImpl#aem.mcm.campaign.publicUrl

This step is also necessary to replicate certain authoring instance configurations into the publishing instance.

To configure replication between AEM instances:

  1. From the authoring instance, select AEM logo> Tools icon > Deployment > Replication > Agents on author, then click Default Agent.

    chlimage_1-138

    note note
    NOTE
    Avoid using localhost (that is a local copy of AEM) when configuring your integration with 51ºÚÁϲ»´òìÈ Campaign unless the publish and author instance are both on the same computer.

  2. Tap or click Edit then select the Transport tab.