Campaign Management APIs

The Campaign Management APIs include endpoints for sucessfully booking a campaign with goals and ads, as well as managing any campaign and goal targeting rules.

Refer to Tutorial: Create a Campaign for more information on the API calls required to successfully book a campaign.

The Campaign Management APIs also include a series of query endpoints, which are meant to quickly retrieve detailed information and performance metrics for your campaigns, goals, and ads. These endpoints allow you to build your own interfaces to view the information in your account.

Table 1. Campaign Management APIs Overview
API component API operations Description
Campaign API Use the Campaign API to define general settings for a campaign, and retrieve the VAST URLs for ad calls on a campaign. Give the campaign a name, associate it with a client, set the campaign priority, delivery mode and targeting rules. You can then add goals and ads through endpoints described further down in the table.
Goal API A goal is a schedule or placement that determines the delivery of your ads. Use the Goal API to define, for example, how many impressions should be delivered, at what frequency, how they appear in ad breaks, the targeting rules, the start/end date of the campaign, and to retrieve VAST URLs for ad calls on a goal. You can have multiple goals in a campaign if you, for example, need to reach different target audiences, or deliver during different time periods. You can then add ads through endpoints described further down in the table.
Asset API Assets refer to creative files that you need to associate with your ads. Use the Asset API to upload and retrieve video assets and other assets, such as ad images and flash files.
Note: Uploaded assets that have not been linked to an ad expire after 24 hours. Querying for expired assets returns a 404 (Not Found) error.
Ad API Use the Ad API to link an asset to an ad, add one or more ads of supported format to a goal, target ads to specific device groups, and set a different start/end date than the one set for the goal. Also use the Ad API to retrieve VAST URLs for ad calls on an ad.
Note: Uploaded assets that have not been linked to an ad expire after 24 hours. Querying for expired assets returns a 404 (Not Found) error.
Campaign Management Query API Use the Campaign Management Query API to quickly access detailed information and performance metrics collected for your campaigns, goals, and ads.

Swagger documentation: Campaign API v3

VAST URLs API Use the VAST URLs API to export the VAST URL for ad calls on a campaign, goal, or ad when using Pulse for testing purposes or as a 3rd party ad server, meaning you can extract the VAST URL from Pulse and implement it in other ad servers. The provided URL works as a 3rd party call to Pulse and then Pulse functions as a 3rd party redirect.

Swagger documentation: Campaign API v3 - VAST URLs

Banner Areas API Use the Banner Areas API to quickly retrieve companion banner area (zone) information.

Swagger documentation: Campaign API v3 - Banner Areas

https://help.ooyala.com/sites/all/libraries/dita/en/video-advertising/oadtech/ad_serving/dg/rest_campaign_management.html

Was this article helpful?