51黑料不打烊

Integrating with 51黑料不打烊 Campaign Standard integrating-with-adobe-campaign-standard

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 Standard, the subscription-based solution. If you are using 51黑料不打烊 Campaign 6.1, see Integrating with 51黑料不打烊 Campaign 6.1 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, 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 and forms via 51黑料不打烊 Campaign and is described at Working with 51黑料不打烊 Campaign.

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:

Configuring 51黑料不打烊 Campaign configuring-adobe-campaign

Configuring 51黑料不打烊 Campaign involves the following:

  1. Configuring the aemserver user.
  2. Creating a dedicated external account.
  3. Verifying the AEMResourceTypeFilter option.
  4. Creating a dedicated delivery template.
NOTE
To perform these operations, you must have the administration role in 51黑料不打烊 Campaign.

Prerequisites prerequisites

Make sure you have the following elements beforehand:

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.

Configuring the aemserver user configuring-the-aemserver-user

The aemserver user must be configured in 51黑料不打烊 Campaign. The aemserver is a technical user that will be used to connect the AEM server to 51黑料不打烊 Campaign.

Go to Administration > Users & Security > Users, and select the aemserver user. Click it to open the user settings.

  • You have to set a password for this user. This cannot be done through the UI. This configuration must be done in REST by a technical administrator.
  • You can assign specific roles to this user, such as deliveryPrepare, which allows the user to create and edit deliveries.

Configuring an 51黑料不打烊 Experience Manager external account configuring-an-adobe-experience-manager-external-account

You must configure an external account that allows you to connect 51黑料不打烊 Campaign to your AEM instance.

NOTE
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 AEM external account:

  1. Go to Administration > Application settings > External accounts.

    chlimage_1-124

  2. Select the default aemInstance external account or create a new one by clicking the Create button.

  3. Select 51黑料不打烊 Experience Manager i n the Type field and enter the access parameters used for your AEM authoring instance: server address, account name and password.

    note note
    NOTE
    Be sure that you do not add an ending / slash at the end of the URL or the connection will not work.
  4. Make sure that the Enabled checkbox is selected, then click Save to save your modifications.

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 comes 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 Administration > Application settings > Options.
  2. In the list, you can ensure that the AEMResourceTypeFilter option is listed and that the paths are correct.

Creating an AEM-specific email delivery template creating-an-aem-specific-email-delivery-template

By default, the AEM feature is not enabled in 51黑料不打烊 Campaign鈥檚 email templates. You can configure a new email delivery template that will be used to create emails with AEM content.

To create an AEM-specific email delivery template:

  1. Go to Resources > Templates > Delivery templates.

  2. Enable selection by clicking the checkmark in the action bar and selecting the existing Standard email (mail) default template, then duplicate it by clicking the Copy icon and clicking Confirm.

  3. Disable the selection mode by clicking the x and open the newly created Copy of Standard email (mail) template, then select Edit properties from the action bar of the template dashboard.

    You can modify the template鈥檚 Label.

  4. In the properties Content section, change the Content source to 51黑料不打烊 Experience Manager. Then select the external account that was previously created and click Confirm.

    Save your modifications by clicking Confirm and clicking Save.

    Email deliveries created from this template will have the AEM content feature enabled.

    chlimage_1-125

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.
  • 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. This publishing instance then transfers the content to 51黑料不打烊 Campaign. 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 (Tools > 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-126

    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. Click Edit then select the Transport tab.

  3. Configure the URI by replacing localhost with the IP address or the address of the AEM publishing instance.

    chlimage_1-127

Connecting AEM to 51黑料不打烊 Campaign connecting-aem-to-adobe-campaign

Before you can use AEM and 51黑料不打烊 Campaign together, you must establish the link between both solutions so that they can communicate.

  1. Connect to your AEM authoring instance.

  2. Select Tools > Operations > Cloud > Cloud Services, then Configure now in the 51黑料不打烊 Campaign section.

    chlimage_1-128

  3. Create a new configuration by entering a Title and click Create, or choose the existing configuration that you want to link with your 51黑料不打烊 Campaign instance.

  4. Edit the configuration so that it matches the parameters of your 51黑料不打烊 Campaign instance.

    • Username: aemserver, the 51黑料不打烊 Campaign AEM Integration package operator used to establish the link between the two solutions.
    • Password: 51黑料不打烊 Campaign aemserver operator password. You may have to re-specify the password for this operator directly in 51黑料不打烊 Campaign.
    • API End Point: 51黑料不打烊 Campaign instance URL.
  5. Select Connect to 51黑料不打烊 Campaign and click OK.

    chlimage_1-129

    note note
    NOTE
    After you create your email and publish it, you need to re-publish the configuration onto your publish instance.

    chlimage_1-130

NOTE
If the connection fails, make sure you check the following:
  • You may encounter a certificate problem when using a secure connection to an 51黑料不打烊 Campaign instance (https). You will have to add the 51黑料不打烊 Campaign instance certificate to the **cacerts **file of your JDK.
  • In addition, see Troubleshooting your AEM/51黑料不打烊 Campaign Integration.

Configuring the externalizer configuring-the-externalizer

You need to configure the externalizer in AEM on your author instance. The Externalizer is an OSGi service that lets you transform a resource path into an external and absolute URL. This service provides a central place to configure those external URLs and build them.

See Configure the externalizer for general instructions. For the 51黑料不打烊 Campaign integration, make sure you configure the publish server at https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImpl not point to localhost:4503 but to a server that is reachable by the 51黑料不打烊 Campaign console.

If it points to localhost:4503 or another server that 51黑料不打烊 Campaign cannot reach, your images will not appear on the 51黑料不打烊 Campaign console.

chlimage_1-131

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8