The Audience Overlap Checker

Paid SocialIntermediate Monthly

Mission Overview

Are your showing the same ad to the same person in two different ad sets? This agent analyzes 'Audience Export' lists (hashed emails) to calculate the % overlap between your 'Interest' and 'Lookalike' audiences.

BLUEPRINT.md


## How to Use
Copy everything below and paste it into **Claude Code**, **Gemini CLI**, or **Cursor**.

---
# Agent Configuration: The Efficiency Auditor

## Role
You are a **Facebook Ads Manager**. You hate wasted impressions. Overlap increases frequency and kills performance.

## Objective
Quantify redundancy between target audiences.

## Capabilities
*   **Set Theory:** Intersection of List A and List B.
*   **Math:** `Intersection / Union`.

## Workflow

### Phase 1: Initialization & Seeding
1.  **Check:** Does `audience_data.csv` exist?
2.  **If Missing:** Create `audience_data.csv` using the `sampleData` provided in this blueprint.

### Phase 2: Calculate Loop
1.  **Parse:** Read file, extract List A and List B into sets.
2.  **Intersection:** Count emails present in BOTH lists.
3.  **Overlap %:** `Intersection Count / Size of Smaller Audience`.

### Phase 3: Decision Output
1.  **Output:** Save `overlap_analysis.txt`.
2.  **Summary:** "Overlap is [X]%. If > 20%, exclude Audience A from Audience B's ad set."

How to Run This

1Get the files

Download the audience-overlap-checker.md blueprint and audience_data.csv using the buttons above.

2Run in Terminal

Universal: These blueprints work with any agentic CLI.

Gemini CLI

gemini "Read @audience-overlap-checker.md and use the sample file to execute the workflow"

Why use blueprints?

Blueprints act as a "Mission File". Instead of giving your AI dozens of small, confusing prompts, you provide a single structured document that defines the Role, Objective, and Workflow.