Adobe Analytics - Media Analytics for Audio and Video - Adobe Experience Platform Mobile SDKs

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 the Data Collection UI
1.In the Data Collection UI, select the Extensions tab.
2.On the Catalog tab, locate the Adobe Media Analytics for Audio and Video extension, and select Install.
3.Type the extension settings. For more information, see Configure Media Analytics Extension.
4.Select Save.
5.Follow the publishing process to update your SDK configuration.
Configure the Media Analytics extension
If you update the Adobe Media Analytics for Audio and Video launch extension to v2.x in your launch property, you must make sure to update and use AEP SDK Media extension v2.0.0 and higher.
Adobe Media Analytics Extension Configuration
To configure the Media Analytics extension, complete the following steps:
Collection API Server
Type the name of the media collection API server. This is the server where the downloaded media tracking data is sent. Important: You need to contact your Adobe account representative for this information.
Channel
Type the channel name property.
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.
Legacy settings should not be configured for Media Extension v2.x and higher. Those settings are only for backwards compatibility.
If you are using Media Extension v1.x, then go to Legacy settings section 1. Enable the Use Tracking Server checkbox. 2. In Tracking Server, Type the name of the tracking server to which all media tracking data should be sent.
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.
Android
iOS (AEP 3.x)
iOS (ACP 2.x)
React Native
Latest Android SDK versions - ​
​ ​
​ ​
​​
1.Add the Media extension and its dependencies to your project using the app's Gradle file.
1
implementation 'com.adobe.marketing.mobile:sdk-core:1.+'
2
implementation 'com.adobe.marketing.mobile:analytics:1.+'
3
implementation 'com.adobe.marketing.mobile:media:2.+'
Copied!
You can also manually include the libraries. Get .aar libraries from Github.
2.Import the Media extension in your application's main activity.
1
import com.adobe.marketing.mobile.*;
Copied!
Latest iOS SDK versions - ​
​ ​
​ ​
​​
1.To add the Media library and its dependencies to your project, add the following pods to your Podfile:
1
pod 'AEPCore
2
pod 'AEPAnalytics
3
pod 'AEPMedia'
Copied!
2.In Xcode project, import the Media extension:
Swift
1
import AEPMedia
2
import AEPCore
3
import AEPIdentity
4
import AEPAnalytics
Copied!
Objective C
1
 @import AEPCore;
2
 @import AEPMedia;
3
 @import AEPAnalytics;
4
 @import AEPIdentity;
Copied!
Latest iOS SDK versions - ​
​ ​
​ ​
​​
1.To add the Media library and its dependencies to your project, add the following pods to your Podfile:
1
pod 'ACPCore', '~> 2.0'
2
pod 'ACPAnalytics', '~> 2.0'
3
pod 'ACPMedia', '~> 2.0'
Copied!
You can also manually include the libraries. Get .a libraries from Github.
1.In Xcode project, import the Media extension:
Swift
1
import ACPMedia
Copied!
Objective C
1
 #import "ACPMedia.h"
Copied!
JavaScript
Latest React Native Wrapper versions - ​
​ ​
​ ​
​​
1.Install Media.
1
   npm install @adobe/react-native-acpmedia
Copied!
1.1 Link
React Native 0.60+
​CLI autolink feature links the module while building the app.
React Native <= 0.59
1
   react-native link @adobe/react-native-acpmedia
Copied!
Note For iOS using cocoapods, run:
1
   cd ios/ && pod install
Copied!
1.Import the extension.
1
 import {ACPMedia} from '@adobe/react-native-acpmedia';
Copied!
2.Get the extension version.
1
 ACPMedia.extensionVersion().then(version => console.log("AdobeExperienceSDK: ACPMedia version: " + version));
Copied!
Register Media with Mobile Core
Android
iOS (AEP 3.x)
iOS (ACP 2.x)
React Native
Java
To register media with Mobile Core, call the setApplication() method in onCreate() and call set up methods, as shown in this sample:
1
import com.adobe.marketing.mobile.*;
2
​
3
public class MobileApp extends Application {
4
​
5
  @Override
6
  public void onCreate() {
7
      super.onCreate();
8
      MobileCore.setApplication(this);
9
​
10
      try {
11
          Media.registerExtension();
12
          Analytics.registerExtension();
13
          Identity.registerExtension();
14
          MobileCore.start(new AdobeCallback () {
15
              @Override
16
              public void call(Object o) {
17
                  MobileCore.configureWithAppID("your-launch-app-id");
18
              }
19
          });
20
      } catch (InvalidInitException e) {
21
​
22
      }
23
  }
24
}
Copied!
Swift
In your app's _:didFinishLaunchingWithOptions function, register the Audience Manager extension with the Mobile Core:
1
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
2
   MobileCore.registerExtensions([Media.self, Analytics.self, Identity.self], {
3
   MobileCore.configureWith(appId: "yourAppId") 
4
 })  
5
 ...
6
}
Copied!
Objective-C
In your app's application:didFinishLaunchingWithOptions, register Media with Mobile Core:
1
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
2
    [AEPMobileCore registerExtensions:@[AEPMobileMedia.class, AEPMobileAnalytics.class, AEPMobileIdentity.class] completion:^{
3
    [AEPMobileCore configureWithAppId: @"yourAppId"];
4
  }];
5
  ...
6
}
Copied!
Swift
In your app's _:didFinishLaunchingWithOptions function, register the Audience Manager extension with the Mobile Core:
1
import ACPCore
2
import ACPAnalytics
3
import ACPIdentity
4
import ACPMedia
5
​
6
func application(_ application: UIApplication,
7
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
8
    ACPCore.setLogLevel(.debug)
9
    ACPCore.configure(withAppId: "your-launch-app-id")
10
​
11
    ACPAnalytics.registerExtension()
12
    ACPIdentity.registerExtension()
13
    ACPMedia.registerExtension()
14
​
15
    ACPCore.start {
16
​
17
    }
18
​
19
    return true;
20
}
Copied!
Objective-C
In your app's application:didFinishLaunchingWithOptions, register Media with Mobile Core:
1
#import "ACPCore.h"
2
#import "ACPAnalytics.h"
3
#import "ACPIdentity.h"
4
#import "ACPMedia.h"
5
​
6
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
7
    [ACPCore setLogLevel:ACPMobileLogLevelDebug];
8
    [ACPCore configureWithAppId:@"your-launch-app-id"];
9
​
10
    [ACPAnalytics registerExtension];
11
    [ACPIdentity registerExtension];
12
    [ACPMedia registerExtension];
13
​
14
    [ACPCore start:^{
15
​
16
    }];
17
​
18
    return YES;
19
  }
Copied!
JavaScript
When using React Native, registering Media with Mobile Core should be done in native code which is shown under the Android and iOS tabs.
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
Data Type
media.collectionServer
Yes
Media Collection Server endpoint to which all the media tracking data is sent. For more information, see Collection Server.
String
media.channel
No
Channel name. For more information, see Channel.
String
media.playerName
No
Name of the media player in use, i.e., "AVPlayer", "HTML5 Player", "My Custom Player". For more information, see Player Name.
String
media.appVersion
No
Version of the media player app/SDK. For more information, see Application Version.
String
Platform Support
Platform
Support Status
Android
Supported
Apple iOS​
Supported
React Native (iOS & Android)
Supported