This technical implementation guide provides information about the reference architecture, ​guidelines, configuration steps and tests that implementation specialists need to follow while integrating Audience Manager with Campaign.

This technical integration guide is intended for Adobe Consultants, Adobe Partners, and other experienced implementation specialists. Configuring this integration requires a full understanding of the implementation process for each individual solution covered in this guide.

Adobe customers can contact Adobe Professional Services or an Adobe Partner to learn more about this integration.

Integration Overview

The integration makes use of marketing cloud shared audiences and the declared ID functionality within AAM.

Solution Planning And Integration Architecture

Pre-requisites (License, Connectivity, Initialization)

  1. Marketing Cloud Org provisioned for the customer
  2. Adobe Analytics License
  3. Adobe Campaign V6 to be upgraded to 8687 or higher(8705 or higher recommended)
  4. Adobe Audience Manager License
  5. Adobe DTM
  6. Adobe Marketing Cloud shared audiences
  7. Customer CRM data to be pushed to Adobe Campaign
  8. Adobe Campaignv6 has to be connected with the Marketing-Cloud
  9. Configure campaign users in the marketing cloud
  10. Users should be able to login to Campaign V6 via Adobe ID

Implementation Architecture

1

Installation, Provisioning and Configuration

​Set-up/ Provisioning

  1. Any additional solutions core services provisioning should be done through your Adobe representative.
  2. Campaign Provisioning needs to be done by Campaign TechOps.
  3. Datasources, destinations in AAM UI and AAM sFTP should be created/provisoned through your Adobe representative.

Solution Implementation

  1. Customer CRM
    Customer needs to have a system that stores all the CRM data. This has to be a list of e-mail addresses, combined with a unique hashed ID of this customer. For example:
    abc@abcmail.com, 1231231j2g3123
    xyz@xyzmail.com, 234234jh23k4jh324
    Where the first column is the e-mail address and the second column the hashed CRM_ID

  2. Sync CRM database with Campaign
    Customer needs to set up a process where they push their CRM data to Campaign. The e-mail, CRM_ID are the minimum fields to be synced.

  3. Make the CRM_ID available on the page
    This requires the customer to have logged in. Upon login, the CMS has to reach out to customer CRM to verify that the password is correct. At this level, also the unique CRM_ID has to be captured and send to the page, preferably to a datalayer.

  4. DTM reads the CRM_ID
    Configuration is in “marketing cloud ID service” tool. The hashed_email data element is configured in DTM reading the CRM_ID available in the dataLayer.

    2
  5. Configure AAM sFTP in Adobe Campaign

    The sFTP created for AAM needs to be configured with Adobe Campaign so that Campaign can push and pull segments from AAM. The sFTP credentials will be provided to you by Adobe Customer Care or your Adobe representative. During provisioned both ftp-in and ftp-out locations are provisioned which are used by campaign to send audiences to AAM and onboard segments from AAM to campaign respectively.

    3
    3b
  6. Create the Datasources and Destinations with AAM

    The Datasources and destinations for the integrations should be created in the AAM UI if not created already. If this has been created, the datasource and destination IDs should be used for configuring them in Adobe Campaign UI. Two datasources should be created, one based on Marketing Cloud ID and the other based on Declared ID. The destinations are created in the AAM Admin UI corresponding to each datasource. This would require involvement from either an AAM consultant or AAM Clientcare.

    4
  7. Configure the Datasources within Adobe Campaign
    The datasources are then configured in Adobe Campaign. Two datasources will be created in Adobe Campaign UI; one based on declred ID or hashed customer ID and the other based on marketing cloud id or requestor UUID. The destination ID corresponding to each ID is added in the respective fields. For example, the destination ID for AAM destination Adobe Campaign - Declared ID is added in the datasource setting with reconciliation key as hashed customer ID.

    5
    6
  8. Track user behavior on site
    In the below use case, the search keyword used by a customer is captured in evar2 and a product purchase as a purchase event in Analytics. The below flow is based on server side forwarding of AA calls to AAM. On the search page, we capture the “q” parameter and put it in a data-element:

    7
    8

    And we add this to a page load rule where we add the search keyword in evar2:

    9
    10

    Then, we also capture the “purchase” event in analytics on the thank you page:

    11
    12
    13

    At this point, we are able to track our customers and able to create segments in Audience Manager. Also, we have assured that both Audience Manager and Campaign are collecting the users with the same CRM_ID.

  9. Create segments in AAM based on user behavior
    Then create the following traits:
    “Has searched for Winter”:

    14

    Has bought a product:

    15

    And create your segment:

    16

    You could add recency and frequency settings in the segment rules as per the business use case.

  10. Push the segment to Campaign
    To share an AMC audience with campaign, the configuration has to be done within Adobe Campaign once the segment is created in AAM. Start by creating a shared audience within Adobe Campaign and select the AMC segment from the segment list. Two shared audiences have to be created based on MID and declared ID within campaign. Once the configuration is completed, the segments can be seen as automatically mapped to the respective destinations within AAM.

    17
    18
    19
    20
    21
  11. Share a campaign audience with AAM through AMC
    To share a campaign audience with AAM through AMC, the following configuration is required within Adobe Campaign.
    Under Administration menu option within the campaign UI, select production > technical workflows. Click on new technical workflows, drag query and then update shared audience and then end.

    22

    Double click on the query and edit it to select a shared audience and datasource. 

    23

    Create the segment in AMC.

    24

    Once created, these segments automatically appear in the AAM UI, under traits > All Traits > Adobe Campaign Traits

    25

    Run the workflow in Adobe Campaign to send the segments to AMC. Check the audit once completed.

    26
  12. Send the e-mail to customers

    In campaign, first create a list based on an audience. This is in “lists”: 

    27

    The popup now allows you to select a marketing cloud audience. Choose the “search_for_winter_did_not-buy”:

    28

    In the campaign workflow, you will now be able to select this list and send a targeted e-mail:

    29
    30

​Testing

It is recommended to run a sample workflow making use of a test segment within AAM to check if the integration is working end to end.

FAQ

What settings do I use while creatine datasources in AAM UI?

The following settings are to be used for the Declared ID and MID Datasources respectively. The integration codes cannot be changed to any other values or the customer might incur additional costs.

Declared ID

31
32

MID

34
35

I don't have the 'create shared audience' option under lists, what could be the reason?

You might not have logged in using your Adobe ID to campaign. If you logged in using your Adobe ID, please make sure you have been added to Audience Library product in Marketing Cloud Enterprise Console UI.

I have shared a segment with AAM but I don't see it in the AAM UI yet. What could be the reason?

Once the workflow is run, it could take 12-24 hours for the data to be ingested into AAM and an additional 24-48 hours for the reports to be updated in the AAM UI. If you don't see number under the traits/segments in AAM UI even after 3 days, please get in touch with your AAM consultant.                                    

 

Best Practices​

  1. It is recommended that the AAM and Campaign consultants work together to complete the setup on both ends. 
  2. It is recommended to use a segment with limited records to test the integration end to end. 
  3. Never map the segments to the campaign destination from the AAM UI​

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy