Skip to content

johnwight/Configure-AEM-with-Launch-and-Analytics

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 

Repository files navigation

Configure-AEM-with-Launch

Connect your Adobe Experience Manager Instance with Launch

The following instructions provide guidance on configuring Adobe Experience Manager (AEM) with Adobe Launch. Although your AEM site may differ from the example site used below, you can use these steps as a guide for setting up your own configuration.

Adobe Launch is the next generation of Dynamic Tag Management. It provides a platform-based approach to building Dynamic Tag Management (DTM) extensions and a streamlined distribution system to quickly deploy client-side DTM libraries. Custom resources can now be created and reused within DTM to simplify the distribution of client side web applications.

These instructions include the following sections:

  1. Setup Adobe Launch

  2. Configure with AEM 6.4

  3. Configure with AEM 6.3

To Setup Adobe Launch:

  1. On www.launch.adobe.com, click New Property.

    create new property

  2. On the Create Property box, provide the details for the new property and click Save.

    create property box details

  3. Click the Extensions tab and install the Analytics extension.

    extensions

  4. Click on Adobe Analytics extension.

  5. Enter your Adobe Analytics Report Suite ID in the corresponding report suites environments, such as Production Report Suites. If you do not have separate environments then please add the same report suite ID for all environments.

  6. If you do not know how to find the Report Suite ID, login via Marketing Cloud in Analytics, click Admin >Report Suites and create a new report suite or copy an ID of an existing report suite that you want to use.

    report suite manager

  7. Click Save after entering the Report Suite ID as shown below.

    report suite id

  8. Make sure you have the following extensions:

    final extensions

  9. Click the Rules tab and click on Create New Rule.

  10. Enter the rule name as Analytics and click the Add button under EVENTS.

    events

  11. Specify the Event Configuration options as shown below and click Keep Changes.

    event config options

  12. Click the Add button in the Actions section and specify the following options to Send Beacon. Click Keep Changes.

    action options

  13. Make sure your final Rule definition appears as shown below. Click Save.

    rule definition

  14. Click the Adapters tab, then click Add Adapter and then create an akamai adapter as shown below.

    akamai adapter

  15. Click the Environments tab, then click Add Environment and create Dev, Stage, and Production environments.

    environments tab

  16. Save the rule and click the Publishing tab. Click Add New Library.

    add new library

  17. Provide a Name for the build, select the Dev (Development) environment, and then click Add All Changed Resources.

    provide build name

  18. Build for development and staging and then approve for production.

    approve

To configure Launch with AEM 6.4:

  1. On the Adobe I/O Console, click New Integration.

  2. Click Access an API and then click Continue.

    access api

  3. Under Experience Cloud, select Launch, by Adobe and then click Continue.

    experience cloud

  4. Select New Integration for fresh setup and click Continue.

    new integration

  5. In the AEM instance in a new window and click Tools > Security > Adobe IMS Configurations.

    ims config

  6. Create a new Adobe IMS Configuration certificate as shown below:

    ims cert

  7. Download the public key certificate by clicking on Download Public Key. This certificate needs to be uploaded in the Adobe I/O console integration.

    download public key

  8. On the I/O Console Integration window, click Select a file and upload the AEM-Adobe-IMS.crt in Public Key Certificates.

    console integration

  9. On the Overview tab, copy the Client ID and Client Secret. Then copy the JWT Payload and Authorization Server info from JWT tab.

    credentials

  10. Return to the AEM IMS Configuration step and provide the copied details from the I/O Console integration. Save the configuration.

    integration details

  11. In your AEM Instance, click Tools > Cloud Services >Adobe Launch Configurations.

    adobe launch configurations

  12. Create a new configuration under the We.Retail website. Select the Associated Adobe IMS Configuration, Company and Property as shown below.

    new config

  13. In your AEM instance, click Sites, then select Card View from upper right corner and click the info properties icon.

    card view 2

  14. On the Advanced tab, select Cloud Configuration.

  15. Select the We.retail path and save & close the configuration.

    save path

  16. Open the We-Retail website. Right click and select Inspect > Sources. You will see that the Launch scripts are firing and events are flowing in the designated report suite.

    scripts fired

AEM 6.3 does not have the official connector for Launch. However, to connect your AEM 6.3 instance with Launch, you can follow work around presented below.

To configure Launch with AEM 6.3:

  1. In your DTM account, create a dummy empty property Adobe_Launch. Please do not customize this property as we are not using it in our integration.

    dummy report

  2. In your AEM instance, click on Tools or the Hammer icon in the left panel.

  3. In Deployment, click Cloud Services.

    cloud services

  4. Locate "Dynamic Tag Management" and click "Configure Now".

    dtm

  5. Provide a Title and Name for the configuration and click Create.

  6. In your Dynamic Tag Management profile, click on the DTM Account and copy the API Token.

    copy token

  7. Paste the API token to AEM > DTM Configuration window and click Connect To DTM.

    paste connection successful

  8. Select the company and the dummy property that you previously created.

    previous dummy

  9. Click the Staging Settings and Production Settings tabs and uncheck the Use Self Hosting.

  10. In Launch > Environments > Staging, copy the header code and replace it in AEM > DTM Configuration Staging Settings Header code section.

    staging

  11. In Launch > Environments > Production, copy the header code and replace it in AEM > DTM Configuration Production Settings Header code section. Click OK.

    production

  12. After the configuring, it should appear as shown below. Nake sure the scripts are from Launch environments.

    verify

  13. In your AEM instance, click Sites, and open the page in Card View from the upper right corner.

    card view 2

  14. Click the Properties icon for the website that you want to connect to Launch.

  15. Click Cloud Services > Add Configuration and Select Dynamic Tag Management.

    select dtm

  16. Select the Launch integration you created in previous steps. Click Save & Close.

    launch integration

  17. Open the We.Retail website. Right click and select Inspect > Sources. You will see that the Launch scripts are firing and events are flowing in the designated report suite.

    script fire 2

Authors

Feedback?

Please help make this solution as useful as possible. If you find a problem in the documentation or have a suggestion, click the Issues tab on this GiHhub repository and then click the New issue button. Provide a title and description for your comment and then click the Submit new issue button.

submit new issue

About

Connect your Adobe Experience Manager Instance with Launch

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published