App Analytics SDK

This page describes the integration of the MediaMelon App Analytics SDK

Prerequisites

  1. Android Sample App

  2. MediaMelon SmartSight SDK appanalytics-release.aar

  3. MediaMelon-assigned Customer ID

If you do not know your Customer ID contact MediaMelon at support@mediamelon.com

Step 1: Set up the build environment

  1. Copy appanalytics-release.aar provided with the release package to SampleApp/appanalytics-release.aar

  2. Add network permissions to

    app/src/main/AndroidManifest.xml

    <uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

Step 2: Integrate MediaMelon SDK Code to SampleApp

The application must register the MediaMelon SDK and provide app information once when the application launches. Please note that values provided in this integration step persist across app sessions.

you need to create Application class MyApplication.java

import android.app.Application;
import java.util.HashMap;
import com.mediamelon.appanalytics.MMIntegrationWrapper;

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        ....
        MMIntegrationWrapper.getInstance(this).initialize("CUTOMER_ID" , "APP_NAME" , "APP_VERSION");
        HashMap<String , Object> userInfoCustomData = new HashMap<String , Object>();
        userInfoCustomData.put("KEY" , "VALUE");
        MMIntegrationWrapper.reportSubscriberInfo("SUBSCRIBER_ID","SUBSCRIBER_TYPE","SUBSCRIBER_TAG","PROFILE_ID",userInfoCustomData);
        ...
    }
    @Override
    public void onTerminate() {
        super.onTerminate();
        MMIntegrationWrapper.release(true);
    }
}

Note: you can rename MyApplication.java according to your application

Now you need to mention in your MyApplication.java AndroidManifest.xml

 <application
        ...
           android:name=".MyApplication"
        ...
   </application>

Step 3: Custom Data & Referral Data

//Report Referral data
HashMap<String,Object> referralCustomData = new HashMap<String,Object>()
referralCustomData.put("REFERAl_KEY", "R_VALUE");
MMIntegrationWrapper.reportReferralInfo("REFERRAL_ID",referralCustomData);

// Report custom data
HashMap<String,Object> customData = new HashMap<String,Object>()
customData.put("KEY","VALUE")
MMIntegrationWrapper.reportCustomData("EVENT_NAME",customData)

Step 4 : User Actions

  • Screen View

HashMap<String,Object> screenData = new HashMap<String,Object>()
screenData.put("KEY","VALUE")
MMIntegrationWrapper.reportScreenView("EVENT_NAME",screenData)

  • Event

HashMap<String,Object> eventData = new HashMap<String,Object>()
eventData.put("KEY","VALUE")
MMIntegrationWrapper.reportEvent("EVENT_NAME",eventData)

  • App State

MMIntegrationWrapper.reportAppState("APP_STATE")

  • App Error

HashMap<String,Object> errorData = new HashMap<String,Object>()
errorData.put("KEY","VALUE")
MMIntegrationWrapper.reportAppError("APP_ERROR" , errorData)

  • Video State

HashMap<String,Object> videoData = new HashMap<String,Object>()
videoData.put("KEY","VALUE")
MMIntegrationWrapper.reportVideoState("VIDEO_STATE" , videoData)

  • Interruption

HashMap<String,Object> interruptionData = new HashMap<String,Object>()
interruptionData.put("KEY","VALUE")
MMIntegrationWrapper.reportInterruption("INTERRUTION_TYPE" , interruptionData)

  • Purchase

HashMap<String,Object> purchaseData = new HashMap<String,Object>()
purchaseData.put("KEY","VALUE")
MMIntegrationWrapper.reportPurchase("PURCHASE_TYPE" , purchaseData)

  • Subscription

HashMap<String,Object> subscriptionData = new HashMap<String,Object>()
subscriptionData.put("KEY","VALUE")
MMIntegrationWrapper.reportSubcription("SUBSCRIPTION_TYPE" , subscriptionData)

Step 4: Report Ended State to the SDK

 MMIntegrationWrapper.release(true);

PreviousAndroid SDKNextBitmovin Android v3.73 with Content Provider Metrics

Last updated