Question

Why is my Amazon Advertising API returning incomplete data for campaign performance metrics?

Answer 1

If your Amazon Advertising API is returning incomplete data — missing metrics like impressions, clicks, or conversions, you’re not alone. This usually isn’t a bug, but a result of timing, permissions, or data processing delays. Here's what could be happening and how to troubleshoot it:

1. Data Latency: Not Real-Time

Amazon’s Ads API is not real-time. Performance data is updated periodically, not instantly.

• Sponsored Products: ~12–24 hours delay

• Sponsored Brands / Display: May take longer

• Conversion data: Can take up to 48 hours to finalize

Fix: Always query data with a 48-hour buffer (e.g., request data up to “yesterday” instead of “today”).

2. Missing or Incorrect Access Scope

If you're using a token with limited permissions, some metrics or campaign types may not be accessible.

• Fix: Check that your API access token includes the right scope (advertising::campaign_management) and that your user role is Admin or has full reporting permissions.

3. Metrics Not Available for All Campaign Types

Some metrics like attributedSales14d or conversionRate don’t apply to all ad types, or may return null if not relevant.

• Fix: Review the Amazon Ads API documentation to ensure you’re requesting valid metrics for the campaign type (Sponsored Products, Brands, Display, etc.).

4. Rate Limits or Partial Page Fetches

If you’re paginating through a large set of campaigns or ad groups and hit rate limits or stop fetching early, some data won’t appear.

• Fix: Make sure you're handling pagination properly (nextToken) and respecting API throttling limits.

5. Archived or Paused Entities

Archived or paused campaigns/ad groups may not return performance metrics, especially if you're querying "active" status only.

• Fix: Set stateFilter=enabled, paused, and archived to get a full picture.

6. Budget-Limited or Inactive Campaigns

If a campaign had no spend, Amazon will often return empty performance objects (0 or null values).

• Fix: Confirm the campaigns actually delivered impressions or spend during your selected date range.

7. Wrong Report Type or API Version

Requesting metrics from the wrong report type or using outdated API versions can result in missing fields.

• Fix: Double-check that you're:

  • Using the correct endpoint (e.g., reporting/{adType}).

  • Using the latest API version (v2, v3, etc.).

  • Requesting the appropriate report columns