Release Notes
Back to All
Added

August 2026

September 10th, 2026

Product update

  • Search-filtered retrieval expansion for Sponsored Brands (SB) - Sponsored Brands ads now go through the same search relevance filtering as Sponsored Products, so every item shown in an SB ad can be guaranteed to match the shopper's search query depending on the configuration. Two new configuration options control the minimum number of relevant items per ad and whether lower-relevance items can backfill under-filled placements, balancing relevance, fill rate, and latency for each platform's needs.
  • Demand Agent API & Webhook - Demand Agent lifecycle-trigger recommendations, previously available only through the MCM portal, are now available via the ListCampaignRecommendations API endpoint and a new webhook service. Platforms with their own portal or notification system can now surface one-click campaign recommendations, budget upsell alerts, and churn re-engagement prompts on their own.
  • Campaign-level Credit - Platforms can now issue credit ring-fenced to specific campaigns and time-boxed with an optional expiration date, instead of only a non-expiring, account-wide lump sum. Credit is available standalone or alongside Spend Cap V2. When used alone, credit doesn’t impact ad serving but accrues usage as ad spend occurs; when used with Spend Cap, a campaign automatically stops once both its credit and spend cap are exhausted.

API changes

  • Decision Public API
    • Description changes
      • The shared response_setting object on DecideAdBrands, DecideAdDisplay, and DecideAdProducts was split into per-ad-type objects, each with an ad-type-specific description. The public field shape is unchanged (response_setting.campaign_metadata_fields); DecideAdReservedDisplay is unaffected.
  • Management Public API
    • New APIs
      • ListExternalInventories - new endpoint (GET .../platforms/{platform_id}/inventories-external): lists a platform's Sponsored Ads inventories (ITEM, BRAND, DISPLAY only). Response inventories[] (id, title, ad_type, placement_id) with prev_cursor/next_cursor/total; request supports ad_types (empty defaults to ITEM + BRAND + DISPLAY), placement_id, cursor, and limit (default 15, max 50).
      • UpdateSpendCapCampaignAssignment - new endpoint (PUT .../spend-caps/{spend_cap_id}/campaign-assignments): sets which campaigns a spend cap applies to. Request campaign_ids and effective_from; response echoes both.
      • QuerySpendCapCampaignAssignments - new endpoint (POST on the same path): lists the campaigns assigned to a spend cap. Request effective_at, cursor, limit (default 10, max 50); response campaign_assignment_scope and assignments[] (assignment_id, spend_cap_id, campaign_id, effective_from, effective_to)`.
      • QueryCampaignSpendCapAssignments - new endpoint (POST .../campaigns/{campaign_id}/spend-cap-assignments): the inverse lookup - which spend caps apply to a given campaign. Request effective_at, purposes (filter by ADVERTISER_FUNDS/CREDITS), cursor, limit; response assignments[] (assignment_id, spend_cap_id, purpose, campaign_assignment_scope, effective_from, effective_to).
    • Field changes
      • The spend cap object (on CreateSpendCap, ReadSpendCap, ListSpendCaps, UpdateSpendCap) gains purpose (ADVERTISER_FUNDS or CREDITS), campaign_assignment_scope (SELECTED_CAMPAIGNS or ALL_CAMPAIGNS), and period (MONTHLY or TOTAL).
      • budget.period on CreateSpendCap/UpdateSpendCap now accepts only MONTHLY and TOTAL - DAILY and WEEKLY have been removed. This applies across all Spend Cap specs, not just campaign-level credit; integrations still sending DAILY or WEEKLY will break.
    • Description changes
      • QueryAdAccountSummary, QueryAdManagerAccountSummary, and QueryPlatformSummary - direct/indirect metric descriptions reworded for in-store attribution, and total, revenue_breakdown, roas_breakdown, and purchase_breakdown (previously undocumented) now describe the attribution components included per the platform's reporting configuration.
      • CreateSpendCap - budget.period description reworded to describe the MONTHLY/TOTAL cadence options.
  • Event Public API
    • No changes.

Documentation update

  • Platform - Clarified that Sponsored Product, Brand, and Display auction types can be configured as First-price or Second-price, with a link to the Auction and Pricing Model page for how ads are ranked and priced.
  • View-Through Attribution - New guide covering the seven View-Through (VT) data exports across four ad types and three targeting options, including schema, export paths, and how VT relates to Click-Through attribution.
  • Webhooks - New guide for the MCM webhook service, covering destination setup, signature verification, event payloads, and the budget-upsell and churn re-engagement events.
  • Ad inventories - Documented the six standardized inventory dimensions (page type, layout, OS, channel, country, sub-platform) you can now set on your inventory configuration to describe and compare inventories consistently.
  • Reserved Display - Updated to cover Cost-Per-Time (CPT) pricing alongside CPM, including line item setup, forecasting, and API support for CPT orders.
  • User Roles & Permissions - Documented that an agency account can be mapped to a maximum of 3,000 ad accounts, aligned with the Report API's ad_account_ids cap.
  • Quotas & Limits - Updated the Decision API limits table to reflect the generalized multi-inventory request limits across DecideAdProducts, DecideAdBrands, DecideAdDisplay, and DecideAdReservedDisplay.

Deprecated