mm-app-analytics-js-sdk

v1.0.1

Published

10 months ago

MediaMelon Application Analytics SDK

0High
0Medium
0Low

mediamelon

analytics sdk mediamelon tracking video-analytics user-tracking monetization experiment-tracking

MediaMelon App Analytics SDK

A comprehensive JavaScript SDK for tracking user behavior, video engagement, monetization events, and application analytics in web applications.

Features

🎯 Core Analytics: User tracking, screen tracking, app state monitoring
🎥 Video Analytics: Video engagement, quality tracking, user interactions
💰 Monetization Tracking: Subscription management, payment tracking, ad analytics
🔬 Experiment & Feature Tracking: A/B testing, feature flags, user segmentation
🤖 Auto-Collection: Automatic event capture, performance monitoring, error tracking
🌳 Tree Shaking Support: Optimized for bundle size reduction

Installation

NPM Installation

npm install mm-app-analytics-js-sdk

CDN Installation

<!-- ES Module (Recommended for modern bundlers) -->
<script type="module">
  import { MMAppAnalyticsSDK } from 'https://unpkg.com/[email protected]/mm-app-analytics-js-sdk.min.js';
</script>

<!-- Browser Bundle (IIFE) - Modern browsers -->
<script src="https://unpkg.com/[email protected]/mm-app-analytics-js-sdk.min.js"></script>

<!-- ES5 Bundle - Legacy browsers (IE 11+) -->
<script src="https://unpkg.com/[email protected]/mm-app-analytics-js-sdk.es5.min.js"></script>

Browser Compatibility

The SDK provides multiple builds for different browser environments:

mm-app-analytics-js-sdk.min.js - Modern ES6+ build (Chrome 50+, Firefox 50+, Safari 10+, Edge 14+)
mm-app-analytics-js-sdk.es5.min.js - ES5 compatible build (IE 11+, older browsers)
mm-app-analytics-js-sdk.esm.js - ES Module build for bundlers

Choose the appropriate build based on your browser support requirements.

Quick Start

NPM Usage

import { MMAppAnalyticsSDK } from 'mm-app-analytics-js-sdk';

// Initialize the SDK
const analytics = new MMAppAnalyticsSDK();

// Initialize with required parameters
await analytics.initialize(
    'your-customer-id',
    'your-app-id', 
    'Your App Name',
    '1.0.0'
);

// Track events
analytics.reportVideoStart({
    videoId: "1234",
    title: "Sample Video",
    duration: 2400,
    quality: "1080p"
});

HTML Usage

<!DOCTYPE html>
<html>
<head>
    <title>Analytics Demo</title>
</head>
<body>
    <!-- Include the SDK -->
    <script src="https://unpkg.com/[email protected]/mm-app-analytics-js-sdk.min.js"></script>
    
    <script>
        // Initialize the SDK
        const analytics = new MMAppAnalyticsSDK();
        
        // Initialize with required parameters
        analytics.initialize(
            'your-customer-id',
            'your-app-id', 
            'Your App Name',
            '1.0.0'
        ).then(() => {
            console.log('SDK initialized successfully');
            
            // Track events
            analytics.reportVideoStart({
                videoId: "1234",
                title: "Sample Video",
                duration: 2400,
                quality: "1080p"
            });
        });
    </script>
</body>
</html>

ES5 Usage (Legacy Browsers)

<!DOCTYPE html>
<html>
<head>
    <title>Analytics Demo - ES5</title>
</head>
<body>
    <!-- Include the ES5 SDK -->
    <script src="https://unpkg.com/[email protected]/mm-app-analytics-js-sdk.es5.min.js"></script>
    
    <script>
        // Initialize the SDK (ES5 compatible)
        var analytics = new MMAppAnalyticsSDK();
        
        // Initialize with required parameters
        analytics.initialize(
            'your-customer-id',
            'your-app-id', 
            'Your App Name',
            '1.0.0'
        ).then(function() {
            console.log('SDK initialized successfully');
            
            // Track events
            analytics.reportVideoStart({
                videoId: "1234",
                title: "Sample Video",
                duration: 2400,
                quality: "1080p"
            });
        }).catch(function(error) {
            console.error('SDK initialization failed:', error);
        });
    </script>
</body>
</html>

Advanced Configuration

With User Information

const userInfo = {
    userId: "user123",
    email: "[email protected]",
    phoneNumber: "+1234567890",
    demographics: {
        age: 25,
        gender: "female",
        region: "US-West"
    }
};

const sdkConfig = {
    debug: true,
    logLevel: 'info',
    offlineQueueSize: 1000,
    batchSize: 50,
    batchIntervalMs: 5000,
    autoCollect: {
        enabled: true,
        session: true,
        navigation: true,
        clicks: true,
        scrolls: true
    }
};

await analytics.initialize(
    'your-customer-id',
    'your-app-id', 
    'Your App Name',
    '1.0.0',
    userInfo,
    sdkConfig
);

API Reference

MediaMelon App Analytics JS SDK - API Reference Table

| API | Parameters | Example Code | |-----|------------|--------------| | reportVideoStart(data) | Mandatory:- data.assetId (string): Video asset identifier- data.assetName (string): Video asset name- data.duration (number): Video duration in seconds- data.position (number): Starting position in seconds- data.quality (string): Video quality- data.reason (string): Reason for video startOptional:- data.genre (string): Video genre- data.metadata (object): Additional metadata- data.playbackSpeed (number): Playback speed- data.bufferingTime (number): Buffering time in milliseconds- data.bitrate (number): Video bitrate- data.resolution (string): Video resolution- data.playerVersion (string): Player version- data.playerType (string): Player type | javascript mmAnalytics.reportVideoStart({ assetId: "video_123", assetName: "Sample Video", duration: 3600, position: 0, quality: "1080p", reason: "user_click", genre: "action", playbackSpeed: 1.0, metadata: { category: "movies", language: "en" } });  | | reportVideoPause(data) | Mandatory: Same as reportVideoStart | javascript mmAnalytics.reportVideoPause({ assetId: "video_123", assetName: "Sample Video", duration: 3600, position: 120, quality: "1080p", reason: "user_pause" });  | | reportVideoResume(data) | Mandatory: Same as reportVideoStart | javascript mmAnalytics.reportVideoResume({ assetId: "video_123", assetName: "Sample Video", duration: 3600, position: 120, quality: "1080p", reason: "user_resume" });  | | reportVideoEnd(data) | Mandatory: Same as reportVideoStart | javascript mmAnalytics.reportVideoEnd({ assetId: "video_123", assetName: "Sample Video", duration: 3600, position: 3600, quality: "1080p", reason: "video_complete" });  | | reportVideoSkip(data) | Mandatory: Same as reportVideoStart | javascript mmAnalytics.reportVideoSkip({ assetId: "video_123", assetName: "Sample Video", duration: 3600, position: 300, quality: "1080p", reason: "user_skip" });  | | reportVideoStop(data) | Mandatory: Same as reportVideoStart | javascript mmAnalytics.reportVideoStop({ assetId: "video_123", assetName: "Sample Video", duration: 3600, position: 180, quality: "1080p", reason: "user_stop" });  | | reportVideoQuality(data) | Mandatory:- data.assetId (string): Video asset identifier- data.oldQuality (string): Previous quality- data.newQuality (string): New qualityOptional:- data.metadata (object): Additional metadata | javascript mmAnalytics.reportVideoQuality({ assetId: "video_123", oldQuality: "720p", newQuality: "1080p", metadata: { reason: "bandwidth_improvement" } });  | | reportVideoBuffering(data) | Mandatory:- data.assetId (string): Video asset identifier- data.duration (number): Buffering duration in millisecondsOptional:- data.metadata (object): Additional metadata | javascript mmAnalytics.reportVideoBuffering({ assetId: "video_123", duration: 2000, metadata: { reason: "network_issue" } });  | | reportVideoShared(data) | Mandatory:- data.assetId (string): Video asset identifierOptional:- data.assetName (string): Video asset name- data.sharedTo (string): Platform shared to- Additional metadata (key-value pairs) | javascript mmAnalytics.reportVideoShared({ assetId: "video_123", assetName: "Sample Video", sharedTo: "facebook", metadata: { shareType: "social" } });  | | reportVideoBookmarked(data) | Mandatory:- data.assetId (string): Video asset identifierOptional:- data.assetName (string): Video asset name- data.type (string): Bookmark type- Additional metadata (key-value pairs) | javascript mmAnalytics.reportVideoBookmarked({ assetId: "video_123", assetName: "Sample Video", type: "favorite", metadata: { listName: "my_favorites" } });  | | reportVideoLiked(data) | Mandatory:- data.assetId (string): Video asset identifierOptional:- data.assetName (string): Video asset name- Additional metadata (key-value pairs) | javascript mmAnalytics.reportVideoLiked({ assetId: "video_123", assetName: "Sample Video", metadata: { likeType: "thumbs_up" } });  | | reportVideoComment(data) | Mandatory:- data.assetId (string): Video asset identifierOptional:- data.assetName (string): Video asset name- data.comment (string): Comment text- Additional metadata (key-value pairs) | javascript mmAnalytics.reportVideoComment({ assetId: "video_123", assetName: "Sample Video", comment: "Great video!", metadata: { commentType: "user_review" } });  | | reportVideoRating(data) | Mandatory:- data.assetId (string): Video asset identifierOptional:- data.assetName (string): Video asset name- data.rating (number): Rating value (1-5)- Additional metadata (key-value pairs) | javascript mmAnalytics.reportVideoRating({ assetId: "video_123", assetName: "Sample Video", rating: 5, metadata: { ratingType: "star_rating" } });  | | reportVideoQualityChange(data) | Mandatory:- data.assetId (string): Video asset identifier- data.assetName (string): Video asset name- data.quality (string): Current quality- data.reason (string): Reason for quality changeOptional:- data.oldQuality (string): Previous quality- data.newQuality (string): New quality- Additional metadata (key-value pairs) | javascript mmAnalytics.reportVideoQualityChange({ assetId: "video_123", assetName: "Sample Video", quality: "1080p", reason: "auto_adjustment", oldQuality: "720p", newQuality: "1080p" });  | | reportVideoPlaybackSpeedChange(data) | Mandatory:- data.assetId (string): Video asset identifierOptional:- data.assetName (string): Video asset name- data.oldSpeed (number): Previous playback speed- data.newSpeed (number): New playback speed- Additional metadata (key-value pairs) | javascript mmAnalytics.reportVideoPlaybackSpeedChange({ assetId: "video_123", assetName: "Sample Video", oldSpeed: 1.0, newSpeed: 1.5 });  | | reportScreenView(screenView) | Mandatory:- screenView.screenName (string): Screen name- screenView.screenId (string): Screen identifierOptional:- screenView.timestamp (number): Event timestamp- screenView.metadata (object): Additional metadata | javascript mmAnalytics.reportScreenView({ screenName: "Home Screen", screenId: "home_screen_001", timestamp: Date.now(), metadata: { source: "navigation" } });  | | reportScreenExit(data) | Mandatory:- data.screenName (string): Screen name- data.screenId (string): Screen identifier- data.duration (number): Time spent on screen in millisecondsOptional:- data.timestamp (number): Event timestamp- data.metadata (object): Additional metadata | javascript mmAnalytics.reportScreenExit({ screenName: "Home Screen", screenId: "home_screen_001", duration: 45000, timestamp: Date.now(), metadata: { exitMethod: "back_button" } });  | | reportAppState(appState) | Mandatory:- appState.state (string): App state ("foreground" or "background")Optional:- appState.timestamp (number): Event timestamp- appState.metadata (object): Additional metadata | javascript mmAnalytics.reportAppState({ state: "foreground", timestamp: Date.now(), metadata: { trigger: "user_interaction" } });  | | reportAppError(error) | Mandatory:- error.errorType (string): Type of error- error.message (string): Error messageOptional:- error.stack (string): Error stack trace- error.source (string): Error source file- error.line (number): Error line number- error.column (number): Error column number- error.metadata (object): Additional metadata | javascript mmAnalytics.reportAppError({ errorType: "network_error", message: "Failed to fetch data", stack: error.stack, source: "api.js", line: 45, column: 12, metadata: { endpoint: "/api/data" } });  | | reportPerformanceMetrics(data) | Mandatory:- data (object): Performance metrics dataOptional:- Additional metadata (key-value pairs) | javascript mmAnalytics.reportPerformanceMetrics({ loadTime: 1200, renderTime: 800, memoryUsage: 45.6, metadata: { page: "dashboard" } });  | | reportUserInfo(userInfo) | Mandatory:- userInfo (object): User information objectOptional:- Additional user data (key-value pairs) | javascript mmAnalytics.reportUserInfo({ userId: "user_123", email: "[email protected]", name: "John Doe", age: 25, location: "New York" });  | | reportUserSignUp(data) | Mandatory:- data.userId (string): User identifier- data.email (string): User email addressOptional:- data.name (string): User name- data.age (number): User age- data.source (string): Sign up source- Additional metadata (key-value pairs) | javascript mmAnalytics.reportUserSignUp({ userId: "user_123", email: "[email protected]", name: "John Doe", age: 25, source: "email_campaign", metadata: { referralCode: "REF123" } });  | | reportUserSignIn(data) | Mandatory:- data.userId (string): User identifier- data.email (string): User email addressOptional:- data.method (string): Sign in method- data.device (string): Device type- Additional metadata (key-value pairs) | javascript mmAnalytics.reportUserSignIn({ userId: "user_123", email: "[email protected]", method: "email_password", device: "mobile", metadata: { ipAddress: "192.168.1.1" } });  | | reportUserSignOut(data) | Mandatory:- data.userId (string): User identifier- data.email (string): User email addressOptional:- data.reason (string): Sign out reason- data.sessionDuration (number): Session duration in milliseconds- Additional metadata (key-value pairs) | javascript mmAnalytics.reportUserSignOut({ userId: "user_123", email: "[email protected]", reason: "user_logout", sessionDuration: 3600000, metadata: { logoutMethod: "button_click" } });  | | reportUserIdentification(data) | Mandatory:- data (object): User identification dataOptional:- Additional metadata (key-value pairs) | javascript mmAnalytics.reportUserIdentification({ anonymousId: "anon_456", userId: "user_123", email: "[email protected]", metadata: { identificationMethod: "login" } });  | | reportUserSessionStart(data) | Mandatory:- data (object): User session dataOptional:- Additional metadata (key-value pairs) | javascript mmAnalytics.reportUserSessionStart({ sessionId: "session_789", userId: "user_123", timestamp: Date.now(), metadata: { source: "app_launch" } });  | | reportUserSessionEnd(data) | Mandatory:- data (object): User session dataOptional:- Additional metadata (key-value pairs) | javascript mmAnalytics.reportUserSessionEnd({ sessionId: "session_789", userId: "user_123", duration: 1800000, metadata: { reason: "app_close" } });  | | reportUserPreferenceChange(data) | Mandatory:- data (object): User preference dataOptional:- Additional metadata (key-value pairs) | javascript mmAnalytics.reportUserPreferenceChange({ userId: "user_123", preference: "theme", oldValue: "light", newValue: "dark", metadata: { changeSource: "settings_page" } });  | | reportUserProfileUpdate(data) | Mandatory:- data.userId (string): User identifier- data.updatedFields (array): List of updated fieldsOptional:- Additional profile data (key-value pairs) | javascript mmAnalytics.reportUserProfileUpdate({ userId: "user_123", updatedFields: ["name", "avatar"], name: "Jane Doe", avatar: "avatar_url", metadata: { updateSource: "profile_edit" } });  | | reportUserClick(metadata) | Mandatory:- metadata.elementId (string): Element identifier- metadata.elementType (string): Element type- metadata.pageUrl (string): Page URL- metadata.position (object): Click position- metadata.timestamp (number): Event timestampOptional:- Additional metadata (key-value pairs) | javascript mmAnalytics.reportUserClick({ elementId: "btn_subscribe", elementType: "button", pageUrl: "https://example.com/pricing", position: { x: 150, y: 200 }, timestamp: Date.now(), metadata: { buttonText: "Subscribe Now" } });  | | reportUserScroll(metadata) | Mandatory:- metadata.scrollDepth (number): Scroll depth in pixels- metadata.scrollPercentage (number): Scroll percentage (0-100)- metadata.pageUrl (string): Page URL- metadata.timestamp (number): Event timestampOptional:- Additional metadata (key-value pairs) | javascript mmAnalytics.reportUserScroll({ scrollDepth: 800, scrollPercentage: 75, pageUrl: "https://example.com/article", timestamp: Date.now(), metadata: { scrollDirection: "down" } });  | | reportSubscriberInfo(data) | Mandatory:- data.subscriberId (string): Unique subscriber ID- data.planType (string): Subscription plan type- data.segment (string): User segment- data.profileId (string): Profile IDOptional:- Additional metadata (key-value pairs) | javascript mmAnalytics.reportSubscriberInfo({ subscriberId: "sub_123", planType: "premium", segment: "power_user", profileId: "profile_456", metadata: { subscriptionDate: "2024-01-15" } });  | | reportReferralInfo(data) | Mandatory:- data.referralId (string): Unique referral ID- data.source (string): Referral source- data.medium (string): Referral medium- data.campaign (string): Referral campaignOptional:- data.term (string): Search term- data.content (string): Content identifier- Additional metadata (key-value pairs) | javascript mmAnalytics.reportReferralInfo({ referralId: "ref_789", source: "google", medium: "cpc", campaign: "summer_sale", term: "video streaming", content: "banner_ad_001", metadata: { landingPage: "/welcome" } });  | | reportSubscriptionStart(data) | Mandatory:- data.subscriptionId (string): Subscription identifier- data.planId (string): Plan identifier- data.planName (string): Plan name- data.amount (number): Subscription amount- data.currency (string): Currency code- data.duration (number): Duration value- data.measure (string): Duration measure- data.status (string): Subscription statusOptional:- data.metadata (object): Additional metadata- data.paymentMethod (string): Payment method- data.autoRenew (boolean): Auto-renewal status- data.trialPeriod (number): Trial period in days- data.startDate (string): Start date | javascript mmAnalytics.reportSubscriptionStart({ subscriptionId: "sub_123", planId: "premium_monthly", planName: "Premium Monthly", amount: 9.99, currency: "USD", duration: 1, measure: "month", status: "active", paymentMethod: "credit_card", autoRenew: true, trialPeriod: 7, startDate: "2024-01-15", metadata: { source: "pricing_page" } });  | | reportSubscriptionRenewal(data) | Mandatory: Same as reportSubscriptionStart | javascript mmAnalytics.reportSubscriptionRenewal({ subscriptionId: "sub_123", planId: "premium_monthly", planName: "Premium Monthly", amount: 9.99, currency: "USD", duration: 1, measure: "month", status: "renewed", metadata: { renewalNumber: 3 } });  | | reportSubscriptionCancellation(data) | Mandatory: Same as reportSubscriptionStart | javascript mmAnalytics.reportSubscriptionCancellation({ subscriptionId: "sub_123", planId: "premium_monthly", planName: "Premium Monthly", amount: 9.99, currency: "USD", duration: 1, measure: "month", status: "cancelled", metadata: { reason: "too_expensive" } });  | | reportSubscriptionUpgrade(data) | Mandatory: Same as reportSubscriptionStart | javascript mmAnalytics.reportSubscriptionUpgrade({ subscriptionId: "sub_123", planId: "premium_yearly", planName: "Premium Yearly", amount: 99.99, currency: "USD", duration: 12, measure: "month", status: "upgraded", metadata: { previousPlan: "premium_monthly" } });  | | reportSubscriptionDowngrade(data) | Mandatory: Same as reportSubscriptionStart | javascript mmAnalytics.reportSubscriptionDowngrade({ subscriptionId: "sub_123", planId: "basic_monthly", planName: "Basic Monthly", amount: 4.99, currency: "USD", duration: 1, measure: "month", status: "downgraded", metadata: { previousPlan: "premium_monthly" } });  | | reportSubscriptionViewed(data) | Mandatory:- data.planId (string): Plan identifierOptional:- data.planName (string): Plan name- data.price (number): Plan price- data.duration (string): Plan duration- Additional metadata (key-value pairs) | javascript mmAnalytics.reportSubscriptionViewed({ planId: "premium_monthly", planName: "Premium Monthly", price: 9.99, duration: "1 month", metadata: { page: "pricing" } });  | | reportPaymentInitiation(data) | Mandatory:- data.paymentId (string): Payment identifier- data.amount (number): Payment amount- data.currency (string): Currency code- data.paymentMethod (string): Payment methodOptional:- data.metadata (object): Additional metadata- data.transactionId (string): Transaction identifier- data.orderId (string): Order identifier- data.customerId (string): Customer identifier | javascript mmAnalytics.reportPaymentInitiation({ paymentId: "pay_123", amount: 9.99, currency: "USD", paymentMethod: "credit_card", transactionId: "txn_456", orderId: "order_789", customerId: "cust_123", metadata: { source: "subscription_payment" } });  | | reportPaymentSuccess(data) | Mandatory: Same as reportPaymentInitiation | javascript mmAnalytics.reportPaymentSuccess({ paymentId: "pay_123", amount: 9.99, currency: "USD", paymentMethod: "credit_card", transactionId: "txn_456", metadata: { processingTime: 1500 } });  | | reportPaymentFailure(data) | Mandatory:- data.paymentId (string): Payment identifier- data.amount (number): Payment amount- data.currency (string): Currency code- data.paymentMethod (string): Payment method- data.errorType (string): Error type- data.message (string): Error messageOptional:- data.metadata (object): Additional metadata | javascript mmAnalytics.reportPaymentFailure({ paymentId: "pay_123", amount: 9.99, currency: "USD", paymentMethod: "credit_card", errorType: "insufficient_funds", message: "Insufficient funds in account", metadata: { retryCount: 1 } });  | | reportPaymentRefund(data) | Mandatory:- data.paymentId (string): Payment identifier- data.amount (number): Refund amount- data.currency (string): Currency code- data.refundReason (string): Refund reasonOptional:- data.metadata (object): Additional metadata | javascript mmAnalytics.reportPaymentRefund({ paymentId: "pay_123", amount: 9.99, currency: "USD", refundReason: "customer_request", metadata: { refundType: "full_refund" } });  | | reportAdImpression(data) | Mandatory:- data.adId (string): Ad identifier- data.adType (string): Ad typeOptional:- data.duration (number): Ad duration in seconds- data.metadata (object): Additional metadata | javascript mmAnalytics.reportAdImpression({ adId: "ad_123", adType: "banner", duration: 30, metadata: { position: "top_banner" } });  | | reportAdClick(data) | Mandatory: Same as reportAdImpression | javascript mmAnalytics.reportAdClick({ adId: "ad_123", adType: "banner", metadata: { clickPosition: { x: 150, y: 200 } } });  | | reportAdStart(data) | Mandatory: Same as reportAdImpression | javascript mmAnalytics.reportAdStart({ adId: "ad_123", adType: "preroll", duration: 15, metadata: { videoId: "video_456" } });  | | reportAdComplete(data) | Mandatory: Same as reportAdImpression | javascript mmAnalytics.reportAdComplete({ adId: "ad_123", adType: "preroll", duration: 15, metadata: { completionRate: 100 } });  | | reportAdSkip(data) | Mandatory: Same as reportAdImpression | javascript mmAnalytics.reportAdSkip({ adId: "ad_123", adType: "preroll", duration: 5, metadata: { skipReason: "user_skip" } });  | | reportAdError(data) | Mandatory:- data.adId (string): Ad identifier- data.adType (string): Ad type- data.errorType (string): Error type- data.message (string): Error messageOptional:- data.duration (number): Ad duration in seconds- data.metadata (object): Additional metadata | javascript mmAnalytics.reportAdError({ adId: "ad_123", adType: "preroll", errorType: "load_failed", message: "Ad failed to load", metadata: { errorCode: "AD_LOAD_ERROR" } });  | | reportExperimentExposure(data) | Mandatory:- data.experimentId (string): Experiment identifier- data.experimentName (string): Experiment name- data.variantId (string): Variant identifier- data.variantName (string): Variant name- data.timestamp (number): Event timestampOptional:- data.metadata (object): Additional metadata- data.exposureType (string): Exposure type- data.source (string): Exposure source- data.context (object): Exposure context | javascript mmAnalytics.reportExperimentExposure({ experimentId: "exp_123", experimentName: "New UI Layout", variantId: "variant_a", variantName: "Control", timestamp: Date.now(), exposureType: "page_view", source: "homepage", context: { userSegment: "new_users" }, metadata: { sessionId: "session_789" } });  | | reportExperimentActivation(data) | Mandatory: Same as reportExperimentExposure | javascript mmAnalytics.reportExperimentActivation({ experimentId: "exp_123", experimentName: "New UI Layout", variantId: "variant_a", variantName: "Control", timestamp: Date.now(), exposureType: "feature_activation", source: "user_interaction", metadata: { activationTrigger: "button_click" } });  | | reportFeatureFlagEvaluation(data) | Mandatory:- data.featureId (string): Feature identifier- data.featureName (string): Feature name- data.enabled (boolean): Feature enabled status- data.timestamp (number): Event timestampOptional:- data.metadata (object): Additional metadata- data.evaluationContext (object): Evaluation context- data.source (string): Evaluation source | javascript mmAnalytics.reportFeatureFlagEvaluation({ featureId: "feature_123", featureName: "Dark Mode", enabled: true, timestamp: Date.now(), evaluationContext: { userType: "premium" }, source: "app_startup", metadata: { evaluationTime: 50 } });  | | reportExperimentResults(data) | Mandatory:- data.experimentId (string): Experiment identifier- data.experimentName (string): Experiment name- data.variantId (string): Variant identifier- data.variantName (string): Variant name- data.results (object): Experiment results- data.timestamp (number): Event timestampOptional:- data.metadata (object): Additional metadata- data.resultType (string): Result type- data.metrics (object): Metrics data- data.context (object): Result context | javascript mmAnalytics.reportExperimentResults({ experimentId: "exp_123", experimentName: "New UI Layout", variantId: "variant_a", variantName: "Control", results: { conversionRate: 0.15, engagementTime: 300 }, timestamp: Date.now(), resultType: "conversion", metrics: { clicks: 45, impressions: 300 }, context: { userSegment: "new_users" }, metadata: { sessionDuration: 1800 } }); | | reportEvent(event) | Mandatory:- event (object): Event data objectOptional:- Additional event data (key-value pairs) | javascript mmAnalytics.reportEvent({ eventName: "custom_action", eventType: "user_interaction", timestamp: Date.now(), userId: "user_123", metadata: { action: "button_click", page: "dashboard" } });  | | reportFeatureUsage(data) | Mandatory:- data.featureId (string): Feature identifier- data.featureName (string): Feature name- data.action (string): Feature action- data.timestamp (number): Event timestampOptional:- data.metadata (object): Additional metadata | javascript mmAnalytics.reportFeatureUsage({ featureId: "feature_123", featureName: "Search Function", action: "search_executed", timestamp: Date.now(), metadata: { searchTerm: "video streaming", resultsCount: 15 } });  |

Modern Browsers: Chrome 50+, Firefox 50+, Safari 10+, Edge 14+
Legacy Browsers: IE 11+ (using ES5 build)
Mobile Browsers: iOS Safari 10+, Android Chrome 50+

Node.js Support

Node.js 14.0.0+

License

MIT License

Support

For support and questions:

Documentation: GitHub Repository
Issues: GitHub Issues
Contact: MediaMelon Support

Changelog

v1.0.0

Initial release
Core analytics functionality
Video tracking
User tracking
Monetization tracking
Experiment tracking
Auto-collection
Tree shaking support