Aetra

Changelog

Updates, improvements, and new features for Aetra.

APIIntegrations

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 the rtid parameter from landing page URLs and stores it for conversion attribution
  • Integration Passthrough: If rtid is already included on Segment’s integrations object under “Rokt Conversions API”, the existing value is preserved
  • Fallback Generation: When rtid isn’t present in the integration data, it’s extracted from the page’s query parameters automatically
APIIntegrations

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_encoded for Google Enhanced Conversions when included on Segment’s integrations object
    • If session_attributes_encoded isn’t included, it is generated from the landing page URL, referrer, user agent, and session timestamp
    • In scenarios where the gclid or hashed user-provided data is not available, this improves conversion measurement
  • Reddit Conversions API: Stores uuid and click_id when included on Segment’s Reddit integration data for improved conversion tracking
AnalyticsDashboard

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.

BillingDashboard

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
Dashboard

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

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