Documentation / The Data / Taxonomies
Taxonomies
Compare your writing with standard category lists used by advertisers, publishers, and search engines.
What a taxonomy is
A taxonomy is a fixed list of categories, for example "Travel > Hotels". OppAlerts includes 11 standard taxonomies. It compares writing with every category in each taxonomy using semantic similarity.
The 11 taxonomies
google-ads-topics: Google Ads topics, 2,558 categories.google-merchant: Google Merchant product categories, 5,595 categories.iab-ad-product-taxonomy: IAB ad product taxonomy, 583 categories.iab-audience-taxonomy: IAB audience taxonomy, 1,558 categories.iab-content-taxonomy: IAB content taxonomy, 704 categories.iptc-media-topics: IPTC media topics, 1,084 categories.linkedin-industry-codes: LinkedIn industry codes, 424 categories.microsoft-advertising: Microsoft Advertising categories, 5,427 categories.census-naics: the US Census NAICS industries, 2,125 categories.soc: the SOC occupations, 1,447 categories.us-cities: US cities, 4,117 categories.
How the comparison works
- Your text is converted into a vector using the same model used for every category.
- OppAlerts compares the vector with every category and returns the nearest ones, with a similarity score.
- A strong match is usually in the 40s and 50s. Nothing reaches 90. Focus on the order and the gaps between results rather than the score alone.
- The score measures semantic similarity, not writing quality or keyword density.
Where you use them
- Content Optimizer: paste up to 8,192 bytes of writing, and pick up to three categories, one for each taxonomy. Each category is scored separately; the scores are never merged.
- A campaign's taxonomy presets, set on the Settings tab of Edit Campaign, populate the Content Optimizer for everyone on the account.
- MCP and the API:
taxonomy_taxonomieslists the taxonomies,taxonomy_categorieslists the categories of one taxonomy, andtaxonomy_semantic_content_analyzerreturns Content Optimizer results for text and 1 to 3 target categories. The Content Optimizer page uses these 3 tools.
Which taxonomy to use
- A product page: Google Merchant.
- An article: IAB Content or IPTC Media Topics.
- A page for one type of reader: IAB Audience or SOC occupations.
- A business or service page: NAICS or LinkedIn industry codes.
- A local service page: US cities. See How to Optimize Local Service Content.