🎯

Scope

Full Stack Production Microservice

Overview

Scope is a full-stack ad channel monitoring application that integrates with the YouTube API and Google Ads API to track where brand ads are being shown. Based on configurable audience targeting rules, it identifies channels that fall outside the defined target audience and automatically excludes them from future placements.

The system gives marketing teams operational control over ad placement at scale — replacing a largely manual review process with automated data collection, rule evaluation, and Google Ads API operations.

Ad placement monitoring & channel exclusion flow

Features

API for receiving operations requests from marketing departments
Internal UI to review channel placement data and submit audience targeting rule changes
Background workers that continuously collect data from the Google Ads and YouTube APIs
Automated channel exclusion operations via the Google Ads API based on configured rules

Architecture

Part of a broader microservices ecosystem. Scope operates as an independent monitoring service — ingesting data from ad platforms and applying targeting rules without depending on other internal services.

Frontend

Internal UI for the marketing team to review channel placement data, inspect flagged channels, and configure audience targeting rules.

API

Handles frontend requests and exposes endpoints for rule configuration, channel review, and triggering manual operations against the Google Ads API.

Workers

Custom background workers collect channel and campaign data from YouTube and Google Ads on a schedule, then evaluate placement against targeting rules.

Database

PostgreSQL stores channel records, targeting rules, placement history, and exclusion logs for reporting and auditing.

Tech Stack

Frontend

Next.js React Tailwind CSS shadcn/ui

Backend

TypeScript Node.js PostgreSQL Docker GCP

APIs

Google Ads API YouTube API

← 🛡️ Shield 🎫 Resolve →