MAHMOUD ABDELNABY
Media Buying · CLI SCRIPT · 2

Ad Creative Naming Taxonomy Governance & Linter

Eliminate chaotic ad names, fix broken creative dashboards, and automate naming governance across Meta, TikTok, and Google Ads.

Problem it addresses

Build an ad naming governance and validation toolkit: 1) Universal ad naming taxonomy specification ([Channel]_[Objective]_[Audience]_[Angle]_[Format]_[Date]), 2) Pure Python linter script (taxonomy_linter.py) that audits CSV ad exports and flags invalid names, 3) Interactive Excel/Sheets formula generator for building valid names, 4) Integration guide for automated Slack/Discord notifications.

Who it is for

PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

What is inside

Key files listed in the README repository architecture:

  • config/taxonomy_rules.json
  • examples/ad_names_sample.csv
  • examples/valid_and_invalid_campaigns.csv
  • LICENSE
  • README.md
  • reports/validation_errors.csv
  • spec/universal-taxonomy-spec.md
  • src/naming_validator.py
  • src/taxonomy_linter.py
  • templates/formula-builder.md
  • tests/test_linter.py
  • tests/test_naming.py

How to evaluate and use it

  1. Read the README first and confirm that the documented problem matches your use case.
  2. Inspect the listed files to find the data, tools, templates, and tests relevant to your task.
  3. Follow the repository’s Quick Start and check prerequisites before running commands.
  4. Compare outputs with documented examples and review limitations before using them in a decision or client workflow.

Quick Start from the README: python -m unittest discover -s tests · python src/naming_validator.py --help

Scope and limitations

  • Delimiter Parsing Consistency: Standardizes double-underscore or pipe delimiters across Meta, Google, and TikTok naming conventions.
  • Token Integrity: Enforces required fields (Geo, Funnel Stage, Objective, Creator Handle, Angle, Format, Aspect Ratio).
  • Automated ETL Cleanliness: Validated names ensure clean dimension splitting in BigQuery and Looker Studio dashboards without messy regex overrides.

This page summarizes the available documentation; it does not establish performance or business results. Verify data and prerequisites before use.

Related repositories