Brightcove Native Player for iOS Reference

Omniture (Adobe Marketing Cloud - Adobe Analytics) Plugin for Brightcove Player SDK for iOS, version 6.8.7.1605

Requirements

Xcode 11.0+
ARC

Supported Platforms

iOS 11.0 and above.

Installation

The Omniture plugin is a static library framework which supports Adobe Marketing Cloud v4.14.1 and Adobe Video Heartbeat v2.0.1. The Marketing Cloud and Video Heartbeat libraries are not included with this SDK and must be manually added to your project. Instructions for downloading the libraries are provided below.

CocoaPods

You can use CocoaPods version 1.0 or higher to add the Omniture plugin to your project. You can find the latest Brightcove-Player-Omniture podspec here. To use this spec, add the following to the top of your Podfile: source 'https://github.com/brightcove/BCOVSpecs.git'.

Static Framework example:

```bash source ‘https://github.com/brightcove/BrightcoveSpecs.git'

target ‘MyOmniturePlayer’ do pod ‘Brightcove-Player-Omniture’ end ```

When updating your installation, it’s a good idea to refresh the local copy of your BrightcoveSpecs repository so that you have the latest podspecs locally, just like you would update your CococaPods master repository.

Typically if you use pod update in Terminal this will happen automatically, or alternatively you can update explicitly with pod repo update.

Manual

To add the Omniture Plugin for Brightcove Player SDK to your project manually:

Install the latest version of the Brightcove Player SDK.
Download the latest zip'ed release of the plugin from the release page.
Add the BrightcoveAMC.framework project. You can do this by right-clicking on the Frameworks folder and choose “Add Files To” option and select the BrightcoveAMC.framework from the path where it is stored.
On the “Build Settings” tab of your application target, ensure that the “Framework Search Paths” include the path to the framework. This should have been done automatically unless the framework is stored under a different root directory than your project.
On the “Build Phases” tab of your application target, add the following to the “Link Binary With Libraries” phase:
- BrightcoveAMC.framework
On the “Build Settings” tab of your application target:
- Ensure that -ObjC has been added to the “Other Linker Flags” build setting.
Download Adobe Marketing Cloud following Adobe’s instructions and add AdobeMobileLibrary.a to your project.
Download Adobe Video Heartbeat following Adobe’s instructions and add VideoHeartbeat.a to your project.
Add the Marketing Cloud and Video Heartbeat header folders to the Header Search Path settings of your project.

Quick Start

BrightcoveAMC is a bridge between the Brightcove Player SDK for iOS and Adobe video tracking, including Adobe Video Heartbeat v2 and Adobe Media Tracking v4. BrightcoveAMC tracks basic video behaviors: video ready, video completed, video play, and video pause.

Client Implementation

To setup Adobe Video Heartbeat, Omniture Plugin clients need to implement instances of BCOVAMCVideoHeartbeatConfigurationPolicy. To setup Adobe Media Tracking, an instance of BCOVAMCMediaSettingPolicy is required. These policies allow for customization of ADBMediaHeartbeatConfig or ADBMediaSettings objects for each playback session.

Video Heartbeat v2

This example uses video heartbeat tracking.

[1] // Create the VHB configuration policy object.
    BCOVAMCVideoHeartbeatConfigurationPolicy videoHeartbeatConfigurationPolicy = ^ADBMediaHeartbeatConfig *(id<BCOVPlaybackSession> session) {

        ADBMediaHeartbeatConfig *configData = [[ADBMediaHeartbeatConfig alloc] init];

        configData.trackingServer = <adobe-assigned_tracking_server>";
        configData.channel = <cutomize_sample_channel>;
        configData.appVersion = <app_version>;
        configData.ovp = <online_video_platform>;
        configData.playerName = <player_name>;
        configData.ssl = <YES | NO>;

        // Set debugLogging to true to activate debug tracing. Remove it in production.
        configData.debugLogging = YES;

        return configData;
    };

[2] // Create the Brightcove AMC analytics policy object fromw1w the VHB configuration policy object.
    BCOVAMCAnalyticsPolicy *heartbeatPolicy = [[BCOVAMCAnalyticsPolicy alloc] initWithHeartbeatConfigurationPolicy:videoHeartbeatConfigPolicy];

    BCOVAMCSessionConsumer *sessionConsumer = [BCOVAMCSessionConsumer heartbeatAnalyticsConsumerWithPolicy:heartbeatPolicy delegate:self];

    BCOVPlayerSDKManager *manager = [BCOVPlayerSDKManager sharedManager];
    id<BCOVPlaybackController> controller = [manager createPlaybackController];
    controller.delegate = self;
    [self.view addSubview:controller.view];

[3] // Add the Brightcove AMC session consumer to the playback controller.
    [controller addSessionConsumer:sessionConsumer];       

[4] // Find and play a video.
    NSString *policyKey = <your-policy-key>;
    NSString *accountId = <your-account-id>;
    NSString *videoID = <your-video-id>;
    BCOVPlaybackService *service = [[BCOVPlaybackService alloc] initWithAccountId:accountId
                                                                        policyKey:policyKey];
    [service findVideoWithVideoID:videoID
                       parameters:nil
                       completion:^(BCOVVideo    *video,
                                    NSDictionary *jsonResponse,
                                    NSError      *error) {

        [controller setVideos:@[ video ]];
        [controller play];

    }];

Create the video heartbeat configuration policy block which will be called at the start of each playback session. The policy allows for customization of configuration data based on the current session.
Use the configuration policy block to create and initialize a BCOVAMCAnalyticsPolicy instance with -[initWithHeartbeatConfigurationPolicy:]. The BCOVAMCAnalyticsPolicy object is used to create the BCOVAMCSessionConsumer.
After the playback controller is created, call the add session consumer method, -[addSessionConsumer:], to add the AMC session consumer.

Marketing Cloud

This example uses media tracking.

[1] BCOVAMCMediaSettingPolicy mediaSettingPolicy = ^ADBMediaSettings *(id<BCOVPlaybackSession> session) {

      ADBMediaSettings *settings = [ADBMobile mediaCreateSettingsWithName:<cutomize_setting_name>
[2]                                                                length:0
                                                               playerName:<cutomize_player_name>
                                                                 playerID:<cutomize_player_ID>];
[3]   settings.milestones = @"25,50,75"; // a customization.
      return settings;

    };

[4] BBCOVAMCAnalyticsPolicy *mediaPolicy = [[BCOVAMCAnalyticsPolicy alloc] initWithMediaSettingsPolicy:mediaSettingPolicy];

    BCOVAMCSessionConsumer *sessionConsumer = [BCOVAMCSessionConsumer mediaAnalyticsConsumerWithPolicy:mediaPolicy
                                                                                              delegate:self];

    BCOVPlayerSDKManager *manager = [BCOVPlayerSDKManager sharedManager];
    id<BCOVPlaybackController> controller = [manager createPlaybackController];
    controller.delegate = self;
    [self.view addSubview:controller.view];

[5] [controller addSessionConsumer:sessionConsumer];       

    NSString *policyKey = <your-policy-key>;
    NSString *accountId = <your-account-id>;
    NSString *videoID = <your-video-id>;
    BCOVPlaybackService *service = [[BCOVPlaybackService alloc] initWithAccountId:accountId
                                                                        policyKey:policyKey];
    [service findVideoWithVideoID:videoID
                       parameters:nil
                       completion:^(BCOVVideo    *video,
                                    NSDictionary *jsonResponse,
                                    NSError      *error) {

      [controller setVideos:@[ video ]];
      [controller play];

    }];

Create the media settings policy block which will be called at the start of each playback session. The policy allows for customization of media settings based on the current session.
When creating the ADBMediaSettings instance with a class method of ADBMobile +[mediaCreateSettingsWithName:length:playerName:playerID:], you can set video length to 0. The Omniture plugin will update it later.
Add optional settings such as milestones.
Use the media settings policy block to create and initialize a BCOVAMCAnalyticsPolicy instance with -[initWithMediaSettingsPolicy:]. The policy object is used to create an AMC session consumer for Adobe media tracking as +[mediaAnalyticsConsumerWithPolicy:delegate:].
After the playback controller is created, call the add session consumer method, -[addSessionConsumer:], to add the AMC session consumer.

Adobe-Marketing-Cloud.git

To fetch the Adobe Marketing Cloud libraries, run the following:

git clone -b v4.14.1-iOS --single-branch https://github.com/Adobe-Marketing-Cloud/mobile-services.git
git clone -b ios-v2.0.1 --single-branch https://github.com/Adobe-Marketing-Cloud/video-heartbeat-v2.git

Support

If you have questions, need help or want to provide feedback, please use the Support Portal or contact your Account Manager. To receive notification of new SDK software releases, subscribe to the Brightcove Native Player SDKs Google Group.

Brightcove Native Player for iOS