Creating banner campaigns with the Campaign API

To create a banner campaign using the Campaign API, you need to define the basic campaign information, such as name, budget, start, and end. But also, more specific data, to create the campaign for the right place and targets. The main configurations for the basic implementation of banner ads are the following.

Promotion type

Promotion type is the banner definition for the campaign, here you will set 2 important configurations: the asset properties and the slotId. The asset properties are important to trace back the banner and validate the dimensions, to make sure all banners in the one slotId have the same dimensions. The slotId is a reference to the placement where the banner will appear. You can have different slots on different pages, such as home, landing pages, category pages, and search pages.

Bids definition

Here you will set the target and triggers for this campaign. Target is the object to where the banner will lead the user, such as "product", "brand", "vendor" or "url". The auction response will provide this object, so that you can use it to create the path to the user, such as a link or deeplink. Triggers are the objects or references that will be used by the auction system to choose this campaign among others to compete. As triggers, you can set keywords, products, vendors, brands, categories, and homepage.

Campaign Options

Optionally, you can also benefit from using extra parameters to attend more use cases:

  • Status: with this parameter, you can set the initial status for the campaign, such as "approved", "pending" or "rejected".
  • IsActive: allow the campaign to start right away if it's true, or to be created as inactive so that you can change the status later.
  • Location: with this option, you will be able to target this campaign to a specific group. You must define the same location as a parameter on the auction request. Bids on a specific campaign will have specific conversion rates, considering the context of location, so it will not interfere with the conversion rates for the same product in other campaigns. Use cases for this configuration can be, for example: creating campaigns for specific countries, and cities.