Skip to content
Permalink
Fetching contributors…
Cannot retrieve contributors at this time
208 lines (144 sloc) 5.97 KB

Adobe Media Analytics for Audio and Video

{% hint style="warning" %} This extension requires the Adobe Analytics for Media add-on SKU. To learn more, contact your Adobe Customer Success Manager. {% endhint %}

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

{% hint style="info" %} This server is different from your Analytics tracking server. {% endhint %}

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

Collection API Server

{% hint style="warning" %} Contact your Adobe account representative to receive this information. {% endhint %}

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

{% hint style="danger" %} Disable this option for your production application. {% endhint %}

Enables or disables Media SDK logs.

Add Media Analytics to your app

{% hint style="info" %} 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. {% endhint %}

  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

{% tabs %} {% tab title="Android" %}

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) {

      }
  }
}

{% endtab %}

{% tab title="iOS" %} 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;
}

{% endtab %} {% endtabs %}

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.
You can’t perform that action at this time.