PHPackages alifahmmed/metrics-tracker - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. alifahmmed/metrics-tracker ActiveLibrary[Utility & Helpers](/categories/utility) alifahmmed/metrics-tracker ========================== A Laravel helper package for store impression, click of a post with filter and ctr. 1.0.7(1y ago)024MITPHPPHP >=8.1 Since Apr 20Pushed 1y ago1 watchersCompare [ Source](https://github.com/s-m-alif-ahmmed/metrics-tracker)[ Packagist](https://packagist.org/packages/alifahmmed/metrics-tracker)[ Docs](https://github.com/s-m-alif-ahmmed/metrics-tracker)[ RSS](/packages/alifahmmed-metrics-tracker/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (1)Versions (8)Used By (0) ๐Ÿ“Š MetricsTracker ================ [](#-metricstracker) A Laravel package to **track impressions, clicks, and CTR** (Click-Through Rate) for any model like pages, posts, banners, or other content. Inspired by platforms like Fiverr and Upwork. --- โœจ Features ---------- [](#-features) - โœ… Track impressions (when content is viewed) - โœ… Track clicks (when user interacts) - โœ… Automatically generates CTR (Click-Through Rate) - โœ… Supports polymorphic relationships - โœ… Artisan command to clean old records --- ๐Ÿ“ฆ Installation -------------- [](#-installation) ``` composer require alifahmmed/metrics-tracker ``` Then publish the migration: ``` php artisan vendor:publish --tag=public php artisan migrate ``` ๐Ÿ”ง Setup ๐ŸŽฎ 1. How to Use in Controller You can easily integrate metrics tracking (impressions and clicks) directly in your controllers. ๐Ÿ‘๏ธ Store Impressions (e.g., in index() method) To track impressions when showing a list of items: ``` use AlifAhmmed\MetricsTracker\Helpers\MetricsTracker; $data = YourModel::all(); // Replace with your model MetricsTracker::trackImpressionsForCollection($data); ``` This will: Store an impression only once per user/IP per day Automatically attach a metric\_token to each model for tracking clicks ๐Ÿ–ฑ๏ธ Store Clicks (e.g., in show() method) To track clicks when a user views or interacts with a single item: ``` use AlifAhmmed\MetricsTracker\Helpers\MetricsTracker; $data = YourModel::findOrFail($id); // Replace with your model MetricsTracker::trackClickAndGenerateToken($data); ``` This will: Store a click only if an impression exists for today Attach the metric\_token to the model for reference ๐Ÿ” 2. Filter Metrics by Days You can filter impressions and clicks by a specific range of days using this snippet: ``` $request->validate([ 'days' => 'required|in:1,7,14,30,60,90,180,365', ]); $days = $request->days; $metrics = MetricsTracker::getMetricsByDays($days); ``` Accepted values for days: 1, 7, 14, 30, 60, 90, 180, 365 This will return all metrics grouped by: trackable\_type type (impression or click) date ๐Ÿ“ˆ 3. Calculate CTR (Click-Through Rate) To calculate CTR for a specific model, ID, and day range, use: ``` use App\Models\YourModel; $ctr = MetricsTracker::calculateCTR(YourModel::class, $trackableId, 30); ``` Replace YourModel::class with your actual model class. Replace $trackableId with the model ID. Replace 30 with any day value (1, 7, 14, 30, 60, 90, 180, 365). If there are no impressions, the CTR will return 0. ๐Ÿ“Š How It Works ๐Ÿ‘๏ธ Impression is tracked when an element becomes visible in the viewport. ๐Ÿ–ฑ๏ธ Click is tracked when an element is clicked. ๐Ÿ“ˆ CTR (Click-Through Rate) is calculated based on total clicks / total impressions \* 100. ๐Ÿ›  Artisan Commands Clean up metrics older than 90 days (adjustable): ``` php artisan metrics:clean ``` ๐Ÿงช Example Usage (Controller or API) If you're building a SPA or headless app, you can also generate tokens server-side: ``` use AlifAhmmed\MetricsTracker\Helpers\MetricsTracker; $token = MetricsTracker::generateMetricToken($post); ``` ๐Ÿง‘โ€๐Ÿ’ป Author S M Alif Ahmmed โš– License MIT License. Use it freely in personal and commercial projects. โญ Like it? Give it a โญ on GitHub and share it with your Laravel friends! ### Health Score 30 โ€” LowBetter than 64% of packages Maintenance48 Moderate activity, may be stable Popularity7 Limited adoption so far Community7 Small or concentrated contributor base Maturity50 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits โ€” single point of failure How is this calculated?**Maintenance (25%)** โ€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** โ€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** โ€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** โ€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 7 Last Release 386d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/3af3c0ae537b65ab45f1b6cf345dc00327e959377c8a1be855884807b4db0e1e?d=identicon)[s-m-alif-ahmmed](/maintainers/s-m-alif-ahmmed) --- Top Contributors [![s-m-alif-ahmmed](https://avatars.githubusercontent.com/u/115633805?v=4)](https://github.com/s-m-alif-ahmmed "s-m-alif-ahmmed (19 commits)") --- Tags laravelhelperpackageactivitycountclickctrimpression ### Embed Badge ![Health badge](/badges/alifahmmed-metrics-tracker/health.svg) ``` [![Health](https://phpackages.com/badges/alifahmmed-metrics-tracker/health.svg)](https://phpackages.com/packages/alifahmmed-metrics-tracker) ``` ### Alternatives [barryvdh/laravel-ide-helper Laravel IDE Helper, generates correct PHPDocs for all Facade classes, to improve auto-completion. 14.9k123.0M687](/packages/barryvdh-laravel-ide-helper)[bensampo/laravel-embed Painless responsive embeds for videos, slideshows and more. 142146.8k](/packages/bensampo-laravel-embed)[erlandmuchasaj/laravel-gzip Gzip your responses. 40129.3k2](/packages/erlandmuchasaj-laravel-gzip)[tehwave/laravel-achievements Simple, elegant Achievements the Laravel way 7012.8k](/packages/tehwave-laravel-achievements) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)