To help you further understand the DISPL Ads External DSP API, another crucial JSON structure is the Industry Category Configuration.

When creating a campaign, the industry object is required to ensure your advertisements are contextually aligned with the environment where they will be displayed¹¹¹. This example demonstrates how to correctly format industry categories using the two supported taxonomy versions².

Example: Industry Category Payloads

This JSON object is a subset of the larger campaign creation request³.

Using IAB Content Category Taxonomy 1.0 (Version 1):

{
  "industry": {
    "version": 1,
    "id": "IAB1"
  }
}

Using IAB Content Category Taxonomy 2.0 (Version 2):

{
  "industry": {
    "version": 2,
    "id": "248"
  }
}

Why This Example is Important for Learning

• Contextual Relevance: Many inventory providers (SSPs) use these categories to filter which ads are allowed on their screens⁴. If you do not specify a category or use an incorrect ID, your campaign might be automatically filtered out of certain networks.

• Taxonomy Versions: The API supports both Version 1.0 and Version 2.0 of the IAB Content Category Taxonomy⁵. Before launching a campaign, you should clarify with your inventory provider which version they use to ensure compatibility⁶.

• Verification Requirements: To pass the mandatory audit (Step 10 of the general procedure), your industry category must be accurately defined so the SSP moderator can review the application against the specific hardware locations⁷⁷⁷.

• Example IDs:

  • "IAB1" in Version 1 typically represents Arts & Entertainment⁸.

  • "248" in Version 2 typically represents Arts and Crafts⁹.

Understanding this small but vital JSON object ensures that your programmatic campaign requests are compliant with industry standards and the specific rules of the advertising networks you are targeting.