Set up Audience Manager with Platform Web SDK

Learn how to set up Adobe Audience Manager using the Adobe Experience Platform Web SDK and validate the implementation using a cookie destination.

Adobe Audience Manager is the Adobe Experience Cloud solution that provides everything required to collect commercially relevant information about site visitors, create marketable segments, and serve targeted advertising and content to the right audience.

Web SDK and Adobe Audience Manager diagram

Learning objectives

At the end of this lesson, you will be able to:

  • Configure a datastream to enable Audience Manager
  • Enable a cookie destination in Audience Manager
  • Validate the Audience Manager implementation by confirming audience qualification with Adobe Experience Platform Debugger

Prerequisites

To complete this lesson, you must first:

  • Complete the earlier lessons in the Initial Configuration and Tags Configuration sections of this tutorial.
  • Have access to Adobe Audience Manager and the appropriate permissions to create, read, and write traits, segments, and destinations. For more information, please review Audience Manager’s Role-Based Access Control.

Configure the datastream

The Audience Manager implementation using the Platform Web SDK differs from the implementation using server-side forwarding (SSF). Server-side forwarding passes Adobe Analytics request data to Audience Manager. A Platform Web SDK implementation passes XDM data sent to Platform Edge Network to Audience Manager. Audience Manager is enabled in the datastream:

  1. Go to Data Collection interface

  2. On the left navigation, select Datastreams

  3. Select the previously created Luma Web SDK: Development Environment datastream

    Select the Luma Web SDK datastream

  4. Select Add Service
    Add a service to the datastream

  5. Select Adobe Audience Manager as the Service

  6. Confirm that Cookie Destinations Enabled and URL Destinations Enabled are selected

  7. Select Save
    Confirm the Audience Manager datastream settings and save

Create a data source

Next, create a Data Source, a fundamental tool for organizing data within Audience Manager:

  1. Go to the Audience Manager interface

  2. Select Audience Data from the top navigation

  3. Select the Data Sources from the drop-down menu

  4. Select the Add New button from the top of the Data Sources page

    Adobe Experience Platform Audience Manager Data Sources

  5. Give the Data Source a friendly name and description. For initial setup, you can name this Platform Web SDK tutorial.

  6. Set ID Type to Cookie

  7. In the Data Export Controls section, select No Restriction

    Adobe Experience Platform Audience Manager Data Source Setup

  8. Save the Data Source

Create a trait

After the Data Source is saved, set up a trait. Traits are a combination of one or more signals in Audience Manager. Create a trait for homepage visitors.

NOTE
All XDM data is sent to Audience Manager if it is enabled in the datastream, however the data might take 24hrs until it is available in the Unused Signals report. Create explicit traits for the XDM data that you want to use immediately in Audience Manager, as described in this exercise.
  1. Select Audience Data > Traits

  2. Select Add New > Rule-Based trait

    Adobe Experience Platform Audience Manager Rule-Based Trait

  3. Give your trait a friendly name and description, Luma homepage view

  4. Select the Data Source you created in the previous section.

  5. Select a Folder in which to save your trait in the pane to the right. You may want to create a folder by selecting the + icon next to an existing parent folder. You can name this new folder Platform Web SDK tutorial.

  6. Expand the Trait Expression caret and select Expression Builder You must provide a key value pair that signifies a homepage visit.

  7. Open the Luma homepage (mapped to your tag property) and the Adobe Experience Platform Debugger and refresh the page.

  8. Look at the Network Requests and the event details for the Platform Web SDK to find the key and name value for the homepage.
    Adobe Experience Platform Audience Manager XDM Data

  9. Return to the Expression Builder in the Audience Manager UI and enter the key as web.webPageDetails.name and the value of content:luma:us:en. This step ensures that you fire a trait whenever you load the homepage.

  10. Save the trait.

Create a segment

The next steps are to create a segment and assign your newly defined trait to this segment.

  1. Select Audience Data in the top navigation and select Segments

  2. Select Add New in the top left of the page to open the segment builder

  3. Give your segment a friendly name and description, such as Platform Web SDK - Homepage visitors

  4. Select a Folder where your segment is saved in the pane to the right. You may want to create a folder by selecting the + icon next to an existing parent folder. You can name this new folder Platform Web SDK tutorial.

  5. Add an integration code, which in this case is a random set of numbers.

  6. In the Data Source section, select Audience Manager and the data source you created earlier

  7. Expand the Traits section and search for the trait that you created

  8. Select Add Trait.

  9. Select Save at the bottom of the page

    Adobe Experience Platform Audience Manager Add Trait

    Adobe Experience Platform Audience Manager Add Trait

Create a destination

Next, create a Cookie-based destination using the Destination Builder. The Destination Builder lets you create and manage cookie, URL, and server-to-server destinations.

  1. Open the Destination Builder by selecting Destinations within the Audience Data menu in the top navigation

  2. Select Create Destination

  3. Enter a name and description, Platform Web SDK tutorial

  4. As the Category, select Custom

  5. As the Type, select Cookie

    Adobe Experience Platform Audience Manager Add Trait

  6. Open the Configuration section to enter the details about your cookie destination

  7. Give your cookie a friendly name, platform_web_sdk_tutorial

  8. As the Cookie Domain, add the domain of the site where you are planning for the integration, for the tutorial input the Luma domain, luma.enablementadobe.com

  9. As the Publish data to option, select Only the Selected domains

  10. Select your domain if not already added

  11. As the Data Format, select Single Key and give your cookie a key. For this tutorial use segment as the key value.

  12. Finally, select Save to save the destination configuration details.

    Audience Manager Destination Configuration section

  13. In the Segment Mappings section, use the Search and Add Segments feature to search for your previously created Platform Web SDK - Homepage visitors and select Add.

  14. Once you add your segment, a pop-up opens where you must provide an expected value for your cookie. For this exercise, enter the value “hpvisitor”.

  15. Select Save

  16. Select Done
    Adobe Experience Platform Audience Manager Add Trait

The segment-mapping period requires a few hours to be activated. Once completed, you can refresh the Audience Manager interface and see that the Mapped Segments list updated.

Validate the segment

A few hours after the initial creation of the segment, you can validate that it is working properly.

First, confirm that you can qualify for the segment

  1. Open the Luma demo site homepage with it mapped to your tag property to qualify for your newly created segment.

  2. Open your browser’s developer tools > Network tab

  3. Filter to the Platform Web SDK request using interact as the text filter

  4. Select a call and open the Preview tab to view the response details

  5. Expand the payload to view the expected cookie details, as previously configured in Audience Manager. In this example, you will see the expected cookie name platform_web_sdk_tutorial.

    Adobe Experience Platform Audience Manager Add Trait

  6. Open the Application tab, and open Cookies from the Storage menu.

  7. Select the https://luma.enablementadobe.com domain and confirm that your cookie is written appropriately in the list

    Adobe Experience Platform Audience Manager Add Trait

Finally, you should open the segment in the Audience Manager interface and ensure that the Segment Populations has incremented:

Adobe Experience Platform Audience Manager Add Trait

Now that you have completed this lesson, you should be able to see how the Platform Web SDK passes data to Audience Manager and can set a segment-specific first-party cookie with a cookie destination.

Next: Set up Adobe Target

NOTE
Thank you for investing your time in learning about Adobe Experience Platform Web SDK. If you have questions, want to share general feedback, or have suggestions on future content, please share them on this Experience League Community discussion post
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4