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_taxonomies lists the taxonomies, taxonomy_categories lists the categories of one taxonomy, and taxonomy_semantic_content_analyzer returns 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.