Piano Analytics for Short URL

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

1. The Short URL module dispatches a ShortUrlVisitEvent on every redirect visit.
2. This module subscribes to that event, builds PA properties from the visit data, and calls ServerSideEventSender::queueEvent().
3. 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.