Services

use ArtisanPackUI\Analytics\Services\AnalyticsQuery;
use ArtisanPackUI\Analytics\Data\DateRange;

$query = app(AnalyticsQuery::class);
$range = DateRange::last30Days();

$stats = $query->getStats($range, $withCompare = true, $filters = []);

// Returns:
[
    'pageviews' => 1234,
    'visitors' => 567,
    'sessions' => 890,
    'bounce_rate' => 45.5,
    'avg_session_duration' => 180,
    'pages_per_session' => 2.3,
    'comparison' => [
        'pageviews' => ['value' => 1100, 'change' => 12.2],
        // ...
    ],
]

$pageViews = $query->getPageViews($range, $granularity = 'day', $filters = []);

// Returns Collection:
[
    ['date' => '2024-01-01', 'pageviews' => 100, 'visitors' => 80],
    ['date' => '2024-01-02', 'pageviews' => 150, 'visitors' => 90],
    // ...
]

$count = $query->getVisitors($range, $filters = []);
// Returns: int

$topPages = $query->getTopPages($range, $limit = 10, $filters = []);

// Returns Collection:
[
    ['path' => '/products', 'title' => 'Products', 'views' => 500, 'unique_views' => 350],
    // ...
]

$sources = $query->getTrafficSources($range, $limit = 10, $filters = []);

// Returns Collection:
[
    ['source' => 'google', 'medium' => 'organic', 'sessions' => 450, 'percentage' => 25.5],
    // ...
]

$devices = $query->getDeviceBreakdown($range, $filters = []);

// Returns Collection:
[
    ['device' => 'desktop', 'sessions' => 600, 'percentage' => 60],
    ['device' => 'mobile', 'sessions' => 350, 'percentage' => 35],
    ['device' => 'tablet', 'sessions' => 50, 'percentage' => 5],
]

$browsers = $query->getBrowserBreakdown($range, $limit = 10, $filters = []);

$countries = $query->getCountryBreakdown($range, $limit = 10, $filters = []);

$realtime = $query->getRealtime($minutes = 5);

// Returns:
[
    'active_visitors' => 23,
    'active_pages' => [...],
    'sources' => [...],
    'devices' => [...],
]

use ArtisanPackUI\Analytics\Services\TrackingService;
use ArtisanPackUI\Analytics\Data\PageViewData;
use ArtisanPackUI\Analytics\Data\EventData;

$service = app(TrackingService::class);

$pageViewData = new PageViewData(
    path: '/products',
    title: 'Products',
);

$service->trackPageView($pageViewData);

$eventData = new EventData(
    name: 'purchase',
    properties: ['product_id' => 123],
    value: 99.99,
    category: 'ecommerce',
);

$service->trackEvent($eventData);

if ($service->canTrack()) {
    // Proceed with tracking
}

use ArtisanPackUI\Analytics\Services\SessionManager;

$sessionManager = app(SessionManager::class);

$session = $sessionManager->startSession($sessionData);

$session = $sessionManager->getSession($sessionId);

$sessionManager->endSession($sessionId);

$sessionManager->extendSession($sessionId);

$isActive = $sessionManager->isSessionActive($sessionId);

use ArtisanPackUI\Analytics\Services\ConsentService;

$consentService = app(ConsentService::class);

$hasConsent = $consentService->hasConsent($fingerprint, 'analytics');

$consentService->grantConsent($fingerprint, ['analytics', 'marketing']);

$consentService->revokeConsent($fingerprint, ['marketing']);

$status = $consentService->getConsentStatus($fingerprint);

// Returns:
[
    'analytics' => ['granted' => true, 'granted_at' => '2024-01-01 12:00:00'],
    'marketing' => ['granted' => false, 'revoked_at' => '2024-01-02 10:00:00'],
]

use ArtisanPackUI\Analytics\Services\TenantManager;

$tenantManager = app(TenantManager::class);

$site = $tenantManager->currentSite();

$tenantId = $tenantManager->currentTenantId();

$tenantManager->setSite($site);

$site = $tenantManager->resolveSite($request);

use ArtisanPackUI\Analytics\Services\GoalService;

$goalService = app(GoalService::class);

$goalService->checkGoals($pageView);

$goalService->recordConversion($goal, $session, $value);

$data = $exportService->exportVisitorData($visitorId);

$deletionService->deleteVisitorData($visitorId);

$deletionService->deleteOldData($days = 90);