Introduction

The Suggested Items provides data-driven recommendations to advertisers on which items to include in their campaigns for increased efficiency and performance, based on a daily-refreshed suggestion score designed to identify items with high potential for campaign success.

How items are suggested

The suggestion score is derived from various performance metrics, which may include user engagement, sales data, and other relevant factors, ensuring that the suggested items have proven appeal and sales potential.

Items currently in active campaigns or out of stock are excluded to keep the recommendations focused and practical. Furthermore, the system limits the number of recommendations to a manageable number, typically up to ten items.

📘

Note

The exact composition of the suggestion score may evolve over time to incorporate new data insights and market trends.

QuerySuggestedItems API

To get the list of suggested items, use QuerySuggestedItems API.

Sample Request

POST  
https\://<platform>-mgmt.mcm-api.moloco.com/mcm/mgmt/v1/platforms/{platform_id}/ad-accounts/{ad_account_id}/suggested-items

Parameters

• platform_id: The identification assigned to the platform within MCM.
• ad_account_id: The unique ID of the ad account which contains the new campaign.
• order_by: Options for sorting the results.
• search_keyword: String used to search for specific keywords within product IDs, titles, or categories.
• filter: Filtering parameter. Currently, created_timestamp filter and is_active filter are supported. The created_timestamp filter allows users to filter items based on their creation timestamp before or after a specific time, and is_active filter allows users to filter items based on their activeness.
• limit: Maximum number of items to return. The default limit is 10. If no limit is specified, the system will return up to 10 items by default. However, Platform owners and advertisers can specify a limit, the maximum limit is 100 items. .
• new_item_timestamp: Timestamp used to identify new items. A new item is defined as one added after a certain timestamp, typically the last updated timestamp of a campaign.