Adobe Media Analytics for Audio and Video

This extension requires the Adobe Analytics for Media add-on SKU. To learn more, contact your Adobe Customer Success Manager.

Configure Media Analytics extension in Experience Platform Launch

  1. In Experience Platform Launch, click the Extensions tab.

  2. On the Catalog tab, locate the Adobe Media Analytics for Audio and Video extension, and click Install.

  3. Type the extension settings. For more information, see Configure Media Analytics Extension.

  4. Click Save.

  5. Follow the publishing process to update your SDK configuration.

Configure the Media Analytics extension

Adobe Media Analytics Extension Configuration

Tracking Server

This server is different from your Analytics tracking server.

Type the name of the tracking server to which all media tracking data should be sent.

Collection API Server

Contact your Adobe account representative to receive this information.

Type the name of the media collection API server to which the downloaded media tracking data should be sent.

Channel

Type the channel name property.

Online video provider

Type the name of the online platform through which content is distributed.

Player name

Type the name of the media player in use (for example, AVPlayer, Native Player, or Custom Player).

Application version

Type the version of the media player application/SDK.

Debug logging

Disable this option for your production application.

Enables or disables Media SDK logs.

Add Media Analytics to your app

This extension requires the Adobe Analytics extension. You must add the Analytics extension to your Launch property and make sure the extension is correctly configured.

  1. Add the Media extension and its dependencies to your project using the app's Gradle file.

    implementation 'com.adobe.marketing.mobile:analytics:1.+'
    implementation 'com.adobe.marketing.mobile:media:1.+'
    implementation 'com.adobe.marketing.mobile:sdk-core:1.+'
  2. Import the Media extension in your application's main activity.

    import com.adobe.marketing.mobile.*;
  3. To add the Media library and its dependencies to your project, add the following pods to your Podfile:

    pod 'ACPMedia', '~> 1.0'
    pod 'ACPAnalytics', '~> 2.0'
    pod 'ACPCore', '~> 2.0'

You can also manually include the libraries in Github.

  1. In Xcode project, import Media extension:

    Objective-C

    #import <ACPMedia.h>

    Swift

    import ACPMedia

Register Media with Mobile Core

Android
iOS

Java

To register media with Mobile Core, call the setApplication() method in onCreate() and call set up methods, as shown in this sample:

import com.adobe.marketing.mobile.*;
public class MobileApp extends Application {
@Override
public void onCreate() {
super.onCreate();
MobileCore.setApplication(this);
try {
Media.registerExtension();
Analytics.registerExtension();
Identity.registerExtension();
MobileCore.start(new AdobeCallback () {
@Override
public void call(Object o) {
MobileCore.configureWithAppID("your-launch-app-id");
}
});
} catch (InvalidInitException e) {
}
}
}

In your app's application:didFinishLaunchingWithOptions, register Media with Mobile Core:

Objective-C

#import <ACPCore.h>
#import <ACPAnalytics.h>
#import <ACPMedia.h>
#import <ACPIdentity.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[ACPCore setLogLevel:ACPMobileLogLevelDebug];
[ACPCore configureWithAppId:@"your-launch-app-id"];
[ACPMedia registerExtension];
[ACPAnalytics registerExtension];
[ACPIdentity registerExtension];
[ACPCore start:^{
}];
return YES;
}

Swift

import ACPCore
import ACPAnalytics
import ACPMedia
import ACPIdentity
import ACPLifecycle
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
ACPCore.setLogLevel(.debug)
ACPCore.configure(withAppId: "your-launch-app-id")
ACPMedia.registerExtension()
ACPAnalytics.registerExtension()
ACPIdentity.registerExtension()
ACPCore.start {
}
return true;
}

Configuration keys

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

Key

Required

Description

media.trackingServer

Yes

For more information, see Tracking Server.

media.collectionServer

No

For more information, see Collection Server.

media.channel

No

For more information, see Channel.

media.ovp

No

For more information, see Online Video Provider.

media.playerName

No

For more information, see Player Name.

media.appVersion

No

For more information, see Application Version.

media.debugLogging

No

For more information, see Debug Logging.