Skip to content

Targeted API ADRs

This directory contains architecture decision records for the Targeted API service.

Scope

The Targeted API provides player-specific offer targeting and filtering. ADRs cover:

  • API architecture and service design
  • Resource access patterns
  • Authentication mechanisms (including Cognito integration)
  • Targeting vs filtering strategies

Key Concepts

  • Targeting: Selecting offers based on inferred client information (device, location via HTTP hints)
  • Filtering: Retrieving offers based on explicit parameters provided by the client
  • Offer API - Upstream data source for offers
  • Player API - Player data and progress tracking
  • AdGem - Core platform that Targeted API serves