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.
At the end of this lesson, you will be able to:
To complete this lesson, you must first:
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
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 this
Platform Web SDK tutorial.
Set ID Type to Cookie
In the Data Export Controls section, select No Restriction
Save the Data Source
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.
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.
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
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,
As the Cookie Domain, add the domain of the site where you are planning for the integration, for the tutorial input the Luma domain,
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”.
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.
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
Open the Application tab, and open Cookies from the Storage menu.
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:
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.
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