Launch announcement

Access DSP recommendations via new Guidance API

November 10, 2024

What launched?

Amazon DSP has launched a new Guidance API and Quick Action API, enabling advertisers to programmatically access pre-flight and in-flight recommendations for their campaigns. The Guidance API provides the same intelligent suggestions for maximum average CPM, line-item frequency caps, viewability targeting and other optimization opportunities that are available through the DSP console. Advertisers can now retrieve recommendations for new campaigns pre-flight and in-flight optimizations for live campaigns, allowing for seamless integration with their own systems and workflows. The Quick Action API allows advertisers to seamlessly action Amazon DSP’s recommendations.

Why is it important?

The Guidance API empowers advertisers to automate their campaign optimization processes, reducing manual effort and improving efficiency. By providing programmatic access to Amazon's machine learning-driven recommendations, advertisers can quickly identify and act on opportunities to enhance campaign performance and delivery. This API integration enables more frequent and consistent optimization, especially beneficial for advertisers managing large-scale campaigns or using custom tools for campaign management.

Where is the feature available?

  • North America: United States, Canada, Mexico
  • South America: Brazil
  • Europe: Germany, Spain, France, Italy, Netherlands, United Kingdom, Sweden, Poland, United Kingdom, Austria, Luxembourg, Ireland, Denmark, Finland, Norway, Belgium
  • Middle East: Saudi Arabia, United Arab Emirates, Israel, Egypt, Turkey, Morocco, Bahrain, Kuwait
  • Asia Pacific: Australia, India, Japan, China, Singapore, New Zealand

Who can use it?

  • Self-service advertisers on Amazon DSP

Where do I access it?

  • The Guidance API is accessible through the Amazon Advertising API platform. Developers can find detailed documentation, including endpoints, request/response formats, and implementation guides, in the Amazon Advertising API documentation portal.

API specific

DSP Guidance API: Advertisers can use this API to view recommendations for their campaigns. The four new endpoints will aggregate the guidance at various object levels (advertiser, order or line items). Recommendations can be fetched for many objects at once.

Listed bellow are the new endpoints included in this API

  • POST /dsp/v1/guidance/lineitems/list
  • POST /dsp/v1/guidance/orders/list
  • POST /dsp/v1/guidance/advertisers/list

DSP Quick Actions API: This API allows advertisers to adopt the recommended changes returned by the Guidance API. Sending a request to POST /dsp/v1/quickactions/{actionId}/executions using the actionId included in the guidance response will trigger the relevant change to be adopted.

Back to updates