Release Notes

December 2024

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

November 2024

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

October 2024

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.

September 2024

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.