Download the PHP package mehdiyev-signal/pixel-manager without Composer
On this page you can find all versions of the php package mehdiyev-signal/pixel-manager. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package pixel-manager
Pixel Manager v2.0
A powerful, production-ready Laravel package for tracking and distributing customer events to multiple marketing platforms with enterprise-grade reliability and security.
๐ Version 2.0 - Complete rewrite with Domain-Driven Design, all bugs fixed, production-ready!
โจ Features
Core Features
- ๐ Multi-Platform Support: Meta, Google, Brevo, TikTok, Pinterest, Snapchat
- โก Asynchronous Processing: Queue-based event distribution
- ๐ฏ Event Mapping: Configure which platforms receive specific events
- ๐ MongoDB Logging: Track all events for analytics
- ๐ง Highly Configurable: Flexible configuration system
v2.0 New Features
- ๐๏ธ Domain-Driven Design: Clean, maintainable architecture
- ๐ AES-256 Encryption: Secure credential storage
- โป๏ธ Auto-Retry: Exponential backoff (3 attempts)
- ๐ก๏ธ Circuit Breaker: Prevents cascading failures
- ๐ฆ Rate Limiting: Protects against API limits
- ๐พ Smart Caching: 90% reduction in DB queries
- ๐ค Bot Detection: Filters out crawler traffic
- ๐ SHA256 Hashing: Privacy-compliant PII handling
- ๐ 33 Currencies: Including AZN (Azerbaijani Manat) ๐ฆ๐ฟ
- ๐ All Bugs Fixed: Meta, Google, Pinterest issues resolved
- ๐๏ธ SQL Support: MySQL, PostgreSQL, SQLite (in addition to MongoDB)
- ๐ง Extensible: Easy to add new platforms and events
Requirements
Core Requirements
- PHP 8.2 or higher
- Laravel 11.0 or higher
- Queue driver (Redis, Database, etc.)
Optional Dependencies (Based on Your Setup)
Choose ONE credential storage method:
- ENV Mode (Simplest): No extra dependencies needed โ
- SQL Mode: Uses Laravel's built-in database (MySQL/PostgreSQL/SQLite) โ
- MongoDB Mode: Requires
composer require mongodb/laravel-mongodb
Platform-Specific (Install only what you use):
- Meta/Facebook Pixel: Requires
composer require facebook/php-business-sdk - Other platforms (Google, TikTok, etc.): Work out of the box with Guzzle HTTP client โ
Note: Start with ENV mode for quick setup, upgrade to database mode when needed!
Installation
โก Quick Start (5 minutes - ENV Mode)
For simple setups without database configuration:
Add credentials to .env:
Done! See QUICK-START.md for details.
๐๏ธ MongoDB Mode Installation
๐พ SQL Mode Installation
๐ Full Installation
For multi-environment or advanced setups:
Upgrading from v1.x? See UPGRADE-2.0.md for migration guide.
Publish the configuration file:
Optionally, publish the migration files:
Configuration
Environment Variables
Add the following to your .env file:
Platform Credentials
Store your platform credentials in MongoDB's applications collection:
Event Mapping
Configure which platforms receive specific events in config/pixel-manager.php:
Usage
Basic Usage
Use the Facade to track events:
In a Controller
Check Platform Status
Supported Events
The package supports the following standard events:
| Event Type | Description | Platforms |
|---|---|---|
purchase |
Completed purchase | All |
add_to_cart |
Product added to cart | All |
view_item |
Product viewed | All |
begin_checkout |
Checkout started | All |
view_cart |
Shopping cart viewed | All |
search |
Search performed | All |
add_payment_info |
Payment info added | All |
add_to_wishlist |
Item added to wishlist | All |
page_view |
Page viewed | All |
completed_registration |
User registration | All |
subscription |
Subscription created | All |
customize_product |
Product customization | Meta only |
Platform-Specific Features
Meta Pixel
- Server-side event tracking
- Automatic user data hashing
- FBC/FBP tracking support
- Full Facebook Business SDK integration
Google Analytics 4
- Measurement Protocol v2
- Standard GA4 event names
- Rich e-commerce data
- Client ID and User ID support
Brevo
- Contact identification (email, WhatsApp, external ID)
- Contact properties tracking
- Event properties with cart data
- Real-time CRM updates
TikTok, Pinterest, Snapchat
- Server-side conversion tracking
- Product catalog integration
- Advanced event parameters
- Audience building support
Queue Configuration
The package uses Laravel's queue system for asynchronous processing. Make sure to configure your queue driver:
Run the queue worker:
Event Logging
All events are logged to MongoDB for analytics and debugging. Access logs through the CustomerEventModel:
Testing
Run the test suite:
With coverage:
Troubleshooting
Events Not Being Sent
- Check queue worker is running
- Verify platform credentials in MongoDB
- Check
storage/logs/laravel.logfor errors - Ensure event type is mapped in config
MongoDB Connection Issues
Platform-Specific Issues
Check individual platform action logs:
Getting Started
- โก Quick Start - Get started in 5 minutes without database
- ๐ APP_ID Guide - Understand application ID configuration
- ๐งช Testing Guide - Comprehensive testing documentation
Extensibility
Want to add a new platform, customize behavior, or override components? The package is fully extensible!
- Extensibility Guide - How to add new platforms, events, and decorators
- Override Guide - How to customize and override package behavior
- SQL Setup Guide - How to use SQL instead of MongoDB
The DDD architecture makes it easy to extend and override without modifying core code.
Security
If you discover any security-related issues, please email [email protected] instead of using the issue tracker.
Credits
- Saleh Mehdiyev
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
Changelog
Please see CHANGELOG for more information on what has changed recently.
Support
For support, please open an issue on GitHub Issues or contact [email protected].
All versions of pixel-manager with dependencies
illuminate/support Version ^11.0
illuminate/database Version ^11.0
illuminate/queue Version ^11.0
illuminate/events Version ^11.0
mongodb/laravel-mongodb Version ^4.0|^5.0
facebook/php-business-sdk Version ^9.0|^10.0|^11.0
guzzlehttp/guzzle Version ^7.9