Campaigns

Campaigns are entities that for the same advertiser and account, group together line items which harbour one or more creatives, composed of one or more creative files.

*breath*

I just threw a whole lot of potentially cryptic terminology at you, and for that, I am sorry. So how about we go over what each one of them means one-by-one! Alright, alright, alright, enough rambling, let's get to it:

The above diagram illustrates the relationship between the aforementioned entities. They will all be described in detail below, starting from the bottom and working our way upwards.

Creative files

A creative file is an entity that describes a playable file. A playable file can be an image, video, or an HTML file. Some information about the file is stored, such as width and height in pixels, it's URL to where it resides on the almighty Internet, duration if it's a video, and more.

Creatives

A creative is a collection of creative files. Often, all of the creative files associated to a creative have the same content, but instead define different parameters such as dimensions to play on different sized screens.

Line items

A line item, sometimes referred to as a flight, or a segment, is an entity that represents the details for where, when, how long, and many more parameters that determine the allowed play-out of an ad. For example: A line item can specify that a particular creative/creative file can only play on 1080p screens in New York City during the week of spring break 2025 and target people between the ages of 18 and 25.

Campaigns

A campaign is simply a grouping of line items. You might be thinking something along the lines of "why would you need more than one line item for a campaign? Can't you just target the things you need?". Those are great hypothetical questions! Let's use a specific example to illustrate the why. Example: Consider the case where Advertiser, Bob Corp., comes to you with the intent to run a line item in both New York City and Brooklyn to advertise the release of their newest product, Steve-ee-Os cereal, with a budget of $200k. Well that's no problem at all, we can just create a line item that targets both of those markets, easy! However, the CMO of Bob Corp. comes back to you and says that he's been told he has to spend $150k of the budget in NYC, and the remainder in Brooklyn. Line items don't allow you to split budget based on various targeting parameters, so to solve this week need two distinct line items associated to the same campaign. One that targets NYC with $150k budget, and another that targets Brooklyn with a $50k budget.

Setting this all up via the API

The basic idea here is that you will create entities in the opposite order than how they were defined above.