Adobe Experience Manager for Pega Marketing
Adobe Experience Manager (AEM) is a content management solution which provides users with an interface to build, deliver, and maintain digital experiences. The Pega AEM Connector allows you to connect your AEM assets to Pega offers and treatments, so that you can apply advanced analytics to existing AEM assets. You can navigate the Adobe Experience Manager folder structure and browse Adobe Experience Manager assets from inside Pega Marketing. The Pega AEM Connector uses the Query Builder API provided by Adobe. For more information about the API, see the Adobe API documentation.
Deploying Adobe Experience Manager
For information about installing and deploying Adobe Experience Manager, see the Adobe Experience Manager documentation.
Connecting Adobe Experience Manager and Pega Marketing
- Download the Pega AEM Connector from Pega Exchange.
- In Dev Studio, click the down arrow by the name of your application, then click Definition to open the Application rule form.
- On the Definition tab, in the Enabled components section, click Manage components.
- Click Install new, select the file that you downloaded from Pega Exchange, and click Open.
- Select the Enabled check box to enable this component for your application, and click OK.
- In the list of enabled components, verify that the Pega AEM Connector is selected, and save your changes to the rule form.
- In Dev Studio, click Records > SysAdmin > Repository.
- Click Create.
- Enter a description and a name for your repository.
- Click Create and open.
- In the Definition tab, click Select.
- Select Adobe Experience Manager as the repository type.
- Optional: By default, Pega Marketing can create and delete files and folders in Adobe Experience Manager. If you want to disable this functionality, select Read-Only.
- In the Repository configuration section, in the Publish host name field, enter the host name of your Adobe Experience Manager repository. Pega Marketing will use this host name to access Adobe Experience Manager.
- Optional: If you want to automatically publish content to Adobe Experience Manager, enter the Author host name of your Adobe Experience Maanger repository in the Author host name field, and select Auto Publish. The Author host name field is only available if you did not set the Adobe Experience Manager repository to Read Only in step 13.
- In the Root path field, enter the name of the folder where Adobe Experience Manager assets are stored. The Pega AEM connector will allow you to browse the assets in this folder from inside Pega Marketing. The Root folder path must not start with the / character.
- In the Authentication section, in the Authentication profile field, enter the name of a new authentication profile and click the Open icon to configure the profile. The authentication profile stores the credentials that Pega Marketing needs to authenticate with the Adobe Experience Manager API.
- In the Type field, select Basic.
- Enter a name and description for your authentication profile.
- Click Create and open.
- Enter the user name, password, realm and host name required to authenticate with Adobe Experience Manager. For more information, refer to the Adobe API documentation.
- Click Save.
- On the Definition tab of your repository, click Test connectivity. If there are any errors, ensure that the credentials in the authentication profile are correct, and that Pega Marketing can access the URLs you entered in the Publish host name and Author host name fields.
- Click Save.
- Click Records > SysAdmin > Dynamic System Settings.
- Edit the following Dynamic System Settings:
- MarketingImageAssets/IsRepositoryStorageEnabled – Set the value to True
- MarketingImageAssets/CustomRepositoryName – Enter the name of the repository you created
- MarketingImageAssets/Folder – Enter a valid sub-folder of the Root folder. If you leave this field blank, the Root folder is used as the destination folder for your images.
- Flush the D_RepositorySettings data page to make sure the configuration changes are applied.
- Click Records > Data Model > Data Page.
- Open the D_RepositorySettings data page.
- On the Load Management tab, click Clear data page.
- Select Flush All.
- Click Submit.
Allowing Pega Marketing to access images from Adobe Experience Manager
Images stored in AEM are treated as images from an unknown source by Pega Marketing. To allow your application to access an image from Adobe Experience Manager, add the Adobe Experience Manager host in the Content security policy.
- In Dev Studio, click the down arrow by the name of your application, then click Overview.
- Click Integration & security.
- In the Content security section, open the content security policy.
- Expand the Image-Source section
- In the Allowed Websites table, click Add a row.
- Enter the URL of your Adobe Experience Manager host.
- Save the content policy.