Release Notes
Back to All
Added

March 2026

April 11th, 2026

Product update

  • Campaign Metadata in Ad Response — Campaign Metadata in Ad Response — Campaign metadata (e.g., ad operation type, alias) can now be returned in ad decision responses. Allows API customers to store their internal information about a Campaign and easily retrieve that information through Ad responses. For example, it enables checking whether a campaign is a managed campaign created by the ad ops team or a self-serve campaign created via API.
  • Max Sales ROAS Range Control — Platforms can now define a ROAS range (min–max) for MaxSales campaigns, addressing the lack of clear ROAS targeting for advertisers. The system dynamically adjusts auction pressure to target ROAS within this range — designed to deliver more predictable outcomes, driving adoption, and allowing campaigns to scale.
  • Smart Selection V2 - Brand, Category & On-Sale Filters + SKU Exclusions — The Smart Selection engine now supports inclusion filters for brand, category, and on_sale status, along with SKU-level exclusions. These fields are available in both the Campaign Manager UI and on the Management API endpoints and let advertisers scope automated item selection to specific catalog slices — for example, promoting only on-sale items within a single brand — without losing "set and forget" automation.

ML changes

  • New Search Relevance Improvements — Upgraded the internal framework that evaluates how well sponsored ads match shopper search queries and their true intents. The new framework assesses relevance across multiple dimensions of a query, expanding beyond just a single-faceted judgment. The framework also incorporates platform-specific context to better reflect each platform's unique catalog and shopper behavior. This enables more accurate relevance assessments, faster diagnosis of edge cases, and more fine-grained per-platform tuning. It also lays the foundation for progressively deeper integration of relevance signals into ad serving.

API changes

  • Decision API
    • DecideAdReservedDisplay — New endpoint POST .../reserved-display-ads. Request reserved display ads for an inventory. Supports custom key-value targeting in the request.
    • DecideAdBrands, DecideAdDisplay, DecideAdProducts — New response_setting request field to control which campaign_metadata fields are returned in the response.
    • DecideAdBrands, DecideAdDisplay, DecideAdProducts — New campaign_metadata in auction results (ad_operation_type, alias).
  • Management API
    • Reserved Display
      • UpsertOrderWithLineItems — New endpoint POST .../orders-with-line-items. Create or update an order with its line items in a single atomic operation. Line items support frequency_cappings and targeting.
      • ReadOrder — New endpoint GET .../orders/order_id. Read order information with line items.
      • QueryLineItemDailySummary — New endpoint POST .../orders/order_id/line-items/line_item_id/daily-report. Retrieve daily summary reports for a line item. Report rows include click_count.
      • ListReservedDisplayInventories — New endpoint GET .../reserved-display-inventories. List available reserved display inventories for a platform.
      • QueryReservedInventoryForecast — New endpoint POST .../reserved-display-inventories/inventory_id/forecast. Forecast reserved inventory availability.
    • Custom Targeting
      • QueryCustomTargetKeys — New endpoint POST .../custom-target-keys. Query custom target keys for a platform.
      • QueryCustomTargetValues — New endpoint POST .../custom-target-keys/id/custom-target-values.
      • Query values for a custom target key.
    • Campaign
      • CreateCampaign, UpdateCampaign, ReadCampaign — New ad_operation_type, alias, and smart_selection_setting fields on campaigns.
    • Intelligence
      • ReadCampaignForecast — New item_selection_type and smart_selection_setting fields on campaign item options.
      • ReadItemBasedCampaignGuidance — New endpoint POST .../item-based-campaign-guidances. Get item-based guidance recommendations for campaign optimization based on item performance analysis.
      • Removed several NO_GUIDED_MESSAGE_* enum values from GuidedMessageType (e.g., NO_GUIDED_MESSAGE_NO_SPENDING, NO_GUIDED_MESSAGE_NO_CLICK, etc.).
  • Data Export
    • RotateDataExportKey — New endpoint POST .../data-export/key. Rotates the data export key; previous keys are deleted. Returns new HMAC credentials (key_id, key_secret).