Documentation Experience Platform Web SDK Tutorial

Set up Audience Manager with Platform Web SDK

Last update: Fri Nov 17 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Topics:
Web SDK,Tags

CREATED FOR:

Beginner
Intermediate
Developer

Learn how to set up Adobe Audience Manager using the 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.

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:

Go to Data Collection interface
On the left navigation, select Datastreams
Select the previously created Luma Web SDK datastream
Select Add Service
Select Adobe Audience Manager as the Service
Confirm that Cookie Destinations Enabled and URL Destinations Enabled are selected
Select Save

Create a data source

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

Go to the Audience Manager interface
Select Audience Data from the top navigation
Select the Data Sources from the drop-down menu
Select the Add New button from the top of the Data Sources page
Give the Data Source a friendly name and description. For initial setup, you can name thisPlatform Web SDK tutorial.
Set ID Type to Cookie
In the Data Export Controls section, select No Restriction
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 you want to use immediately in Audience Manager, as decribed in this exercise.

Select Audience Data > Traits
Select Add New > Rule-Based trait
Give your trait a friendly name and description, Luma homepage view
Select the Data Source you created in the previous section.
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.
Expand the Trait Expression caret and select Expression Builder You must provide a key value pair that signifies a homepage visit.
Open the Luma homepage (mapped to your tag property) and the Platform Web SDK Debugger and refresh the page.
Look at the Network Requests and the event details for the Platform Web SDK to find the key and name value for the homepage.
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.
Save the trait.

Create a segment

The next step is to create a segment, and assign your newly defined trait to this segment.

Select Audience Data in the top navigation and select Segments
Select Add New in the top left of the page to open the segment builder
Give your segment a friendly name and description, such as Platform Web SDK - Homepage visitors
Select a Folder where your segment will be 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.
Add an integration code, which in this case is a random set of numbers. 1. In the Data Source section, select Audience Manager and the data source you created earlier
Expand the Traits section and search for the trait you created
Select Add Trait.
Select Save at the bottom of the page

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.

Open the Destination Builder by selecting Destinations within the Audience Data menu in the top navigation
Select Create Destination
Enter a name and description, Platform Web SDK tutorial
As the Category, select Custom
As the Type, select Cookie
Open the Configuration section to enter the details about your cookie destination
Give your cookie a friendly name, platform_web_sdk_tutorial
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
As the Publish data to option, select Only the Selected domains
Select your domain if not already added
As the Data Format, select Single Key and give your cookie a key. For this tutorial use segment as the key value.
Finally, select Save to save the destination configuration details.
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.
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”.
Select Save
Select Done

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

Open the Luma demo site homepage with it mapped to your tag property to qualify for your newly created segment.
Open your browser’s developer tools > Network tab
Filter to the Platform Web SDK request using interact as the text filter
Select a call and open the Preview tab to view the response details
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.
Open the Application tab, and open Cookies from the Storage menu.
Select the https://luma.enablementadobe.com domain and confirm that your cookie is written appropriately in the list

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, share them on this Experience League Community discussion post

recommendation-more-help

8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4