Datazoom is a high-availability real-time data collection solution. This document summarizes how to integrate the Bitmovin Android video player with the Datazoom platform.

1. Login to Datazoom here:  https://app.datazoom.io
   
2. Add a Collector as indicated here:  How to add a Collector
   
   
3. Copy the config key that was created at the end of the process
   Click the icon indicated below to copy the Configuration Key
   
   You will see this message:
   

     4. Replace the <configuration id from Datazoom>  with the Key you copied above.

     5. Replace the <url given by Datazoom> with <https://platform.datazoom.io/beacon/v1/>

Adding dependencies to your project

1. (a) You can download the latest version of the library file from the below URL and add it into your project's libs directory

   https://gitlab.com/datazoom/mobile-android-group/mobile-android-collector-libraries-release/-/packages/4594553

     else you can follow step (b)

   (b) Add following maven repository URL in your project's build.gradle file

   Maven

   maven {
      url 'https://gitlab.com/api/v4/projects/10353305/packages/maven'
   }

   Add following dependency in your project's build.gradle file's dependencies block

   Maven

   dependencies {
       implementation 'com.datazoom.android:base-collector-gold:2.0.1'
       implementation 'com.datazoom.android:android-bitmovin-collector:2.0.0'
   }

2. Add following compile options if you don't have it already

   compileOptions

   compileOptions {
       sourceCompatibility JavaVersion.VERSION_1_8
       targetCompatibility JavaVersion.VERSION_1_8
   }

3. Add retrofit library to your project

   retrofit

   dependencies {
       implementation 'com.bitmovin.player:playercore:2.14.0'
       implementation 'com.squareup.retrofit2:retrofit:2.4.0'
   }

4. Use the following code snippet to add the BitmovinPlayerCollector to your project.
   Following code snippet illustrates the usage of the BitmovinPlayer collector. Open demo application's MainActivity.java to see a running example.

   String configId = <configuration id from Datazoom>;
   String configUrl = <url given by Datazoom>;
   
    BitmovinPlayerCollector.create(bitmovinPlayer, BitmovinActivity.this)
                   .setConfig(new DatazoomConfig(configId, configUrl))
                   .connect(new DZBeaconConnector.ConnectionListener() {
                       @Override
                       public void onSuccess(DZEventCollector dzEventCollector) {
                           sdkInitialized = true;
                           setupCustomMetadata();
                           setupCustomEvent(dzEventCollector);
                       }
   
                       @Override
                       public void onError(Throwable t) {
                           showAlert("Error", "Error while creating NativeAndroidConnector, error:" + t.getMessage());
                       }
                   });
                
   

Custom Events and Metadata

Datazoom allows customers to collect custom events and metadata that don't originate from a video player.

Custom Metadata

1. a. Create a JSONArray with necessary metadata               

   JSONArray metadata = new JSONArray( "[{\"customMetadata\": \"MetadataValue\"}]"); or HashMap<String, Object> metadata = new HashMap<String, Object>;
   

   b. Add the metadata to DZEventCollector

   dzEventCollector.setDatazoomMetadata(metadata); or dzEventCollector.setCustomMetadata(HashMap<String, Object> metadata);
   
   

   Example: 

   @Override
   public void onSuccess(DZEventCollector dzEventCollector) {
    try {
        dzEventCollector.setDatazoomMetadata(new JSONArray("[{\"customPlayerName\": \"Exo Player\"}," + "{\"customDomain\": " + "\"platform.io\"}]"));  } catch (JSONException e) {
        e.printStackTrace();
        }
   }
   
   

Custom Events

1. a. Create an Event object

   Event event = new Event("Custom_Event_Name", new JSONArray()); or Event event = new Event(String type, HashMap<String, Object> metadata);
   
   

   b.  Add the event to DZEventCollector. 

   dzEventCollector.addCustomEvent(event);
   
   

   Example:

   @Override
   public void onSuccess(DZEventCollector dzEventCollector) {
   Event event = new Event("SDKLoaded", new JSONArray());
   dzEventCollector.addCustomEvent(event);
   btnPush.setOnClickListener(v -> {
   try {
   Event event1 = new Event("btnPush", new JSONArray("[{\"customPlay\": \"true\"}] "));
   dzEventCollector.addCustomEvent(event1);
   } catch (JSONException e) {
   e.printStackTrace();
   }
   });
   }