Documentation

Documentation

SEA Marketing Dashboard

Internal documentation for the SwissActivities Search Engine Advertising platform.

Architecture

  • Astro SSR with React islands
  • Hono API with PostgreSQL + ClickHouse
  • Google Ads API v23 integration
  • BullMQ workers for async processing
  • Redis for caching and queue management

Key Concepts

  • Campaigns: Global V4 campaigns per locale/market + custom campaigns
  • Ad Groups: One per activity per campaign, auto-created from availability
  • RSAs: Responsive Search Ads with AI-generated headlines and descriptions
  • Keywords: AI-seeded, validated via Google Keyword Planner
  • Bookability: Ad groups ENABLED/PAUSED based on real-time availability