Create Ads

This creates an ad. The result will provide a unique Ad ID that can be used to update/delete ads.

To make an ad, you'll first need to upload a creative to the system using the Create Creative endpoint. Then, you'll take that CreativeID and pass it as the 'id' for the creative object in the Create Ads ping.

Additional Parameters

Property

Description

IsNetworkAd
(boolean)

Indicates that ad comes from a 3rd party (i.e. uses 3rd party ad tags) - for use with Click Bucketing. If true = multiple clicks from the same IP address count as Unique Clicks

DontAffectParentFreqCap
(boolean)

"Opts-out" of frequency cap settings imposed on it by above

FreqCap
(integer)

The cap of the frequency cap. Instructions here

FreqCapDuration
(integer)

How long the frequency cap should apply. Instructions here

FreqCapType
(integer)

The unit for the frequency cap: 1 = Hour 2 = Day 3 = Minute. Instructions here

Deprecated Parameters

DistributionType, Percentage, Impressions, CampaignId, StartDate, EndDate, and PublisherAccountID.

Misc Notes

Goal: If GoalType is 2 (Percentage), then a Goal of 100 represents a 100% goal. If GoalType is 1 (Impressions), then a Goal of 200000 represents a goal of 200,000 impressions. Note: when you GET a creative, you will see a value of "null" for Goal, and the goal should be represented as e.g. "Impressions": 200000 or "Percentage": 100. Our API does this conversion behind the scenes.

IsGoalOverride: You will see this IsGoalOverride field in the results of a GET request for a creative flight map -- this indicates whether or not the flight-level goal is being overridden by an ad-level goal. When creating or updating a creative flight map, however, you do not need to explicitly set IsGoalOverride -- it is set automatically based on whether or not you are supplying GoalType and Goal.

IsStartEndDateOverride: You will see IsStartEndDateOverride field in the results of a GET request for a creative flight map -- this indicates whether or not the ad has its own start/end dates. When creating or updating a creative flight map, however, you do not need to explicitly set IsStartEndDateOverride -- it is set automatically based on whether or not you are supplying StartDateISO and EndDateISO.

Language
Authentication
Header