MetrixAnalytics.newEvent("my_event_slug");

MetrixAnalytics.newEventByName("my_event_name");

    Map<String, Object> attributes = new HashMap<>();
    attributes.put("product_name", "shirt");
    attributes.put("purchase_date", "2024-11-20T11:24:03.000Z"); // use ISO 8601 to consider this attribute as s a date

    MetrixAnalytics.newEvent("purchase_event_slug", attributes);
    // OR
    MetrixAnalytics.newEventByName("purchase_event_name", attributes);

    // استفاده از slug
    MetrixAnalytics.newEvent('purchase_event_slug', JSON.stringify(attributes));
 
    // استفاده از نام سفارشی
    MetrixAnalytics.newEventByName('purchase_event_name', JSON.stringify(attributes));

Map<String, Object> attributes = new HashMap<>();
attributes.put("order_id", "ORD-12345");
attributes.put("product_ids", "PROD-001,PROD-002");
attributes.put("quantity", 2);
attributes.put("subtotal", 1500.00);
attributes.put("tax", 150.00);
attributes.put("total", 1650.00);
attributes.put("coupon_applied", true);
attributes.put("coupon_code", "SAVE10");
 
MetrixAnalytics.newEvent("checkout_complete", attributes);

Map<String, Object> attributes = new HashMap<>();
attributes.put("registration_method", "email");
attributes.put("signup_date", "2024-11-20T11:24:03.000Z");
attributes.put("referral_source", "app_store");
 
MetrixAnalytics.newEventByName("user_signup", attributes);

Map<String, Object> attributes = new HashMap<>();
attributes.put("content_id", "ARTICLE-001");
attributes.put("content_title", "Getting Started with Analytics");
attributes.put("content_category", "tutorial");
attributes.put("reading_time_seconds", 180);
attributes.put("scroll_depth", 85);
 
MetrixAnalytics.newEvent("content_viewed", attributes);

Map<String, Object> attributes = new HashMap<>();
attributes.put("button_name", "Share Button");
attributes.put("share_destination", "facebook");
attributes.put("content_id", "POST-001");
 
MetrixAnalytics.newEventByName("content_shared", attributes);

// کاربر یک اشتراک را خریداری می‌کند
double subscriptionPrice = 99.99;
MetrixAnalytics.newRevenue("subscription_purchase", subscriptionPrice, RevenueCurrency.USD);

// کاربر ارز مجازی خریداری می‌کند
Map<String, Object> attributes = new HashMap<>();
attributes.put("item_type", "virtual_currency");
attributes.put("item_name", "Gold Coins");
attributes.put("quantity", 1000);
attributes.put("unit_price", 9.99);
 
MetrixAnalytics.newRevenue("virtual_item_purchase", 9.99, RevenueCurrency.USD);

// مدیریت واحدهای پولی مختلف کاربر
String userCurrency = getUserCurrency(); // "USD", "EUR", "IRR"
double amount = getConvertedAmount(userCurrency);
 
MetrixAnalytics.newRevenue("purchase", amount, 
    RevenueCurrency.valueOf(userCurrency));

// ردیابی درآمد تکراری
double renewalAmount = 199.99;
MetrixAnalytics.newRevenueByName("subscription_renewal", renewalAmount, RevenueCurrency.USD);

// خوب: نام‌گذاری ثابت
MetrixAnalytics.newEvent("checkout_complete");
MetrixAnalytics.newEvent("checkout_complete", attributes);
 
// بد: تغییر نام ایونت ها
MetrixAnalytics.newEvent("checkout_complete");  // نسخه 1
MetrixAnalytics.newEvent("purchase_complete");  // نسخه 2 - ردیابی متفاوت

// خوب: ایونت  پس از عملیات موفقیت‌آمیز ثبت می‌شود
if (submitForm()) {
    MetrixAnalytics.newEvent("form_submitted");
}
 
// بد: ایونت  قبل از اعتبارسنجی ثبت می‌شود
MetrixAnalytics.newEvent("form_submitted");
submitForm(); // ممکن است با شکست مواجه شود

// خوب: فقط در صورت موفقیت ثبت می‌شود
ApiResponse response = makeApiCall();
if (response.isSuccessful()) {
    MetrixAnalytics.newEvent("api_call_successful");
} else {
    MetrixAnalytics.newEvent("api_call_failed");
}

// خوب: تمام داده‌ها در یک ایونت 
Map<String, Object> attributes = new HashMap<>();
attributes.put("category", "electronics");
attributes.put("brand", "Samsung");
attributes.put("price", 999.99);
MetrixAnalytics.newEvent("product_viewed", attributes);
 
// بد: چندین ایونت  برای داده‌های مرتبط
MetrixAnalytics.newEvent("product_category_viewed");
MetrixAnalytics.newEvent("product_brand_viewed");
MetrixAnalytics.newEvent("product_price_viewed");

// بد: شامل PII است
Map<String, Object> attributes = new HashMap<>();
attributes.put("user_name", "John Doe");  // ✗ PII
attributes.put("email", "john@example.com");  // ✗ PII
attributes.put("phone", "989123456789");  // ✗ PII
 
// خوب: به جای آن از متدهای ردیابی کاربر استفاده کنید
MetrixAnalytics.User.setFirstName("John");
MetrixAnalytics.User.setEmail("john@example.com");
 
// ویژگی‌های ایونت  با داده‌های غیر-PII
Map<String, Object> attributes = new HashMap<>();
attributes.put("user_type", "premium");  // ✓ غیر-PII
attributes.put("registration_age_days", 365);  // ✓ غیر-PII

// بد: بسیار پرفرکانس
onScroll(() -> MetrixAnalytics.newEvent("scroll"));
 
// خوب: ردیابی نقاط عطف معنی‌دار
if (scrollPercentage == 25) {
    MetrixAnalytics.newEvent("scroll_25_percent");
}
if (scrollPercentage == 50) {
    MetrixAnalytics.newEvent("scroll_50_percent");
}

// دریافت واحد پول ترجیحی کاربر یا تنظیمات اپلیکیشن
String userCurrency = preferenceManager.getCurrency();
 
// ثبت با واحد پول صحیح
MetrixAnalytics.newRevenue("purchase", amount, 
    RevenueCurrency.valueOf(userCurrency));

public class WebViewActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        WebView webView = findViewById(R.id.webView);
        webView.getSettings().setJavaScriptEnabled(true);
        
        // ثبت analytics bridge
        MetrixAnalyticsBridge.registerAndGetInstance(webView);
        
        webView.loadUrl("file:///android_asset/page.html");
    }
}

<!DOCTYPE html>
<html>
<head>
    <script type="text/javascript" src="metrix_analytics.js"></script>
</head>
<body>
    <script>
        // ایونت  ساده
        document.getElementById('buyBtn').onclick = function() {
            MetrixAnalytics.newEvent('purchase_clicked');
        };
        
        // ایونت  همراه با ویژگی‌ها
        document.getElementById('shareBtn').onclick = function() {
            var attrs = {
                'platform': 'facebook',
                'content_id': 'POST-001'
            };
            MetrixAnalytics.newEvent('content_shared', JSON.stringify(attrs));
        };
        
        // ایونت  درآمدی
        document.getElementById('subscribeBtn').onclick = function() {
            MetrixAnalytics.newRevenue('subscription_purchase', 99.99, 'USD');
        };
    </script>
</body>
</html>