knowledge/manifest.json

{
  "version": "0.1.0",
  "description": "Realize advertiser knowledge base — topic index. Encodes Realize advertiser best practices.",
  "pathConvention": "Every topic.path is relative to the directory containing this manifest file (i.e., the /knowledge directory).",
  "topics": [
    {
      "slug": "bidding",
      "title": "Bidding",
      "path": "bidding.md",
      "tags": [
        "bidding",
        "bid strategy",
        "CPA",
        "Target CPA",
        "Enhanced CPC",
        "Maximize Conversions",
        "Fixed Bid",
        "learning phase",
        "learning period guard",
        "bid levers",
        "no per-item bidding",
        "publisher bid boost",
        "CPA volatility",
        "high CPA",
        "fluctuating CPA",
        "scaling bids"
      ],
      "description": "Bidding strategy selection, learning phase + learning-period guard, CPA troubleshooting, scaling adjustments, and the bid-levers matrix (what's valid at campaign / publisher / item level for each strategy)."
    },
    {
      "slug": "tracking",
      "title": "Tracking",
      "path": "tracking.md",
      "tags": [
        "tracking",
        "Taboola Pixel",
        "S2S",
        "server to server",
        "conversion events",
        "conversion tracking",
        "ROAS",
        "UTM",
        "tracking parameters",
        "click ID",
        "GTM",
        "Google Tag Manager",
        "attribution"
      ],
      "description": "Tracking-method selection (pixel vs S2S), conversion-event strategy, ROAS tracking, parameters, and debugging. Does not cover platform install steps (web-fallback lookup) or live rule state (MCP). Live pixel diagnosis (is it firing on a page, why aren’t conversions tracking) routes to the diagnose-tracking skill, not this file."
    },
    {
      "slug": "targeting",
      "title": "Targeting",
      "path": "targeting.md",
      "tags": [
        "targeting",
        "audience segments",
        "Taboola First Party Audiences",
        "geo targeting",
        "platform targeting",
        "contextual targeting",
        "predictive audiences",
        "retargeting",
        "pixel retargeting",
        "CRM retargeting",
        "pixel vs CRM",
        "audience expansion",
        "scheduling",
        "dayparting",
        "narrow targeting",
        "narrow targeting diagnostic",
        "reach estimator",
        "6-dimension priority",
        "Tier 1 regions",
        "non-Tier-1",
        "market availability",
        "small markets"
      ],
      "description": "Audience strategy, geo / platform targeting, expansion playbook, retargeting, predictive audiences, and the 6-dimension narrow-targeting diagnostic."
    },
    {
      "slug": "creative",
      "title": "Creative",
      "path": "creative.md",
      "tags": [
        "creative",
        "Sponsored Content",
        "display ads",
        "thumbnails",
        "titles",
        "headlines",
        "motion ads",
        "video",
        "Gen AI AdMaker",
        "landing page",
        "landing pages",
        "creative review",
        "creative testing",
        "creative fatigue",
        "social importer"
      ],
      "description": "Sponsored Content ads, display ads (overview), Gen AI AdMaker, landing pages, creative review process, creative testing, and creative fatigue. For Display item payload shape (3P `ad_tag` vs 1P `asset_url` + `dimensions`), see `targeting.md` → 'Native vs Display creative type'."
    },
    {
      "slug": "budget",
      "title": "Budget",
      "path": "budget.md",
      "tags": [
        "budget",
        "daily budget",
        "total budget",
        "10X rule",
        "budget pacing",
        "underspending",
        "overspending",
        "scaling budget",
        "short-burst",
        "flight dates",
        "depletion investigation",
        "cross-period comparison",
        "percent share"
      ],
      "description": "Budget planning, the 10× CPA rule, pacing, scaling, short-burst campaigns, depletion-miss investigation, and cross-period comparison rule (% share + Δ pp)."
    },
    {
      "slug": "campaign-structure",
      "title": "Campaign Structure",
      "path": "campaign-structure.md",
      "tags": [
        "campaign structure",
        "Campaign Groups",
        "campaign objectives",
        "campaign types",
        "Sponsored Content vs display",
        "campaign hierarchy",
        "Budget Distributor",
        "budget allocator",
        "Realize+",
        "Realize+ beta",
        "Realize Plus",
        "platform split",
        "device split",
        "Native vs Display lock-in",
        "cross-period comparison",
        "percent share",
        "delta pp"
      ],
      "description": "Campaign Groups, objectives, campaign types (Sponsored Content / Display) including the Native-vs-Display lock-in and the two MCP paths (CPC + first-item / VCPM), hierarchy, platform/device splits, and cross-period comparison of structural splits in % share."
    },
    {
      "slug": "brand-safety",
      "title": "Brand Safety",
      "path": "brand-safety.md",
      "tags": [
        "brand safety",
        "DoubleVerify",
        "DV",
        "IAS",
        "Integral Ad Science",
        "category exclusions",
        "keyword exclusions",
        "supply quality",
        "third-party tags",
        "verification"
      ],
      "description": "Native safety tools, DV / IAS integration, topic exclusions, and placement complaints."
    },
    {
      "slug": "custom-rules",
      "title": "Custom Rules",
      "path": "custom-rules.md",
      "tags": [
        "Custom Rules",
        "SpendGuard",
        "automated rules",
        "publisher rules",
        "time-based rules",
        "CPA cap",
        "spend cap",
        "auto-pause",
        "rule thresholds",
        "data sufficiency"
      ],
      "description": "SpendGuard, Custom Rules, time-based rules, configuration best practices, and do's and don'ts."
    },
    {
      "slug": "site-management",
      "title": "Site Management",
      "path": "site-management.md",
      "tags": [
        "site management",
        "publisher management",
        "publisher blocking",
        "publisher performance",
        "approved list",
        "whitelist",
        "block list",
        "site targeting",
        "publisher CPA",
        "historical block guard",
        "block attribution"
      ],
      "description": "Publisher performance monitoring, blocking decisions with the historical-top-N block guard, approved-list dynamics, block-attribution families (rule / targeting / bid loss), and cross-cutting CPA / CVR diagnosis."
    },
    {
      "slug": "environments",
      "title": "Environments",
      "path": "environments.md",
      "tags": [
        "environments",
        "placements",
        "Mail",
        "Apple News",
        "Lockscreen",
        "environment expansion",
        "inventory"
      ],
      "description": "Environment overview and expansion strategy across Mail, Apple News, and Lockscreen inventory."
    },
    {
      "slug": "reach-estimation",
      "title": "Reach Estimation",
      "path": "reach-estimation.md",
      "tags": [
        "reach",
        "reach estimator",
        "reach estimation",
        "campaign-level reach",
        "audience size",
        "narrow targeting",
        "lower bound",
        "get_campaign_reach_estimate"
      ],
      "description": "Campaign-level reach via `mcp__realize-mcp__get_campaign_reach_estimate` (never per-publisher). Inputs, outputs, IMPRESSIONS cap handling, narrow-targeting routing into the 6-dimension diagnostic in `targeting.md`."
    },
    {
      "slug": "reporting-aggregation",
      "title": "Reporting & Aggregation Discipline",
      "path": "reporting-aggregation.md",
      "tags": [
        "reporting",
        "aggregation",
        "pagination",
        "MCP report",
        "site breakdown",
        "campaign grain",
        "dynamic report",
        "sum reconciliation",
        "data accuracy",
        "Grain header",
        "short page",
        "Records header",
        "page_size",
        "get_campaign_breakdown_report",
        "campaign breakdown report",
        "GROUP account",
        "admin network",
        "403",
        "account type routing",
        "grand Total",
        "record count",
        "visible impressions",
        "served ads",
        "CTR basis"
      ],
      "description": "Pagination discipline + sum-reconciliation gate for every MCP-report-based answer. Codifies the rule that aggregating page 1 of a paginated report is a silent failure mode that understates spend on long-tail breakdowns. Mandatory read for any reporting / optimization question."
    }
  ]
}