Product update

  • New Video Ad format - this enables advertisers and platform partners to incorporate engaging video formats into their Sponsored Brands and Sponsored Display campaigns, further expanding our creative portfolio and supporting industry trends in retail media.
    • Video Format Support: Users can now upload, import, and serve video assets in addition to static images within the Sponsored Brands and Sponsored Display ad types.
    • Video Transcoding: Automatically transcode original video uploads (MP4) into multiple ready-to-serve formats (MP4 in 720p/360p, HLS), covering a range of devices, players, and network conditions. This enables seamless playback and removes technical barriers for customers lacking in-house transcoding capabilities.
    • Review & Approval: Campaign reviewers can preview video creatives directly within the review UX.

API update

  • Video Ads updates
    • Management API
      • CreateVideoAsset - Capability to upload the video resources
      • New CampaignStatus
        • PENDING state when the video in the campaign asset is in pending state due to the transcoding
    • Decision API
      • inventory.video from DecideAdBrands and DecideAdDisplay requests
        • Providing context of which video format that inventory would use
          • HLS (m3u8)
          • MP4_360P (360p mp4)
          • MP4_720P (720p mp4)
        • media_type, video_url and video_thumbnail_url in DecideAdBrands and DecideAdDisplay responses
          • In asset.banner 3 fields are added for the video response

Documentation update

Product updates

Predefined Audience

  • We added the ability to manually target campaigns using your own predefined audiences.
  • With predefined audiences, advertisers can search and select from a list of available audiences provided by the Platform. They can select up to 5 predefined audiences per campaign and combine them using AND(“all”) or OR(“any”) logic. This enables highly specific ad strategies to tailor your campaigns with particular customer segments you define.
  • Access to those audiences are managed using the new audience administration feature described below.

Audience Administration

  • This new interface within the MCM campaign manager now allows Platform Owners to manage which Ad Accounts can access their predefined audiences. Users can assign audience access using three modes: open to all accounts, manual per-account assignment, or full restriction. The feature also supports bulk operations for efficient access configuration. Only authorized Ad Accounts will see their assigned Audiences during campaign setup, providing additional data governance and control.

Wallet deduction cap (by balance)

  • This new feature gives platforms the ability to prevent wallet overdrafts by capping daily ad spend deductions to the wallet’s available balance. When enabled, advertisers are only charged up to their funded amount (including Credits and Pre-paid funds), and will never see a negative balance.
  • When enabled, the deduction logic applies the lesser of the daily ad spend or available balance (including Credits and Pre-paid funds). Negative balances are also suppressed from appearing in both the UI and API responses (ListWallets, QueryWallets), improving transparency for advertisers.
    • Reporting behavior remains unchanged: the full daily ad spend will continue to be reflected in both the reporting UI and Report API, regardless of the actual wallet deduction amount. This ensures accurate performance tracking while maintaining financial control through billing separation.
  • When disabled (default behavior), the system deducts the full daily ad spend regardless of wallet balance. This may result in negative wallet balances, which may appear in the UI and API responses.
  • This feature is now available as an opt-in configuration for platforms using Wallet.

Documentation update

Product Updates

Spending Limits V2

  • Spending Limits V2 introduces support for Credits within the post-payment system. This allows platforms to issue and manage ad credits, automating what was previously a manual process for platform ad operations teams.

Documentation update

New

Product Updates

Sponsored Brands

  • Multi-Ads Response: Sponsored Brands now support multiple ad responses from the single request using a brand ad inventory.

Smart Selection Forecasting

  • Smart Section now provides impression, click, and purchase forecasts. The forecasting capability provides advertisers with an estimate of their campaign performance, and allows advertisers to make informed decisions when making adjustments to campaign settings such as budget, bids and ROAS targets.
  • Added description improvements when using exclusion options for the UpdateCampaign and ReadCampaignForecast API.

Platform dashboard v1

  • The Platform Dashboard v1 is a new home for platform users, offering built-in reporting and analytics for essential metrics directly within the MCM portal. Tailored for platform users, it provides insights into key business indicators, such as Ad Spend/GMV, Advertiser and Item adoption rates, and Performance by Inventory or Category. Featuring a grid layout for enhanced data visualization and CSV download functionality, the new dashboard enables comprehensive reporting and informed decision-making.

API Changes

Sponsored Brands

  • Sponsored Brands now supports requesting multiple ads
  • Added num\_ads field in inventory of DecideAdBrands API

Documentation updates

Updated

API changes

Deprecated Campaign’s targeting.audience_setting.event_based field. Audience Targeting has been upgraded to offer more targeting criteria (Please refer to the public documentation on manual targeting). This was replaced by the more complete fields targeting.audience_setting.event_based_include_list and targeting.audience_setting.event_based_exclude_listoffering a much more granular targeting options.

Documentation updates

New

User Event error categories - An overview of error codes along with recommended actions.
https://mcm-docs.moloco.com/docs/user-event-api-error-categories

Updated

Audience Targeting - Enhanced options for segmentation and additional controls for campaign targeting.
https://mcm-docs.moloco.com/docs/advertisement-targeting#audience-targeting

Decision API filters - Added 11 filtering options to allow for customized ad targeting based on item attributes.
https://mcm-docs.moloco.com/docs/decision-api-filtering

Product updates

Audience Targeting

Audience targeting is a sophisticated feature that allows advertisers to build custom audiences and allocate budgets specifically to those audiences. The key advantage is its ability to accommodate a wide range of use cases, utilizing Event and Catalog metadata provided by the platform. Moloco can create audiences according to the attributes defined by the advertiser within the MCM Campaign Manager, enabling sophisticated targeting that serves ads only to the designated audience for that campaign.

Sponsored Brands Updates

Aspect Ratio-based image validation

  • Allows the platform to accept a range of image sizes by validating the aspect ratio and minimum width & height instead of enforcing users to use exact dimension for image uploads.

Ad Detail Reports

  • Provides each campaign’s item and asset level performance metrics which allows platform owners and advertisers more insight into their ad campaign performance.

Asset rejection email notifications

  • When an asset or landing page for a Sponsored Brands campaign is rejected during the review/approval process, the ad account owner is now notified via email. Notified users can click "Open Campaign" taking them directly to the "Edit Campaign" page where they can review the platform feedback and update the image assets or landing pages accordingly.

Updated Decision API filtering

The new filtering capabilities within the Decision API allow customer platforms to display ad items based on their catalog data. MCM has designed the Decision API to support a variety of UX scenarios on the platform side, enabling specific items to be shown to shoppers based on their preferences.

MCM supports the following 15 filtering criteria:

  • Category
  • Location
  • Brand
  • Delivery
  • Price
  • Sale_price
  • Rating
  • Review_count
  • Color
  • Gender
  • Size
  • Material
  • Pattern
  • Condition
  • Age_group

API changes

Sponsored Brands Updates

Added

  • DecideAdBrands API - New Decision API for use with Sponsored Brands
  • ImageAsset API - New API for creating and listing images used with Sponsored Brands campaigns.
  • CampaignReview API - New API for the Sponsored Brands campaign review system, used for approving or rejecting campaign components such as image assets or landing pages.

Updates

  • Sponsored Brands assets and landing_pages fields have been added to manage to the components of a Sponsored Brands campaign. See our guide for more details.
  • Smart Selection
    • Updated the Campaign API for Smart Selection. You may choose either MANUAL_SELECTION to select items manually in the campaign or SMART_SELECTION to let Moloco choose items automatically.
    • Added additional channel types to the Decision and Event API.
      • DESKTOP_SITE - Desktop Site (e.g. Desktop Website)
      • MOBILE_SITE- Mobile Site (e.g. Mobile Website)
    • Added Domain field to the Decision and Event API to identify the domain portion of your website's URL
    • Added Decision API filtering fields based on Catalog Feed data.

Documentation updates

New

Sponsored Brand - Added additional information for Sponsored Brands ad campaigns.
https://mcm-docs.moloco.com/docs/sponsored-brands-campaign-creation

Updated

MCM CLI tool v1.4.2 release - This version includes support for management API key-based authentication.
https://mcm-docs.moloco.com/docs/mcm-cli

Ad Serving and Tracking - Added examples for Sponsored Brands decision response.
https://mcm-docs.moloco.com/docs/ad-serving-and-tracking

Calling Trackers - Added information for Sponsored Brands impression tracking and click tracking
https://mcm-docs.moloco.com/docs/calling-trackers

Build-your-own Campaign Manager - Updates for Sponsored Brands management.
https://mcm-docs.moloco.com/docs/build-your-own-campaign-manager

Ad Campaign States - Updated information to include Sponsored Brands states and added
https://mcm-docs.moloco.com/docs/campaign-states

Product updates

Smart item selection

This feature allows advertisers to make their entire catalog of items to be eligible for advertising for the given campaign. Any new items that they add to the catalog will be auto-included in the campaign (Note that restrictions like out of stock or blocked items will continue to work as is - those items are not considered for ads)

Reporting enhancements

Manual targeting reports

  • Targeting reports (Keyword, Placement, Audience) are now accessible directly from the campaign homepage, eliminating the need for CSV downloads.
  • Visibility of the Placements, Keywords, and Audiences tabs is dynamically controlled based on the platform’s targeting configurations. Only relevant tabs will appear for each platform.

Separated campaign-level report

  • Campaign-level data is now separated from item, creative, or asset-level reports for better clarity and ease of use.

API changes

Management API Transition to API Keys for Authentication

The Management API's authentication mechanism has transitioned from token-based (JWT) to API Keys. This update unifies the authentication method across all MCM APIs to use API Keys. Due to this change, Token-based authentication will be retired on May 31, 2025. For detailed guidance on the API Key authentication method, please see our updated documentation (v1.1) on API and SSO Credential Management.

📘

If you are currently using the legacy token-based (JWT) authentication method, you can continue using it after May 31, 2025 and no action is required (token-based authentication remains documented in our v1.0 documentation). If you are newly onboarding on Moloco Commerce Media, please use the new API key authentication method as described here.

Documentation updates

Transition to version 1.1

With the introduction of API key authentication for our Management API we have updated our guide to version 1.1. Version 1.0 will no longer be updated, please refer to the latest version for the most up to date information.

Added

Item Kill Switch (UpdateBulkItemStatus)

Added support for WebP images

Updated

Updated the following pages to include Management API Key authentication.

Updated information for Catalog Feed Error Handling

Updated Event data delivery options to include Google Tag Manager (GTM) allowing customers to collect user events (using tags) and forward them to the MCM Event API

Deprecated

CreateToken API

Product updates

Sponsored Brands

  • Ad type that allows platform customers to configure various ad elements (banner, logo, headline, call-to-action, landing) for a more expressive ad that can highlight both brands through creative elements and product images.

Google Merchant Feed support

  • Customers can use their existing catalog feed for Google Shopping ads to integrate into MCM

Wallet enhancements

  • Added UI for Top-up & Withdrawal functions within the Campaign Manager portal.
  • Optional comment fields for Top-Up and Withdraw transactions, enhancing clarity and providing an auditing trail.
  • Added Automatic ad account activation upon Top-up when the wallet is set above the deactivation threshold.
  • Added detailed error messages which provide clear explanations, including real-time ad spending values to assist platform users with withdrawal errors.

API changes

WithdrawWallet

  • The WithdrawWallet API Allows platforms to make adjustments to the amount of CREDITS applied to a wallet.

Documentation updates

Added

Updated

The MCM team strives to provide the best service with feature updates and improvements. If you have any questions or feedback, please don’t hesitate to contact our support team.

This release includes several enhancements to improve MCM overall functionality and user experience as well as new articles in our public documentation.

Product updates

  • Release of the Self-Service API/SSO Credential Management: Platform Owners can now generate and manage API and SSO credentials. For more details click here.

Documentation

Added

Updated

The MCM team strives to provide the best service with feature updates and improvements. If you have any questions or feedback, please don’t hesitate to contact our support team.