As CoreMedia Campaigns is a headless service, it offers a Delivery API based on GraphQL. This API can be used by your website frontend to request the currently active campaign content for a specific page and slot. All campaigns that are currently actively running and that define content for a page and furthermore slot can be returned.

Figure 11.2. Only the summer collection Campaigns are retrieved for the site with the id "ced8921…"

To get the desired content managed via campaigns, for instance, all campaigns that should be visible on category pages and are visible for the summer, a query like shown in the picture above would be correct.

How do I get a specific campaign?

You don't. The Campaigns Delivery API is not designed to retrieve specific campaigns by name or ID. It is rather the other way around. You perform a request where you specify the site and page you are working on and refinements relevant to that page ("women", for instance) and the API will return the appropriate content from all active campaigns.

What is the content of a campaign?

The content is divided by the channel types it references to, and after that, a campaign contains linked articles for slots, for example "Hero-slot".

Which campaign is returned if two with the same refinements exist?

The campaign with the highest priority will be returned if no exact match via refinements can be found. You can also request more than one results via the API, then you get them sorted by priority.