Show Menu
TOPICS×

Add Adobe Audience Manager

This lesson will guide you through the steps to implement Adobe Audience Manager into the Experience Platform Mobile SDK using Server-Side Forwarding.
Adobe Audience Manager (AAM) provides industry-leading services for online audience data management, giving digital advertisers and publishers the tools they need to control and leverage their data assets to help drive sales success.

Learning Objectives

At the end of this lesson, you will be able to:
  1. Describe the two main ways to implement Audience Manager in a mobile app
  2. Add Audience Manager using Server-Side Forwarding of the Analytics beacon
  3. Validate the Audience Manager implementation

Prerequisites

In order to complete this lesson, you will need:
  1. To have completed the lessons under the Configuring Launch section, namely Create a Launch Property , Add Extensions , Create a Library , and Install the Mobile SDK .
  2. Admin access to Adobe Analytics so that you can enable Server-Side Forwarding for the report suite you are using for this tutorial. Alternatively, you can ask an existing admin at your organization to do this for you, following the instructions below.

Implementation Options

There are two ways to implement Audience Manager in an app:
  • Server-Side Forwarding (SSF)—for customers with Adobe Analytics, this is the easiest and recommended way to implement. Adobe Analytics forwards data to AAM on Adobe's backend, so that you don't have to make requests from the app directly to Audience Manager. This also enables key integration features and conforms with our best practices for Audience Manager code implementation and deployment.
  • Client-Side DIL—This approach is for customers who do not have Adobe Analytics. Audience Manager methods in the app send data directly into Audience Manager. In this case you would use the Audience Manager extension in Launch when you are setting up your mobile Launch property.
When you previously set up the Analytics extension in the Add Extensions section of this tutorial, you checked the box to initiate server-side forwarding of data from Analytics to Audience Manager. This will dynamically insert the code needed to handle the response of Audience Manager segments back into your app. We will not be adding the Audience Manager extension in this tutorial, because again, this is only for the use case of when you do NOT have Adobe Analytics.

Enable Server-Side Forwarding

There are three main steps to implement SSF :
  1. Adding the Experience Cloud Mobile SDK and Analytics extension to the app, * which you have already done in the Configuring Launch lessons
  2. Enabling Audience Manager Forwarding in the Analytics extension configuration, which you have have already done during the Add Extensions lesson simply by checking a box.
  3. Turning on a "switch" in the Analytics Admin Console to forward data from Analytics to Audience Manager per report suite , which we will review in the rest of this lesson.

Enable Server-Side Forwarding in the Analytics Admin Console

A configuration in the Adobe Analytics Admin Console is required to start forwarding data from Adobe Analytics to Adobe Audience Manager. Be advised that it can take the system up to four hours to start forwarding the data, so keep that in mind as you are troubleshooting the forwarding.

To Enable SSF in the Analytics Admin Console

  1. Log into Analytics via the Experience Cloud UI. If you don't have Admin access to Analytics, you will need to talk to your Experience Cloud or Analytics admin to assign you access or complete these steps for you.
  2. From the top navigation in Analytics, choose Admin > Report Suites , and from the list, select (or multi-select) the report suite(s) that you want to forward to Audience Manager.
  3. From the Report Suites screen and with the report suite(s) selected, choose Edit Settings > General > Server-Side Forwarding .
    As stated above, you will need to have administrator privileges to see this menu item.
  4. Once on the Server-Side Forwarding page, read the info and check the box to Enable Server-Side Forwarding for the report suite(s).
  5. Click Save
Since SSF needs to be enabled per report suite, don't forget to repeat this step for your real report suites when you are deploying SSF in your actual app's report suite.
Also, if the SSF option is grayed out, you will need to "map the report suite(s) to your Experience Cloud Org in order to enable the option. This is explained in the documentation .
This switch will start the actual forwarding of data to AAM, as long as you have the Adobe Experience Platform Identity Service implemented. The rest of SSF implementation happens in the code, which was handled in Launch when you checked the box in the Analytics extension to forward to AAM.
Server-Side Forwarding code is now implemented for your app!