Adobe Audience Manager

Adobe Audience Manager is a versatile audience data management platform. With the SDK, you can update audience profiles for users and retrieve user segment information from your mobile app. For more information, see Adobe Audience Manager.

Configuring the Audience Manager extension in Experience Platform Launch

Adobe Audience Manager Extension Configuration
  1. In Experience Platform Launch, click the Extensions tab.

  2. Choose Catalog, locate the Adobe Audience Manager extension, and click Install.

  3. Type your Audience Manager server.

  4. Type a timeout value. This value is the period, in seconds, to wait for a response from Audience Manager before timing out. We recommend a default value of 2s.

  5. Click Save.

  6. Follow the publishing process to update the SDK configuration.

Add Audience Manager to your app

Android
iOS
React Native
Android

Java

  1. Add the library to your project.

  2. Import the library.

import com.adobe.marketing.mobile.*;

Audience Manager depends on the Identity extension and is automatically included in the Core pod. When manually installing the Audience Manager extension, ensure that you add the identity-1.x.x.aar library to your project.

iOS
  1. Add the library to your project via your Podfile by adding pod 'ACPAudience'

  2. Import the Audience and Identity library, using the respective language:

Objective-C

#import "ACPCore.h"
#import "ACPAudience.h"
#import "ACPIdentity.h"

Swift

import ACPCore
import ACPAudience

Audience Manager depends on the Identity extension and is automatically included in the Core pod. When installing the Audience Manager extension manually, ensure that you added the libACPIdentity_iOS.a library to your project.

React Native

JavaScript

  1. Install Audience Manager in your project.

npm install @adobe/react-native-acpaudience
react-native link @adobe/react-native-acpaudience
  1. Import the extension.

import {ACPAudience} from '@adobe/react-native-acpaudience';
  1. Ensure the extension version is correct.

ACPAudience.extensionVersion().then(version => console.log("AdobeExperienceSDK: ACPAudience version: " + version));

Register Audience Manager with Mobile Core

Android
iOS
React Native
Android

Java

Call the setApplication() method once in the onCreate() method of your main activity.

For example, your code might look like the following:

public class AudiencetApp extends Application {
@Override
public void onCreate() {
super.onCreate();
MobileCore.setApplication(this);
try {
Audience.registerExtension(); //Register Audience Manager with Mobile Core
Identity.registerExtension();
MobileCore.start(null);
} catch (Exception e) {
//Log the exception
}
}
}
iOS

In your app's application:didFinishLaunchingWithOptions function, register the Audience Manager extension with the Mobile Core:

Objective-C

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[ACPIdentity registerExtension];
[ACPAudience registerExtension];
[ACPCore start:nil]
// Override point for customization after application launch.
return YES;
}

Swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
ACPIdentity.registerExtension()
ACPAudience.registerExtension()
ACPCore.start(nil)
// Override point for customization after application launch.
return true;
}
React Native

JavaScript

import {ACPAudience} from '@adobe/react-native-acpcore';
initSDK() {
ACPAudience.registerExtension();
}

Implement Audience Manager APIs

For more information about implementing Audience Manager APIs, please read the Audience Manager API reference.

Configuration keys

To update SDK configuration programmatically, use the following information to change your Audience Manager configuration values. For more information, see the Configuration API reference.

Key

Required

Description

Data Type

audience.server

Yes

Server endpoint used to collect Audience Manager data

String

audience.timeout

No

Time, in seconds, to wait for a response from Audience Manager before timing out. Default value is 2 seconds.

Integer

Additional information