Piano Analytics for Short URL
Security covered
This module sends tracking data about short URL redirects to Piano Analytics. It records details like the destination URL and referrer without slowing down the redirect process, and respects user consent settings.
Sends Piano Analytics server-side events for Short URL redirect visits.
Features
- Non-blocking tracking: visit events are queued during the redirect and sent to the Piano Analytics Collection API after the response via
kernel.terminate. Zero impact on redirect latency. - Configurable event name: defaults to
page.display, configurable in the settings form. - Rich event properties: slug, destination URL, referrer, language, and domain (when Domain Short URL is installed).
- Consent-aware: respects the Piano Analytics opt-out cookie (
pa_consent_mode). - Enable/disable: toggle via settings form with automatic container rebuild.
How it works
- The Short URL module dispatches a
ShortUrlVisitEventon every redirect visit. - This module subscribes to that event, builds PA properties from the visit data, and calls
ServerSideEventSender::queueEvent(). - The base Piano Analytics module sends queued events in batch during
kernel.terminate(after the response).
Requirements
- Drupal 10.3+ or 11.2+
- Short URL (^2)
- Piano Analytics (^2.4)
Installation
composer require drupal/pianoanalytics_shorturl drush en pianoanalytics_shorturl
Configuration
Navigate to Short URL settings (/admin/config/shorturl/settings). The Piano Analytics section appears when this module is enabled. Configure the PA event name (default: page.display) and enable/disable tracking.