This creates a new creative under an advertiser.
What is a Creative?
As described in the Creativessection of this guide, a creative contains detailed information about a specific ad, such as ad size, URL, format, and other fields. When you set up a flight with ads, creatives become an important part of the flight, since this is where the information about the ad is kept.
API Syntax
When using the Create Creative API, it is important to understand the syntax required to make the request. Because the Kevel API is a RESTful API, there is a specific request format that must be followed to ensure the endpoint can process the request. The format is:
POST https://api.kevel.co/v1/creative
Where:
POST
- the type of API request being made.https://api.kevel.co
- the URL for the request.v1
- the API version.creative
- the API endpoint being called.
Creative Parameter Fields
The Create Creative API call is a POST
call, meaning you must enter a number of body parameters as part of the request before calling the endpoint. These parameters enable you to specify the fields included in the creative. Although there are many different parameters you can add as part of the request, there are several required fields that must be part of the request in order to create the creative. These fields are:
- AdvertiserId - The ID of the Advertiser.
- AdTypeId - The ad size's ID. More info here.
- isActive - Specifies whether creative is eligible to serve.
Enabling Creatives To Be Served
In order to have a creative be eligible to serve, you must use the Creative Flight Maps (Ads) endpoints. These endpoints will map the creative to a flight's ad.
Uploading Creatives
You may also choose to upload a creative to Kevel so it is hosted on the Kevel site. To upload a creative, use the Upload Creative Image endpoint after the creative has been created.