Changelog
Updates, improvements, and new features for Aetra.
Rokt Conversions API Support
We’ve added support for the Rokt Conversions API, enabling attribution tracking for Rokt campaigns.
What’s New
- Rokt Tracking ID (
rtid): Automatically captures thertidparameter from landing page URLs and stores it for conversion attribution - Integration Passthrough: If
rtidis already included on Segment’sintegrationsobject under “Rokt Conversions API”, the existing value is preserved - Fallback Generation: When
rtidisn’t present in the integration data, it’s extracted from the page’s query parameters automatically
Enhanced Integrations Support
We’ve added support for storing integration-specific data from your analytics events, enabling better attribution tracking across advertising platforms.
What’s New
- Google Ads Session Attributes: Automatically captures and stores
session_attributes_encodedfor Google Enhanced Conversions when included on Segment’sintegrationsobject- If
session_attributes_encodedisn’t included, it is generated from the landing page URL, referrer, user agent, and session timestamp - In scenarios where the
gclidor hashed user-provided data is not available, this improves conversion measurement
- If
- Reddit Conversions API: Stores
uuidandclick_idwhen included on Segment’s Reddit integration data for improved conversion tracking
Analytics API
We’ve migrated our dashboard analytics to a dedicated API endpoint. This update improves how we handle analytics data, giving you quicker access to detailed metrics about your spaces.
What’s New
- Aggregated Metrics: View daily summaries of events (like tracks, identifies, and pages) and profile activities
- Detailed Counts: Get specific numbers for received events, enriched data, profile creations, and updates
- Flexible Querying: Support for custom date ranges and timezones
Your dashboard now uses this new API automatically, so you’ll notice improved speed and more comprehensive insights right away.
Billing
Aetra now supports a full Stripe integration with secure checkout sessions, subscription management, and automated billing workflows.
Features
- Self-Service Customer Portal: Built-in Stripe Customer Portal integration allowing users to update payment methods, change plans, cancel subscriptions, and access billing history without admin intervention
- Flexible Subscription Plans: Support for multiple pricing tiers with both monthly and annual billing intervals, including trial periods and promotional codes
Teams
The dashboard now supports multiple users. Workspace owners can invite team members to join their workspace and users can be members on multiple workspaces at the same time.
Features
- Multi-User Dashboard: The dashboard now supports multiple users with role-based access control
- Team Invitations: Workspace owners can invite team members to join their workspace with granular permissions
- Cross-Workspace Membership: Users can be members of multiple workspaces simultaneously, enabling seamless collaboration across different projects and organizations
- Workspace-Based Permissions: Team members inherit appropriate access levels based on their workspace membership and assigned roles
API
This release marks a major milestone in the development of Aetra by introducing a complete API solution that combines the power of Segment’s event tracking with advanced ad network attribution capabilities. Built for scale on Cloudflare’s edge infrastructure, the API offers a direct integration with Segment as a supported destination, Analytics.js compatible endpoints, and a webook detination supporting HMAC authenication.
Core Engine
- Segment-Compatible Event Tracking: Full support for Segment event types (track, identify, page, screen)
- Dual API Endpoints: Supports both individual event type endpoints and a unified endpoint for the Segment destination and webhooks
- Real-time Processing: Built on Cloudflare Workers for global edge processing with minimal latency
Advanced Profile Management
- Durable Object Storage: Persistent user profiles with 90-day automatic expiration
- Deterministic Identity Resolution: Automatic linking of anonymous user profiles You.with identified users to a single profile
- Profile Enrichment API: Intelligent event enrichment using historical user data
- Profile Lookup API: Direct access to user profiles for debugging and analysis
- Smart Data Merging: Sophisticated timestamp-aware merging logic for handling out-of-order events
- Trait Normalization: Automatic normalization of user traits across different naming conventions
Multi-Channel Attribution
- 9 Ad Network Integrations: Automatic click ID detection and collection for:
- Google Ads (gclid, gbraid, wbraid)
- Meta/Facebook (fbclid)
- Microsoft Ads (msclkid)
- LinkedIn (li_fat_id)
- TikTok (ttclid)
- Pinterest (epik)
- Reddit (rdt_cid)
- Snapchat (sccid)
- Impact (irclickid)
- Plugin Architecture: Extensible system for adding new ad networks
- Smart Campaign Tracking: Intelligent handling of UTM parameters and campaign data
Enterprise Security
- JWT Authentication: Secure admin API access with JWT token validation
- HMAC Signature Verification: Optional request signing for enhanced security
- Multi-Token Support: Granular API access control with named tokens
- Space-Based Authorization: Workspace-level permissions and access control
Admin & Management
- Space Management: Create, configure, and manage analytics spaces
- Token Lifecycle: Generate, list, and revoke API access tokens
- Settings API: Dynamic configuration updates without redeployment
- Analytics Dashboard: Built-in usage analytics and monitoring
Performance & Reliability
- Edge Computing: Deployed on Cloudflare Workers for global distribution
- Automatic Scaling: Handles traffic spikes without configuration
- Built-in Analytics: Real-time API usage tracking and monitoring
- Data Retention: Automatic 90-day profile expiration with alarm-based cleanup
Developer Experience
- Comprehensive Validation: Request validation with detailed error messages
- Test Suite: Comprehensive test coverage with Vitest and Cloudflare Workers testing