PHPackages rsmmonaem/laravel-meta-ads-attribution - 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. rsmmonaem/laravel-meta-ads-attribution ActiveLibrary rsmmonaem/laravel-meta-ads-attribution ====================================== Production-ready Meta/Facebook Ads attribution, customer journey tracking, order attribution, and delivered-order Conversions API (CAPI) system for Laravel e-commerce. v1.0.0(today)00MITPHPPHP ^8.2CI failing Since Aug 24Pushed todayCompare [ Source](https://github.com/rsmmonaem/laravel-meta-ads-attribution)[ Packagist](https://packagist.org/packages/rsmmonaem/laravel-meta-ads-attribution)[ Docs](https://github.com/rsmmonaem/laravel-meta-ads-attribution)[ RSS](/packages/rsmmonaem-laravel-meta-ads-attribution/feed)WikiDiscussions main Synced today READMEChangelogDependencies (5)Versions (2)Used By (0) Laravel Meta/Facebook Ads Attribution & Delivered Conversions API (CAPI) Package ==================================================================================== [](#laravel-metafacebook-ads-attribution--delivered-conversions-api-capi-package) [![Latest Version on Packagist](https://camo.githubusercontent.com/9dad012357bc94f6a20deecd51a4cb3af01dd8899c85f4509715c2358f28cf99/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f72736d6d6f6e61656d2f6c61726176656c2d6d6574612d6164732d6174747269627574696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/rsmmonaem/laravel-meta-ads-attribution)[![Total Downloads](https://camo.githubusercontent.com/3d949398f6fb5aea0a3a8b5215fc963f1b1b4c34a96ec60a75889f46488b5555/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f72736d6d6f6e61656d2f6c61726176656c2d6d6574612d6164732d6174747269627574696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/rsmmonaem/laravel-meta-ads-attribution)[![License](https://camo.githubusercontent.com/30fd1c4472737c6a34a6188831c6a2c6272b60b5eb1f96db5abeaada16315947/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f72736d6d6f6e61656d2f6c61726176656c2d6d6574612d6164732d6174747269627574696f6e2e7376673f7374796c653d666c61742d737175617265)](LICENSE) Production-ready end-to-end Meta/Facebook Ads attribution, customer journey tracking, order attribution, and qualified **DELIVERED** order Conversions API (CAPI) system for **ANY Laravel application** (custom e-commerce, Bagisto, Lunar, Shopper, Filament, Nova, Aimeos). --- ๐ŸŒŸ Key Features -------------- [](#-key-features) - **First-Party Click & Landing Attribution Engine**: Captures `fbclid`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`, `_fbp`, `_fbc`, landing page, referrer, IP address, user-agent. - **First-Party Visitor Tracking**: Sets a 90-day visitor cookie (`meta_visitor_id`) that persists across page browsing, cart additions, login, registration, and guest checkout. - **Hybrid / First Paid Touch Attribution**: Preserves original acquisition ad campaign while tracking latest touchpoint. - **Meta Conversions API (CAPI)**: Normalizes and SHA-256 hashes PII (`em`, `ph`, `fn`, `ln`, `ct`, `st`, `zp`, `country`, `external_id`) while transmitting unhashed technical parameters (`client_ip_address`, `client_user_agent`, `fbp`, `fbc`). - **Qualified DELIVERED Conversion Trigger**: Fires Meta CAPI `Purchase` conversion **ONLY** when an order status reaches **DELIVERED** (or configured status). - **Strict Idempotency & Deduplication**: Guarantees duplicate status changes to `DELIVERED` do NOT produce duplicate CAPI dispatches (tracked by deterministic event ID `purchase_{order_id}`). - **Asynchronous Queue & Retries**: Queued dispatches (`SendMetaDeliveredConversionJob`) with 5 retries and exponential backoff (`10s`, `60s`, `300s`, `900s`, `3600s`). - **Admin Dashboard & Audit Log**: Analytics UI (`/admin/meta-attribution`) showing Meta visitors, sessions, orders, delivered orders, revenue, campaign performance breakdown, and log with manual event retry. --- ๐Ÿ“ฅ Installation -------------- [](#-installation) ``` composer require rsmmonaem/laravel-meta-ads-attribution ``` --- โš™๏ธ Package Setup ---------------- [](#๏ธ-package-setup) Run the automated installer command: ``` php artisan meta-attribution:install ``` This will publish: - `config/meta-attribution.php` - Database Migrations - Admin Blade views Then run migrations: ``` php artisan migrate ``` --- ๐Ÿ”ง Environment Configuration --------------------------- [](#-environment-configuration) Add your Meta credentials to your `.env` file: ``` META_ATTRIBUTION_ENABLED=true META_ENABLE_BROWSER_PIXEL=true META_ENABLE_CAPI=true META_PIXEL_ID=123456789012345 META_ACCESS_TOKEN=EAAB1234567890... META_TEST_EVENT_CODE= # Optional: set to test code during Meta Events Manager testing META_QUALIFIED_ORDER_STATUS=delivered META_ATTRIBUTION_MODEL=first_paid_touch ``` --- ๐Ÿš€ How to Integrate into Your Laravel Models & Views ------------------------------------------------------- [](#-how-to-integrate-into-your-laravel-models--views) ### 1. Register Middleware [](#1-register-middleware) In Laravel 11+: Add `CaptureMetaAttributionMiddleware` in `bootstrap/app.php`: ``` use RsmMonaem\MetaAdsAttribution\Middleware\CaptureMetaAttributionMiddleware; ->withMiddleware(function (Middleware $middleware) { $middleware->web(append: [ CaptureMetaAttributionMiddleware::class, ]); }) ``` In Laravel 10 or earlier: Add `CaptureMetaAttributionMiddleware::class` to `$middlewareGroups['web']` in `app/Http/Kernel.php`. ### 2. Attach Trait to Your Order Model [](#2-attach-trait-to-your-order-model) Add `HasMetaAttribution` to any Order Eloquent model (`App\Models\Order`, `Lunar\Models\Order`, etc.): ``` namespace App\Models; use Illuminate\Database\Eloquent\Model; use RsmMonaem\MetaAdsAttribution\Traits\HasMetaAttribution; class Order extends Model { use HasMetaAttribution; } ``` ### 3. Add `@metaPixel` to Your Blade Layout `` [](#3-add-metapixel-to-your-blade-layout-head) In your main `resources/views/layouts/app.blade.php`: ``` My Store @metaPixel ``` --- ๐Ÿ“Š Admin Dashboard ----------------- [](#-admin-dashboard) Access the built-in attribution & CAPI audit log dashboard at: `https://yourdomain.com/admin/meta-attribution` Features: - Real-time Meta traffic, session, order, and revenue metrics. - Campaign breakdown by `utm_campaign`. - Conversions API audit log with status badges (`sent`, `failed`, `pending`). - One-click **Retry** button for failed API requests. --- ๐Ÿงช Testing --------- [](#-testing) Run the automated PHPUnit / Pest test suite: ``` php artisan test ``` --- ๐Ÿ“„ License --------- [](#-license) The MIT License (MIT). Please see [LICENSE](LICENSE) for more information. ### Health Score 39 โ€” LowBetter than 84% of packages Maintenance100 Actively maintained with recent releases Popularity0 Limited adoption so far Community2 Small or concentrated contributor base Maturity45 Maturing project, gaining track record 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 Unknown Total 1 Last Release 0d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/72827332?v=4)[MOHAMMAD MUNAYAM SOWDAGOR](/maintainers/rsmmonaem)[@rsmmonaem](https://github.com/rsmmonaem) --- Tags laravelfacebookecommercemetaattributionconversions-apicapifacebook pixelutm-trackingfbcliddelivered-order-conversions ### Embed Badge ![Health badge](/badges/rsmmonaem-laravel-meta-ads-attribution/health.svg) ``` [![Health](https://phpackages.com/badges/rsmmonaem-laravel-meta-ads-attribution/health.svg)](https://phpackages.com/packages/rsmmonaem-laravel-meta-ads-attribution) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3345.4M354](/packages/psalm-plugin-laravel)[laravel/scout Laravel Scout provides a driver based solution to searching your Eloquent models. 1.7k57.2M687](/packages/laravel-scout)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9922.4M147](/packages/roots-acorn)[simplestats-io/laravel-client Server-side analytics for Laravel that follows the full funnel from visit to registration to payment, attributed to the channel that drove it. Revenue, MRR, churn and ad-spend profit (ROAS/CAC) per channel. GDPR compliant, ad-blocker proof. 5226.7k](/packages/simplestats-io-laravel-client)[api-platform/laravel API Platform support for Laravel 58190.1k21](/packages/api-platform-laravel)[flat3/lodata OData v4.01 Producer for Laravel 100357.6k](/packages/flat3-lodata) PHPackages ยฉ 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)