Adform Frequency Cap Audit

Adform frequency cap audit

Retrieves frequency and impression capping settings for line items under an order or campaign and compares them against campaign-level capping or a brief, flagging mismatches that could cause over-exposure. Read-only.

Connection & tooling

Runs on the Adform GraphQL MCP. Use graphql_execute to run queries. Use graphql_introspect on RtbLineItemCapping, RtbLineItemFrequencyCapping, and CampaignRtbSettings to discover the current field shapes for capping sub-objects. Keep calls sequential (~1–2s apart).

---

Step 1 — List line items

{
  rtbLineItems(
    orderIds: ["67890"]
    offset: 0
    limit: 20
  ) {
    lineItems { id name environments orderId campaignId paused deleted }
    totalCount
  }
}

Step 2 — Get line item capping detail

The id is the RTB setup ID returned by rtbLineItems(), not the placement ID.

{ rtbLineItem(id: "99999") { id impressionCappings { frequency { impressions } } } }

Use graphql_introspect on RtbLineItemCapping and RtbLineItemFrequencyCapping to confirm available fields — the impressions value is the cap limit.

A line item with an empty impressionCappings list has no frequency capping applied.

Step 3 — Get campaign-level cap for comparison

{
  campaignRtbSettings(id: "3993873") {
    capping {
      type
      impressions
      period { type duration }
      viewability { type duration }
    }
  }
}

---

Method

1. Read each line item's cap limit from impressionCappings[].frequency.impressions
2. Compare each limit against the campaign cap and the brief value (e.g. "3 impressions per user")
3. Flag: missing cap where one is required, a higher limit than the brief specifies, or no

capping at all where the brief mandates one

Presenting

Table of line items: name, cap limit (impressions), expected from the brief, and a PASS or FLAG verdict with the reason. Summarise how many are non-compliant and the over-exposure risk. For deeper line-item context use adform-line-items; for campaign config use adform-campaign-management.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: adform
• Source: adform/agentic-skills
• License: MIT
• Homepage: https://site.adform.com

Install and usage instructions live in the source repository linked above.