আপনার উইজেটের জন্য মেট্রিক্স ট্র্যাক করুন

অ্যান্ড্রয়েড ১৬-তে অতিরিক্ত মেট্রিক্স API রয়েছে যা আরও সূক্ষ্ম। এই মেট্রিক্সগুলি বোতাম ক্লিক, স্ক্রোল, ইমপ্রেশন এবং উইজেটের আকার এবং অবস্থানের মতো ট্যাপ অ্যাকশনগুলি ট্র্যাক করে।

প্রধান API হল AppWidgetEvent । WorkManager ব্যবহার করে একটি পর্যায়ক্রমিক কর্মী তৈরি করুন যা প্রতি ঘন্টায় একবার উইজেট এনগেজমেন্ট ক্যাপচার করে।

ক্লিক, স্ক্রোল এবং ইম্প্রেশনের দৈর্ঘ্য ট্র্যাক করার উদাহরণের জন্য নিম্নলিখিত স্নিপেটটি দেখুন। 

@RequiresApi(Build.VERSION_CODES_FULL.BAKLAVA_1)
fun getWidgetEngagementMetrics(context: Context) {
    val manager = AppWidgetManager.getInstance(context)

    val endTime = System.currentTimeMillis()
    val startTime = endTime - (24 * 60 * 60 * 1000) // a day ago

    val events = manager.queryAppWidgetEvents(startTime, endTime)

    if (events.isEmpty()) {
        Log.d(TAG, "No events found for the given time range.")
    }

    val metrics = hashMapOf(
        "clicks" to 0L,
        "scrolls" to 0L,
        "totalImpressionLength" to 0L
    )

    for (event in events) {

        Log.d(TAG, "Event Start: ${event.start}")
        Log.d(TAG, "Event End: ${event.end}")

        val widgetId = event.appWidgetId

        // Tap actions
        val clickedIds = event.clickedIds
        if (clickedIds?.isNotEmpty() == true) {
            metrics["clicks"] = metrics.getValue("clicks") + clickedIds.size
            // Log or analyze which components were clicked.
            for (id in clickedIds) {
                Log.d(TAG, "Widget $widgetId: Tap event on component with ID $id")
            }
        }

        // Scroll events
        val scrolledIds = event.scrolledIds
        if (scrolledIds?.isNotEmpty() == true) {
            metrics["scrolls"] = metrics.getValue("scrolls") + scrolledIds.size
            // Log or analyze which lists were scrolled.
            for (id in scrolledIds) {
                Log.d(TAG, "Widget $widgetId: Scroll event in list with ID/tag $id")
            }
        }

        // Impressions
        metrics["totalImpressionLength"] = metrics.getValue("totalImpressionLength") + event.visibleDuration.toMillis()
        Log.d(
            TAG,
            "Widget $widgetId: Impression event with duration " + event.visibleDuration.toMillis() + "ms"
        )

        // Position
        val position = event.position
        if (position != null) {
            Log.d(
                TAG,
                "Widget $widgetId: left=${position.left}, right=${position.right}, top=${position.top}, bottom=${position.bottom}"
            )
        }
    }
    Log.d("WidgetMetrics", "Metrics: $metrics")
}
GlanceMetrics.kt

সিস্টেমের স্বাস্থ্য রক্ষা করার জন্য, ইভেন্টগুলি ডিফল্টভাবে ঘন্টায় একবার রিপোর্ট করা হয় যদিও ডিভাইস নির্মাতারা রিপোর্টিং উইন্ডো পরিবর্তন করতে পারে। উদাহরণস্বরূপ, Pixel ডিভাইসে যদি কোনও ব্যবহারকারী আপনার উইজেটে একই তালিকাটি এক ঘন্টায় 10 বার স্ক্রোল করে, তাহলে সেই ঘন্টার জন্য শুধুমাত্র 1টি স্ক্রোল ইভেন্ট গণনা করা হবে।

পরীক্ষার জন্য, আপনি নিম্নলিখিত বৈশিষ্ট্যটি একটি নির্দিষ্ট সময়ে সেট করতে পারেন এবং আপনার পরীক্ষা ডিভাইসটি পুনরায় চালু করতে পারেন। নিম্নলিখিত উদাহরণে, রিপোর্ট উইন্ডোটি 0 ms এ সেট করা আছে এবং ইভেন্টগুলি অবিলম্বে রিপোর্ট করা হয়।

adb shell device_config override systemui widget_events_report_interval_ms 0

ক্লিক এবং স্ক্রোল রিপোর্ট করার জন্য একটি কাস্টম ট্যাগ সেট করার জন্য, আপনি আপনার RemoteViews লেআউটের মধ্যে একটি ভিউতে RemoteViews.setAppWidgetEventTag ব্যবহার করতে পারেন। এই পূর্ণসংখ্যা ট্যাগটি তখন ব্যবহার করা হয় যখন আপনি AppWidgetEvents জন্য অনুসন্ধান করেন যেখানে এই ভিউতে ক্লিক বা স্ক্রোল অন্তর্ভুক্ত থাকে।

পূর্ববর্তী
গ্ল্যান্সের সাথে ব্যবহারকারীর মিথস্ক্রিয়া পরিচালনা করুন
পরবর্তী
GlanceAppWidget পরিচালনা এবং আপডেট করুন