Note: The format of the report is CSV, and it will be enclosed in “gzip” file format by default.
Definition of Columns in the Campaign Recommendations Report
Column
Description
Type
reportDate
Date on which the report was generated
date
campaignId
Campaign Id for desired recommendations report
Integer
budgetType
The budget type of the campaign for which the report was requested
string
missedClicksLower
This field provides cumulative lower range of missed clicks over last 7 days for a campaign which went out of budget (OOB) for T-1 time
integer
missedClicksUpper
This field provides cumulative upper range of missed clicks over last 7 days for a campaign which went out of budget (OOB) for T-1 time
integer
missedImpressionsLower
This field will provide cumulative lower range of missed impressions over last 7 days for a campaign which went out of budget (OOB) for T-1 time
integer
missedImpressionUpper
This field will provide cumulative upper range of missed impressions over last 7 days for a campaign which went out of budget (OOB) for T-1 time
integer
suggestedLatestDailyBudget
This field provides the suggested latest daily budget recommendation to be applied to a campaign so that the campaign does not go out of budget.
double
suggestedLatestTotalBudget
This field provides the suggested latest total budget recommendation to be applied to a campaign so that the campaign does not go out of budget.
double
avgCapOutTime
The average cap out time is the average time for which the campaign went out of budget in the last 7 days. This value is represented in military time e.g. 1000 refers to 10 AM.
integer
adGroupId
Ad group Id
integer
itemId
Item Id
integer
itemName
Item Name
string
issueTypes
List of issue types
string
Headers
Header Name
Description
Required
Values
Authorization
The token will provide you the access to the API. It is same for all advertisers you access through the API.
Y
Please utilize the generated auth_token shared with you at the time of partner onboarding from the Getting Started Guide
WM_CONSUMER.ID
We will provide you the consumer ID to access the API. It is same for all advertisers you access through the API.
Y
Please use the generated ConsumerId shared with you at the time of partner onboarding. Refer to the Getting Started Guide for more information
WM_SEC.AUTH_SIGNATURE
Auth signature as an API key.
Y
Use the signature generator code from Getting Started Guide to generate this value
WM_SEC.KEY_VERSION
We will provide you with the KEY VERSION to access the API. It is same for all advertisers you access through the API.
Y
1
WM_CONSUMER.intimestamp
Timestamp for which the auth signature is generated. Use Unix epoch format for the timestamp.
Y
Use the signature generator code from Getting Started Guide to generate this value
Top-selling item was disabled from an active ad group
Re-enable item
PRICE_INCREASE
Item price increased >10% vs. its own 14-day rolling average
Review and adjust pricing in Seller Center to restore competitiveness
OLQ_SCORE_DROP_CONTENT
Content OLQ component dropped >10% vs. 14-day baseline
Improve item title, key features, description, and image quality
OLQ_SCORE_DROP_SHIPPING
Shipping OLQ component dropped >10% vs. 14-day baseline
Take action to improve delivery speed
OLQ_SCORE_DROP_PRICE_COMPETITIVENESS
Price Competitiveness OLQ component dropped >10% vs. 14-day baseline
Review pricing
OLQ_SCORE_DROP_PUBLISHED_AND_IN_STOCK
Published & In-Stock OLQ component dropped >10% vs. 14-day baseline
Check inventory levels; replenish stock or resolve listing status issues
OLQ_SCORE_DROP_RATINGS_AND_REVIEWS
Ratings & Reviews OLQ component dropped >10% vs. 14-day baseline
Investigate root causes of rating decline
BUYBOX_WIN_RATE_DROP
Buy Box win rate dropped >10% vs. 14-day baseline
Review pricing competitiveness and fulfilment reliability
OLQ_SCORE_LOW_CONTENT
Content OLQ component currently below 60% quality threshold
Comprehensively improve listing content — title, images, key features
OLQ_SCORE_LOW_SHIPPING
Shipping OLQ component currently below 60% quality threshold
Improve delivery speed and reduce cost to customer
OLQ_SCORE_LOW_PRICE_COMPETITIVENESS
Price Competitiveness OLQ component currently below 60%
Lower price to match or beat competitor pricing
OLQ_SCORE_LOW_PUBLISHED_IN_STOCK
Published & In-Stock OLQ component currently below 60%
Resolve any listing publication issues in Seller Center
OLQ_SCORE_LOW_RATINGS_REVIEWS
Ratings & Reviews OLQ component currently below 60%
Address review issues
Understanding issueTypes in API responses
The issueTypes field returns a comma-separated string of active issue flags, ordered by descending priority. The first value always represents the highest-priority issue affecting the item.
Parsing Guidance
Primary action: Parse the first token to identify the most urgent issue requiring attention.
Multi-issue handling: Parse the full list to support multi-issue displays, alerting logic, or audit logs.
Example values: DISABLEMENT : single issue, item was disabled DISABLEMENT,PRICE_INCREASE : two issues, disablement is higher priority OLQ_SCORE_DROP_SHIPPING, BUYBOX_WIN_RATE_DROP, OLQ_SCORE_LOW_CONTENT : three issues, OLQ drop is highest priority
Alert Persistent Rules
Alerts do not disappear the moment an underlying issue is resolved. Each alert type has a persistence window and to account for the T-1 data latency. An alert is only cleared once the removal condition is confirmed in the daily data refresh.
Alert Type
Persists For
Removed When
DISABLEMENT
7 days after disablement event
Item is re-enabled in the ad group
PRICE_INCREASE
14 days after price increase
Price reverts to within <10% of 14-day baseline average
OLQ_SCORE_DROP_*
14 days while score remains >10% below baseline
OLQ component rebounds within <10% of its baseline
