Struct CtrTracker 

pub struct CtrTracker { /* private fields */ }

Tracks CTR metrics for an arbitrary number of items.

Each item is identified by a &str key. Items are created on first impression or click — there is no need to pre-register them.

Implementations

impl CtrTracker

pub fn new() -> Self

Creates an empty CtrTracker.

pub fn record_impression(&mut self, item_id: &str)

Records one impression for item_id.

If the item is not yet tracked it is created with zero counts first.

pub fn record_impressions(&mut self, item_id: &str, count: u64)

Records count impressions for item_id in a single call.

Useful for bulk-ingesting impression counts from a reporting pipeline.

pub fn record_click(&mut self, item_id: &str)

Records one click for item_id.

If the item is not yet tracked it is created with zero counts first. Clicks without a preceding impression are allowed (e.g. deep links).

pub fn record_clicks(&mut self, item_id: &str, count: u64)

Records count clicks for item_id in a single call.

pub fn stats(&self, item_id: &str) -> Option<&CtrStats>

Returns the CtrStats for item_id, or None if it has never been seen.

pub fn ctr(&self, item_id: &str) -> Result<f64, AnalyticsError>

Returns the raw CTR for item_id.

Errors

Returns AnalyticsError::InvalidInput when item_id is not tracked.

pub fn ranked(&self) -> Vec<CtrVariant>

Returns items ranked by CTR descending.

Items with no impressions are placed at the bottom (CTR = 0). Items with equal CTR are ordered by total impressions descending (more data first).

pub fn winner(&self, min_impressions: u64) -> Result<CtrVariant, AnalyticsError>

Returns the item with the highest CTR among those with at least min_impressions impressions.

Errors

Returns AnalyticsError::InsufficientData when no item meets the min_impressions threshold.

pub fn item_count(&self) -> usize

Returns the total number of items currently being tracked.

pub fn reset(&mut self)

Clears all tracking data.

Trait Implementations

impl Clone for CtrTracker

fn clone(&self) -> CtrTracker

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CtrTracker

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CtrTracker

fn default() -> CtrTracker

Returns the “default value” for a type.