Ads API structure and objects

The API is made up of the following structure and objects:

Structure and objects

Organization

The highest-level object, an organization typically corresponds to a business entity, like an advertiser or ad agency, or can be created by an API partners that wants to create an app with Roku. An organization contains everything you need to run an ad with Roku, including your ad accounts, campaigns, ad groups, and creatives.

Ad account

An ad account is owned by an organization and has one or more funding source. It's good practice to have an ad account for each individual brand within your organization. An ad account contains campaigns.

Campaign

Use campaigns to define your specific advertising objective, like awareness or conversion. You may want to create multiple campaigns for each of your ad accounts, depending on how many advertising objectives and approaches to those objectives you have. A campaign contains one ad group. (In the future, a campaign will be able to contain multiple ad groups).

Ad group

An ad group defines the schedule, target audience, budget, and ad placement for a campaign. Ad groups aren't currently visible in the Roku Ads Manager UI but these settings are stored in an ad group behind the scenes when you create a campaign. You have one ad group per campaign. Ad groups contain the creatives that are served within their campaigns.

Creative

A creative, defined by a unique creative ID, is made up of one or more ad assets. For example, a creative for an action ad could contain a video, an image, and metadata like a URL to link to. You can attach creatives to an ad group and you can attach the same creative to many different ad groups.

Other important objects

Custom audience

A list of Roku devices, associated with households, that you can target in ad campaigns to increase campaign performance. Create custom audiences using customer lists or event data. Learn more about custom audiences in the Ads Manager help center.